mcs

Центральный поиск Maven

Используйте поиск в центральном репозитории Maven из командной строки!

Используйте mcs для быстрого поиска координат зависимостей в Maven Central без необходимости переключения в браузер.

Использование

Этот инструмент поддерживает следующие режимы поиска:

1. Поиск по подстановочным знакам

    mcs search plexus-utils

   Это даст вам все артефакты в Maven Central, в названии которых есть «plexus-utils». Выходные данные имеют табличную форму, показывающую точную координату каждого артефакта и момент развертывания его последней версии.

2. Координатный поиск

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

   Если попаданий несколько, вы получите тот же вывод таблицы, что и выше. Но если совпадение только одно, по умолчанию вы получите фрагмент pom.xml для артефакта, который вы искали. Готово для копирования и вставки в вашу любимую IDE!
   Если вам нужен фрагмент в другом формате, используйте -f <type> или --format=<type> . Поддерживаемые типы: maven , gradle , gradle-short , gradle-kotlin , sbt , ivy , grape , leiningen , buildr , jbang , gav .

3. Поиск по имени класса

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

   Это даст вам все артефакты в Maven Central, содержащие определенный класс. Если вы установите флаг -f , поисковый запрос считается «полностью классифицированным» именем класса, включая имя пакета.

Флаги

• Все режимы распознают ключ -l <number> , который позволяет указать максимальное количество результатов, которые вы хотите видеть.
• При поиске по подстановочным знакам и поиске по координатам вы можете передать флаг -s (или --show-vulnerabilities ). Это приведет к тому, что MCS покажет сводку обнаруженных уязвимостей безопасности для каждого результата. Если есть только один результат поиска, он отобразит номера CVE, указанные для этого результата. Обратите внимание , что эта функция, вероятно, скоро достигнет ограничений API для индекса Sonatype OSS. Подробную информацию о том, как это может повлиять на ваше использование, см. в их документации. Вы можете указать свои учетные данные, используя системные свойства ossindex.username и ossindex.password . О том, как это сделать наиболее удобным способом, читайте в разделе «Настройка MCS».

Установка

Вы можете установить mcs, используя любой менеджер пакетов:

Менеджер пакетов	Платформа	Установка	Примечания
Домашнее пиво	? ?	brew install mthmulders/tap/mcs	️ 1
Щелчок	?	snap install maven-central-search
СДКМАН!	? ?	sdk install mcs
Шоколадный	?	choco install mcs
Совок	?	scoop install mthmulders/mcs

1. Бинарные файлы Linux работают только на процессорах x86_64. Существуют двоичные файлы Apple как для x86_64, так и для Apple Silicon, поэтому Rosetta вам не нужна.

Использование с собственным хранилищем доверенных сертификатов

В определенных ситуациях, например, когда вы работаете за перехватывающим TLS (корпоративным) брандмауэром, MCS может выйти из строя с

Не удалось построить путь PKIX: sun.security.provider.certpath.SunCertPathBuilderException: невозможно найти действительный путь сертификации к запрошенной цели

Говоря простым языком: встроенное хранилище доверенных сертификатов по умолчанию (набор доверенных сертификатов X.509) не содержит ничего, что позволяло бы доверять сертификатам, представленным сервером. Maven Central использует сертификат, которому можно было бы доверять, но виновником здесь является перехватывающий TLS (корпоративный) брандмауэр, который представляет внутренний сертификат.

Решение состоит в том, чтобы создать хранилище доверенных сертификатов, имеющее сертификат «самого высокого» уровня в цепочке сертификатов, например сертификат (внутреннего) центра сертификации. Вы можете использовать такой инструмент, как Portecle, для создания такого хранилища доверенных сертификатов. Затем укажите MCS на это хранилище доверенных сертификатов следующим образом.

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

Использование за прокси

Если вы используете прокси-сервер, MCS будет учитывать переменные среды HTTP_PROXY и HTTPS_PROXY .

Настройка MCS

Некоторая конфигурация MCS передается через свойства системы. Вы можете делать это каждый раз при вызове MCS, добавляя -Dxxx=yyy . Для удобства вы можете создать файл конфигурации, который будет автоматически читаться MCS и интерпретироваться как параметры конфигурации.

Для этого создайте каталог .mcs в своем пользовательском каталоге (обычно C:Users<ваше-имя-пользователя> на ?, /home/ на ? или /Users/ на ?). Внутри этой папки создайте файл mcs.config и напишите в нем следующую строку:

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

Таким образом, вам не нужно помнить о передаче -D .

Содействие

Вероятно, самый простой способ получить работающую среду разработки — использовать Gitpod:

Он настроит рабочую область в вашем браузере и покажет, что все работает как положено, запустив mvn verify . Эта настройка не затрагивает ваш компьютер — как только вы закроете вкладку браузера, она исчезнет.

Ознакомьтесь с выпусками, если ищете, над чем поработать. Если у вас есть новая идея, не стесняйтесь обсуждать ее в обсуждениях.

Благодарности

MCS не была бы возможна без вклада замечательных людей со всего мира. Полный список находится на сайте CONTRIBUTORS.md.