cpan - En ligne dans le Cloud

PROGRAMME:

Nom

cpan - interagir facilement avec CPAN à partir de la ligne de commande

SYNOPSIS

# avec des arguments et aucun commutateur, installe les modules spécifiés
cpan nom_module [ nom_module ... ]

# avec des commutateurs, installe des modules avec un comportement supplémentaire
cpan [-cfgimtTw] nom_module [ nom_module ... ]

# avec juste le point, installez depuis la distribution dans le
# répertoire actuel
cpan.

# sans arguments, démarre le shell CPAN.pm
cpan

# forcer l'installation des modules (généralement ceux qui échouent aux tests)
cpan -f nom_module [ nom_module ... ]

# installer les modules mais sans les tester
cpan -T nom_module [ nom_module ... ]

# vider la configuration
cpan-J

# charger une configuration différente pour installer Module::Foo
cpan -j un/autre/fichier Module::Foo

# sans arguments, mais quelques commutateurs
cpan [-ahrvACDlLO]

DESCRIPTION

Ce script fournit une interface de commande (pas un shell) au CPAN. En ce moment il utilise
CPAN.pm pour faire le travail, mais ce n'est pas un lanceur de commandes unique pour CPAN.pm.

Options
-a Crée un autobundle CPAN.pm avec CPAN::Shell->autobundle.

-Un module [ module ... ]
Affiche les principaux responsables des modules spécifiés.

module -c
Exécute un `make clean` dans les répertoires du module spécifié.

-Cmodule [module...]
Afficher la Modifications fichiers pour les modules spécifiés

-D module [ module ... ]
Afficher les détails du module.

-f Force l'action spécifiée, alors qu'elle aurait normalement échoué. Utilisez-le pour installer un
module même si ses tests échouent. Lorsque vous utilisez cette option, -i n'est pas facultatif pour
installer un module quand il faut le forcer :

% cpan -f -i Module :: Foo

-F Désactive les tentatives de CPAN.pm pour verrouiller quoi que ce soit. Vous devez être prudent avec cela car
vous pourriez vous retrouver avec plusieurs scripts essayant de nettoyer dans le même répertoire. Cette
n'est pas vraiment un problème si vous chargez une configuration spéciale avec "-j", et que
config met en place ses propres répertoires de travail.

-g module [ module ... ]
Télécharge dans le répertoire courant la dernière distribution du module.

-Gmodule [ module ... ]
NON MISE EN OEUVRE

Téléchargez dans le répertoire courant la dernière distribution des modules, décompressez chacun
distribution et créez un référentiel git pour chaque distribution.

Si vous voulez cette fonctionnalité, consultez la distribution "Git::CPAN::Patch" de Yanick Champoux.

-h Affiche un message d'aide et quitte. Lorsque vous spécifiez "-h", il ignore tous les autres
options et arguments.

-i Installe les modules spécifiés.

-I Load "local::lib" (pensez comme "-I" pour charger les chemins de la lib).

-j Config.pm
Chargez le fichier contenant les données de configuration CPAN. Cela devrait avoir le même format
comme standard CPAN/Config.pm qui définit $CPAN::Config comme un hachage anonyme.

-J Dump la configuration dans le même format que CPAN.pm utilise. Ceci est utile pour
vérifier la configuration ainsi qu'utiliser le dump comme point de départ pour un nouveau,
configuration personnalisée.

-l Liste tous les modules installés avec leurs versions

-L auteur [ auteur ... ]
Répertoriez les modules par les auteurs spécifiés.

-m Crée les modules spécifiés.

-O Afficher les modules obsolètes.

-p Ping les miroirs configurés

-P Trouvez les meilleurs miroirs que vous pourriez utiliser (mais ne les configurez pas encore)

-r Recompile les modules chargés dynamiquement avec CPAN::Shell->recompile.

-t Exécute un `make test` sur les modules spécifiés.

-T Ne pas tester les modules. Installez-les simplement.

-u Mettre à niveau tous les modules installés. Faire cela aveuglément peut vraiment casser les choses, alors gardez un
sauvegarde

-v Affiche la version du script et la version CPAN.pm puis quitte.

-V Affiche des informations détaillées sur le client cpan.

-w NON IMPLÉMENTÉ

Activez les avertissements cpan. Cela vérifie diverses choses, comme les autorisations de répertoire, et
vous informe des problèmes que vous pourriez avoir.

Exemples
# imprimer un message d'aide
cpan-h

# imprimer les numéros de version
cpan-v

# créer un autobundle
cpan-a

# modules de recompilation
cpan-r

# mettre à niveau tous les modules installés
cpan-u

# installer les modules ( sole -i est facultatif )
cpan -i Netscape::Booksmarks Entreprise::ISBN

# forcer l'installation des modules (doit utiliser -i )
cpan -fi CGI::URI minimal

ENVIRONNEMENT VARIABLES

Il existe plusieurs composants dans CPAN.pm qui utilisent des variables d'environnement. La construction
outils, ExtUtils::MakeMaker et Module::Build en utilisent certains, tandis que d'autres comptent pour le
niveaux au-dessus d'eux. Certains d'entre eux sont spécifiés par le Perl Toolchain Gang :

Consensus de Lancaster :


Consensus d'Oslo :


CPAN_OPTS
"cpan" divise cette variable sur des espaces et ajoute cette liste à @ARGV avant
il traite les arguments de ligne de commande. Par exemple, si vous voulez toujours utiliser
"local:lib", vous pouvez définir "CPAN_OPTS" sur "-I".

CPANSCRIPT_LOGLEVEL
Le niveau de journalisation à utiliser, soit avec l'enregistreur minimal intégré ou Log::Log4perl si
il est installé. Les valeurs possibles sont les mêmes que les niveaux "Log::Log4perl":
"TRACE", "DEBUG", "INFO", "WARN", "ERROR" et "FATAL". La valeur par défaut est "INFO".

GIT_COMMAND
Le chemin vers le binaire "git" à utiliser pour les fonctionnalités de Git. La valeur par défaut est
"/usr/local/bin/git".

TESTS NON INTERACTIFS
Supposons que personne ne prête attention et ignore les invites pour les distributions qui le font
correctement. cpan(1) le met à 1 à moins qu'il n'ait déjà une valeur (même si cela
la valeur est fausse).

PERL_MM_USE_DEFAULT
Utilisez la réponse par défaut pour les questions invitées. cpan(1) le met à 1 à moins qu'il
a déjà une valeur (même si cette valeur est fausse).

EXIT VALEURS

Le script se termine par zéro s'il pense que tout a fonctionné, ou un nombre positif s'il
pense que quelque chose a échoué. A noter cependant que dans certains cas il faut deviner un échec
par la sortie des choses qu'il ne contrôle pas. Pour l'instant, les codes de sortie sont vagues :

1 Une erreur inconnue

2 C'était un problème externe

4 Il y a eu un problème interne avec le script

8 Un module n'a pas pu s'installer

À DO

* valeurs de configuration one shot à partir de la ligne de commande

Utiliser cpan en ligne en utilisant les services onworks.net