cpanmp - Online in de cloud

PROGRAMMA:

NAAM

cpanm - haal, pak bouw- en installeer modules van CPAN

KORTE INHOUD

cpanm Test::Meer # install 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/MyCompany-Enterprise-1.00.tar.gz # installeren vanuit een lokaal bestand
cpanm --interactive Taak::Kensho # Interactief configureren
cpanm . # installeren vanuit de lokale map
cpanm --installdeps . # installeer alle deps voor de huidige map
cpanm -L extlib Plack # installeer Plack en alle niet-core deps 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, distributiebestand of 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 versie-eis in het CPAN::Meta::Spec-formaat,
terwijl "@" de exacte versie vastzet en een snelkoppeling is voor "~"== VERSION"".

cpanm Plack~1.0000 # 1.0000 of later
cpanm Plack~">= 1.0000, < 2.0000" # laatste van 1.xxxx
cpanm Plak@0.9990 # specifieke versie. hetzelfde als Plack~"== 0.9990"

De versiequery inclusief specifieke versie of bereik wordt naar MetaCPAN gestuurd om
zoek naar eerdere releases. De query zoekt standaard naar BackPAN-archieven,
tenzij u de optie "--dev" specificeert, in welk geval gearchiveerde versies worden gefilterd
uit.

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

cpanm git://github.com/plack/Plack.git@1.0000 # 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 zoals cpan of cpanp.

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

cpanm-app::cpanminus

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

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

cpanm --installdeps .

--kijk
Download en pak de distributie uit en open vervolgens de map met je shell.
Handig om in de broncode te neuzen of handmatig te testen.

-h, --help
Geeft het helpbericht weer.

-V, --versie
Geeft het versienummer weer.

OPTIES

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

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

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

Standaard ingesteld op false, en u kunt "--no-notest" zeggen om te negeren wanneer het is ingesteld in de
standaardopties in "PERL_CPANM_OPT".

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

Merk op dat als u deze optie specificeert met een module of distributie die:
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 wilt
installeer modules op het systeem perl include path.

Standaard ingesteld op false, en u kunt "--no-sudo" zeggen om te negeren wanneer het is ingesteld in de
standaardopties in "PERL_CPANM_OPT".

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

-q, --stil
Maakt de uitvoer nog stiller dan de standaard. Het toont alleen de succesvolle/mislukte
afhankelijkheden van de output.

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

-L, --local-lib-bevat
Hetzelfde met "--local-lib" maar met --self-contained set. Alle niet-kernafhankelijkheden zullen
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 ontdoen, zoals RHEL, Fedora
en CentOS, TENZIJ je installeert ook pakketten die alle modules leveren die zijn
gestript. Voor deze systemen wilt u waarschijnlijk de "perl-core" meta-
pakket dat precies dat doet.

--op zichzelf staand
Ga er bij het onderzoeken van de afhankelijkheden van uit dat er geen niet-kernmodules zijn geïnstalleerd op de
systeem. Handig als u applicatie-afhankelijkheden in één map wilt bundelen, zodat u
kan distribueren naar andere machines.

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

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

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

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

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

--alleen-spiegel
Download het 02packages.details.txt.gz indexbestand van de mirror in plaats van de
CPAN Meta DB. Dit zal er ook voor zorgen dat u uw lokale perl-versies niet naar
backend-databaseservers zoals CPAN Meta DB en MetaCPAN.

Selecteer deze optie als u een lokale mirror van CPAN gebruikt, zoals minicpan when
je bent offline, of je eigen CPAN-index (ook bekend als darkpan).

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

Gebruik de opgegeven spiegel-URL en de index als de alleen bron om te zoeken en te downloaden
modulen van.

Het werkt vergelijkbaar met "--mirror" en "--mirror-only" gecombineerd, met een klein verschil:
in tegenstelling tot "--mirror" die voegt de URL naar de lijst met mirrors, "--from" (of "-M" voor
short) gebruikt de opgegeven URL als zijn alleen source om de index en modules van te downloaden.
Dit zorgt ervoor dat de optie altijd de standaard mirror overschrijft, die mogelijk is ingesteld
via globale opties zoals die ingesteld door "PERL_CPANM_OPT" omgevingsvariabele.

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

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

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

--cpanmetadb
Experimenteel: specificeert een alternatieve URI voor CPAN MetaDB-indexzoekacties.

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

--cpanbestand
Experimenteel: een alternatief pad opgegeven voor cpanfile om naar te zoeken, wanneer
De opdracht "--installdeps" is in gebruik. Standaard ingesteld op "cpanfile".

--snel
Vraagt ​​wanneer een test mislukt, zodat u de installatie kunt overslaan, forceren, opnieuw proberen of in de
shell om te zien wat er mis gaat. Het vraagt ​​ook wanneer een van de afhankelijkheid is mislukt als:
u wilt doorgaan met de installatie.

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

--dev
Experimenteel: zoek ook naar een nieuwere ontwikkelaarsversie. Standaard ingesteld op false.

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

cpanm --Plak opnieuw installeren

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

Standaard ingesteld op false.

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

Standaard ingesteld op false, en u kunt "--no-interactive" zeggen om te negeren wanneer het 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 niet.

--met-beveelt, --met-suggereert
Experimenteel: Installeert afhankelijkheden die zijn gedeclareerd als "recommends" en "suggests"
respectievelijk, volgens META-specificatie. Als deze afhankelijkheden niet kunnen worden geïnstalleerd, gaat cpanm verder
de installatie, aangezien het slechts een aanbeveling/suggestie is.

Als u dit inschakelt, kan dit voor een aantal modules een circulaire afhankelijkheid van CPAN maken,
wanneer "aanbeveelt" een module toevoegt die de module in ruil daarvoor "aanbeveelt".

Er zijn ook "--without-recommend" en "--without-suggests" om de standaardwaarde te overschrijven
beslissing eerder genomen 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 wanneer de optie "--interactief" is ingeschakeld.

"--with-all-features" schakelt alle optionele functies in, en "--with-with-feature" kan
selecteer een functie om uit te schakelen.

--config-time-out, --build-time-out, --test-time-out
Specificeer de time-outlengte (in seconden) om te wachten op het configureren, bouwen en testen
Verwerken. De huidige standaardwaarden zijn: 60 voor configureren, 3600 voor bouwen 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 is doorgegeven als een opdrachtregelargument, niet
afhankelijkheden.

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

Omdat dit commando eigenlijk geen distributies installeert, is het handig
dat door te typen:

cpanm --scandeps Katalysator::Runtime

u kunt ervoor zorgen welke modules worden geïnstalleerd.

Dit commando houdt rekening met welke modules je al hebt geïnstalleerd in je
systeem. Als je wilt zien welke modules zullen worden geïnstalleerd tegen een vanilla perl
installatie, wilt u deze misschien combineren met de optie "-L".

--formaat
VEROUDERD: Bepaalt in welk formaat de gescande afhankelijkheidsstructuur moet worden weergegeven. Beschikbaar
opties zijn "tree", "json", "yaml" en "dists".

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

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

[ distributie, afhankelijkheden ]

en de container is een array die de root-elementen bevat. Merk op dat er
kunnen meerdere root-knooppunten zijn, aangezien u meerdere modules aan de . kunt geven
"--scandeps" commando.

dists "dists" is een speciaal uitvoerformaat, waar het de distributiebestandsnaam afdrukt
functie in het 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 in deze volgorde kunt installeren zonder extra's
afhankelijkheden. In combinatie met de "-L" optie, 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 directorystructuur, d.w.z auteurs/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

Als de distro-tarball niet afkomstig is van CPAN, bijvoorbeeld van een lokaal bestand of van
GitHub, dan wordt het opgeslagen onder leverancier/Foo-Bar-versie.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 van
CPAN tegen perl 5.10 of ouder, of modules die vroeger XS-gebaseerd waren maar zijn overgeschakeld naar
pure perl op een bepaalde versie.

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

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

NOTITIE: Sinds versie 1.3000 is deze vlag standaard uitgeschakeld voor perl nieuwer dan
5.12, aangezien met 5.12 @INC de map site_perl bevat voor de perl-kernbibliotheek
pad, en het verwijderen van schaduwen is niet meer nodig en doet meer kwaad door te verwijderen
bestanden uit het pad van de kernbibliotheek.

--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 directory local::lib verwijderd.

Als u een module in de "perl"-directory (dwz de kernmodule) probeert te verwijderen, verschijnt er een fout
gegooid worden.

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

--cascade-zoeken
Experimenteel: Specificeert of zoeken trapsgewijs moet worden uitgevoerd wanneer u meerdere mirrors opgeeft
en een mirror heeft geen module of heeft een lagere versie van de module dan
aangevraagd. Standaard ingesteld op false.

--skip-geïnstalleerd
Specificeert of een module gegeven in de opdrachtregel wordt overgeslagen als de laatste versie
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.

--overslaan-tevreden
Experimenteel: Specificeert of een module (en versie) gegeven in de opdrachtregel is
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 versies dan ook) of DBI . hebt
met versie hoger dan 1.2. Het is vergelijkbaar met "--skip-installed", maar while
"--skip-installed" controleert of de laatste versie van CPAN is geïnstalleerd,
"--skip-tevredenheid" controleert of een gevraagde versie (of niet, wat elke versie betekent) is
geïnstalleerd.

Standaard ingesteld op false.

--verifiëren
Controleer de integriteit van distributiebestanden die zijn opgehaald uit PAUZE 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 als
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
"--no-report-perl-version".

--automatische opruiming
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 op 0 instellen om ervoor te zorgen dat cpan die mappen nooit opruimt.

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

Standaard ingesteld op true (man-pagina's gegenereerd) tenzij de optie "-L|--local-lib-contained" is
geleverd, 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 true, en je kunt zeggen
"--no-lwp" om het gebruik van LWP uit te schakelen, wanneer u LWP wilt upgraden van CPAN op een aantal defecte
perl-systemen.

--wget
Gebruikt GNU Wget (indien beschikbaar) om dingen te downloaden. Standaard ingesteld op true, en je kunt 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 true, en je kunt 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
een beschikbaar.

Gebruik cpanmp online met onworks.net-services