cpanmp - Интернет в облаке

ПРОГРАММА:

ИМЯ

cpanm - получить, распаковать сборку и установить модули из CPAN

СИНТАКСИС

cpanm Test :: More # install Test :: More
cpanm MIYAGAWA / Plack-0.99_05.tar.gz # полный путь распространения
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # установка с URL
cpanm ~ / dists / MyCompany-Enterprise-1.00.tar.gz # установить из локального файла
cpanm --interactive Task :: Kensho # Настроить в интерактивном режиме
cpanm. # установить из локального каталога
cpanm --installdeps. # устанавливаем все депы для текущего каталога
cpanm -L extlib Plack # установить Plack и все неосновные deps в extlib
cpanm --зеркало http://cpan.cpantesters.org/ DBI # использовать зеркало быстрой синхронизации
cpanm --from https://cpan.metacpan.org/ Plack # использовать только зеркало HTTPS

КОМАНДЫ

(аргументы)
Аргументами командной строки могут быть имя модуля, файл дистрибутива, локальный файл.
путь, URL-адрес HTTP или URL-адрес репозитория git. Следующие команды будут работать так, как вы ожидаете.

cpanm Плак
cpanm Plack / Request.pm
cpanm MIYAGAWA / Plack-1.0000.tar.gz
cpanm /путь/к/Plack-1.0000.tar.gz
cpanm http://cpan.metacpan.org/authors/id/M/MI/MIYAGAWA/Plack-0.9990.tar.gz
cpanm git: //github.com/plack/Plack.git

Кроме того, вы можете использовать обозначение с использованием "~" и "@", чтобы указать версию для
данный модуль. "~" указывает требования к версии в формате CPAN :: Meta :: Spec,
в то время как "@" закрепляет точную версию и является ярлыком для "~" == VERSION "".

cpanm Plack ~ 1.0000 # 1.0000 или новее
cpanm Plack ~ "> = 1.0000, <2.0000" # последняя из 1.xxxx
cpanm [электронная почта защищена] # конкретная версия. то же, что и Plack ~ "== 0.9990"

Запрос версии, включая конкретную версию или диапазон, будет отправлен в MetaCPAN на
поиск предыдущих выпусков. По умолчанию запрос будет искать архивы BackPAN,
если вы не укажете параметр "--dev", в этом случае архивные версии будут отфильтрованы
из.

Для репозитория git вы можете указать ветку, тег или фиксацию SHA для сборки. В
по умолчанию "master"

cpanm git: //github.com/plack/[электронная почта защищена] # ярлык
cpanm git: //github.com/plack/Plack.git@devel # ветка

-я, --установить
Устанавливает модули. Это поведение по умолчанию, и это просто совместимость.
возможность заставить его работать как cpan или cpanp.

- самообновление
Самовосстанавливается. Это просто псевдоним для:

Приложение cpanm :: cpanminus

--Информация
Отображает информацию о распространении в формате "AUTHOR / Dist-Name-ver.tar.gz" в
стандартный выход.

--installdeps
Устанавливает зависимости целевого дистрибутива, но не собирается. Удобно, если
вы хотите попробовать приложение из репозитория с контролируемой версией, такого как git.

cpanm --installdeps.

--Смотреть
Загрузите и распакуйте дистрибутив, а затем откройте каталог с вашей оболочкой.
Удобно копаться в исходном коде или проводить ручное тестирование.

-х, --помощь
Отображает справочное сообщение.

-V, --версия
Отображает номер версии.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Вы можете указать параметры по умолчанию в переменной среды «PERL_CPANM_OPT».

-ф, --сила
Принудительно устанавливайте модули, даже если тестирование завершилось неудачно.

-н, --примечание
Пропустить тестирование модулей. Используйте это только тогда, когда вы просто хотите сэкономить время на
установка сотен дистрибутивов на тот же Perl и ту же архитектуру, что вы уже
протестирован, чтобы убедиться, что он работает нормально.

По умолчанию false, и вы можете сказать "--no-notest", чтобы переопределить, если он установлен в
параметры по умолчанию в "PERL_CPANM_OPT".

- только для тестирования
Запускайте только тесты и не устанавливайте указанный модуль или дистрибутивы. Удобно, если
вы хотите убедиться, что новые (или даже старые) выпуски проходят модульные тесты без
установка модуля.

Обратите внимание: если вы укажете эту опцию с модулем или дистрибутивом,
зависимости, эти зависимости будут установлены, если у вас их в настоящее время нет.

-С, --судо
При установке модулей переключитесь на пользователя root с помощью «sudo». Используйте это, если хотите
установить модули в систему perl include path.

По умолчанию false, и вы можете сказать "--no-sudo", чтобы переопределить, если он установлен в
параметры по умолчанию в "PERL_CPANM_OPT".

-v, --подробный
Делает вывод подробным. Это также позволяет интерактивную настройку. (Видеть
- интерактивный)

-к, --тишина
Делает вывод даже тише, чем по умолчанию. Он показывает только успешные / неудачные
зависимости от вывода.

-l, --local-библиотека
Задает путь, совместимый с local :: lib, для установки модулей. Вам не нужно устанавливать это
если вы уже настроили переменные среды оболочки с помощью local :: lib, но это
также можно использовать для отмены этого.

-L, --local-lib-contain
То же самое с "--local-lib", но с --самостоятельным набором. Все неосновные зависимости будут
быть установленным, даже если они уже установлены.

Например,

cpanm -L extlib Распаковать

установит Plack и все его неосновные зависимости в каталог "extlib",
который можно загрузить из вашего приложения с помощью:

используйте local :: lib '/ path / to / extlib';

Обратите внимание, что этот параметр НЕ надежно работать с установками Perl, поставляемыми
поставщики операционных систем, которые удаляют стандартные модули из Perl, такие как RHEL, Fedora
и CentOS, если вы также устанавливаете пакеты, содержащие все модули, которые были
раздели. Для этих систем вы, вероятно, захотите установить мета-файл "perl-core".
пакет, который делает именно это.

- автономный
При изучении зависимостей предположите, что на компьютере не установлены неосновные модули.
система. Удобно, если вы хотите объединить зависимости приложений в один каталог, чтобы
могу раздать на другие машины.

--exclude-поставщик
Не включайте модули, установленные по пути поставщика, при поиске ядра
модули, когда активен флаг "--self-containment". Это восстанавливает поведение
из более ранней версии 1.7023

--зеркало
Задает базовый URL-адрес для использования зеркала CPAN, например
"http://cpan.cpantesters.org/"(можно опустить косую черту в конце). Вы можете указать
несколько зеркальных URL-адресов, повторяя параметр командной строки.

Вы можете использовать локальный каталог с зеркальной структурой CPAN (созданный такими инструментами, как
как OrePAN или Pinto), используя специальную схему URL "file: //". Если данный URL начинается
с `/` (без какой-либо схемы) это также рассматривается как файловая схема.

cpanm --mirror file: /// путь / к / зеркалу
cpanm --зеркало ~ / minicpan # Поскольку оболочка расширяет ~ до / home / user

По умолчанию "http://www.cpan.org/".

- только зеркало
Загрузите индексный файл зеркала 02packages.details.txt.gz вместо того, чтобы запрашивать
CPAN Meta DB. Это также эффективно откажется от отправки ваших локальных версий Perl на
серверы внутренних баз данных, такие как CPAN Meta DB и MetaCPAN.

Выберите этот вариант, если вы используете локальное зеркало CPAN, например minicpan, когда
вы не в сети, или ваш собственный индекс CPAN (он же darkpan).

--из, -M
cpanm -M https://cpan.metacpan.org/
cpanm - с https://cpan.metacpan.org/

Используйте указанный URL-адрес зеркала и его индекс в качестве только источник для поиска и скачивания
модули из.

Он работает аналогично комбинированным командам "--mirror" и "--mirror-only" с небольшой разницей:
в отличие от "--mirror", которое добавляет URL-адрес списка зеркал, "--from" (или "-M" для
коротко) использует указанный URL как свой только источник для загрузки индекса и модулей.
Это заставляет параметр всегда переопределять зеркало по умолчанию, которое могло быть установлено
через глобальные параметры, например, установленную переменной среды "PERL_CPANM_OPT".

Наконечник: Может быть полезно называть эти параметры псевдонимами оболочки, например:

псевдоним minicpanm = 'cpanm --from ~ / minicpan'
псевдоним darkpan = 'cpanm --from http://mycompany.example.com/DPAN'

--зеркальный индекс
ЭКСПЕРИМЕНТАЛЬНАЯ: Указывает путь к файлу "02packages.details.txt" для поиска модуля.
индекса.

--cpanmetadb
ЭКСПЕРИМЕНТАЛЬНАЯ: Задает альтернативный URI для поиска индекса CPAN MetaDB.

--метакпан
Предпочитает MetaCPAN API над CPAN MetaDB.

--cpanfile
ЭКСПЕРИМЕНТАЛЬНАЯ: Указан альтернативный путь для поиска cpanfile, когда
Команда "--installdeps" уже используется. По умолчанию "cpanfile".

--незамедлительный
Запрашивает, когда тест не проходит, чтобы вы могли пропустить, принудительно установить, повторить попытку или посмотреть в
оболочки, чтобы увидеть, что не так. Он также запрашивает, когда одна из зависимостей терпит неудачу, если
вы хотите продолжить установку.

По умолчанию false, и вы можете сказать "--no-prompt", чтобы переопределить, если он установлен в
параметры по умолчанию в "PERL_CPANM_OPT".

--dev
ЭКСПЕРИМЕНТАЛЬНАЯ: также найдите более новую версию для разработчиков. По умолчанию - false.

--переустановить
cpanm, когда ему задано имя модуля в командной строке (например, "cpanm Plack"), проверяет
сначала локально установленная версия и пропускает, если она уже установлена. Этот вариант
заставляет его пропустить проверку, поэтому:

cpanm --переустановить Плак

переустановит Plack, даже если ваша локально установленная версия является последней или даже более новой.
(что произойдет, если вы установите выпуск разработчика из системы контроля версий
репозитории).

По умолчанию false.

- интерактивный
Делает конфигурацию (например, "Makefile.PL" и "Build.PL") интерактивной, чтобы вы могли
ответить на вопросы в дистрибутиве, требующем нестандартной конфигурации или Task ::
Распределения.

По умолчанию false, и вы можете сказать "--no-interactive", чтобы переопределить, если он установлен в
параметры по умолчанию в "PERL_CPANM_OPT".

--pp, --чистый перл
Предпочитайте сборку модулей на чистом perl, установив "PUREPERL_ONLY = 1" для MakeMaker и
"--pureperl-only" для дистрибутивов на основе Build.PL. Обратите внимание, что не все CPAN
модули пока поддерживают это соглашение.

--with-рекомендует, --with-предлагает
ЭКСПЕРИМЕНТАЛЬНАЯ: Устанавливает зависимости, указанные как «рекомендует» и «предлагает».
соответственно, согласно спецификации META. Когда эти зависимости не устанавливаются, cpanm продолжает работать.
установка, так как они просто рекомендации / предложения.

Включение этого потенциально может создать циклическую зависимость для нескольких модулей от CPAN,
когда "рекомендует" добавляет модуль, который "рекомендует" вернуть модуль взамен.

Также есть "--without-Recommended" и "--without-sizes", чтобы переопределить значение по умолчанию.
решение, принятое ранее в «PERL_CPANM_OPT».

По умолчанию для обоих установлено значение false.

--с-развитием
ЭКСПЕРИМЕНТАЛЬНАЯ: Устанавливает зависимости фазы разработки в файлах META или "cpanfile", когда
используется с "--installdeps". По умолчанию false.

--с функцией, --без функции, --со всеми функциями
ЭКСПЕРИМЕНТАЛЬНАЯ: Задает функцию, которую нужно включить, если модуль поддерживает дополнительные функции.
согласно спецификации META 2.0.

cpanm --with-feature = opt_csv Таблица :: Читать

функции также могут быть выбраны интерактивно, когда включена опция «--interactive».

"--with-all-features" включает все дополнительные функции, а "--without-feature" может
выберите функцию, которую нужно отключить.

--configure-timeout, --build-timeout, --test-timeout
Укажите время ожидания (в секундах) для ожидания настройки, сборки и тестирования
процесс. Текущие значения по умолчанию: 60 для конфигурации, 3600 для сборки и 1800 для
тест.

--configure-args, --build-args, --test-args, --install-args
ЭКСПЕРИМЕНТАЛЬНАЯ: Передать аргументы для команд configure / build / test / install соответственно,
для данного модуля для установки.

cpanm DBD :: mysql --configure-args = "- cflags = ... --libs = ..."

Аргумент доступен только для модуля, переданного в качестве аргумента командной строки, но не для
зависимости.

- скандепс
DEPRECATED: Сканирует зависимости данных модулей и выводит дерево в виде текста.
формат. (Дополнительные параметры см. Ниже "--format")

Поскольку эта команда на самом деле не устанавливает никаких дистрибутивов, она будет полезна
это, набрав:

cpanm --scandeps Catalyst :: время выполнения

вы можете убедиться, какие модули будут установлены.

Эта команда учитывает, какие модули вы уже установили в своем
система. Если вы хотите увидеть, какие модули будут установлены против ванильного Perl
установка, вы можете комбинировать ее с опцией "-L".

--формат
DEPRECATED: Определяет, в каком формате отображать просканированное дерево зависимостей. Доступный
варианты: tree, json, yaml и dists.

tree Отображает дерево в текстовом формате. Это значение по умолчанию.

json, ямл
Выводит дерево в формате JSON или YAML. Модули JSON и YAML должны быть
установлен соответственно. Выходное дерево представлено в виде рекурсивного кортежа
о:

[распределение, зависимости]

а контейнер - это массив, содержащий корневые элементы. Обратите внимание, что там
может быть несколько корневых узлов, так как вы можете передать несколько модулей
Команда "--scandeps".

dists "dists" - это специальный формат вывода, в котором печатается имя файла дистрибутива.
в глубина первый заказ после разрешения зависимости, например:

GAAS / MIME-Base64-3.13.tar.gz
GAAS / URI-1.58.tar.gz
PETDANCE / HTML-Tagset-3.20.tar.gz
GAAS / HTML-Parser-3.68.tar.gz
GAAS / libwww-perl-5.837.tar.gz

это означает, что вы можете установить эти дистрибутивы в указанном порядке без дополнительных
зависимости. В сочетании с опцией "-L" будет полезно воспроизвести
установки на другие машины.

--save-dists
Задает необязательный путь к каталогу для копирования загруженных архивов в зеркало CPAN.
совместимая структура каталогов, т.е. авторы / id / A / AU / AUTHORS / Foo-Bar-version.tar.gz

Если архив дистрибутива пришел не из CPAN, например из локального файла или из
GitHub, тогда он будет сохранен в vendor / Foo-Bar-version.tar.gz.

--uninst-тени
Удаляет теневые файлы устанавливаемого вами дистрибутива. Этот
устраняет путаницу, если вы пытаетесь установить основные (двойные) модули из
CPAN против Perl 5.10 или более ранней версии, или модулей, которые раньше были основаны на XS, но перешли на
чистый perl у какой-то версии.

Если вы запускаете cpanm от имени пользователя root и используете "INSTALL_BASE" или эквивалент, чтобы указать настраиваемый
путь установки, вам СЛЕДУЕТ отключить эту опцию, чтобы случайно не удалить
модули dual-life из ядра включают путь.

По умолчанию true, если ваша версия perl меньше 5.12, и вы можете отключить это.
с "--no-uninst-shadows".

ЗАМЕТКА: Начиная с версии 1.3000 этот флаг отключен по умолчанию для perl новее, чем
5.12, поскольку с 5.12 @INC содержит каталог site_perl до основная библиотека Perl
путь, и удаление теней больше не требуется и наносит больший вред, удаляя
файлы из пути к основной библиотеке.

--удалить, -U
Удаляет модуль из пути к библиотеке. Он находит список пакетов для заданных модулей и
удаляет все файлы, входящие в один дистрибутив.

Если вы включите local :: lib, он удалит файлы только из каталога local :: lib.

Если вы попытаетесь удалить модуль в каталоге "perl" (т.е. основной модуль), появится ошибка
быть брошенным.

Появится диалоговое окно с запросом на подтверждение удаления файлов. Если вы передадите опцию "-f"
кроме того, диалоговое окно будет пропущено, и удаление будет выполнено принудительно.

--каскадный поиск
ЭКСПЕРИМЕНТАЛЬНАЯ: Указывает, следует ли выполнять каскадный поиск при указании нескольких зеркал.
и зеркало не имеет модуля или имеет более низкую версию модуля, чем
просил. По умолчанию false.

- пропустить-установлен
Указывает, будет ли пропущен модуль, указанный в командной строке, если его последняя версия
уже установлено. По умолчанию true.

ЗАМЕТКА: Переменная среды "PERL5LIB" должна быть правильно установлена, чтобы это работало.
с модулями, установленными с использованием local :: lib, если вы не всегда используете параметр "-l".

- пропустить-доволен
ЭКСПЕРИМЕНТАЛЬНАЯ: Указывает, является ли модуль (и версия), указанный в командной строке,
пропускается, если он уже установлен.

Если вы запустите:

cpanm - пропустить CGI DBI ~ 1.2

cpanm не установит их, если у вас уже есть CGI (для любых версий) или DBI
с версией выше 1.2. Это похоже на "--skip-installed", но пока
"--skip-installed" проверяет, последний установлена ​​версия CPAN,
"--skip-выполнено" проверяет, является ли запрошенная версия (или нет, что означает любую версию)
установлен.

По умолчанию false.

--проверять
Проверьте целостность файлов распространения, полученных из PAUSE, с помощью CHECKSUMS и
ПОДПИСИ (если есть). По умолчанию false.

--report-perl-версия
Сообщает ли он о локально установленной версии Perl на различные веб-серверы как
часть User-Agent. По умолчанию true, если переменные среды, связанные с CI, такие как
«TRAVIS», «CI» или «AUTOMATED_TESTING» включены. Вы можете отключить его, используя
"--no-report-perl-version".

--автоматическая очистка
Задает количество дней, в течение которых срок действия рабочих каталогов cpanm истекает. По умолчанию 7,
Это означает, что старые рабочие каталоги будут очищены за одну неделю.

Вы можете установить значение 0, чтобы cpan никогда не очищал эти каталоги.

- man-страницы
Создает справочные страницы для исполняемых файлов (man1) и библиотек (man3).

По умолчанию установлено значение true (сгенерированные страницы руководства), если не задана опция "-L | --local-lib-contain".
предоставляется, и в этом случае устанавливается значение false. Вы можете отключить его с помощью "--no-man-pages".

--lwp
Использует модуль LWP для загрузки материалов через HTTP. По умолчанию true, и вы можете сказать
"--no-lwp", чтобы отключить использование LWP, когда вы хотите обновить LWP с CPAN на некоторых сломанных
Perl-системы.

--wget
Использует GNU Wget (если доступно) для загрузки материалов. По умолчанию true, и вы можете сказать
"--no-wget", чтобы отключить использование Wget (версии Wget старше 1.9 не поддерживают
Параметр "--retry-connrefused", используемый cpanm).

--завиток
Использует cURL (если доступен) для загрузки материалов. По умолчанию true, и вы можете сказать
"--no-curl", чтобы отключить использование cURL.

Обычно, когда для параметров "--lwp", "--wget" и "--curl" установлено значение true (что является
по умолчанию) cpanm пробует LWP, Wget, cURL и HTTP :: Tiny (в этом порядке) и использует первый
один доступен.

Используйте cpanmp онлайн с помощью сервисов onworks.net