mcs

Búsqueda central de Maven

Utilice la búsqueda en el repositorio central de Maven desde su línea de comandos.

Utilice mcs para buscar rápidamente coordenadas de dependencia en Maven Central, sin tener que cambiar a su navegador.

Uso

Esta herramienta admite los siguientes modos de búsqueda:

1. Búsqueda con comodines

    mcs search plexus-utils

   Esto le dará todos los artefactos en Maven Central que tienen "plexus-utils" en su nombre. El resultado está en forma de tabla y muestra la coordenada exacta de cada artefacto y el momento en que se implementó su última versión.

2. búsqueda de coordenadas

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

   Si hay varios resultados, obtendrá el mismo resultado de tabla que el anterior. Pero si solo hay un resultado, esto le dará de forma predeterminada un fragmento pom.xml para el artefacto que buscó. ¡Listo para copiar y pegar en tu IDE favorito!
   Si necesita un fragmento en un formato diferente, utilice -f <type> o --format=<type> . Los tipos admitidos son: maven , gradle , gradle-short , gradle-kotlin , sbt , ivy , grape , leiningen , buildr , jbang , gav .

3. Búsqueda de nombre de clase

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

   Esto le dará todos los artefactos en Maven Central que contienen una clase particular. Si configura el indicador -f , el término de búsqueda se considera un nombre de clase "completamente clasificado", por lo que incluye el nombre del paquete.

Banderas

• Todos los modos reconocen el modificador -l <number> , que le permite especificar cuántos resultados desea ver como máximo .
• En Búsqueda con comodines y Búsqueda de coordenadas , puede pasar el indicador -s (o --show-vulnerabilities ). Hará que MCS muestre un resumen de las vulnerabilidades de seguridad reportadas en cada resultado. Si solo hay un resultado de búsqueda, mostrará los números CVE reportados en ese resultado. Tenga en cuenta que esta característica probablemente pronto alcanzará los límites de API para el índice Sonatype OSS. Consulte su documentación para obtener detalles sobre cómo esto puede afectar su uso. Puede especificar sus credenciales utilizando las propiedades del sistema ossindex.username y ossindex.password . Consulte en "Configuración de MCS" cómo hacer esto de la manera más conveniente.

Instalación

Puede instalar mcs utilizando el administrador de paquetes de su elección:

Administrador de paquetes	Plataforma	Instalación	Observaciones
cerveza casera	? ?	brew install mthmulders/tap/mcs	️ 1
Quebrar	?	snap install maven-central-search
SDKMAN!	? ?	sdk install mcs
chocolateado	?	choco install mcs
Cuchara	?	scoop install mthmulders/mcs

1. Los binarios de Linux sólo funcionan en CPU x86_64. Hay archivos binarios de Apple para x86_64 y Apple Silicon, por lo que no necesitas Rosetta.

Uso con almacén de confianza personalizado

En determinadas situaciones, como cuando trabaja detrás de un firewall (corporativo) que intercepta TLS, MCS puede fallar con

Error al crear la ruta PKIX: sun.security.provider.certpath.SunCertPathBuilderException: no se puede encontrar una ruta de certificación válida para el destino solicitado

En términos sencillos: el almacén de confianza integrado predeterminado (el conjunto de certificados X.509 confiables) no contiene nada que permita confiar en los certificados presentados por el servidor. Maven Central utiliza un certificado en el que se habría confiado, pero el culpable aquí es el firewall (corporativo) que intercepta TLS y que presenta un certificado interno.

La solución es crear un almacén de confianza que tenga el certificado "más alto" en la cadena de certificados, por ejemplo, el de la autoridad certificadora (interna). Puede utilizar una herramienta como Portecle para crear un almacén de confianza. A continuación, apunte MCS a ese almacén de confianza así

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

Uso detrás de un proxy

Si está ejecutando detrás de un proxy, MCS respetará las variables de entorno HTTP_PROXY y HTTPS_PROXY .

Configurar MCS

Parte de la configuración de MCS se pasa a través de las propiedades del sistema. Puede hacer esto cada vez que invoque MCS agregando -Dxxx=yyy . Para hacerlo más conveniente, puede crear un archivo de configuración que MCS leerá automáticamente e interpretará como ajustes de configuración.

Para hacerlo, cree un directorio .mcs en su directorio de usuarios (normalmente C:Users<your-user-name> en ?, /home/ en ? o /Users/ en ?). Dentro de esa carpeta, crea un archivo mcs.config y escribe la siguiente línea en él:

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

De esta manera, no es necesario que recuerdes haber pasado el -D .

Contribuyendo

Probablemente la forma más sencilla de conseguir un entorno de desarrollo que funcione es utilizar Gitpod:

Configurará un espacio de trabajo en su navegador y mostrará que todo funciona como se esperaba ejecutando mvn verify . Esta configuración no afecta a su computadora; tan pronto como cierra la pestaña de su navegador, desaparece.

Consulte los problemas si está buscando algo en lo que trabajar. Si tiene una idea nueva, no dude en mencionarla utilizando las discusiones.

Expresiones de gratitud

MCS no habría sido posible sin las contribuciones de personas maravillosas de todo el mundo. La lista completa está en CONTRIBUTORS.md.