mcs

Pesquisa Central Maven

Use o Maven Central Repository Search na sua linha de comando!

Use mcs para pesquisar rapidamente coordenadas de dependência no Maven Central, sem precisar mudar para o navegador.

Uso

Esta ferramenta oferece suporte aos seguintes modos de pesquisa:

1. Pesquisa curinga

    mcs search plexus-utils

   Isso lhe dará todos os artefatos no Maven Central que possuem "plexus-utils" em seu nome. A saída está em formato tabular, mostrando a coordenada exata de cada artefato e o momento em que sua versão mais recente foi implantada.

2. Coordenar pesquisa

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

   Se houver vários acessos, você obterá a mesma saída da tabela acima. Mas se houver apenas uma ocorrência, isso fornecerá, por padrão, um snippet pom.xml para o artefato que você pesquisou. Pronto para copiar e colar no seu IDE favorito!
   Se você precisar de um snippet em formato diferente, use -f <type> ou --format=<type> . Os tipos suportados são: maven , gradle , gradle-short , gradle-kotlin , sbt , ivy , grape , leiningen , buildr , jbang , gav .

3. Pesquisa por nome de classe

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

   Isso fornecerá todos os artefatos do Maven Central que contêm uma classe específica. Se você definir o sinalizador -f , o termo de pesquisa será considerado um nome de classe "totalmente classificado", incluindo o nome do pacote.

Bandeiras

• Todos os modos reconhecem a opção -l <number> , que permite especificar quantos resultados você deseja ver no máximo .
• Na pesquisa curinga e na pesquisa coordenada , você pode passar o sinalizador -s (ou --show-vulnerabilities ). Isso fará com que o MCS mostre um resumo das vulnerabilidades de segurança relatadas em cada resultado. Se houver apenas um resultado de pesquisa, serão exibidos os números CVE relatados nesse resultado. Observe que esse recurso provavelmente atingirá em breve os limites da API para o índice Sonatype OSS. Consulte a documentação para obter detalhes sobre como isso pode afetar seu uso. Você pode especificar suas credenciais usando as propriedades do sistema ossindex.username e ossindex.password . Veja em “Configurando o MCS” como fazer isso da maneira mais conveniente.

Instalação

Você pode instalar o mcs usando o gerenciador de pacotes de sua preferência:

Gerenciador de pacotes	Plataforma	Instalação	Observações
Cerveja caseira	? ?	brew install mthmulders/tap/mcs	️ 1
Foto	?	snap install maven-central-search
SDKMAN!	? ?	sdk install mcs
Chocolate	?	choco install mcs
Colher	?	scoop install mthmulders/mcs

1. Os binários do Linux funcionam apenas em CPUs x86_64. Existem binários da Apple para x86_64 e Apple Silicon, então você não precisa do Rosetta.

Uso com armazenamento confiável personalizado

Em certas situações, como quando você trabalha atrás de um firewall (corporativo) de interceptação de TLS, o MCS pode falhar com

Falha na criação do caminho PKIX: sun.security.provider.certpath.SunCertPathBuilderException: não foi possível encontrar o caminho de certificação válido para o destino solicitado

Em termos gerais: o armazenamento confiável integrado padrão (o conjunto de certificados X.509 confiáveis) não contém nada que permita confiar no(s) certificado(s) apresentado(s) pelo servidor. O Maven Central usa um certificado que seria confiável, mas o culpado aqui é o firewall (corporativo) de interceptação de TLS que apresenta um certificado interno.

A solução é criar um armazenamento confiável que possua o certificado "mais alto" na cadeia de certificados, por exemplo, o da autoridade de certificação (interna). Você pode usar uma ferramenta como o Portecle para criar esse armazenamento confiável. Em seguida, aponte o MCS para esse armazenamento confiável assim

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

Uso por trás de um proxy

Se você estiver executando atrás de um proxy, o MCS respeitará as variáveis ​​de ambiente HTTP_PROXY e HTTPS_PROXY .

Configurando MCS

Algumas configurações do MCS são passadas pelas propriedades do sistema. Você pode fazer isso sempre que invocar o MCS adicionando -Dxxx=yyy . Para tornar isso mais conveniente, você pode criar um arquivo de configuração que será lido automaticamente pelo MCS e interpretado como definições de configuração.

Para fazer isso, crie um diretório .mcs em seu diretório de usuário (normalmente C:Users<seu-nome-de-usuário> em ?, /home/ em ? ou /Users/ em ?). Dentro dessa pasta, crie um arquivo mcs.config e escreva a seguinte linha nele:

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

Dessa forma, você não precisa se lembrar de passar o -D .

Contribuindo

Provavelmente a maneira mais fácil de obter um ambiente de desenvolvimento funcional é usar o Gitpod:

Ele configurará um espaço de trabalho no seu navegador e mostrará que tudo funciona conforme o esperado executando mvn verify . Esta configuração não afeta o seu computador - assim que você fecha a guia do navegador, ela desaparece.

Confira os problemas se estiver procurando algo em que trabalhar. Se você tiver uma ideia nova, sinta-se à vontade para trazê-la à tona usando as discussões.

Agradecimentos

A MCS não teria sido possível sem as contribuições de pessoas maravilhosas ao redor do mundo. A lista completa está em CONTRIBUTORS.md.