mcs

Recherche centrale Maven

Utilisez Maven Central Repository Search depuis votre ligne de commande !

Utilisez mcs pour rechercher rapidement les coordonnées de dépendance dans Maven Central, sans avoir à basculer vers votre navigateur.

Usage

Cet outil prend en charge les modes de recherche suivants :

1. Recherche générique

    mcs search plexus-utils

   Cela vous donnera tous les artefacts de Maven Central qui ont « plexus-utils » dans leur nom. Le résultat se présente sous forme de tableau, montrant les coordonnées exactes de chaque artefact et le moment où sa dernière version a été déployée.

2. Recherche de coordonnées

    mcs search org.codehaus.plexus:plexus-utils
   mcs search org.codehaus.plexus:plexus-utils:3.4.1

   S'il y a plusieurs résultats, vous obtiendrez le même résultat de tableau que ci-dessus. Mais s'il n'y a qu'un seul résultat, cela vous donnera par défaut un extrait pom.xml pour l'artefact que vous avez recherché. Prêt à copier-coller dans votre IDE préféré !
   Si vous avez besoin d'un extrait dans un format différent, utilisez -f <type> ou --format=<type> . Les types pris en charge sont : maven , gradle , gradle-short , gradle-kotlin , sbt , ivy , grape , leiningen , buildr , jbang , gav .

3. Recherche de nom de classe

    mcs class-search CommandLine
   mcs class-search -f picocli.CommandLine

   Cela vous donnera tous les artefacts de Maven Central qui contiennent une classe particulière. Si vous définissez l'indicateur -f , le terme de recherche est considéré comme un nom de classe « entièrement classifié », incluant donc le nom du package.

Drapeaux

• Tous les modes reconnaissent le commutateur -l <number> , qui vous permet de spécifier le nombre de résultats que vous souhaitez voir au maximum .
• Dans la recherche par caractères génériques et la recherche de coordonnées , vous pouvez transmettre l'indicateur -s (ou --show-vulnerabilities ). Cela amènera MCS à afficher un résumé des vulnérabilités de sécurité signalées pour chaque résultat. S'il n'y a qu'un seul résultat de recherche, les numéros CVE rapportés par rapport à ce résultat s'afficheront. Notez que cette fonctionnalité atteindra probablement bientôt les limites de l'API pour l'index Sonatype OSS. Consultez leur documentation pour plus de détails sur l'impact que cela peut avoir sur votre utilisation. Vous pouvez spécifier vos informations d'identification à l'aide des propriétés système ossindex.username et ossindex.password . Voir sous « Configuration de MCS » pour savoir comment procéder de la manière la plus pratique.

Installation

Vous pouvez installer mcs en utilisant le gestionnaire de packages de votre choix :

Gestionnaire de paquets	Plate-forme	Installation	Remarques
Homebrew	? ?	brew install mthmulders/tap/mcs	️ 1
Instantané	?	snap install maven-central-search
SDKMAN !	? ?	sdk install mcs
Chocolaté	?	choco install mcs
Scoop	?	scoop install mthmulders/mcs

1. Les binaires Linux ne fonctionnent que sur les processeurs x86_64. Il existe des binaires Apple pour x86_64 et Apple Silicon, vous n'avez donc pas besoin de Rosetta.

Utilisation avec un magasin de confiance personnalisé

Dans certaines situations, par exemple lorsque vous travaillez derrière un pare-feu (d'entreprise) interceptant TLS, MCS peut échouer avec

Échec de la création du chemin PKIX : sun.security.provider.certpath.SunCertPathBuilderException : impossible de trouver un chemin de certification valide vers la cible demandée

En langage profane : le magasin de confiance intégré par défaut (l'ensemble des certificats X.509 de confiance) ne contient rien qui permette de faire confiance au(x) certificat(s) présenté(s) par le serveur. Maven Central utilise un certificat qui aurait été fiable, mais le coupable ici est le pare-feu (d'entreprise) qui intercepte TLS et qui présente un certificat interne.

La solution consiste à créer un magasin de confiance contenant le certificat "le plus élevé" de la chaîne de certificats, par exemple celui de l'autorité de certification (interne). Vous pouvez utiliser un outil comme Portecle pour créer un tel magasin de confiance. Ensuite, pointez MCS vers ce magasin de confiance comme ceci

 mcs -Djavax.net.ssl.trustStore=/path/to/keystore search something

Utilisation derrière un proxy

Si vous utilisez un proxy, MCS respectera les variables d'environnement HTTP_PROXY et HTTPS_PROXY .

Configuration de MCS

Une partie de la configuration de MCS est transmise via les propriétés système. Vous pouvez le faire chaque fois que vous appelez MCS en ajoutant -Dxxx=yyy . Pour le rendre plus pratique, vous pouvez créer un fichier de configuration qui sera automatiquement lu par MCS et interprété comme paramètres de configuration.

Pour ce faire, créez un répertoire .mcs dans votre répertoire utilisateur (généralement C:Users<your-user-name> sur ?, /home/ sur ? ou /Users/ sur ?). Dans ce dossier, créez un fichier mcs.config et écrivez-y la ligne suivante :

 javax.net.ssl.trustStore=/path/to/keystore
ossindex.username=xxx
ossindex.password=yyy

De cette façon, vous n'avez pas besoin de vous souvenir d'avoir passé le -D .

Contribuer

Le moyen le plus simple d'obtenir un environnement de développement fonctionnel est probablement d'utiliser Gitpod :

Il configurera un espace de travail dans votre navigateur et montrera que tout fonctionne comme prévu en exécutant mvn verify . Cette configuration ne touche pas votre ordinateur : dès que vous fermez l'onglet de votre navigateur, il disparaît.

Consultez les problèmes si vous cherchez quelque chose sur lequel travailler. Si vous avez une nouvelle idée, n'hésitez pas à la proposer à travers les discussions.

Remerciements

Le MCS n’aurait pas été possible sans la contribution de personnes formidables du monde entier. La liste complète se trouve dans CONTRIBUTORS.md.