mcs

Maven Central Search

Verwenden Sie die Maven Central Repository Search über Ihre Befehlszeile!

Verwenden Sie mcs , um in Maven Central schnell nach Abhängigkeitskoordinaten zu suchen, ohne zu Ihrem Browser wechseln zu müssen.

Verwendung

Dieses Tool unterstützt die folgenden Suchmodi:

1. Wildcard-Suche

    mcs search plexus-utils

   Dadurch erhalten Sie alle Artefakte in Maven Central, deren Namen „plexus-utils“ enthalten. Die Ausgabe erfolgt in tabellarischer Form und zeigt die genauen Koordinaten jedes Artefakts und den Zeitpunkt, zu dem die neueste Version bereitgestellt wurde.

2. Koordinatensuche

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

   Bei mehreren Treffern erhalten Sie die gleiche Tabellenausgabe wie oben. Wenn es jedoch nur einen Treffer gibt, erhalten Sie standardmäßig ein pom.xml-Snippet für das gesuchte Artefakt. Bereit zum Kopieren und Einfügen in Ihre Lieblings-IDE!
   Wenn Sie ein Snippet in einem anderen Format benötigen, verwenden Sie -f <type> oder --format=<type> . Unterstützte Typen sind: maven , gradle , gradle-short , gradle-kotlin , sbt , ivy , grape , leiningen , buildr , jbang , gav .

3. Suche nach Klassennamen

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

   Dadurch erhalten Sie alle Artefakte in Maven Central, die eine bestimmte Klasse enthalten. Wenn Sie das Flag -f setzen, wird der Suchbegriff als „vollständig klassifizierter“ Klassenname betrachtet, also einschließlich des Paketnamens.

Flaggen

• Alle Modi erkennen den Schalter -l <number> , mit dem Sie angeben können, wie viele Ergebnisse Sie maximal sehen möchten.
• Bei der Wildcard- Suche und der Koordinatensuche können Sie das Flag -s (oder --show-vulnerabilities ) weitergeben. Dies führt dazu, dass MCS für jedes Ergebnis eine Zusammenfassung der gemeldeten Sicherheitslücken anzeigt. Wenn es nur ein Suchergebnis gibt, werden die für dieses Ergebnis gemeldeten CVE-Nummern angezeigt. Beachten Sie , dass diese Funktion wahrscheinlich bald die API-Grenzwerte für den Sonatype OSS Index erreichen wird. Einzelheiten dazu, wie sich dies auf Ihre Nutzung auswirken kann, finden Sie in der entsprechenden Dokumentation. Sie können Ihre Anmeldeinformationen mithilfe der Systemeigenschaften ossindex.username und ossindex.password angeben. Wie Sie dies am bequemsten tun, erfahren Sie unter „MCS konfigurieren“.

Installation

Sie können mcs mit dem Paketmanager Ihrer Wahl installieren:

Paketmanager	Plattform	Installation	Bemerkungen
Homebrew	? ?	brew install mthmulders/tap/mcs	️ 1
Schnapp	?	snap install maven-central-search
SDKMAN!	? ?	sdk install mcs
Schokoladend	?	choco install mcs
Scoop	?	scoop install mthmulders/mcs

1. Die Linux-Binärdateien funktionieren nur auf x86_64-CPUs. Es gibt Apple-Binärdateien sowohl für x86_64 als auch für Apple Silicon, sodass Sie Rosetta nicht benötigen.

Verwendung mit benutzerdefiniertem Trust Store

In bestimmten Situationen, beispielsweise wenn Sie hinter einer TLS-abfangenden (Unternehmens-)Firewall arbeiten, kann MCS fehlschlagen

PKIX-Pfadaufbau fehlgeschlagen: sun.security.provider.certpath.SunCertPathBuilderException: Es konnte kein gültiger Zertifizierungspfad zum angeforderten Ziel gefunden werden

Um es für Laien auszudrücken: Der standardmäßig integrierte Trust Store (der Satz vertrauenswürdiger X.509-Zertifikate) enthält nichts, was es ermöglicht, den vom Server vorgelegten Zertifikaten zu vertrauen. Maven Central verwendet ein Zertifikat, das vertrauenswürdig gewesen wäre, aber der Übeltäter ist hier die TLS-abfangende (Unternehmens-)Firewall, die ein internes Zertifikat präsentiert.

Die Lösung besteht darin, einen Truststore zu erstellen, der über das „höchste“ Zertifikat in der Zertifikatskette verfügt, z. B. das der (internen) Zertifizierungsstelle. Sie können ein Tool wie Portecle verwenden, um einen solchen Trust Store zu erstellen. Als nächstes verweisen Sie MCS wie folgt auf diesen Trust Store

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

Verwendung hinter einem Proxy

Wenn Sie hinter einem Proxy arbeiten, respektiert MCS die Umgebungsvariablen HTTP_PROXY und HTTPS_PROXY .

MCS konfigurieren

Einige Konfigurationen für MCS werden über Systemeigenschaften übergeben. Sie können dies jedes Mal tun, wenn Sie MCS aufrufen, indem Sie -Dxxx=yyy hinzufügen. Zur Vereinfachung können Sie eine Konfigurationsdatei erstellen, die automatisch von MCS gelesen und als Konfigurationseinstellungen interpretiert wird.

Erstellen Sie dazu ein Verzeichnis .mcs in Ihrem Benutzerverzeichnis (normalerweise C:Users<Ihr-Benutzername> auf ?, /home/ auf ? oder /Users/ auf ?). Erstellen Sie in diesem Ordner eine Datei mcs.config und schreiben Sie die folgende Zeile hinein:

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

Auf diese Weise müssen Sie sich nicht daran erinnern, das -D übergeben zu haben.

Mitwirken

Der wahrscheinlich einfachste Weg, eine funktionierende Entwicklungsumgebung zu erhalten, ist die Verwendung von Gitpod:

Es konfiguriert einen Arbeitsbereich in Ihrem Browser und zeigt durch Ausführen mvn verify an, dass alles wie erwartet funktioniert. Dieses Setup berührt Ihren Computer nicht – sobald Sie den Browser-Tab schließen, ist es verschwunden.

Schauen Sie sich die Probleme an, wenn Sie nach etwas suchen, an dem Sie arbeiten können. Wenn Sie eine neue Idee haben, können Sie diese gerne in den Diskussionen zur Sprache bringen.

Danksagungen

MCS wäre ohne die Beiträge wunderbarer Menschen auf der ganzen Welt nicht möglich gewesen. Die vollständige Liste finden Sie in CONTRIBUTORS.md.