| PPM - Perl Package Manager: localise, installe, met à jour les paquetages. |
PPM - Perl Package Manager: localise, installe, met à jour les paquetages.
ppm genconfig ppm help [command] ppm install [--location=location] package1 [... packageN] ppm query [--case|nocase] [--abstract|author] PATTERN ppm remove package1 [... packageN] ppm search [--case|nocase] [--location=location] [--abstract|author] PATTERN ppm set [option] ppm verify [--location=location] [--upgrade] [--force] [package1 ... packageN] ppm version ppm [--location=location]
ppm est un utilitaire destiné à simplifier les tâches de localiser, installer, mettre à jour et désinstaller des paquetages. C'est un frontal aux fonctionnalités fournies par le module PPM.pm. Il peut déterminer si la version la plus récente d'un paquetage est installée sur un système, et peut installer ou mettre à jour ce paquetage depuis un hôte local ou distant.
ppm fonctionne dans l'un des deux modes suivants : en mode shell interactif dans lequel les commandes peuvent être entrées; en mode ligne de commande dans lequel une seule action spécifique est effectuée par invocation du programme.
Pour obtenir des informations au sujet des paquetages logiciels, ppm utilise des fichiers écrits dans une forme étendue de la spécification OSD (Open Software Description). Ces fichiers de description, qui sont codés en XML (Extensible Markup Language), sont connus sous le nom de fichiers 'PPD'. On trouvera des informations au sujet d'OSD sur le site web du W3C (au moment de la rédaction, http://www.w3.org/TR/NOTE-OSD.html ). Les extensions à OSD utilisées par ppm sont documentées dans PPM.ppd.
La syntaxe des commandes PPM est la même dans le mode interactif et dans le mode en ligne de commande. La commande 'help' affiche la liste des commandes disponibles.
Les commandes de ppm peuvent être abrégées à leur plus courte forme unique.
ppm install [--location=location] package1 [... packageN]
Installe les paquetages spécifiés. Tente l'installation depuis l'URL ou le répertoire 'location' si l'option '--location' est spécifiée.
Les arguments 'package' peuvent être, soit des noms de paquetages ('foo'), soit des chemins (p:/packages/foo.ppd), soit des URLs (http://www.ActiveState.com/packages/foo.ppd) pour spécifier des fichiers PPD.
Dans le cas où un nom du paquetage est spécifié, et l'option '--location' n'est pas utilisée, ppm se réfère aux emplacements de dépôt par défaut.
Voir aussi : l'option 'confirm'
ppm remove package1 [... packageN]
Lit les informations du fichier PPD pour le paquetage indiqué et supprime le paquetage du système.
Voir aussi : l'option 'confirm'
ppm verify [--location=location] [--upgrade] [--force] [package1 ... packageN]
Vérifie que les paquetages actuellement installés sont à jour. Si aucun paquetage n'est spécifié en argument, tous les paquetages installés sont vérifiés.
Si l'option '--upgrade' est spécifiée, tous les paquetages pour lesquels une mise à jour est disponible seront mis à jour.
Si l'option '--location' est spécifiée, les mises à jour seront cherchées dans le répertoire ou à l'URL spécifiée.
Si l'option '--force' est spécifiée, tous les paquetages couramment installés seront réinstallés qu'ils soit hors date ou non.
Voir aussi : l'option 'confirm'
ppm query [--case|nocase] [--abstract|author] PATTERN
Recherche le motif 'PATTERN' (une expression rationnelle) dans le nom
des paquetages installés. Si la recherche réussit, les informations au
sujet du (ou des) paquetage(s) sélectionné(s) sont affichés.
Si le motif 'PATTERN' est omis, les informations à propos de tous les
paquetages installés seront affichés.
Si l'une ou l'autre des options '--abstract' ou '--author' est spécifiée, le motif PATTERN sera recherché dans les tags <ABSTRACT> ou <AUTHOR> des paquetages installés.
Les options '--case' et '--nocase' peuvent être utilisées pour changer les valeurs par défaut de sensibilité à la casse dans la recherche.
Voir aussi : l'option 'case'.
ppm search [--case|nocase] [--location=location] [--abstract|author] PATTERN
Affiche une liste de tous les paquetages qui correspondent à 'PATTERN' (une expression rationnelle) disponibles à l'emplacement spécifié. Si 'PATTERN' est omis, les informations au sujet de tous les paquetages disponibles seront affichées.
Si l'option '--location' est utilisée, la recherche aura lieu dans l'URL ou le répertoire spécifié. Si l'option '--location' n'est pas utilisée, la recherche aura lieu dans le dépôt spécifié dans le fichier de données PPM.
Si l'une ou l'autre des options '--abstract' ou '--author' est spécifiée, le motif PATTERN sera recherché dans les tags <ABSTRACT> ou <AUTHOR> des paquetages installés.
Les options '--case' et '--nocase' peuvent être utilisées pour changer les valeurs par défaut de sensibilité à la casse dans la recherche.
Voir aussi : l'option 'case'.
ppm genconfig ppm getconfig
La commande genconfig imprimera un fichier de configuration PPM valide (ppm.xml) vers STDOUT. Ce peut être utile si le fichier de configuration PPM est endommagé rendant le lancement de PPM impossible.
Si besoin est, cet commande peut être lancé depuis l'invite du shell :
C:\Perl\site\lib> ppm genconfig > ppm.xml
La commande getconfig affiche l'emplacement du fichier de configuration PPM utilisé au démarrage de PPM.
ppm set [option value]
Fixe ou affiche l'état des options courantes. Sans argument, les états des options courantes sont affichés. Pour les options qui acceptent '1' ou '0', spécifier '1' active l'option, et '0' la désactive.
Options disponibles :
build DIRECTORY
- Modifie le répertoire de construction du paquetage.
case [1|0]
- Fixe la sensibilité à la casse des recherches. Si ni '1', ni '0'
n'est spécifié, l'état courant de l'option est inversé.
clean [1|0]
- Autorise le nettoyage des fichiers temporaires du répertoire de
construction du paquetage, si l'installation a réussie.
Si ni '1', ni '0' n'est spécifié, l'état courant de l'option est inversé.
confirm [1|0]
- Demande la confirmation ou non de 'install', 'remove' et 'upgrade'.
Si ni '1', ni '0' n'est spécifié, l'état courant de l'option est inversé.
downloadstatus NOMBRE
- Si non nul, met à jour l'état du téléchargement après chaque
NOMBRE d'octets transférés pendant un 'install'.
Cela peut rassurer quand on installe un gros paquetage (par exemple Tk)
avec une connexion lente.
force_install [1|0]
- Continue d'installer un paquetage même si une dépendance ne peut
pas être installée.
more NOMBRE
- Provoque une pause en sortie après que NOMBRE lignes aient été affichées.
Spécifier '0' arrête ce comportement.
set repository --remove NOM
- Ôte le dépôt 'NOM' de la liste des depots.
set repository NOM EMPLACEMENT
- Ajoute un dépôt à la liste des dépôts PPD pour cette session.
'NOM' est le nom sous lequel le dépôt est référencé ;
'EMPLACEMENT' est une URL ou un nom de répertoire.
root REPERTOIRE
- Change le répertoire racine d'installation. Les paquetages seront
installés dans ce nouveau répertoire.
save
- Sauvegarde les options courantes comme valeurs par défaut pour
les futures sessions.
trace
- Niveau de trace. 1 par défaut, le maximum est 4, 0 annule le
mode trace.
tracefile
- Fichier recevant les information de traçage, 'PPM.LOG' par défaut.
verbose [1|0]
- Affiche des informations supplémentaires sur les paquetages
pour les commandes 'query' et 'search'.
[Montre tous les paquetages disponibles]
PPM> search
Packages available from P:\PACKAGES:
bar [2.91 ] supplies bar methods for perl5.
bax [0.072] module for manipulation of bax archives.
baz [1.03 ] Interface to baz library
foo [2.23 ] Foo parser class
[Liste tout ce qui a déjà été installé]
PPM> query
bax [0.071] module for manipulation of bax archives.
baz [1.02 ] Interface to baz library
[Installe un paquetage]
PPM> install foo
Install package foo? (y/N): y
[...]
[Inverse l'option confirmation]
PPM> set confirm
Commands will not be confirmed.
[Vérifie si 'baz' est à jour]
PPM> verify baz
An upgrade to package 'baz' is available.
[Met à jour 'baz']
PPM> verify --upgrade baz
[...]
[Mise à jour forcée de 'baz']
PPM> verify --upgrade --force baz
[...]
[Inverse la sensibilité à la casse des recherches]
PPM> set case
Case-sensitive searches will be performed.
[Affiche tous les paquetages disponibles commençant par 'b']
PPM> search ^b
bar [2.91 ] supplies bar methods for perl5.
bax [0.072] module for manipulation of bax archives.
baz [1.03 ] Interface to baz library
[Cherche les paquetages installés contenant 'baz' dans le tag ABSTRACT]
PPM> query --abstract baz
Matching packages found at P:\PACKAGES:
baz [1.03 ] Interface to baz library
PPM> quit
Sa valeur doit être de la forme : 'http://proxy:port'.
Les fichiers suivants sont complètement décrits dans la section 'Files' de PPM:ppm.
Ce fichier se trouve d'ordinaire dans le répertoire '[perl]/site/lib'. Si la variable d'environnement 'PPM_DAT' est définie, sa valeur sera utilisée comme un chemin complet à un fichier de données PPM. Si tout échoue, ppm recherchera un fichier de données dans le répertoire courant.
Murray Nesbitt, <murray@ActiveState.com>
Jean-Louis Morel <jl_morel@bribes.org>
| PPM - Perl Package Manager: localise, installe, met à jour les paquetages. |