cpanmp - Online în cloud

PROGRAM:

NUME

cpanm - obțineți, despachetați, construiți și instalați module din CPAN

REZUMAT

cpanm Test::More # install Test::More
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # cale de distribuție completă
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # instalați de la URL
cpanm ~/dists/MyCompany-Enterprise-1.00.tar.gz # instalați dintr-un fișier local
cpanm --interactive Task::Kensho # Configurați interactiv
cpanm . # instalați din directorul local
cpanm --installdeps . # instalați toate dep-urile pentru directorul curent
cpanm -L extlib Plack # instalează Plack și toate dep-urile non-core în extlib
cpanm --oglindă http://cpan.cpantesters.org/ DBI # folosește oglinda cu sincronizare rapidă
cpanm --from https://cpan.metacpan.org/ Plack # folosește numai oglinda HTTPS

COMANDE

(argumente)
Argumentele liniei de comandă pot fi fie un nume de modul, un fișier de distribuție, fie un fișier local
cale, URL HTTP sau adresa URL a depozitului git. Urmărirea comenzilor va funcționa așa cum vă așteptați.

cpanm Plack
cpanm Plack/Request.pm
cpanm MIYAGAWA/Plack-1.0000.tar.gz
cpanm /path/to/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

În plus, puteți utiliza notația folosind „~” și „@” pentru a specifica versiunea pentru a
modul dat. „~” specifică cerința de versiune în formatul CPAN::Meta::Spec,
în timp ce „@” fixează versiunea exactă și este o comandă rapidă pentru „~”== VERSIUNEA”.

cpanm Plack~1.0000 # 1.0000 sau mai târziu
cpanm Plack~">= 1.0000, < 2.0000" # cel mai recent din 1.xxxx
cpanm [e-mail protejat] # versiune specifică. la fel ca Plack~"== 0.9990"

Interogarea privind versiunea, inclusiv versiunea sau intervalul specific, va fi trimisă către MetaCPAN către
caută versiuni anterioare. Interogarea va căuta în mod implicit arhivele BackPAN,
cu excepția cazului în care specificați opțiunea „--dev”, caz în care, versiunile arhivate vor fi filtrate
afară.

Pentru un depozit git, puteți specifica o ramură, etichetă sau SHA de commit pentru a construi. The
implicit este "master"

cpanm git://github.com/plack/[e-mail protejat] # etichetă
cpanm git://github.com/plack/Plack.git@devel # branch

-i, --install
Instalează modulele. Acesta este un comportament implicit și este doar o compatibilitate
opțiunea de a-l face să funcționeze ca cpan sau cpanp.

--auto-upgrade
Se actualizează în sine. Este doar un alias pentru:

Aplicația cpanm::cpanminus

--info
Afișează informațiile de distribuție în format „AUTHOR/Dist-Name-ver.tar.gz” în formatul
ieșire standard.

--installdeps
Instalează dependențele distribuției țintă, dar nu se va construi singur. La îndemână dacă
doriți să încercați aplicația dintr-un depozit controlat de versiune, cum ar fi git.

cpanm --installdeps .

--uite
Descărcați și despachetați distribuția și apoi deschideți directorul cu shell-ul dvs.
La îndemână pentru a căuta codul sursă sau pentru a face testare manuală.

-h, --ajutor
Afișează mesajul de ajutor.

-V, --versiune
Afișează numărul versiunii.

OPŢIUNI

Puteți specifica opțiunile implicite în variabila de mediu „PERL_CPANM_OPT”.

-f, --forță
Forțați instalarea modulelor chiar și atunci când testarea a eșuat.

-n, --notest
Sari peste testarea modulelor. Folosiți-l numai atunci când doriți doar să economisiți timp pentru
instalând sute de distribuții la aceeași arhitectură și perl pe care le-ați avut deja
testat pentru a se asigura că se construiește bine.

Valoarea implicită la false și puteți spune „--no-notest” pentru a înlocui atunci când este setat în
opțiuni implicite în „PERL_CPANM_OPT”.

--doar test
Rulați numai testele și nu instalați modulul sau distribuțiile specificate. La îndemână dacă
doriți să verificați că versiunile noi (sau chiar vechi) trec testele unitare fără
instalarea modulului.

Rețineți că dacă specificați această opțiune cu un modul sau distribuție care are
dependențe, aceste dependențe vor fi instalate dacă nu le aveți în prezent.

-S, --sudo
Treceți la utilizatorul root cu „sudo” când instalați module. Folosește asta dacă vrei
instalați module în calea include perl de sistem.

Valoarea implicită la false și puteți spune „--no-sudo” pentru a înlocui atunci când este setat în
opțiuni implicite în „PERL_CPANM_OPT”.

-v, --verbos
Face ieșirea verbosă. De asemenea, permite configurarea interactivă. (Vedea
--interactiv)

-q, --liniște
Face ieșirea și mai silentioasă decât cea implicită. Arată doar succesul/eșuat
dependențe de ieșire.

-l, --local-lib
Setează calea compatibilă local::lib pentru a instala modulele. Nu trebuie să setați asta
dacă configurați deja variabilele de mediu shell folosind local::lib, dar aceasta
poate fi folosit pentru a anula și asta.

-L, --local-lib-conținut
La fel cu „--local-lib” dar cu --self-contained set. Toate dependențele non-core vor
să fie instalate chiar dacă sunt deja instalate.

De exemplu,

cpanm -L extlib Plack

ar instala Plack și toate dependențele sale non-core în directorul „extlib”,
care poate fi încărcat din aplicația dvs. cu:

utilizați local::lib '/path/to/extlib';

Rețineți că această opțiune o face NU funcționează în mod fiabil cu instalațiile perl furnizate de
Furnizori de sisteme de operare care scot modulele standard din perl, cum ar fi RHEL, Fedora
și CentOS, DACĂ NU instalați și pachete care furnizează toate modulele care au fost
dezbrăcat. Pentru aceste sisteme, probabil că veți dori să instalați meta-ul „perl-core”.
pachet care face exact asta.

--autonom
Când examinați dependențele, presupuneți că nu sunt instalate module non-core pe
sistem. La îndemână dacă doriți să grupați dependențele aplicației într-un singur director, astfel încât
poate distribui către alte mașini.

--exclude-vanzator
Nu includeți module instalate sub căile „furnizor” atunci când căutați core
module atunci când indicatorul „--self-contained” este în vigoare. Acest lucru restabilește comportamentul
de înainte de versiunea 1.7023

--oglindă
Specifică adresa URL de bază pentru oglinda CPAN de utilizat, cum ar fi
"http://cpan.cpantesters.org/" (puteți omite slash-ul final). Puteți specifica
mai multe adrese URL în oglindă prin repetarea opțiunii din linia de comandă.

Puteți utiliza un director local care are o structură oglindă CPAN (creată de instrumente precum
ca OrePAN sau Pinto) utilizând o schemă URL specială „file://”. Dacă URL-ul dat începe
cu `/` (fără nicio schemă), este considerată și o schemă de fișiere.

cpanm --mirror file:///path/to/mirror
cpanm --oglindă ~/minicpan # Deoarece shell-ul se extinde ~ la /home/user

Implicit la "http://www.cpan.org/".

--doar oglindă
Descărcați fișierul index 02packages.details.txt.gz al oglinzii în loc să interogați
CPAN Meta DB. Acest lucru va renunța efectiv la trimiterea versiunilor locale de perl către
Servere de baze de date backend, cum ar fi CPAN Meta DB și MetaCPAN.

Selectați această opțiune dacă utilizați o oglindă locală a CPAN, cum ar fi minicpan când
sunteți offline sau propriul index CPAN (aka darkpan).

--din, -M
cpanm -M https://cpan.metacpan.org/
cpanm --de la https://cpan.metacpan.org/

Utilizați adresa URL în oglindă dată și indexul acesteia ca afară sursă pentru căutare și descărcare
module de la.

Funcționează similar cu „--mirror” și „--mirror-only” combinate, cu o mică diferență:
spre deosebire de „--oglindă” care anexează URL-ul către lista de oglinzi, „--from” (sau „-M” pentru
scurt) folosește URL-ul specificat ca ei afară sursă din care să descărcați indexul și modulele.
Acest lucru face ca opțiunea să înlocuiască întotdeauna oglinda implicită, care ar fi putut fi setată
prin opțiuni globale, cum ar fi cea setată de variabila de mediu „PERL_CPANM_OPT”.

Sfat: Ar putea fi util dacă numiți aceste opțiuni cu aliasurile dvs. de shell, cum ar fi:

alias minicpanm='cpanm --de la ~/minicpan'
alias darkpan='cpanm --de la http://mycompany.example.com/DPAN'

--index-oglindă
EXPERIMENTAL: Specifică calea fișierului către „02packages.details.txt” pentru căutarea în modul
index.

--cpanmetadb
EXPERIMENTAL: Specifică un URI alternativ pentru căutările de index CPAN MetaDB.

--metacpan
Preferă API-ul MetaCPAN decât CPAN MetaDB.

--cpanfile
EXPERIMENTAL: a specificat o cale alternativă pentru căutarea cpanfile, când
Comanda „--installdeps” este în uz. Implicit, „cpanfile”.

--prompt
Solicită atunci când un test eșuează, astfel încât să puteți sări, instalați forțat, încercați din nou sau căutați în
shell pentru a vedea ce nu merge bine. De asemenea, solicită când una dintre dependențe a eșuat dacă
doriți să continuați instalarea.

Valoarea implicită este false și puteți spune „--no-prompt” pentru a înlocui dacă este setat în
opțiuni implicite în „PERL_CPANM_OPT”.

--dev
EXPERIMENTAL: căutați și o versiune de dezvoltator mai nouă. Implicit la fals.

--reinstala
cpanm, când i se oferă un nume de modul în linia de comandă (adică „cpanm Plack”), verifică
versiunea instalată local mai întâi și omite dacă este deja instalată. Această opțiune
face să sară peste verificare, deci:

cpanm --reinstall Plack

ar reinstala Plack chiar dacă versiunea instalată local este cea mai recentă sau chiar mai nouă
(ceea ce s-ar întâmpla dacă instalați o versiune de dezvoltator din controlul versiunilor
depozite).

Implicit la fals.

--interactiv
Face configurația (cum ar fi „Makefile.PL” și „Build.PL”) interactivă, astfel încât să puteți
răspunde la întrebările din distribuție care necesită configurație personalizată sau Sarcină::
distribuții.

Valoarea implicită este false și puteți spune „--no-interactive” pentru a o înlocui atunci când este setat în
opțiuni implicite în „PERL_CPANM_OPT”.

--pp, --pureperl
Preferați construcția Pure Perl a modulelor setând „PUREPERL_ONLY=1” pentru MakeMaker și
„--pureperl-only” pentru distribuțiile bazate pe Build.PL. Rețineți că nu toate CPAN-urile
modulele acceptă încă această convenție.

--cu-recomandă, --cu-sugerează
EXPERIMENTAL: instalează dependențe declarate ca „recomandă” și „sugerează”
respectiv, conform META spec. Când aceste dependențe nu reușesc să se instaleze, cpanm continuă
instalarea, deoarece sunt doar recomandari/sugestii.

Activarea acestui lucru ar putea crea o dependență circulară pentru câteva module pe CPAN,
când „recomandă” adaugă un modul care „recomandă” înapoi modulul în schimb.

Există, de asemenea, „--without-recommend” și „--without-suggests” pentru a înlocui valoarea implicită
decizie luată mai devreme în „PERL_CPANM_OPT”.

Implicit la fals pentru ambele.

--cu-dezvoltare
EXPERIMENTAL: Instalează dependențe de fază în fișierele META sau „cpanfile” când
folosit cu „--installdeps”. Implicit la fals.

--cu-funcție, --fără-funcție, --cu-toate-caracteristicile
EXPERIMENTAL: Specifică caracteristica de activat, dacă un modul acceptă funcții opționale
conform META spec 2.0.

cpanm --with-feature=opt_csv Spreadsheet::Read

caracteristicile pot fi, de asemenea, alese interactiv atunci când opțiunea „--interactive” este activată.

„--with-all-features” activează toate caracteristicile opționale, iar „--without-feature” poate
selectați o funcție de dezactivat.

--configure-timeout, --build-timeout, --test-timeout
Specificați durata de expirare (în secunde) pentru a aștepta configurarea, construirea și testarea
proces. Valorile implicite curente sunt: ​​60 pentru configurare, 3600 pentru compilare și 1800 pentru
Test.

--configure-args, --build-args, --test-args, --install-args
EXPERIMENTAL: Treci argumente pentru comenzile de configurare/build/test/install, respectiv,
pentru instalarea unui anumit modul.

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

Argumentul este activat numai pentru modulul transmis ca argument de linie de comandă, nu
dependențe.

--scandeps
DEPRECAT: Scanează dependențele modulelor date și scoate arborele într-un text
format. (Consultați „--format” de mai jos pentru mai multe opțiuni)

Deoarece această comandă nu instalează de fapt nicio distribuție, va fi utilă
că tastând:

cpanm --scandeps Catalyst::Runtime

poți să te asiguri ce module vor fi instalate.

Această comandă ia în considerare modulele pe care le-ați instalat deja în dvs
sistem. Dacă doriți să vedeți ce module vor fi instalate împotriva unui perl vanilla
instalare, poate doriți să o combinați cu opțiunea „-L”.

--format
DEPRECAT: Stabilește ce format să afișeze arborele de dependență scanat. Disponibil
opțiunile sunt „tree”, „json”, „yaml” și „dists”.

arbore Afișează arborele într-un format de text simplu. Aceasta este valoarea implicită.

json, yaml
Afișează arborele într-un format JSON sau YAML. Modulele JSON și YAML trebuie să fie
instalat respectiv. Arborele de ieșire este reprezentat ca un tuplu recursiv
de:

[ distribuție, dependențe ]

iar containerul este o matrice care conține elementele rădăcină. Rețineți că acolo
pot fi mai multe noduri rădăcină, deoarece puteți da mai multe module la
Comanda „--scandeps”.

dists „dists” este un format special de ieșire, unde tipărește numele fișierului de distribuție
în adâncime primul comandă după rezoluția dependenței, cum ar fi:

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

ceea ce înseamnă că puteți instala aceste distribuții în această ordine fără suplimentar
dependențe. Când este combinat cu opțiunea „-L”, va fi util să reluați
instalatii pe alte masini.

--save-dists
Specifică calea opțională a directorului pentru a copia fișierele tarball descărcate în oglinda CPAN
structura de directoare compatibilă de ex authors/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

Dacă tarball-ul distro nu a venit de la CPAN, de exemplu dintr-un fișier local sau de la
GitHub, apoi va fi salvat sub furnizor/Foo-Bar-version.tar.gz.

--uninst-umbre
Dezinstalează fișierele umbră ale distribuției pe care o instalați. Acest
elimină confuzia dacă încercați să instalați module de bază (dual-life) din
CPAN împotriva perl 5.10 sau mai vechi, sau module care erau bazate pe XS, dar au trecut la
perl pur la o anumită versiune.

Dacă rulați cpanm ca root și utilizați „INSTALL_BASE” sau echivalent pentru a specifica personalizarea
calea de instalare, TREBUIE să dezactivați această opțiune, astfel încât să nu dezinstalați accidental
modulele cu viață dublă din nucleu includ calea.

Valoarea implicită la true dacă versiunea dvs. perl este mai mică decât 5.12 și o puteți dezactiva
cu „--no-uninst-shadows”.

NOTĂ: Începând cu versiunea 1.3000, acest flag este dezactivat implicit pentru perl mai nou decât
5.12, deoarece cu 5.12 @INC conține directorul site_perl înainte biblioteca de bază perl
cale, iar dezinstalarea umbrelor nu mai este necesară și face mai mult rău prin ștergere
fișiere din calea bibliotecii de bază.

--dezinstalare, -U
Dezinstalează un modul din calea bibliotecii. Găsește o listă de pachete pentru modulele date și
elimină toate fișierele incluse în aceeași distribuție.

Dacă activați local::lib, elimină numai fișierele din directorul local::lib.

Dacă încercați să dezinstalați un modul din directorul „perl” (adică modul de bază), va apărea o eroare
fi aruncat.

Va fi solicitat un dialog pentru a confirma fișierele de șters. Dacă treceți opțiunea „-f”.
de asemenea, dialogul va fi omis și dezinstalarea va fi forțată.

--cascade-search
EXPERIMENTAL: Specifică dacă căutarea în cascadă atunci când specificați mai multe oglinzi
iar o oglindă nu are un modul sau are o versiune inferioară a modulului decât
solicitat. Implicit la fals.

--skip-instalat
Specifică dacă un modul dat în linia de comandă este omis dacă este cea mai recentă versiune
este deja instalat. Implicit la adevărat.

NOTĂ: Variabila de mediu „PERL5LIB” trebuie să fie setată corect pentru ca aceasta să funcționeze
cu module instalate folosind local::lib, cu excepția cazului în care utilizați întotdeauna opțiunea „-l”.

--sări-satisfăcut
EXPERIMENTAL: Specifică dacă un modul (și versiunea) dat în linia de comandă este
a omis dacă este deja instalat.

Daca alergi:

cpanm --skip-satisfied CGI DBI~1.2

cpanm nu le va instala dacă aveți deja CGI (pentru orice versiune) sau aveți DBI
cu versiunea mai mare decât 1.2. Este similar cu „--skip-installed”, dar în timp ce
„--skip-installed” verifică dacă Ultimele versiunea CPAN este instalată,
„--skip-satisfied” verifică dacă o versiune solicitată (sau nu, ceea ce înseamnă orice versiune) este
instalat.

Implicit la fals.

--verifica
Verificați integritatea fișierelor de distribuție preluate din PAUSE folosind CHECKSUMS și
SEMNĂTURĂ (dacă este găsită). Implicit la fals.

--report-perl-version
Indiferent dacă raportează versiunea perl instalată local către diferitele servere web ca
parte din User-Agent. Valoarea implicită la true, cu excepția cazului în care variabilele de mediu legate de CI, cum ar fi
„TRAVIS”, „CI” sau „AUTOMATED_TESTING” este activat. Îl puteți dezactiva utilizând
„--no-report-perl-version”.

--curățare automată
Specifică numărul de zile în care expiră directoarele de lucru ale cpanm. Implicit la 7,
ceea ce înseamnă că vechile directoare de lucru vor fi curățate într-o săptămână.

Puteți seta valoarea la 0 pentru ca cpan să nu curețe niciodată acele directoare.

--pagini-man
Generează pagini de manual pentru executabile (man1) și biblioteci (man3).

Valoarea implicită este true (pagini de manual generate), cu excepția cazului în care opțiunea „-L|--local-lib-contained” este
furnizat, caz în care este setat la false. Îl puteți dezactiva cu „--no-man-pages”.

--lwp
Utilizează modulul LWP pentru a descărca lucruri prin HTTP. Implicit este adevărat și puteți spune
„--no-lwp” pentru a dezactiva utilizarea LWP, atunci când doriți să faceți upgrade LWP de la CPAN pe unele defecte
sisteme perl.

--wget
Utilizează GNU Wget (dacă este disponibil) pentru a descărca lucruri. Implicit este adevărat și puteți spune
„--no-wget” pentru a dezactiva utilizarea Wget (versiunile de Wget mai vechi de 1.9 nu acceptă
Opțiunea „--retry-connrefused” folosită de cpanm).

--răsuci
Utilizează cURL (dacă este disponibil) pentru a descărca lucruri. Implicit este adevărat și puteți spune
„--no-curl” pentru a dezactiva utilizarea cURL.

În mod normal, cu opțiunile „--lwp”, „--wget” și „--curl” setate la adevărat (care este
implicit) cpanm încearcă LWP, Wget, cURL și HTTP::Tiny (în această ordine) și folosește primul
unul disponibil.

Utilizați cpanmp online folosind serviciile onworks.net