cpanmp - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

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

СИНТАКСИС

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

КОМАНДИ

(аргументи)
Аргументами командного рядка можуть бути ім’я модуля, файл розповсюдження, локальний файл
path, URL-адреса HTTP або URL-адреса репозиторію git. Усі наступні команди працюватимуть так, як ви очікуєте.

cpanm Плак
cpanm Plack/Request.pm
cpanm MIYAGAWA/Plack-1.0000.tar.gz
cpanm /шлях/до/Plack-1.0000.tar.gz
пробій http://cpan.metacpan.org/authors/id/M/MI/MIYAGAWA/Plack-0.9990.tar.gz
cpanm git://github.com/plack/Plack.git

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

cpanm Plack~1.0000 # 1.0000 або новішої
cpanm Plack~">= 1.0000, < 2.0000" # останній з 1.xxxx
пробій [захищено електронною поштою] # конкретна версія. те саме, що Plack~"== 0.9990"

Запит версії, включаючи конкретну версію або діапазон, буде надіслано до MetaCPAN на адресу
пошук попередніх випусків. Запит шукатиме архіви BackPAN за замовчуванням,
якщо ви не вкажете параметр «--dev», у цьому випадку заархівовані версії будуть відфільтровані
поза.

Для сховища git ви можете вказати гілку, тег або фіксувати SHA для створення. The
за замовчуванням "головний"

cpanm git://github.com/plack/[захищено електронною поштою] # тег
cpanm git://github.com/plack/Plack.git@devel # гілка

-i, --встановити
Встановлює модулі. Це поведінка за замовчуванням, і це лише сумісність
можливість зробити так, щоб він працював як cpan або cpanp.

--самостійне оновлення
Самостійно оновлює. Це просто псевдонім для:

Програма cpanm::cpanminus

--інформація
Відображає інформацію про розповсюдження у форматі "AUTHOR/Dist-Name-ver.tar.gz" у форматі
стандартний вихід.

--installdeps
Встановлює залежності цільового дистрибутива, але не створює сам. Зручно, якщо
ви хочете спробувати програму зі сховища, що контролюється версіями, наприклад git.

cpanm --installdeps.

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

-h, --допомога
Відображає довідкове повідомлення.

-V, --версія
Відображає номер версії.

ВАРІАНТИ

Ви можете вказати параметри за замовчуванням у змінній середовища "PERL_CPANM_OPT".

-f, --сила
Примусово встановлювати модулі, навіть якщо тестування не вдалося.

-n, --примітка
Пропустіть тестування модулів. Використовуйте це лише тоді, коли ви просто хочете заощадити час
встановлення сотень дистрибутивів на тій самій perl та архітектурі, які ви вже використовували
перевірено, щоб переконатися, що він добре збирається.

За замовчуванням значення false, і ви можете сказати "--no-notest", щоб замінити, коли це встановлено в
параметри за замовчуванням у "PERL_CPANM_OPT".

--лише для тестування
Виконуйте лише тести та не встановлюйте вказаний модуль чи дистрибутиви. Зручно, якщо
ви хочете переконатися, що нові (або навіть старі) випуски пройшли його модульні тести
встановлення модуля.

Зауважте, що якщо ви вкажете цю опцію з модулем або дистрибутивом, який має
залежностей, ці залежності будуть встановлені, якщо у вас їх зараз немає.

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

За замовчуванням значення false, і ви можете сказати "--no-sudo", щоб замінити, коли це встановлено в
параметри за замовчуванням у "PERL_CPANM_OPT".

-v, -- багатослівний
Робить висновок багатослівним. Це також дозволяє інтерактивну конфігурацію. (Побачити
--інтерактивний)

-q, -- тихо
Робить вихід навіть тихішим, ніж за замовчуванням. Він показує лише успішне/нездатне
залежності від виводу.

-l, --local-lib
Встановлює локальний::lib сумісний шлях для встановлення модулів. Вам не потрібно це встановлювати
якщо ви вже налаштували змінні середовища оболонки за допомогою local::lib, але це
також можна використовувати, щоб замінити це.

-L, --local-lib-contained
Те саме з "--local-lib", але з --самостійним набором. Усі неосновні залежності будуть
бути встановленими, навіть якщо вони вже встановлені.

Так, наприклад,

cpanm -L extlib Plack

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

використовувати local::lib '/path/to/extlib';

Зауважте, що ця опція діє НЕ надійно працювати з інсталяціями perl, що надаються
постачальники операційних систем, які видаляють стандартні модулі з perl, наприклад RHEL, Fedora
і CentOS, ХІБ Ви також встановлюєте пакунки, що постачають усі модулі, які були
роздягти. Для цих систем вам, напевно, захочеться встановити "perl-core" мета-
пакет, який робить саме це.

-- автономний
При перевірці залежностей припустимо, що не встановлені неосновні модулі
системи. Зручно, якщо ви хочете об’єднати залежності програми в один каталог
можна розповсюджувати на інші машини.

--exclude-vendor
Не включайте модулі, встановлені під шляхами постачальника, під час пошуку ядра
модулів, коли діє прапор «--самодостатній». Це відновлює поведінку
від до версії 1.7023

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

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

cpanm --дзеркальний файл:///шлях/до/дзеркала
cpanm --дзеркало ~/minicpan # Тому що оболонка розгортається ~ до /home/user

За замовчуванням "http://www.cpan.org/".

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

Виберіть цей параметр, якщо ви використовуєте локальне дзеркало CPAN, наприклад minicpan when
ви в автономному режимі або ваш власний індекс CPAN (він же darkpan).

--від, -М
cpanm -M https://cpan.metacpan.org/
cpanm --з https://cpan.metacpan.org/

Використовуйте вказану URL-адресу дзеркала та його індекс як тільки джерело для пошуку та завантаження
модулі від.

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

Порада: Може бути корисно, якщо ви називаєте ці параметри своїми псевдонімами оболонки, наприклад:

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

--дзеркало-індекс
ЕКСПЕРИМЕНТАЛЬНА: Вказує шлях до файлу «02packages.details.txt» для пошуку модуля
index.

--cpanmetadb
ЕКСПЕРИМЕНТАЛЬНА: Визначає альтернативний URI для пошуку в індексі CPAN MetaDB.

--metacpan
Віддає перевагу API MetaCPAN перед CPAN MetaDB.

--cpanfile
ЕКСПЕРИМЕНТАЛЬНА: вказано альтернативний шлях для cpanfile для пошуку, коли
Використовується команда «--installdeps». За замовчуванням «cpanfile».

--підказка
Підказує, коли тест не завершується, щоб ви могли пропустити, примусово встановити, спробувати ще раз або переглянути файл
shell, щоб побачити, що йде не так. Він також підказує, коли одна із залежностей вийшла з ладу, якщо
ви хочете продовжити встановлення.

За замовчуванням значення false, і ви можете сказати "--no-prompt", щоб замінити, якщо це встановлено в
параметри за замовчуванням у "PERL_CPANM_OPT".

--dev
ЕКСПЕРИМЕНТАЛЬНА: також пошук новішої версії розробника. За замовчуванням false.

--перевстановіть
cpanm, коли в командному рядку вказано ім'я модуля (тобто "cpanm Plack"), перевіряє
спочатку локально встановлену версію і пропускає, якщо вона вже встановлена. Цей варіант
змушує його пропускати перевірку, тому:

cpanm --перевстановіть Plack

перевстановить Plack, навіть якщо ваша локально встановлена ​​версія є останньою або навіть новішою
(що станеться, якщо ви встановите випуск розробника з контролю версій
сховища).

За замовчуванням false.

--інтерактивні
Робить конфігурацію (наприклад, "Makefile.PL" і "Build.PL") інтерактивною, щоб ви могли
відповісти на запитання в дистрибутиві, який потребує спеціальної конфігурації або Завдання::
розподілу.

За замовчуванням значення false, і ви можете сказати "--no-interactive", щоб замінити, коли це встановлено в
параметри за замовчуванням у "PERL_CPANM_OPT".

--pp, --pureperl
Віддавайте перевагу збірці модулів Pure perl, встановивши "PUREPERL_ONLY=1" для MakeMaker і
"--pureperl-only" для дистрибутивів на основі Build.PL. Зауважте, що не всі CPAN
модулі ще підтримують цю конвенцію.

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

Увімкнення цього може потенційно створити кругову залежність для кількох модулів від CPAN,
коли "рекомендує" додає модуль, який "рекомендує" повертати модуль у відповідь.

Є також "--without-recommend" і "--without-suggests", щоб замінити значення за замовчуванням
рішення, прийняте раніше в "PERL_CPANM_OPT".

За замовчуванням значення false для обох.

--з-розвинути
ЕКСПЕРИМЕНТАЛЬНА: Встановлює розвиток фазових залежностей у файлах META або "cpanfile", коли
використовується з "--installdeps". За замовчуванням false.

--з-функцією, --без-функцією, --з-всіми функціями
ЕКСПЕРИМЕНТАЛЬНА: Визначає функцію, яку потрібно ввімкнути, якщо модуль підтримує додаткові функції
відповідно до META spec 2.0.

cpanm --with-feature=opt_csv Електронна таблиця::Читання

функції також можна вибирати в інтерактивному режимі, коли увімкнено параметр «--interactive».

"--with-all-features" включає всі додаткові функції, а "--with-with-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=..."

Аргумент увімкнено лише для модуля, переданого як аргумент командного рядка, але ні
залежності.

--скандепс
ЗНИЖЕНИЙ: сканує залежності заданих модулів і виводить дерево у вигляді тексту
формат. (Див. «--format» нижче, щоб отримати додаткові параметри)

Оскільки ця команда насправді не встановлює жодних дистрибутивів, вона буде корисною
що, ввівши:

cpanm --scandeps Catalyst::Runtime

Ви можете переконатися, які модулі будуть встановлені.

Ця команда враховує, які модулі ви вже інсталювали
системи. Якщо ви хочете побачити, які модулі будуть встановлені проти ванільного perl
встановлення, ви можете поєднати його з опцією "-L".

--формат
ЗНИЖЕНИЙ: Визначає формат для відображення відсканованого дерева залежностей. Доступний
опції "дерево", "json", "yaml" і "dists".

дерево Відображає дерево у форматі звичайного тексту. Це значення за замовчуванням.

json, yaml
Виводить дерево у форматі 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

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

--uninst-тіні
Видаляє тіньові файли дистрибутива, який ви встановлюєте. Це
усуває плутанину, якщо ви намагаєтеся встановити основні модулі (з подвійним терміном служби).
CPAN проти perl 5.10 або старішої версії або модулі, які раніше базувалися на XS, але перейшли на
чистий perl у деяких версіях.

Якщо ви запускаєте cpanm як root і використовуєте "INSTALL_BASE" або еквівалент, щоб указати custom
шлях інсталяції, ви ПОВИННІ вимкнути цю опцію, щоб випадково не видалити
модулі з подвійним життям з ядра включають шлях.

За замовчуванням значення 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.

--skip-installed
Вказує, чи пропускається модуль, заданий у командному рядку, якщо його остання версія
вже встановлено. За замовчуванням значення true.

ПРИМІТКА: Змінна середовища "PERL5LIB" має бути правильно встановлена, щоб це працювало
з модулями, встановленими за допомогою local::lib, якщо ви завжди не використовуєте параметр "-l".

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

Якщо ви біжите:

cpanm --задоволена CGI DBI~1.2

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

За замовчуванням false.

--підтвердити
Перевірте цілісність файлів розповсюдження, отриманих із PAUSE, за допомогою КОНТРОЛЬНИХ СУМ і
ПІДПИСИ (якщо знайдено). За замовчуванням false.

--report-perl-version
Чи повідомляє він про локально встановлену версію perl різному веб-серверу як
частина User-Agent. За замовчуванням значення true, якщо не пов’язані з CI змінні середовища, наприклад
"TRAVIS", "CI" або "AUTOMATED_TESTING" увімкнено. Ви можете вимкнути його за допомогою
"--no-report-perl-version".

-- автоматичне очищення
Вказує кількість днів, протягом яких закінчується термін дії робочих каталогів cpanm. За замовчуванням 7,
це означає, що старі робочі каталоги будуть очищені за тиждень.

Ви можете встановити значення 0, щоб cpan ніколи не очищав ці каталоги.

--man-сторінки
Генерує сторінки керівництва для виконуваних файлів (man1) і бібліотек (man3).

За замовчуванням значення true (згенеровано сторінки керівництва), якщо не встановлено параметр "-L|--local-lib-contained"
надається, у цьому випадку для нього встановлено значення 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