opensrc : un chemin source de dépendance mis en cache pour un assistant de code

À qui ça s’adresse

opensrc s’adresse à qui doit faire lire le code source des dépendances à un assistant de code : vous voulez l’implémentation d’un paquet sur npm, PyPI, crates.io ou GitHub, sans cloner le dépôt à la main. La capacité offerte : l’assistant peut accéder au source de n’importe quel paquet, et la ligne de commande le télécharge puis le met en cache.

Plus précisément, le chemin principal est une CLI. Après installation, pointez opensrc path vers un nom de paquet : le premier passage récupère, les suivants renvoient tout de suite le chemin local déjà en cache. Vous pouvez passer ce chemin à des commandes suivantes en lecture seule, par exemple chercher par nom de fichier dans le répertoire d’un paquet PyPI.

Ce n’est pas un gestionnaire de paquets ni un outil de publication. La documentation du dépôt s’arrête à « récupérer et mettre en cache le source, renvoyer un chemin ». Elle n’explique ni comment modifier un paquet, ni comment publier, ni qu’elle modifierait automatiquement vos fichiers de projet. Si vous voulez seulement installer des dépendances dans le projet courant, continuez avec votre gestionnaire habituel ; ne traitez pas opensrc comme un installateur.

Premier essai en 3 minutes

La seule commande d’installation officielle est npm install -g opensrc. Le dépôt est https://github.com/vercel-labs/opensrc Suivez uniquement cette page. La documentation ne donne pas d’autre installateur ni commande de marketplace ; n’en inventez pas.

Prérequis : npm est déjà utilisable sur cette machine, et l’installation globale d’un outil en ligne de commande est autorisée. L’emplacement d’installation est une CLI globale nommée opensrc. Une fois installé, exécutez d’abord opensrc dans un terminal ou consultez l’aide pour confirmer que la commande est trouvée ; cette étape n’écrit pas de fichier dans votre répertoire de projet.

Première tâche à faible risque : choisissez un paquet public que vous inspecteriez déjà en lecture seule. Ne pointez pas vers un dépôt privé ou non autorisé. Dans le terminal, lancez opensrc path plus le nom du paquet. Selon le dépôt, le premier passage récupère et met en cache le source, puis renvoie un chemin local. Signal de succès : la commande imprime un chemin de répertoire local, et relancer tout de suite la même commande n’attend plus une récupération comme la première fois — elle donne le même chemin immédiatement.

Si vous utiliserez le chemin renvoyé ensuite, affichez-le d’abord, puis décidez d’une recherche en lecture seule. L’exemple du dépôt est find $(opensrc path pypi:requests) -name "*.py" : il résout d’abord le chemin en cache de pypi:requests, puis liste les fichiers Python. Avant d’exécuter find, confirmez que vous ne faites que consulter des noms de fichiers, sans supprimer ni réécrire. La documentation n’indique ni l’emplacement par défaut du cache ni une commande de nettoyage ; le premier essai peut s’arrêter à « obtenir un chemin et lister des fichiers ».

Cas d’usage

Cas 1 : donner à l’assistant un répertoire source local réutilisable. Le flux est opensrc path : première récupération, ensuite le chemin en cache. Cela convient quand vous lisez l’implémentation d’une dépendance et devez rouvrir le même répertoire. La documentation n’énumère pas toutes les écritures de noms de paquets prises en charge ; elle insiste seulement sur la première récupération puis le chemin immédiat. Si la commande échoue, revenez à https://github.com/vercel-labs/opensrc pour vérifier que l’installation est terminée, au lieu de changer pour une méthode non documentée.

Cas 2 : consulter des fichiers source à travers les registres. La CLI indique qu’elle peut récupérer et mettre en cache le source depuis npm, PyPI, crates.io et GitHub. L’exemple concret du dépôt est find ... -name "*.py" sur pypi:requests, pour lister les fichiers Python de ce paquet. Cela convient si vous connaissez déjà le préfixe de registre et voulez seulement voir quels fichiers sont dans l’arbre. La documentation n’étend pas les formes de commande équivalentes pour GitHub ou crates.io, et ne décrit pas l’authentification des paquets privés ; ces directions s’arrêtent à « la CLI affirme prendre en charge ces sources ». N’inventez pas de préfixes.

Limites d’usage

Limite d’installation : l’officiel n’écrit que npm install -g opensrc ; n’utilisez pas un installateur non consigné. Limite de capacité : la documentation donne à un assistant l’accès au source de n’importe quel paquet, et met en cache le source npm, PyPI, crates.io et GitHub ; elle n’écrit pas qu’elle modifiera ces paquets, ni qu’elle remplace un gestionnaire de paquets de langage. Limite d’opération : les commandes concrètes vérifiables sont opensrc path et find $(opensrc path pypi:requests) -name "*.py". Le cache est décrit comme « première récupération, ensuite le chemin tout de suite » ; pas de politique d’expiration ni de méthode de nettoyage. Quatre registres apparaissent, sans dire que ce sont les seuls, et sans étapes de justificatifs pour un dépôt privé.