cpanmp - Online in de cloud

PROGRAMMA:

NAAM

cpanm - modules van CPAN ophalen, uitpakken en installeren

KORTE INHOUD

cpanm Test::Meer # installeer Test::Meer
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # volledig distributiepad
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # installeren vanaf URL
cpanm ~/dists/MijnBedrijf-Enterprise-1.00.tar.gz # installeren vanuit een lokaal bestand
cpanm --interactive Task::Kensho # Interactief configureren
cpanm. # installeren vanuit lokale map
cpanm --installdeps . # installeer alle deps voor de huidige map
cpanm -L extlib Plack # installeer Plack en alle niet-kerndeps in extlib
cpanm --spiegel http://cpan.cpantesters.org/ DBI # gebruik de snel synchroniserende spiegel
cpanm --van https://cpan.metacpan.org/ Plack # gebruik alleen de HTTPS-mirror

COMMANDO'S

(argumenten)
Opdrachtregelargumenten kunnen een modulenaam, een distributiebestand of een lokaal bestand zijn
pad, HTTP-URL of git-repository-URL. De volgende opdrachten werken allemaal zoals u verwacht.

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

Bovendien kunt u de notatie gebruiken met "~" en "@" om de versie voor a op te geven
gegeven module. "~" specificeert de versievereiste in het CPAN::Meta::Spec-formaat,
terwijl "@" de exacte versie vastzet, en een snelkoppeling is voor "~"== VERSIE"".

cpanm Plack~1.0000 # 1.0000 of hoger
cpanm Plack~">= 1.0000, < 2.0000" # laatste van 1,xxxx
cpanm [e-mail beveiligd] # specifieke versie. hetzelfde als Plack~"== 0.9990"

De versiequery inclusief specifieke versie of bereik wordt naar MetaCPAN verzonden
zoeken naar eerdere releases. De zoekopdracht zoekt standaard naar BackPAN-archieven,
tenzij u de optie "--dev" specificeert. In dat geval worden gearchiveerde versies gefilterd
uit.

Voor een git-repository kun je een branch, tag of commit SHA opgeven om te bouwen. De
standaard is "meester"

cpanm git://github.com/plack/[e-mail beveiligd] # label
cpanm git://github.com/plack/Plack.git@devel # branch

-i, --installeren
Installeert de modules. Dit is een standaardgedrag en dit is slechts een compatibiliteit
optie om het te laten werken als cpan of cpanp.

--zelf-upgrade
Upgradet zichzelf. Het is slechts een alias voor:

cpanm-app::cpanminus

--info
Geeft de distributie-informatie weer in het formaat "AUTHOR/Dist-Name-ver.tar.gz" in het
standaard uit.

--installatiedeps
Installeert de afhankelijkheden van de doeldistributie, maar bouwt zichzelf niet. Handig als
je wilt de applicatie uitproberen vanuit een versiebeheerde repository zoals git.

cpanm --installdeps .

--Look
Download en pak de distributie uit en open vervolgens de map met uw shell.
Handig om in de broncode te snuffelen of handmatig te testen.

-h, --hulp
Geeft het helpbericht weer.

-V, --versie
Geeft het versienummer weer.

OPTIES

U kunt de standaardopties opgeven in de omgevingsvariabele "PERL_CPANM_OPT".

-f, --kracht
Forceer de installatie van modules, zelfs als het testen is mislukt.

-n, --opmerking
Sla het testen van modules over. Gebruik dit alleen als u er gewoon tijd voor wilt besparen
honderden distributies installeren op dezelfde perl en architectuur die je al hebt
getest om er zeker van te zijn dat het goed bouwt.

De standaardwaarde is false, en u kunt "--no-notest" zeggen om te overschrijven wanneer dit is ingesteld in de
standaardopties in "PERL_CPANM_OPT".

--test-alleen
Voer alleen de tests uit en installeer niet de opgegeven module of distributies. Handig als
je wilt verifiëren dat de nieuwe (of zelfs oude) releases de unit-tests zonder doorstaan
het installeren van de module.

Houd er rekening mee dat als u deze optie opgeeft met een module of distributie die dat wel heeft
afhankelijkheden, deze afhankelijkheden worden geïnstalleerd als u ze momenteel niet hebt.

-S, --sudo
Schakel over naar de rootgebruiker met "sudo" bij het installeren van modules. Gebruik dit als je dat wilt
installeer modules naar het perl include-pad van het systeem.

De standaardwaarde is false, en u kunt "--no-sudo" zeggen om te overschrijven wanneer dit is ingesteld in de
standaardopties in "PERL_CPANM_OPT".

-v, --uitgebreid
Maakt de uitvoer uitgebreid. Het maakt ook de interactieve configuratie mogelijk. (Zien
--interactief)

-q, --stil
Maakt de uitvoer nog stiller dan de standaardinstelling. Het laat alleen de succesvolle/mislukte zaken zien
afhankelijkheden van de output.

-l, --local-lib
Stelt het local::lib-compatibele pad in waarnaar de modules moeten worden geïnstalleerd. U hoeft dit niet in te stellen
als u de shell-omgevingsvariabelen al configureert met local::lib, maar this
kan ook worden gebruikt om dat te overschrijven.

-L, --local-lib-bevat
Hetzelfde met "--local-lib" maar met --self-contained set. Alle niet-kernafhankelijkheden zullen dat wel doen
worden geïnstalleerd, zelfs als ze al zijn geïnstalleerd.

Bijvoorbeeld,

cpanm -L extlib Plack

zou Plack en al zijn niet-kernafhankelijkheden in de map "extlib" installeren,
die vanuit uw applicatie kan worden geladen met:

gebruik local::lib '/pad/naar/extlib';

Let op: deze optie doet: NIET betrouwbaar werken met perl-installaties geleverd door
leveranciers van besturingssystemen die standaardmodules van perl verwijderen, zoals RHEL, Fedora
en CentOS, TENZIJ je installeert ook pakketten die alle modules leveren die zijn geweest
gestript. Voor deze systemen zult u waarschijnlijk de "perl-core" meta-
pakket dat precies dat doet.

--op zichzelf staand
Wanneer u de afhankelijkheden onderzoekt, ga er dan van uit dat er geen niet-kernmodules zijn geïnstalleerd op de
systeem. Handig als u applicatie-afhankelijkheden in één directory wilt bundelen zodat u
kan distribueren naar andere machines.

--exclusief-leverancier
Voeg geen modules toe die zijn geïnstalleerd onder de 'leverancier'-paden bij het zoeken naar core
modules wanneer de vlag "--self-contained" van kracht is. Hierdoor herstelt het gedrag
van vóór versie 1.7023

--spiegel
Specificeert de basis-URL die de CPAN-spiegelserver moet gebruiken, zoals
"http://cpan.cpantesters.org/" (u kunt de laatste schuine streep weglaten). U kunt dit specificeren
meerdere spiegel-URL's door de opdrachtregeloptie te herhalen.

U kunt een lokale map gebruiken die een CPAN-spiegelstructuur heeft (gemaakt door tools zoals
zoals OrePAN of Pinto) met behulp van een speciaal URL-schema "file://". Als de opgegeven URL begint
met `/` (zonder enig schema), wordt het ook als een bestandsschema beschouwd.

cpanm --mirror bestand:///pad/naar/mirror
cpanm --spiegel ~/minipan # Omdat shell ~ uitbreidt naar /home/user

Standaard ingesteld op "http://www.cpan.org/".

--alleen-spiegel
Download het indexbestand 02packages.details.txt.gz van de mirror in plaats van het
CPAN MetaDB. Hiermee kunt u er ook effectief voor kiezen om uw lokale perl-versies niet naar te verzenden
backend-databaseservers zoals CPAN Meta DB en MetaCPAN.

Selecteer deze optie als u een lokale CPAN-spiegelserver gebruikt, zoals minicpan wanneer
je bent offline, of je eigen CPAN-index (ook wel darkpan genoemd).

--van, -M
cpanm -M https://cpan.metacpan.org/
cpanm --van https://cpan.metacpan.org/

Gebruik de opgegeven mirror-URL en de bijbehorende index als de Slechts bron om te zoeken en te downloaden
modulen van.

Het werkt hetzelfde als "--mirror" en "--mirror-only" gecombineerd, met een klein verschil:
in tegenstelling tot "--mirror" die voegt de URL naar de lijst met spiegelservers, "--from" (of "-M" voor
short) gebruikt de opgegeven URL als zijn Slechts bron om de index en modules van te downloaden.
Hierdoor overschrijft de optie altijd de standaardspiegel die mogelijk is ingesteld
via globale opties zoals die ingesteld door de omgevingsvariabele "PERL_CPANM_OPT".

Tip: Het kan handig zijn als u deze opties een naam geeft met uw shell-aliassen, zoals:

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

--spiegelindex
Experimenteel: Specificeert het bestandspad naar "02packages.details.txt" voor het zoeken naar modules
index.

--cpanmetadb
Experimenteel: specificeert een alternatieve URI voor zoekopdrachten naar de CPAN MetaDB-index.

--metacpan
Geeft de voorkeur aan MetaCPAN API boven CPAN MetaDB.

--cpanbestand
Experimenteel: een alternatief pad opgegeven waarnaar cpanfile moet zoeken, wanneer
De opdracht "--installdeps" is in gebruik. Standaard ingesteld op "cpanfile".

--snel
Geeft een melding wanneer een test mislukt, zodat u de installatie kunt overslaan, de installatie kunt forceren, het opnieuw kunt proberen of in het bestand kunt kijken
shell om te zien wat er misgaat. Er wordt ook gevraagd wanneer een van de afhankelijkheid is mislukt
u wilt doorgaan met de installatie.

Standaard ingesteld op false, en u kunt "--no-prompt" zeggen om te overschrijven als dit is ingesteld in de
standaardopties in "PERL_CPANM_OPT".

--ontwikkelaar
Experimenteel: zoek ook naar een nieuwere ontwikkelaarsrelease. Standaard ingesteld op onwaar.

--opnieuw installeren
cpanm, wanneer er een modulenaam wordt gegeven in de opdrachtregel (dwz "cpanm Plack"), controleert de
lokaal geïnstalleerde versie eerst en slaat deze over als deze al is geïnstalleerd. Deze optie
zorgt ervoor dat het de controle overslaat, dus:

cpanm --installeer Plack opnieuw

zou Plack opnieuw installeren, zelfs als uw lokaal geïnstalleerde versie de nieuwste of zelfs nieuwer is
(wat zou gebeuren als u een ontwikkelaarsrelease installeert vanuit versiebeheer
opslagplaatsen).

Standaard ingesteld op onwaar.

--interactief
Maakt de configuratie (zoals "Makefile.PL" en "Build.PL") interactief, zodat u dat kunt
beantwoord vragen in de distributie waarvoor aangepaste configuratie of taak vereist is:
distributies.

De standaardwaarde is false, en u kunt '--no-interactive' zeggen om te overschrijven wanneer dit is ingesteld in de
standaardopties in "PERL_CPANM_OPT".

--pp, --pureperl
Geef de voorkeur aan Pure perl-build van modules door "PUREPERL_ONLY=1" in te stellen voor MakeMaker en
"--pureperl-only" voor op Build.PL gebaseerde distributies. Merk op dat niet alle CPAN
modules ondersteunen deze conventie nog.

--met-beveelt, --met-suggereert
Experimenteel: Installeert afhankelijkheden gedeclareerd als "aanbevolen" en "suggereert"
respectievelijk, volgens META-specificatie. Wanneer deze afhankelijkheden niet kunnen worden geïnstalleerd, gaat cpanm door
de installatie, omdat het slechts een aanbeveling/suggestie is.

Als u dit inschakelt, kan er mogelijk een circulaire afhankelijkheid ontstaan ​​voor een paar modules van CPAN,
wanneer "aanbeveelt" een module wordt toegevoegd die de module in ruil daarvoor "aanbeveelt".

Er zijn ook "--without-recommend" en "--without-suggests" om de standaard te overschrijven
eerder genomen beslissing in "PERL_CPANM_OPT".

Standaard ingesteld op false voor beide.

--met-ontwikkelen
Experimenteel: Installeert ontwikkelingsfase-afhankelijkheden in META-bestanden of "cpanfile" wanneer
gebruikt met "--installdeps". Standaard ingesteld op false.

--met-functie, --zonder-functie, --met-alle-functies
Experimenteel: specificeert de functie die moet worden ingeschakeld als een module optionele functies ondersteunt
volgens META-specificatie 2.0.

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

de functies kunnen ook interactief worden gekozen als de optie "--interactief" is ingeschakeld.

"--with-all-features" schakelt alle optionele functies in, en "--without-feature" kan dat wel
selecteer een functie die u wilt uitschakelen.

--configure-time-out, --build-time-out, --test-time-out
Geef de time-outlengte (in seconden) op voor het wachten op configureren, bouwen en testen
proces. De huidige standaardwaarden zijn: 60 voor configureren, 3600 voor build en 1800 voor
test.

--configure-args, --build-args, --test-args, --install-args
Experimenteel: Geef argumenten door voor respectievelijk configure/build/test/install-opdrachten,
voor een bepaalde module om te installeren.

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

Het argument is alleen ingeschakeld voor de module die als opdrachtregelargument wordt doorgegeven, niet
afhankelijkheden.

--scandeps
VEROUDERD: Scant de afhankelijkheden van bepaalde modules en voert de boom uit in een tekst
formaat. (Zie "--formaat" hieronder voor meer opties)

Omdat deze opdracht feitelijk geen distributies installeert, zal het nuttig zijn
dat door te typen:

cpanm --scandeps Katalysator::Runtime

u kunt er zeker van zijn welke modules worden geïnstalleerd.

Deze opdracht houdt rekening met welke modules je al hebt geïnstalleerd in je
systeem. Als je wilt zien welke modules tegen een vanille-perl worden geïnstalleerd
installatie, wilt u dit misschien combineren met de "-L" optie.

--formaat
VEROUDERD: Bepaalt welk formaat de gescande afhankelijkheidsboom moet weergeven. Beschikbaar
opties zijn "tree", "json", "yaml" en "dists".

boom Geeft de boom weer in platte tekst. Dit is de standaardwaarde.

json, yaml
Voert de boom uit in een JSON- of YAML-indeling. JSON- en YAML-modules moeten dat zijn
respectievelijk geïnstalleerd. De uitvoerboom wordt weergegeven als een recursieve tuple
van:

[ distributie, afhankelijkheden ]

en de container is een array die de rootelementen bevat. Merk op dat daar
kunnen meerdere hoofdknooppunten zijn, omdat u meerdere modules aan de
"--scandeps"-opdracht.

dists "dists" is een speciaal uitvoerformaat, waarin de bestandsnaam van de distributie wordt afgedrukt
in de diepte eerste bestellen na de afhankelijkheidsresolutie, zoals:

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

wat betekent dat u deze distributies zonder extra kosten in deze volgorde kunt installeren
afhankelijkheden. In combinatie met de optie "-L" is het handig om opnieuw af te spelen
installaties op andere machines.

--opslaan-afst
Specificeert het optionele directorypad om gedownloade tarballs naar de CPAN-mirror te kopiëren
compatibele mapstructuur, dwz auteurs/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

Als de distro-tarball niet afkomstig is van CPAN, bijvoorbeeld uit een lokaal bestand of uit
GitHub, dan wordt het opgeslagen onder leverancier/Foo-Bar-version.tar.gz.

--uninst-schaduwen
Verwijdert de schaduwbestanden van de distributie die u installeert. Dit
elimineert de verwarring als u kernmodules (dual-life) probeert te installeren
CPAN tegen perl 5.10 of ouder, of modules die voorheen XS-gebaseerd waren maar daarnaar zijn overgestapt
pure perl in een bepaalde versie.

Als u cpanm als root uitvoert en "INSTALL_BASE" of een equivalent daarvan gebruikt om custom
installatiepad, MOET u deze optie uitschakelen, zodat u niet per ongeluk de installatie ongedaan maakt
dual-life modules uit de kern omvatten pad.

Standaard ingesteld op true als uw perl-versie kleiner is dan 5.12, en u kunt dit uitschakelen
met "--no-uninst-shadows".

NOTITIE: Sinds versie 1.3000 is deze vlag standaard uitgeschakeld voor perl nieuwer dan
5.12, omdat @INC in 5.12 de map site_perl bevat vaardigheden de perl core-bibliotheek
pad, en het verwijderen van schaduwen is niet meer nodig en veroorzaakt meer schade door het verwijderen
bestanden uit het kernbibliotheekpad.

--verwijderen, -U
Verwijdert een module uit het bibliotheekpad. Het vindt een paklijst voor bepaalde modules, en
verwijdert alle bestanden in dezelfde distributie.

Als u local::lib inschakelt, worden alleen bestanden uit de map local::lib verwijderd.

Als u probeert een module in de map "perl" (dat wil zeggen de kernmodule) te verwijderen, zal er een fout optreden
gegooid worden.

Er wordt een dialoogvenster gevraagd om de te verwijderen bestanden te bevestigen. Als u de optie "-f" doorgeeft
ook wordt het dialoogvenster overgeslagen en wordt het verwijderen geforceerd.

--cascade-zoeken
Experimenteel: specificeert of er trapsgewijs moet worden gezocht als u meerdere spiegelservers opgeeft
en een spiegel heeft geen module of heeft een lagere versie van de module dan
aangevraagd. Standaard ingesteld op onwaar.

--skip-geïnstalleerd
Specificeert of een module die op de opdrachtregel wordt gegeven, wordt overgeslagen als de nieuwste versie ervan is
is al geïnstalleerd. Standaard ingesteld op waar.

NOTITIE: De omgevingsvariabele "PERL5LIB" moet correct zijn ingesteld om dit te laten werken
met modules geïnstalleerd met local::lib, tenzij je altijd de "-l" optie gebruikt.

--skip-tevreden
Experimenteel: Specificeert of een module (en versie) op de opdrachtregel wordt opgegeven
overgeslagen als het al is geïnstalleerd.

Als je loopt:

cpanm --skip-tevreden CGI DBI~1.2

cpanm zal ze niet installeren als je al CGI hebt (voor welke versie dan ook) of DBI hebt
met versie hoger dan 1.2. Het is vergelijkbaar met "--skip-installed", maar terwijl
"--skip-installed" controleert of de laatste versie van CPAN is geïnstalleerd,
"--skip-satisfied" controleert of een aangevraagde versie (of niet, wat betekent dat welke versie dan ook)
geïnstalleerd.

Standaard ingesteld op onwaar.

--verifiëren
Controleer de integriteit van distributiebestanden die zijn opgehaald uit PAUSE met behulp van CHECKSUMS en
HANDTEKENINGEN (indien gevonden). Standaard ingesteld op false.

--rapport-perl-versie
Of het de lokaal geïnstalleerde perl-versie rapporteert aan de verschillende webservers
onderdeel van User-Agent. Standaard ingesteld op true tenzij CI-gerelateerde omgevingsvariabelen zoals
"TRAVIS", "CI" of "AUTOMATED_TESTING" is ingeschakeld. U kunt het uitschakelen door te gebruiken
"--geen-rapport-perl-versie".

--automatische opschoning
Specificeert het aantal dagen waarin de werkmappen van cpanm verlopen. Standaard ingesteld op 7,
wat betekent dat oude werkmappen binnen een week worden opgeruimd.

U kunt de waarde instellen op 0 om ervoor te zorgen dat cpan deze mappen nooit opruimt.

--man-pagina's
Genereert manpagina's voor uitvoerbare bestanden (man1) en bibliotheken (man3).

Standaard ingesteld op true (man-pagina's gegenereerd) tenzij de optie "-L|--local-lib-contained" is
opgegeven, in welk geval het is ingesteld op false. Je kunt het uitschakelen met "--no-man-pages".

--lwp
Gebruikt de LWP-module om dingen via HTTP te downloaden. Standaard ingesteld op waar, en dat kun je zeggen
"--no-lwp" om het gebruik van LWP uit te schakelen, wanneer u LWP van CPAN wilt upgraden op een kapotte
perl-systemen.

--wget
Gebruikt GNU Wget (indien beschikbaar) om dingen te downloaden. Standaard ingesteld op waar, en dat kun je zeggen
"--no-wget" om het gebruik van Wget uit te schakelen (versies van Wget ouder dan 1.9 ondersteunen de
"--retry-connrefused" optie gebruikt door cpanm).

--Krul
Gebruikt cURL (indien beschikbaar) om dingen te downloaden. Standaard ingesteld op waar, en dat kun je zeggen
"--no-curl" om het gebruik van cURL uit te schakelen.

Normaal gesproken met "--lwp", "--wget" en "--curl" opties ingesteld op true (wat de
standaard) cpanm probeert LWP, Wget, cURL en HTTP::Tiny (in die volgorde) en gebruikt de eerste
één beschikbaar.

Gebruik cpanmp online met behulp van onworks.net-services