cpanmp — online w chmurze

PROGRAM:

IMIĘ

cpanm - pobierz, rozpakuj kompilację i zainstaluj moduły z CPAN

STRESZCZENIE

cpanm Test::Więcej # zainstaluj Test::Więcej
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # pełna ścieżka dystrybucji
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # zainstaluj z adresu URL
cpanm ~/dists/MojaFirma-Enterprise-1.00.tar.gz # zainstaluj z pliku lokalnego
cpanm --interactive Task::Kensho # Skonfiguruj interaktywnie
cpanm. # zainstaluj z lokalnego katalogu
cpanm --installdeps . # zainstaluj wszystkie deps dla bieżącego katalogu
cpanm -L extlib Plack # instaluje Placka i wszystkie nie-rdzeniowe deps w extlib
cpanm -- lustro http://cpan.cpantesters.org/ DBI # użyj szybko synchronizującego się serwera lustrzanego
cpanm --z https://cpan.metacpan.org/ Plack # używaj tylko serwera lustrzanego HTTPS

POLECENIA

(argumenty)
Argumentami wiersza poleceń mogą być nazwa modułu, plik dystrybucyjny, plik lokalny
ścieżka, adres URL HTTP lub adres URL repozytorium git. Następujące polecenia będą działać zgodnie z oczekiwaniami.

cpanm Plack
cpanm Plack/Request.pm
cpanm MIYAGAWA/Plack-1.0000.tar.gz
cpanm /ścieżka/do/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

Dodatkowo możesz użyć notacji, używając „~” i „@”, aby określić wersję dla a
dany moduł. „~” określa wymagania dotyczące wersji w formacie CPAN::Meta::Spec,
podczas gdy „@” przypina dokładną wersję i jest skrótem dla „~”== WERSJA „”.

cpanm Plack~1.0000 # 1.0000 lub nowszy
cpanm Plack~">= 1.0000, < 2.0000" # ostatni z 1.xxxx
cpanm [email chroniony] # konkretna wersja. tak samo jak Placka~"== 0.9990"

Zapytanie o wersję zawierające konkretną wersję lub zakres zostanie wysłane do MetaCPAN na adres
wyszukaj poprzednie wydania. Zapytanie domyślnie przeszuka archiwa BackPAN,
chyba że określisz opcję „--dev”, w takim przypadku zarchiwizowane wersje zostaną odfiltrowane
się.

W przypadku repozytorium git możesz określić gałąź, tag lub zatwierdzić SHA do zbudowania. The
domyślnie jest to „master”

cpanm git://github.com/plack/[email chroniony] # znacznik
cpanm git://github.com/plack/Plack.git@devel # oddział

-i, --instaluj
Instaluje moduły. Jest to zachowanie domyślne, a to tylko kompatybilność
opcja, aby działała jak cpan lub cpanp.

-- samoaktualizacja
Samo się aktualizuje. To tylko alias dla:

Aplikacja cpanm::cpanminus

--informacje
Wyświetla informacje o dystrybucji w formacie „AUTHOR/Dist-Name-ver.tar.gz” w formacie
standardowe.

--instalacjadeps
Instaluje zależności dystrybucji docelowej, ale nie buduje się. Przydatne, jeśli
chcesz wypróbować aplikację z repozytorium z kontrolą wersji, takiego jak git.

cpanm --installdeps.

--Patrzeć
Pobierz i rozpakuj dystrybucję, a następnie otwórz katalog za pomocą powłoki.
Przydatny do przeglądania kodu źródłowego lub przeprowadzania testów ręcznych.

-h, --pomoc
Wyświetla komunikat pomocy.

-V, --wersja
Wyświetla numer wersji.

OPCJE

Możesz określić domyślne opcje w zmiennej środowiskowej „PERL_CPANM_OPT”.

-f, --siła
Wymuś instalację modułów nawet wtedy, gdy testy się nie powiodą.

-n, --notatka
Pomiń testowanie modułów. Użyj tego tylko wtedy, gdy chcesz zaoszczędzić czas
instalowanie setek dystrybucji w tym samym perlu i architekturze, którą już masz
przetestowane, aby upewnić się, że buduje się dobrze.

Domyślnie jest to false i możesz powiedzieć „--no-notest”, aby zastąpić, gdy jest ustawione w pliku
domyślne opcje w „PERL_CPANM_OPT”.

--tylko test
Uruchom tylko testy i nie instaluj określonego modułu ani dystrybucji. Przydatne, jeśli
chcesz sprawdzić, czy nowe (lub nawet stare) wersje przechodzą testy jednostkowe bez nich
instalowanie modułu.

Zauważ, że jeśli określisz tę opcję z modułem lub dystrybucją, która ma
zależności, te zależności zostaną zainstalowane, jeśli obecnie ich nie masz.

-S, --sudo
Przełącz się na użytkownika root za pomocą „sudo” podczas instalowania modułów. Użyj tego, jeśli chcesz
zainstalować moduły w systemie perl obejmują ścieżkę.

Domyślnie jest to false i możesz powiedzieć „--no-sudo”, aby zastąpić, gdy jest ustawione w pliku
domyślne opcje w „PERL_CPANM_OPT”.

-v, --pełne
Sprawia, że ​​dane wyjściowe są pełne. Umożliwia również interaktywną konfigurację. (Widzieć
--interaktywny)

-q, --cichy
Sprawia, że ​​wyjście jest jeszcze cichsze niż ustawienie domyślne. Pokazuje tylko udane/nieudane
zależności do wyjścia.

-l, --local-lib
Ustawia zgodną ścieżkę local::lib do instalacji modułów. Nie musisz tego ustawiać
jeśli już skonfigurowałeś zmienne środowiskowe powłoki przy użyciu local::lib, ale this
można również użyć do nadpisania tego.

-L, --local-lib-zawiera
To samo z "--local-lib", ale z --self-contained set. Wszystkie zależności inne niż podstawowe będą
zostać zainstalowane, nawet jeśli są już zainstalowane.

Na przykład,

cpanm -L extlib Plack

zainstalowałby Placka i wszystkie jego niezwiązane z rdzeniem zależności w katalogu „extlib”,
które można załadować z aplikacji za pomocą:

użyj local::lib '/ścieżka/do/extlib';

Zauważ, że ta opcja działa NIE niezawodnie współpracuje z instalacjami perla dostarczonymi przez
dostawcy systemów operacyjnych, którzy usuwają standardowe moduły z Perla, tacy jak RHEL, Fedora
i CentOS, CHYBA ŻE instalujesz również pakiety dostarczające wszystkie moduły, które zostały
obnażony. Dla tych systemów prawdopodobnie będziesz chciał zainstalować meta-
pakiet, który właśnie to robi.

--samowystarczalny
Podczas sprawdzania zależności należy założyć, że w programie nie są zainstalowane żadne moduły inne niż podstawowe
system. Przydatne, jeśli chcesz połączyć zależności aplikacji w jednym katalogu
może dystrybuować do innych maszyn.

--wyklucz-dostawcę
Nie uwzględniaj modułów zainstalowanych w ścieżkach „dostawcy” podczas wyszukiwania rdzenia
modułów, gdy obowiązuje flaga „--self-contained”. To przywraca zachowanie
sprzed wersji 1.7023

--lustro
Określa podstawowy adres URL używany przez serwer lustrzany CPAN, na przykład
"http://cpan.cpantesters.org/" (możesz pominąć końcowy ukośnik). Możesz określić
wiele lustrzanych adresów URL, powtarzając opcję wiersza poleceń.

Możesz użyć lokalnego katalogu, który ma strukturę lustrzaną CPAN (utworzoną przez narzędzia takie jak
jak OrePAN lub Pinto) przy użyciu specjalnego schematu adresu URL „file://”. Jeśli podany adres URL się zaczyna
z `/` (bez żadnego schematu), jest również uważany za schemat plików.

cpanm --mirror file:///ścieżka/do/mirror
cpanm -- lustro ~/miniaturowy # Ponieważ powłoka rozwija ~ do /home/user

Domyślnie „http://www.cpan.org/".

--tylko lustro
Pobierz plik indeksu 02packages.details.txt.gz serwera lustrzanego zamiast odpytywania
CPAN Meta DB. Spowoduje to również skuteczną rezygnację z wysyłania lokalnych wersji Perla do
backendowe serwery baz danych, takie jak CPAN Meta DB i MetaCPAN.

Wybierz tę opcję, jeśli używasz lokalnego serwera lustrzanego CPAN, takiego jak minicpan when
jesteś offline lub swój własny indeks CPAN (aka darkpan).

--od, -M
cpanm -M https://cpan.metacpan.org/
cpanm --z https://cpan.metacpan.org/

Użyj podanego lustrzanego adresu URL i jego indeksu jako tylko źródło do wyszukania i pobrania
moduły z.

Działa podobnie do kombinacji „--mirror” i „--mirror-only”, z niewielką różnicą:
w przeciwieństwie do „--mirror”, które dołącza adres URL do listy serwerów lustrzanych, „--from” (lub „-M” dla
short) używa określonego adresu URL jako swojego tylko źródło do pobrania indeksu i modułów.
To sprawia, że ​​opcja zawsze zastępuje domyślny serwer lustrzany, który mógł zostać ustawiony
za pomocą opcji globalnych, takich jak ta ustawiona przez zmienną środowiskową „PERL_CPANM_OPT”.

Wskazówka: Przydatne może być nazwanie tych opcji aliasami powłoki, na przykład:

alias minicpanm='cpanm --z ~/miniaturowy'
alias darkpan='cpanm --z http://mycompany.example.com/DPAN'

--mirror-indeks
EKSPERYMENTALNE: Określa ścieżkę do pliku „02packages.details.txt” do wyszukiwania modułów
index.

--cpanmetadb
EKSPERYMENTALNE: Określa alternatywny identyfikator URI do wyszukiwania indeksu CPAN MetaDB.

--metakpan
Preferuje MetaCPAN API od CPAN MetaDB.

--cpanplik
EKSPERYMENTALNE: Określono alternatywną ścieżkę do wyszukiwania pliku cpanfile, kiedy
Polecenie „--installdeps” jest w użyciu. Domyślnie „cpanfile”.

--podpowiedź
Monituje, gdy test się nie powiedzie, aby można było pominąć, wymusić instalację, ponowić próbę lub zajrzeć do pliku
powłoki, aby zobaczyć, co się dzieje. Monituje również, gdy jedna z zależności nie powiodła się, jeśli
chcesz kontynuować instalację.

Domyślnie jest to false i możesz powiedzieć „--no-prompt”, aby nadpisać, jeśli jest ustawione w
domyślne opcje w „PERL_CPANM_OPT”.

--rozw
EKSPERYMENTALNE: wyszukaj również nowszą wersję dla programistów. Domyślnie fałsz.

--ponowna instalacja
cpanm, po podaniu nazwy modułu w wierszu poleceń (tj. "cpanm Plack"), sprawdza plik
najpierw lokalnie zainstalowana wersja i pomija, jeśli jest już zainstalowana. Ta opcja
powoduje pominięcie sprawdzenia, więc:

cpanm --reinstall Placka

ponownie zainstaluje Plack, nawet jeśli lokalnie zainstalowana wersja jest najnowsza lub nawet nowsza
(co by się stało, gdybyś zainstalował wersję programisty z kontroli wersji
repozytoria).

Domyślnie fałsz.

--interaktywny
Sprawia, że ​​konfiguracja (taka jak „Makefile.PL” i „Build.PL”) jest interaktywna, dzięki czemu
odpowiedz na pytania w dystrybucji wymagającej niestandardowej konfiguracji lub Zadanie::
dystrybucje.

Domyślnie jest to false i możesz powiedzieć „--no-interactive”, aby zastąpić, gdy jest ustawione w
domyślne opcje w „PERL_CPANM_OPT”.

--pp, --pureperl
Preferuj kompilację modułów Pure Perl, ustawiając „PUREPERL_ONLY=1” dla MakeMaker i
"--pureperl-only" dla dystrybucji opartych na Build.PL. Należy pamiętać, że nie wszystkie CPAN
moduły obsługują jeszcze tę konwencję.

--z-poleca, --z-sugeruje
EKSPERYMENTALNE: Instaluje zależności zadeklarowane jako „zalecane” i „sugeruje”
odpowiednio, zgodnie ze specyfikacją META. Gdy instalacja tych zależności nie powiedzie się, cpanm kontynuuje
instalacji, ponieważ są to tylko rekomendacje/sugestie.

Włączenie tego może potencjalnie spowodować cykliczną zależność dla kilku modułów w CPAN,
kiedy „poleca” dodaje moduł, który „poleca” w zamian za moduł.

Istnieje również „--without-recommend” i „--without-suggests”, aby zastąpić domyślne
decyzja podjęta wcześniej w „PERL_CPANM_OPT”.

Domyślnie false dla obu.

--z-rozwojem
EKSPERYMENTALNE: Instaluje rozwijanie zależności fazowych w plikach META lub „cpanfile”, kiedy
używany z „--installdeps”. Domyślnie fałsz.

--z-funkcjami, --bez-funkcji, --ze-wszystkimi-funkcjami
EKSPERYMENTALNE: Określa funkcję do włączenia, jeśli moduł obsługuje funkcje opcjonalne
zgodnie ze specyfikacją META 2.0.

cpanm --with-feature=opt_csv Arkusz kalkulacyjny::Odczyt

funkcje można również wybierać interaktywnie, gdy włączona jest opcja „--interactive”.

„--with-all-features” włącza wszystkie opcjonalne funkcje, a „--without-feature” może
wybierz funkcję do wyłączenia.

--configure-timeout, --build-timeout, --test-timeout
Określ czas oczekiwania (w sekundach) na konfigurację, kompilację i testowanie
proces. Bieżące wartości domyślne to: 60 dla konfiguracji, 3600 dla kompilacji i 1800 dla
test.

--configure-args, --build-args, --test-args, --install-args
EKSPERYMENTALNE: Przekazuj argumenty odpowiednio dla poleceń configure/build/test/install,
do zainstalowania danego modułu.

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

Argument jest włączony tylko dla modułu przekazanego jako argument wiersza poleceń, nie
zależności.

--skandeps
ODRADZANA: Skanuje zależności danych modułów i wyświetla drzewo w tekście
format. (Zobacz „--format” poniżej, aby uzyskać więcej opcji)

Ponieważ to polecenie tak naprawdę nie instaluje żadnych dystrybucji, będzie przydatne
że wpisując:

cpanm --scandeps Katalizator::Środowisko wykonawcze

możesz upewnić się, jakie moduły zostaną zainstalowane.

To polecenie bierze pod uwagę, które moduły już zainstalowałeś w swoim
system. Jeśli chcesz zobaczyć, jakie moduły zostaną zainstalowane na waniliowym perlu
instalacji, możesz chcieć połączyć to z opcją „-L”.

--format
ODRADZANA: Określa format wyświetlania zeskanowanego drzewa zależności. Dostępny
opcje to „drzewo”, „json”, „yaml” i „dists”.

tree Wyświetla drzewo w formacie zwykłego tekstu. To jest wartość domyślna.

json, yaml
Wyprowadza drzewo w formacie JSON lub YAML. Moduły JSON i YAML muszą być
zainstalowane odpowiednio. Drzewo wyjściowe jest reprezentowane jako krotka rekurencyjna
z:

[ dystrybucja, zależności ]

a kontener jest tablicą zawierającą elementy główne. Zauważ, że tam
może być wiele węzłów głównych, ponieważ można przekazać wiele modułów do
Polecenie „--scandeps”.

dists „dists” to specjalny format wyjściowy, w którym wypisuje nazwę pliku dystrybucji
głębokość drugim zamówienie po rozwiązaniu zależności, na przykład:

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

co oznacza, że ​​możesz zainstalować te dystrybucje w tej kolejności bez dodatkowych opłat
zależności. W połączeniu z opcją „-L” przyda się powtórka
instalacje na innych maszynach.

--zapisz-odległości
Określa opcjonalną ścieżkę katalogu do kopiowania pobranych plików tar w serwerze lustrzanym CPAN
kompatybilna struktura katalogów, tj Authors/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

Jeśli archiwum dystrybucji nie pochodzi z CPAN, na przykład z pliku lokalnego lub z
GitHub, a następnie zostanie zapisany pod sprzedawca/Foo-Bar-wersja.tar.gz.

--uninst-cienie
Odinstalowuje pliki cieni instalowanej dystrybucji. Ten
eliminuje zamieszanie, jeśli próbujesz zainstalować podstawowe (podwójne) moduły z
CPAN przeciwko perlowi 5.10 lub starszemu lub modułom, które kiedyś były oparte na XS, ale zostały na nie przełączone
czysty Perl w niektórych wersjach.

Jeśli uruchomisz cpanm jako root i użyjesz „INSTALL_BASE” lub odpowiednika, aby określić custom
ścieżkę instalacji, POWINIENEŚ wyłączyć tę opcję, aby przypadkowo nie odinstalować
moduły o podwójnym życiu z rdzenia obejmują ścieżkę.

Domyślnie jest to prawda, jeśli twoja wersja Perla jest mniejsza niż 5.12 i możesz to wyłączyć
z "--no-uninst-cienie".

UWAGA: Od wersji 1.3000 ta flaga jest domyślnie wyłączona dla perla nowszego niż
5.12, ponieważ z 5.12 @INC zawiera katalog site_perl zanim podstawowa biblioteka Perla
path, a odinstalowanie cieni nie jest już konieczne i powoduje więcej szkód przez usunięcie
pliki ze ścieżki biblioteki podstawowej.

--odinstaluj, -U
Odinstalowuje moduł ze ścieżki biblioteki. Znajduje listę pakietów dla danych modułów i
usuwa wszystkie pliki zawarte w tej samej dystrybucji.

Jeśli włączysz local::lib, usunie to tylko pliki z katalogu local::lib.

Jeśli spróbujesz odinstalować moduł w katalogu „perl” (tj. moduł podstawowy), pojawi się błąd
zostać rzuconym.

Zostanie wyświetlone okno dialogowe z prośbą o potwierdzenie plików do usunięcia. Jeśli przekażesz opcję „-f”.
okno dialogowe zostanie pominięte, a dezinstalacja zostanie wymuszona.

--wyszukiwanie kaskadowe
EKSPERYMENTALNE: Określa, czy wyszukiwanie kaskadowe ma być wykonywane w przypadku określenia wielu serwerów lustrzanych
a lustro nie ma modułu lub ma niższą wersję modułu niż
wymagany. Domyślnie fałsz.

--pomiń-zainstalowane
Określa, czy moduł podany w wierszu poleceń jest pomijany, jeśli jego najnowsza wersja
jest już zainstalowany. Wartość domyślna to prawda.

UWAGA: Zmienna środowiskowa „PERL5LIB” musi być poprawnie ustawiona, aby to zadziałało
z modułami zainstalowanymi przy użyciu local::lib, chyba że zawsze używasz opcji „-l”.

--pomiń-zadowolony
EKSPERYMENTALNE: Określa, czy moduł (i wersja) podany w wierszu poleceń jest
pominięty, jeśli jest już zainstalowany.

Jeśli biegasz:

cpanm -- zadowalający pominięciem CGI DBI ~ 1.2

cpanm nie zainstaluje ich, jeśli masz już CGI (dla dowolnych wersji) lub masz DBI
z wersją wyższą niż 1.2. Jest podobny do „--skip-installed”, ale while
„--skip-installed” sprawdza, czy plik firmy zainstalowana jest wersja CPAN,
„--skip-satisfied” sprawdza, czy żądana wersja (lub nie, co oznacza dowolną wersję) jest
zainstalowany.

Domyślnie fałsz.

--zweryfikować
Sprawdź integralność plików dystrybucyjnych pobranych z PAUSE za pomocą SUMY KONTROLNE i
PODPISY (jeśli zostały znalezione). Domyślnie fałsz.

--report-wersja-perla
Czy zgłasza lokalnie zainstalowaną wersję Perla do różnych serwerów WWW jako
część User-Agent. Wartość domyślna to true, chyba że zmienne środowiskowe związane z CI, takie jak
„TRAVIS”, „CI” lub „AUTOMATED_TESTING” są włączone. Możesz go wyłączyć za pomocą
"--no-report-perl-version".

--automatyczne czyszczenie
Określa liczbę dni, po których wygasają katalogi robocze cpanm. Domyślnie 7,
co oznacza, że ​​stare katalogi pracy zostaną wyczyszczone w ciągu jednego tygodnia.

Możesz ustawić wartość na 0, aby cpan nigdy nie czyścił tych katalogów.

--strony podręcznika
Generuje strony man dla plików wykonywalnych (man1) i bibliotek (man3).

Domyślnie true (wygenerowane strony podręcznika), chyba że opcja "-L|--local-lib-contained" jest ustawiona
dostarczone, w którym to przypadku jest ustawione na fałsz. Możesz go wyłączyć za pomocą „--no-man-pages”.

--lwp
Używa modułu LWP do pobierania rzeczy przez HTTP. Domyślnie true i możesz powiedzieć
„--no-lwp”, aby wyłączyć używanie LWP, gdy chcesz uaktualnić LWP z CPAN na niektórych uszkodzonych
systemy Perla.

--wget
Używa GNU Wget (jeśli jest dostępny) do pobierania rzeczy. Domyślnie true i możesz powiedzieć
„--no-wget”, aby wyłączyć używanie Wget (wersje Wget starsze niż 1.9 nie obsługują
opcja „--retry-connrefused” używana przez cpanm).

--kędzior
Używa cURL (jeśli jest dostępny) do pobierania rzeczy. Domyślnie true i możesz powiedzieć
„--no-curl”, aby wyłączyć używanie cURL.

Zwykle z opcjami "--lwp", "--wget" i "--curl" ustawionymi na true (co jest
domyślnie) cpanm próbuje LWP, Wget, cURL i HTTP::Tiny (w tej kolejności) i używa pierwszego
jeden dostępny.

Korzystaj z cpanmp online, korzystając z usług onworks.net