cpanmp – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

cpanm – Build-Module aus CPAN abrufen, entpacken und installieren

ZUSAMMENFASSUNG

cpanm Test::More # install Test::More
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # vollständiger Verteilungspfad
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # Von URL installieren
cpanm ~/dists/MyCompany-Enterprise-1.00.tar.gz # von einer lokalen Datei installieren
cpanm --interactive Task::Kensho # Interaktiv konfigurieren
cpanm . # aus lokalem Verzeichnis installieren
cpanm --installdeps . # alle Deps für das aktuelle Verzeichnis installieren
cpanm -L extlib Plack # Plack und alle nicht zum Kern gehörenden Deps in Extlib installieren
cpanm --mirror http://cpan.cpantesters.org/ DBI # verwenden Sie den schnellsynchronisierenden Spiegel
cpanm --von https://cpan.metacpan.org/ Plack # Verwenden Sie nur den HTTPS-Spiegel

BEFEHLE

(Argumente)
Befehlszeilenargumente können entweder ein Modulname, eine Verteilungsdatei oder eine lokale Datei sein
Pfad, HTTP-URL oder Git-Repository-URL. Die folgenden Befehle funktionieren alle wie erwartet.

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

Darüber hinaus können Sie die Notation mit „~“ und „@“ verwenden, um die Version für a anzugeben
gegebenes Modul. „~“ gibt die Versionsanforderung im CPAN::Meta::Spec-Format an,
während „@“ die genaue Version anheftet und eine Abkürzung für „~“== VERSION“ ist.

cpanm Plack~1.0000 # 1.0000 oder höher
cpanm Plack~">= 1.0000, < 2.0000" # aktuellste Version von 1.xxxx
cpanm [E-Mail geschützt] # spezifische Version. wie Plack~"== 0.9990"

Die Versionsabfrage einschließlich einer bestimmten Version oder eines bestimmten Bereichs wird an MetaCPAN gesendet
Suche nach früheren Veröffentlichungen. Die Abfrage sucht standardmäßig nach BackPAN-Archiven.
Sofern Sie nicht die Option „--dev“ angeben, werden archivierte Versionen in diesem Fall gefiltert
out.

Für ein Git-Repository können Sie einen Branch, ein Tag oder einen Commit-SHA zum Erstellen angeben. Der
Standard ist „Master“

cpanm git://github.com/plack/[E-Mail geschützt] # Schild
cpanm git://github.com/plack/Plack.git@devel # Zweig

-i, --install
Installiert die Module. Dies ist ein Standardverhalten und dient lediglich der Kompatibilität
Option, damit es wie cpan oder cpanp funktioniert.

--Selbst-Upgrade
Aktualisiert sich selbst. Es ist nur ein Alias ​​für:

cpanm App::cpanminus

--die Info
Zeigt die Verteilungsinformationen im Format „AUTHOR/Dist-Name-ver.tar.gz“ im an
Standard aus.

--installdeps
Installiert die Abhängigkeiten der Zielverteilung, erstellt sich jedoch nicht selbst. Praktisch, wenn
Sie möchten die Anwendung aus einem versionierten Repository wie Git ausprobieren.

cpanm --installdeps .

--sehen
Laden Sie die Distribution herunter, entpacken Sie sie und öffnen Sie dann das Verzeichnis mit Ihrer Shell.
Praktisch, um im Quellcode herumzustöbern oder manuelle Tests durchzuführen.

-h, --Hilfe
Zeigt die Hilfemeldung an.

-V, --Version
Zeigt die Versionsnummer an.

OPTIONAL

Sie können die Standardoptionen in der Umgebungsvariablen „PERL_CPANM_OPT“ angeben.

-f, --force
Erzwingen Sie die Installation von Modulen, auch wenn der Test fehlgeschlagen ist.

-n, --notest
Überspringen Sie das Testen von Modulen. Verwenden Sie dies nur, wenn Sie einfach nur Zeit sparen möchten
Hunderte von Distributionen auf demselben Perl und derselben Architektur installieren, die Sie bereits haben
Getestet, um sicherzustellen, dass es einwandfrei funktioniert.

Der Standardwert ist „false“, und Sie können „--no-notest“ sagen, um es zu überschreiben, wenn es in festgelegt ist
Standardoptionen in „PERL_CPANM_OPT“.

--test-only
Führen Sie nur die Tests aus und installieren Sie nicht das angegebene Modul oder die angegebenen Distributionen. Praktisch, wenn
Sie möchten überprüfen, ob die neuen (oder sogar alten) Versionen die Unit-Tests ohne bestehen
Installation des Moduls.

Beachten Sie Folgendes: Wenn Sie diese Option mit einem Modul oder einer Distribution angeben, die über Folgendes verfügt:
Abhängigkeiten: Diese Abhängigkeiten werden installiert, wenn Sie sie derzeit nicht haben.

-S, --sudo
Wechseln Sie bei der Installation von Modulen mit „sudo“ zum Root-Benutzer. Verwenden Sie dies, wenn Sie möchten
Installieren Sie Module im System-Perl-Include-Pfad.

Der Standardwert ist „false“, und Sie können „--no-sudo“ sagen, um es zu überschreiben, wenn es in festgelegt ist
Standardoptionen in „PERL_CPANM_OPT“.

-v, --verbose
Macht die Ausgabe ausführlich. Es ermöglicht auch die interaktive Konfiguration. (Sehen
--interaktiv)

-q, --leise
Macht die Ausgabe noch leiser als die Standardeinstellung. Es werden nur Erfolge/Fehlschläge angezeigt
Abhängigkeiten zur Ausgabe.

-l, --local-lib
Legt den mit local::lib kompatiblen Pfad fest, in dem Module installiert werden sollen. Sie müssen dies nicht festlegen
wenn Sie die Shell-Umgebungsvariablen bereits mit local::lib konfigurieren, aber dies
kann auch verwendet werden, um dies zu überschreiben.

-L, --local-lib-contained
Das Gleiche gilt für „--local-lib“, jedoch mit dem Satz „--self-contained“. Alle nicht zum Kern gehörenden Abhängigkeiten werden dies tun
installiert werden, auch wenn sie bereits installiert sind.

Zum Beispiel

cpanm -L extlib Plack

würde Plack und alle seine nicht zum Kern gehörenden Abhängigkeiten im Verzeichnis „extlib“ installieren,
die aus Ihrer Anwendung geladen werden kann mit:

use local::lib '/path/to/extlib';

Beachten Sie, dass diese Option NICHT Funktioniert zuverlässig mit Perl-Installationen von
Betriebssystemanbieter, die Standardmodule aus Perl entfernen, wie z. B. RHEL, Fedora
und CentOS, ES SEI DENN Sie installieren auch Pakete, die alle vorhandenen Module bereitstellen
ausgezogen. Für diese Systeme möchten Sie wahrscheinlich die Metadatei „perl-core“ installieren.
Paket, das genau das tut.

--in sich geschlossen
Gehen Sie bei der Untersuchung der Abhängigkeiten davon aus, dass auf dem keine Nicht-Kernmodule installiert sind
System. Praktisch, wenn Sie Anwendungsabhängigkeiten in einem Verzeichnis bündeln möchten
Kann auf andere Maschinen verteilt werden.

--exclude-vendor
Berücksichtigen Sie bei der Suche nach dem Kern keine Module, die unter den „Anbieter“-Pfaden installiert sind
Module, wenn das Flag „--self-contained“ aktiviert ist. Dadurch wird das Verhalten wiederhergestellt
von vor Version 1.7023

--Spiegel
Gibt die Basis-URL an, die der CPAN-Spiegel verwenden soll, z. B
"http://cpan.cpantesters.org/" (Sie können den abschließenden Schrägstrich weglassen). Sie können angeben
Mehrere Spiegel-URLs durch Wiederholen der Befehlszeilenoption.

Sie können ein lokales Verzeichnis verwenden, das über eine CPAN-Spiegelstruktur verfügt (erstellt durch Tools wie z
wie OrePAN oder Pinto) mithilfe eines speziellen URL-Schemas „file://“. Wenn die angegebene URL beginnt
mit `/` (ohne Schema) wird es ebenfalls als Dateischema betrachtet.

cpanm --mirror file:///path/to/mirror
cpanm --mirror ~/minicpan # Weil die Shell ~ zu /home/user erweitert

Standardmäßig ist „http://www.cpan.org/".

--nur Spiegel
Laden Sie die Indexdatei 02packages.details.txt.gz des Spiegels herunter, anstatt die abzufragen
CPAN Meta DB. Dadurch wird auch effektiv verhindert, dass Ihre lokalen Perl-Versionen an gesendet werden
Backend-Datenbankserver wie CPAN Meta DB und MetaCPAN.

Wählen Sie diese Option, wenn Sie einen lokalen CPAN-Spiegel verwenden, z. B. minicpan when
Sie sind offline oder Ihr eigener CPAN-Index (auch bekannt als Darkpan).

--von, -M
cpanm -M https://cpan.metacpan.org/
cpanm – von https://cpan.metacpan.org/

Verwenden Sie die angegebene Spiegel-URL und ihren Index als einzige Quelle zum Suchen und Herunterladen
Module von.

Es funktioniert ähnlich wie „--mirror“ und „--mirror-only“ kombiniert, mit einem kleinen Unterschied:
im Gegensatz zu „--mirror“, das hängt an die URL zur Liste der Spiegel, „--from“ (oder „-M“ für
kurz) verwendet die angegebene URL als seine einzige Quelle zum Herunterladen von Index und Modulen.
Dadurch überschreibt die Option immer den Standardspiegel, der möglicherweise festgelegt wurde
über globale Optionen wie die, die durch die Umgebungsvariable „PERL_CPANM_OPT“ festgelegt wird.

TIPP: Es könnte nützlich sein, wenn Sie diese Optionen mit Ihren Shell-Aliassen benennen, wie zum Beispiel:

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

--mirror-index
EXPERIMENTAL: Gibt den Dateipfad zu „02packages.details.txt“ für die Modulsuche an
Index.

--cpanmetadb
EXPERIMENTAL: Gibt einen alternativen URI für CPAN-MetaDB-Indexsuchen an.

--metacpan
Bevorzugt die MetaCPAN-API gegenüber der CPAN-MetaDB.

--cpanfile
EXPERIMENTAL: Es wurde ein alternativer Pfad angegeben, nach dem cpanfile wann suchen soll
Der Befehl „--installdeps“ wird verwendet. Der Standardwert ist „cpanfile“.

--prompt
Fordert Sie auf, wenn ein Test fehlschlägt, sodass Sie ihn überspringen, die Installation erzwingen, es erneut versuchen oder nachschauen können
Shell, um zu sehen, was falsch läuft. Außerdem wird eine Meldung angezeigt, wenn eine der Abhängigkeiten fehlgeschlagen ist
Sie möchten mit der Installation fortfahren.

Der Standardwert ist „false“, und Sie können „--no-prompt“ sagen, um es zu überschreiben, wenn es in festgelegt ist
Standardoptionen in „PERL_CPANM_OPT“.

--dev
EXPERIMENTAL: Suchen Sie auch nach einer neueren Entwicklerversion. Der Standardwert ist „false“.

--reinstall
cpanm überprüft, wenn in der Befehlszeile ein Modulname angegeben wird (z. B. „cpanm Plack“)
Zuerst wird die lokal installierte Version aufgerufen und übersprungen, wenn sie bereits installiert ist. Diese Option
lässt die Prüfung überspringen, also:

cpanm --Plack neu installieren

würde Plack neu installieren, selbst wenn Ihre lokal installierte Version die neueste oder sogar neuere Version ist
(was passieren würde, wenn Sie eine Entwicklerversion über die Versionskontrolle installieren
Repositories).

Der Standardwert ist falsch.

--interaktiv
Macht die Konfiguration (z. B. „Makefile.PL“ und „Build.PL“) interaktiv, sodass Sie dies tun können
Beantworten Sie Fragen in der Distribution, die eine benutzerdefinierte Konfiguration oder Aufgabe erfordern::
Verteilungen.

Der Standardwert ist „false“, und Sie können „--no-interactive“ sagen, um es zu überschreiben, wenn es in festgelegt ist
Standardoptionen in „PERL_CPANM_OPT“.

--pp, --pureperl
Bevorzugen Sie den reinen Perl-Build von Modulen, indem Sie „PUREPERL_ONLY=1“ für MakeMaker und festlegen
„--pureperl-only“ für Build.PL-basierte Distributionen. Beachten Sie, dass nicht alle CPAN
Module unterstützen diese Konvention noch.

--with-recommends, --with-suggests
EXPERIMENTAL: Installiert Abhängigkeiten, die als „empfohlen“ und „empfohlen“ deklariert sind.
bzw. gemäß META-Spezifikation. Wenn die Installation dieser Abhängigkeiten fehlschlägt, wird cpanm fortgesetzt
die Installation, da es sich lediglich um eine Empfehlung/Vorschlag handelt.

Durch die Aktivierung könnte möglicherweise eine zirkuläre Abhängigkeit für einige Module von CPAN entstehen.
Wenn „empfohlen“ ein Modul hinzufügt, das das Modul im Gegenzug „empfiehlt“.

Es gibt auch „--without-recommend“ und „--without-suggests“, um die Standardeinstellung zu überschreiben
Entscheidung wurde zuvor in „PERL_CPANM_OPT“ getroffen.

Der Standardwert ist für beide Werte „false“.

--with-develop
EXPERIMENTAL: Installiert Entwicklungsphasenabhängigkeiten in META-Dateien oder „cpanfile“, wenn
Wird mit „--installdeps“ verwendet. Der Standardwert ist „false“.

--with-feature, --without-feature, --with-all-features
EXPERIMENTAL: Gibt die zu aktivierende Funktion an, wenn ein Modul optionale Funktionen unterstützt
gemäß META-Spezifikation 2.0.

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

Die Funktionen können auch interaktiv ausgewählt werden, wenn die Option „--interactive“ aktiviert ist.

„--with-all-features“ aktiviert alle optionalen Funktionen und „--without-feature“ kann
Wählen Sie eine Funktion aus, die Sie deaktivieren möchten.

--configure-timeout, --build-timeout, --test-timeout
Geben Sie die Timeout-Länge (in Sekunden) an, die auf die Konfiguration, den Build und den Test gewartet werden soll
Verfahren. Aktuelle Standardwerte sind: 60 für „Configure“, 3600 für „Build“ und 1800 für
Test.

--configure-args, --build-args, --test-args, --install-args
EXPERIMENTAL: Übergeben Sie jeweils Argumente für die Befehle configure/build/test/install.
für die Installation eines bestimmten Moduls.

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

Das Argument ist nur für das als Befehlszeilenargument übergebene Modul aktiviert, nicht jedoch
Abhängigkeiten.

--scandeps
DEPARCATED: Scannt die Abhängigkeiten bestimmter Module und gibt den Baum in einem Text aus
Format. (Weitere Optionen finden Sie unter „--format“ unten.)

Da dieser Befehl eigentlich keine Distributionen installiert, ist er nützlich
das durch Eingabe von:

cpanm --scandeps Catalyst::Runtime

Sie können sicherstellen, welche Module installiert werden.

Dieser Befehl berücksichtigt, welche Module Sie bereits in Ihrem installiert haben
System. Wenn Sie sehen möchten, welche Module gegen ein Vanilla-Perl installiert werden
Bei der Installation möchten Sie es möglicherweise mit der Option „-L“ kombinieren.

--Format
DEPARCATED: Bestimmt, welches Format der gescannte Abhängigkeitsbaum angezeigt werden soll. Verfügbar
Optionen sind „tree“, „json“, „yaml“ und „dists“.

Baum Zeigt den Baum im Nur-Text-Format an. Dies ist der Standardwert.

json, yaml
Gibt den Baum im JSON- oder YAML-Format aus. JSON- und YAML-Module müssen es sein
jeweils installiert. Der Ausgabebaum wird als rekursives Tupel dargestellt
der:

[Verteilung, Abhängigkeiten]

und der Container ist ein Array, das die Stammelemente enthält. Beachten Sie, dass dort
Es kann sich um mehrere Root-Knoten handeln, da Sie dem mehrere Module zuweisen können
Befehl „--scandeps“.

dists „dists“ ist ein spezielles Ausgabeformat, in dem der Dateiname der Distribution ausgegeben wird
der Tiefe zuerst Auftrag nach der Abhängigkeitsauflösung, wie:

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

Das bedeutet, dass Sie diese Distributionen in dieser Reihenfolge ohne Extras installieren können
Abhängigkeiten. In Kombination mit der Option „-L“ ist die Wiedergabe hilfreich
Installationen auf anderen Maschinen.

--save-dists
Gibt den optionalen Verzeichnispfad zum Kopieren heruntergeladener Tarballs im CPAN-Spiegel an
kompatible Verzeichnisstruktur, d. h Authors/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

Wenn der Distributions-Tarball nicht von CPAN stammt, beispielsweise aus einer lokalen Datei oder von
GitHub, dann wird es unter gespeichert Vendor/Foo-Bar-version.tar.gz.

--uninst-shadows
Deinstalliert die Schattendateien der Distribution, die Sie installieren. Das
beseitigt die Verwirrung, wenn Sie versuchen, Kernmodule (Dual-Life) von zu installieren
CPAN gegen Perl 5.10 oder älter oder Module, die früher XS-basiert waren, aber auf diese umgestiegen sind
reines Perl in irgendeiner Version.

Wenn Sie cpanm als Root ausführen und „INSTALL_BASE“ oder ein Äquivalent verwenden, um „custom“ anzugeben
Installationspfad verwenden, SOLLTEN Sie diese Option deaktivieren, damit Sie nicht versehentlich deinstallieren
Dual-Life-Module aus dem Kern enthalten Pfad.

Der Standardwert ist „true“, wenn Ihre Perl-Version kleiner als 5.12 ist, und Sie können dies deaktivieren
mit „--no-uninst-shadows“.

HINWEIS: Seit Version 1.3000 ist dieses Flag für Perl neuer als standardmäßig deaktiviert
5.12, da @INC ab 5.12 das Verzeichnis site_perl enthält Bevor Die Perl-Kernbibliothek
Pfad, und das Deinstallieren von Shadows ist nicht mehr notwendig und verursacht durch das Löschen mehr Schaden
Dateien aus dem Kernbibliothekspfad.

--uninstall, -U
Deinstalliert ein Modul aus dem Bibliothekspfad. Es findet eine Packliste für bestimmte Module und
Entfernt alle in derselben Distribution enthaltenen Dateien.

Wenn Sie local::lib aktivieren, werden nur Dateien aus dem Verzeichnis local::lib entfernt.

Wenn Sie versuchen, ein Modul im Verzeichnis „perl“ (z. B. das Kernmodul) zu deinstallieren, wird ein Fehler angezeigt
geworfen werden.

Es wird ein Dialog zur Bestätigung der zu löschenden Dateien angezeigt. Wenn Sie die Option „-f“ übergeben
Außerdem wird der Dialog übersprungen und die Deinstallation erzwungen.

--cascade-search
EXPERIMENTAL: Gibt an, ob die Suche kaskadiert werden soll, wenn Sie mehrere Spiegel angeben
und ein Spiegel hat kein Modul oder eine niedrigere Version des Moduls als
angefordert. Der Standardwert ist „false“.

--skip-installiert
Gibt an, ob ein in der Befehlszeile angegebenes Modul übersprungen wird, wenn es sich um die neueste Version handelt
Ist bereits installiert. Der Standardwert ist „true“.

HINWEIS: Damit dies funktioniert, muss die Umgebungsvariable „PERL5LIB“ korrekt eingestellt sein
mit Modulen, die mit local::lib installiert wurden, es sei denn, Sie verwenden immer die Option „-l“.

--skip-zufrieden
EXPERIMENTAL: Gibt an, ob ein Modul (und eine Version) in der Befehlszeile angegeben ist
übersprungen, wenn es bereits installiert ist.

Wenn du läufst:

cpanm --skip-satisfied CGI DBI~1.2

cpanm installiert sie nicht, wenn Sie bereits über CGI (für welche Versionen auch immer) oder DBI verfügen
mit Version höher als 1.2. Es ist ähnlich wie „--skip-installed“, aber während
„--skip-installed“ prüft, ob die neueste Version von CPAN installiert ist,
„--skip-satisfied“ prüft, ob eine angeforderte Version (oder nicht, d. h. irgendeine Version) vorhanden ist
installiert.

Der Standardwert ist falsch.

--verifizieren
Überprüfen Sie die Integrität der aus PAUSE abgerufenen Verteilungsdateien mithilfe von CHECKSUMS und
UNTERSCHRIFTEN (falls vorhanden). Der Standardwert ist „false“.

--report-perl-version
Ob es die lokal installierte Perl-Version an die verschiedenen Webserver meldet
Teil von User-Agent. Der Standardwert ist „true“, es sei denn, CI-bezogene Umgebungsvariablen wie z
„TRAVIS“, „CI“ oder „AUTOMATED_TESTING“ ist aktiviert. Sie können es deaktivieren, indem Sie verwenden
„--no-report-perl-version“.

--auto-cleanup
Gibt die Anzahl der Tage an, in denen die Arbeitsverzeichnisse von cpanm ablaufen. Standardmäßig ist 7,
Das bedeutet, dass alte Arbeitsverzeichnisse in einer Woche bereinigt werden.

Sie können den Wert auf 0 setzen, damit cpan diese Verzeichnisse nie bereinigt.

--man-pages
Erstellt Manpages für ausführbare Dateien (man1) und Bibliotheken (man3).

Der Standardwert ist „true“ (Manpages werden generiert), es sei denn, die Option „-L|--local-lib-contained“ ist aktiviert
angegeben. In diesem Fall wird es auf „false“ gesetzt. Sie können es mit „--no-man-pages“ deaktivieren.

--lwp
Verwendet das LWP-Modul, um Inhalte über HTTP herunterzuladen. Der Standardwert ist „true“, und das können Sie sagen
„--no-lwp“, um die Verwendung von LWP zu deaktivieren, wenn Sie LWP von CPAN auf einem defekten Gerät aktualisieren möchten
Perl-Systeme.

--wget
Verwendet GNU Wget (falls verfügbar), um Inhalte herunterzuladen. Der Standardwert ist „true“, und das können Sie sagen
„--no-wget“, um die Verwendung von Wget zu deaktivieren (Versionen von Wget, die älter als 1.9 sind, unterstützen das nicht
Option „--retry-connrefused“, die von cpanm verwendet wird).

--locken
Verwendet cURL (falls verfügbar), um Inhalte herunterzuladen. Der Standardwert ist „true“, und das können Sie sagen
„--no-curl“, um die Verwendung von cURL zu deaktivieren.

Normalerweise sind die Optionen „--lwp“, „--wget“ und „--curl“ auf „true“ gesetzt (was der Fall ist).
Standardmäßig versucht cpanm LWP, Wget, cURL und HTTP::Tiny (in dieser Reihenfolge) und verwendet das erste
eine verfügbar.

Verwenden Sie cpanmp online über die Dienste von onworks.net