cpanmp - En ligne dans le Cloud

PROGRAMME:

Nom

cpanm - obtenir, décompresser et installer les modules de CPAN

SYNOPSIS

cpanm Test ::Plus # install Test ::Plus
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # chemin de distribution complet
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # installer à partir de l'URL
cpanm ~/dists/MyCompany-Enterprise-1.00.tar.gz # installer à partir d'un fichier local
cpanm --interactive Task::Kensho # Configurer de manière interactive
cpanm. # installer à partir du répertoire local
cpanm --installdeps . # installer tous les deps pour le répertoire courant
cpanm -L extlib Plack # installe Plack et tous les deps non essentiels dans extlib
cpanm --miroir http://cpan.cpantesters.org/ DBI # utilise le miroir à synchronisation rapide
cpanm --from https://cpan.metacpan.org/ Plack # n'utilise que le miroir HTTPS

COMMANDES

(arguments)
Les arguments de la ligne de commande peuvent être soit un nom de module, un fichier de distribution, un fichier local
chemin, URL HTTP ou URL du référentiel git. Les commandes suivantes fonctionneront toutes comme prévu.

cpanm
cpanm Plack/Demande.pm
cpanm MIYAGAWA/Plack-1.0000.tar.gz
cpanm /chemin/vers/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

De plus, vous pouvez utiliser la notation en utilisant "~" et "@" pour spécifier la version d'un
module donné. "~" spécifie l'exigence de version dans le format CPAN::Meta::Spec,
tandis que "@" épingle la version exacte et est un raccourci pour "~"== VERSION"".

cpanm Plack~1.0000 # 1.0000 ou version ultérieure
cpanm Plack~">= 1.0000, < 2.0000" # le plus récent de 1.xxxx
cpanm [email protected] # version spécifique. Identique à Plack~"== 0.9990"

La requête de version comprenant une version ou une plage spécifique sera envoyée à MetaCPAN pour
rechercher les versions précédentes. La requête recherchera les archives BackPAN par défaut,
sauf si vous spécifiez l'option "--dev", auquel cas, les versions archivées seront filtrées
en dehors.

Pour un référentiel git, vous pouvez spécifier une branche, une balise ou un commit SHA à compiler. Les
la valeur par défaut est "maître"

cpanm git://github.com/plack/[email protected] # étiqueter
cpanm git://github.com/plack/Plack.git@devel # branche

-je, --installer
Installe les modules. C'est un comportement par défaut et c'est juste une compatibilité
option pour le faire fonctionner comme cpan ou cpanp.

--auto-mise à niveau
Se met à niveau. C'est juste un alias pour :

Application cpanm :: cpanminus

--Info
Affiche les informations de distribution au format "AUTHOR/Dist-Name-ver.tar.gz" dans le
sortie standard.

--installdeps
Installe les dépendances de la distribution cible mais ne se construit pas. Pratique si
vous voulez essayer l'application à partir d'un référentiel contrôlé en version tel que git.

cpanm --installdeps .

--voir
Téléchargez et décompressez la distribution puis ouvrez le répertoire avec votre shell.
Pratique pour fouiller dans le code source ou faire des tests manuels.

-h, --aide
Affiche le message d'aide.

-V, --version
Affiche le numéro de version.

OPTIONS

Vous pouvez spécifier les options par défaut dans la variable d'environnement "PERL_CPANM_OPT".

-f, --force
Forcer l'installation des modules même en cas d'échec du test.

-n, --note
Ignorez le test des modules. Utilisez-le uniquement lorsque vous voulez juste gagner du temps pour
installer des centaines de distributions sur le même perl et la même architecture que vous avez déjà
testé pour s'assurer qu'il se construit bien.

La valeur par défaut est false et vous pouvez dire "--no-notest" pour remplacer lorsqu'il est défini dans le
options par défaut dans "PERL_CPANM_OPT".

--test-seulement
Exécutez uniquement les tests et n'installez pas le module ou les distributions spécifiés. Pratique si
vous voulez vérifier que les nouvelles (ou même les anciennes) versions passent ses tests unitaires sans
installer le module.

Notez que si vous spécifiez cette option avec un module ou une distribution qui a
dépendances, ces dépendances seront installées si vous ne les avez pas actuellement.

-S, --sudo
Basculez vers l'utilisateur root avec "sudo" lors de l'installation des modules. Utilisez ceci si vous voulez
installer les modules sur le système perl include path.

La valeur par défaut est false et vous pouvez dire "--no-sudo" pour remplacer lorsqu'il est défini dans le
options par défaut dans "PERL_CPANM_OPT".

-v, --verbeux
Rend la sortie verbeuse. Il permet également la configuration interactive. (Voir
--interactif)

-q, --calme
Rend la sortie encore plus silencieuse que la valeur par défaut. Il ne montre que le succès/l'échec
dépendances à la sortie.

-l, --local-lib
Définit le chemin compatible local::lib pour installer les modules. Vous n'avez pas besoin de définir ceci
si vous configurez déjà les variables d'environnement shell en utilisant local::lib, mais ceci
peut également être utilisé pour annuler cela.

-L, --local-lib-contenu
Idem avec "--local-lib" mais avec --self-contained set. Toutes les dépendances non essentielles seront
être installés même s'ils sont déjà installés.

Par exemple,

cpanm -L extlib Plack

installerait Plack et toutes ses dépendances non essentielles dans le répertoire "extlib",
qui peut être chargé depuis votre application avec :

utilisez local::lib '/chemin/vers/extlib' ;

Notez que cette option ne ne pas travailler de manière fiable avec les installations perl fournies par
fournisseurs de systèmes d'exploitation qui suppriment les modules standard de perl, tels que RHEL, Fedora
et CentOS, SAUF SI vous installez également des packages fournissant tous les modules qui ont été
dépouillé. Pour ces systèmes, vous voudrez probablement installer le méta-cœur "perl-core".
package qui fait exactement cela.

--autonome
Lors de l'examen des dépendances, supposez qu'aucun module non essentiel n'est installé sur le
système. Pratique si vous souhaitez regrouper les dépendances des applications dans un répertoire afin que vous
peut distribuer à d'autres machines.

--exclude-vendeur
N'incluez pas les modules installés sous les chemins « fournisseur » lors de la recherche de noyau
modules lorsque l'indicateur "--self-contained" est activé. Cela restaure le comportement
d'avant la version 1.7023

--miroiter
Spécifie l'URL de base pour le miroir CPAN à utiliser, telle que
"http://cpan.cpantesters.org/" (vous pouvez omettre la barre oblique finale). Vous pouvez spécifier
plusieurs URL miroir en répétant l'option de ligne de commande.

Vous pouvez utiliser un répertoire local doté d'une structure miroir CPAN (créée par des outils tels que
comme OrePAN ou Pinto) en utilisant un schéma d'URL spécial "file://". Si l'URL donnée commence
avec `/` (sans aucun schéma), il est également considéré comme un schéma de fichier.

cpanm --fichier miroir:///chemin/vers/miroir
cpanm --miroir ~/minipan # Parce que le shell étend ~ vers /home/user

La valeur par défaut est "http://www.cpan.org/".

--miroir-seulement
Téléchargez le fichier d'index 02packages.details.txt.gz du miroir au lieu d'interroger le
Meta DB du CPAN. Cela désactivera également efficacement l'envoi de vos versions locales de perl à
serveurs de base de données principaux tels que CPAN Meta DB et MetaCPAN.

Sélectionnez cette option si vous utilisez un miroir local de CPAN, tel que minicpan lorsque
vous êtes hors ligne, ou votre propre index CPAN (aka darkpan).

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

Utilisez l'URL miroir donnée et son index comme uniquement source à rechercher et à télécharger
modules de.

Cela fonctionne de la même manière que "--mirror" et "--mirror-only" combinés, avec une petite différence :
contrairement à "--mirror" qui ajoute l'URL de la liste des miroirs, "--from" (ou "-M" pour
short) utilise l'URL spécifiée comme uniquement source à partir de laquelle télécharger l'index et les modules.
Cela fait que l'option remplace toujours le miroir par défaut, qui peut avoir été défini
via des options globales telles que celle définie par la variable d'environnement "PERL_CPANM_OPT".

Conseil: Cela peut être utile si vous nommez ces options avec vos alias de shell, comme :

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

--miroir-index
EXPERIMENTAL: Spécifie le chemin du fichier vers "02packages.details.txt" pour la recherche de module
indice.

--cpanmetadb
EXPERIMENTAL: spécifie un autre URI pour les recherches d'index CPAN MetaDB.

--métacpan
Préfère l'API MetaCPAN à la MetaDB CPAN.

--cpanfile
EXPERIMENTAL: a spécifié un chemin alternatif pour cpanfile à rechercher, lorsque
La commande "--installdeps" est en cours d'utilisation. La valeur par défaut est "cpanfile".

--rapide
Invite lorsqu'un test échoue afin que vous puissiez ignorer, forcer l'installation, réessayer ou regarder dans le
shell pour voir ce qui ne va pas. Il s'affiche également lorsque l'une des dépendances a échoué si
vous souhaitez procéder à l'installation.

La valeur par défaut est false et vous pouvez dire "--no-prompt" pour remplacer s'il est défini dans le
options par défaut dans "PERL_CPANM_OPT".

--dev
EXPERIMENTAL : recherchez également une version plus récente du développeur. La valeur par défaut est false.

--réinstaller
cpanm, lorsqu'on lui donne un nom de module dans la ligne de commande (c'est-à-dire "cpanm Plack"), vérifie le
version installée localement en premier et ignore si elle est déjà installée. Cette option
fait sauter la vérification, donc :

cpanm --réinstaller Plack

réinstallerait Plack même si votre version installée localement est la plus récente, voire plus récente
(ce qui se produirait si vous installiez une version développeur à partir du contrôle de version
référentiels).

La valeur par défaut est false.

--interactif
Rend la configuration (telle que "Makefile.PL" et "Build.PL") interactive, afin que vous puissiez
répondre aux questions de la distribution qui nécessitent une configuration personnalisée ou une tâche : :
répartitions.

La valeur par défaut est false et vous pouvez dire "--no-interactive" pour remplacer lorsqu'il est défini dans le
options par défaut dans "PERL_CPANM_OPT".

--pp, --pureperl
Préférez la construction de modules Pure perl en définissant "PUREPERL_ONLY=1" pour MakeMaker et
"--pureperl-only" pour les distributions basées sur Build.PL. Notez que tous les CPAN
les modules prennent encore en charge cette convention.

--with-recommande, --with-suggère
EXPERIMENTAL: Installe les dépendances déclarées comme "recommande" et "suggère"
respectivement, selon les spécifications META. Lorsque l'installation de ces dépendances échoue, cpanm continue
l'installation, car ce ne sont que des recommandations/suggestions.

L'activation de cela pourrait potentiellement créer une dépendance circulaire pour quelques modules sur CPAN,
lorsque "recommend" ajoute un module qui "recommande" le module en retour.

Il y a aussi "--without-recommend" et "--without-suggests" pour remplacer la valeur par défaut
décision prise plus tôt dans "PERL_CPANM_OPT".

La valeur par défaut est false pour les deux.

--avec-développer
EXPERIMENTAL: Installe les dépendances de phase de développement dans les fichiers META ou "cpanfile" lorsque
utilisé avec "--installdeps". La valeur par défaut est false.

--avec-fonctionnalité, --sans-fonctionnalité, --avec-toutes-fonctionnalités
EXPERIMENTAL: Spécifie la fonctionnalité à activer, si un module prend en charge des fonctionnalités facultatives
selon la spécification META 2.0.

cpanm --with-feature=opt_csv Feuille de calcul :: Lire

les fonctionnalités peuvent également être choisies de manière interactive lorsque l'option "--interactive" est activée.

"--with-all-features" active toutes les fonctionnalités optionnelles, et "--without-feature" peut
sélectionnez une fonctionnalité à désactiver.

--configure-timeout, --build-timeout, --test-timeout
Spécifiez le délai d'attente (en secondes) pour attendre la configuration, la construction et le test
traiter. Les valeurs par défaut actuelles sont : 60 pour configurer, 3600 pour construire et 1800 pour
test.

--configure-args, --build-args, --test-args, --install-args
EXPERIMENTAL: Passez les arguments pour les commandes configure/build/test/install respectivement,
pour un module donné à installer.

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

L'argument n'est activé que pour le module passé en tant qu'argument de ligne de commande, pas
dépendances.

--scandeps
Déprécié: Scanne les dépendances de modules donnés et affiche l'arbre dans un texte
format. (Voir "--format" ci-dessous pour plus d'options)

Étant donné que cette commande n'installe aucune distribution, elle sera utile
qu'en tapant :

cpanm --scandeps Catalyst :: Exécution

vous pouvez vous assurer quels modules seront installés.

Cette commande prend en compte les modules que vous avez déjà installés dans votre
système. Si vous voulez voir quels modules seront installés contre un perl vanille
l'installation, vous voudrez peut-être le combiner avec l'option "-L".

--format
Déprécié: détermine le format d'affichage de l'arborescence des dépendances analysée. Disponible
les options sont "tree", "json", "yaml" et "dists".

tree Affiche l'arborescence dans un format de texte brut. Ceci est la valeur par défault.

json, yaml
Génère l'arborescence au format JSON ou YAML. Les modules JSON et YAML doivent être
installés respectivement. L'arbre de sortie est représenté comme un tuple récursif
de:

[ répartition, dépendances ]

et le conteneur est un tableau contenant les éléments racine. Notez qu'il y
peut être plusieurs nœuds racine, car vous pouvez donner plusieurs modules au
commande "--scandeps".

dists "dists" est un format de sortie spécial, où il imprime le nom du fichier de distribution
dans le profondeur premier de commander après la résolution des dépendances, comme :

GAAS/MIME-Base64-3.13.tar.gz
GAAS/URI-1.58.tar.gz
PETDANCE/HTML-Tagset-3.20.tar.gz
Analyseur GAAS/HTML-3.68.tar.gz
GAAS/libwww-perl-5.837.tar.gz

ce qui signifie que vous pouvez installer ces distributions dans cet ordre sans supplément
dépendances. Lorsqu'il est combiné avec l'option "-L", il sera utile de rejouer
installations sur d'autres machines.

--save-dists
Spécifie le chemin de répertoire facultatif pour copier les archives tar téléchargées dans le miroir CPAN
structure de répertoire compatible, c'est-à-dire auteurs/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

Si l'archive tar de la distribution ne provient pas du CPAN, par exemple d'un fichier local ou de
GitHub, puis il sera enregistré sous fournisseur/Foo-Bar-version.tar.gz.

--uninst-ombres
Désinstalle les fichiers shadow de la distribution que vous installez. Cette
élimine la confusion si vous essayez d'installer des modules de base (à double durée de vie) à partir de
CPAN contre perl 5.10 ou plus ancien, ou modules qui étaient basés sur XS mais sont passés à
perl pur à une certaine version.

Si vous exécutez cpanm en tant que root et utilisez "INSTALL_BASE" ou l'équivalent pour spécifier custom
chemin d'installation, vous DEVRIEZ désactiver cette option afin de ne pas désinstaller accidentellement
les modules à double vie du noyau incluent le chemin.

La valeur par défaut est true si votre version de perl est inférieure à 5.12, et vous pouvez la désactiver
avec "--no-uninst-shadows".

REMARQUE: Depuis la version 1.3000, ce drapeau est désactivé par défaut pour perl plus récent que
5.12, car avec 5.12 @INC contient le répertoire site_perl avant la bibliothèque principale de perl
chemin, et la désinstallation des ombres n'est plus nécessaire et fait plus de mal en supprimant
fichiers du chemin de la bibliothèque principale.

--désinstaller, -U
Désinstalle un module du chemin de la bibliothèque. Il trouve une liste de paquets pour des modules donnés, et
supprime tous les fichiers inclus dans la même distribution.

Si vous activez local::lib, cela ne supprime que les fichiers du répertoire local::lib.

Si vous essayez de désinstaller un module dans le répertoire "perl" (c'est-à-dire le module de base), une erreur
être jeté.

Une boîte de dialogue vous demandera de confirmer les fichiers à supprimer. Si vous passez l'option "-f"
de plus, la boîte de dialogue sera ignorée et la désinstallation sera forcée.

--cascade-recherche
EXPERIMENTAL: spécifie s'il faut effectuer une recherche en cascade lorsque vous spécifiez plusieurs miroirs
et un miroir n'a pas de module ou a une version inférieure du module que
demandé. La valeur par défaut est false.

--skip-installé
Spécifie si un module donné dans la ligne de commande est ignoré si sa dernière version
est déjà installé. La valeur par défaut est true.

REMARQUE: La variable d'environnement "PERL5LIB" doit être correctement définie pour que cela fonctionne
avec des modules installés à l'aide de local::lib, à moins que vous n'utilisiez toujours l'option "-l".

--sauter-satisfait
EXPERIMENTAL: Spécifie si un module (et une version) donné dans la ligne de commande est
ignoré s'il est déjà installé.

Si vous exécutez :

cpanm --saut-satisfait CGI DBI~1.2

cpanm ne les installera pas si vous avez déjà CGI (pour toutes les versions) ou DBI
avec une version supérieure à 1.2. C'est similaire à "--skip-installed" mais tandis que
"--skip-installed" vérifie si le derniers version de CPAN est installée,
"--skip-satisfied" vérifie si une version demandée (ou non, ce qui signifie n'importe quelle version) est
installé.

La valeur par défaut est false.

--Vérifier
Vérifiez l'intégrité des fichiers de distribution récupérés de PAUSE à l'aide de CHECKSUMS et
SIGNATURES (si trouvées). La valeur par défaut est false.

--report-perl-version
S'il signale la version de perl installée localement aux différents serveurs Web en tant que
partie de User-Agent. La valeur par défaut est true sauf si les variables d'environnement liées à CI telles que
"TRAVIS", "CI" ou "AUTOMATED_TESTING" est activé. Vous pouvez le désactiver en utilisant
"--pas de rapport-version-perl".

--auto-nettoyage
Spécifie le nombre de jours d'expiration des répertoires de travail de cpanm. Par défaut à 7,
ce qui signifie que les anciens répertoires de travail seront nettoyés en une semaine.

Vous pouvez définir la valeur sur 0 pour que cpan ne nettoie jamais ces répertoires.

--pages-man
Génère des pages de manuel pour les exécutables (man1) et les bibliothèques (man3).

La valeur par défaut est true (pages de manuel générées) sauf si l'option "-L|--local-lib-contained" est
fourni, auquel cas il est défini sur false. Vous pouvez le désactiver avec "--no-man-pages".

--lwp
Utilise le module LWP pour télécharger des éléments via HTTP. La valeur par défaut est true, et vous pouvez dire
"--no-lwp" pour désactiver l'utilisation de LWP, lorsque vous souhaitez mettre à niveau LWP à partir du CPAN sur certains
systèmes perl.

--wget
Utilise GNU Wget (si disponible) pour télécharger des trucs. La valeur par défaut est true, et vous pouvez dire
"--no-wget" pour désactiver l'utilisation de Wget (les versions de Wget antérieures à 1.9 ne prennent pas en charge le
option "--retry-connrefused" utilisée par cpanm).

--boucle
Utilise cURL (si disponible) pour télécharger des trucs. La valeur par défaut est true, et vous pouvez dire
"--no-curl" pour désactiver l'utilisation de cURL.

Normalement, avec les options "--lwp", "--wget" et "--curl" définies sur true (qui est le
par défaut) cpanm essaie LWP, Wget, cURL et HTTP::Tiny (dans cet ordre) et utilise le premier
un disponible.

Utiliser cpanmp en ligne en utilisant les services onworks.net