perlmodinstall - En ligne dans le Cloud

PROGRAMME:

Nom

perlmodinstall - Installation des modules CPAN

DESCRIPTION

Vous pouvez considérer un module comme l'unité fondamentale du code Perl réutilisable ; voir perlmod pour
des détails. Chaque fois que quelqu'un crée un morceau de code Perl qu'il pense être utile pour
le monde, ils s'enregistrent en tant que développeur Perl sur http://www.cpan.org/modules/04pause.html
afin qu'ils puissent ensuite télécharger leur code sur le CPAN. Le CPAN est le Perl complet
Réseau d'archives et accessible à l'adresse http://www.cpan.org/ , et recherché à
http://search.cpan.org/ .

Cette documentation est destinée aux personnes qui souhaitent télécharger des modules CPAN et les installer sur
leur propre ordinateur.

PRÉAMBULE
Tout d'abord, êtes-vous sûr que le module n'est pas déjà sur votre système ? Essayez "perl -MFoo -e 1".
(Remplacez "Foo" par le nom du module ; par exemple, "perl -MCGI::Carp -e 1".)

Si vous ne voyez pas de message d'erreur, vous avez le module. (Si vous voyez un message d'erreur,
il est toujours possible que vous ayez le module, mais qu'il ne soit pas dans votre chemin, ce que vous pouvez
display avec "perl -e "print qq(@INC)"".) Pour le reste de ce document, nous allons
supposez qu'il vous manque vraiment un module installé, mais que vous l'avez trouvé sur le
CPAN.

Alors maintenant, vous avez un fichier se terminant par .tar.gz (ou, moins souvent, .zip). Tu sais qu'il y a un savoureux
module à l'intérieur. Il y a quatre étapes que vous devez maintenant suivre :

DÉCOMPRESSER le fichier
DÉBALLER le fichier dans un répertoire
CONSTRUIRE le module (parfois inutile)
INSTALLER le module.

Voici comment effectuer chaque étape pour chaque système d'exploitation. C'est un remplaçant pour
en lisant les fichiers README et INSTALL qui pourraient être fournis avec votre module !

Notez également que ces instructions sont conçues pour l'installation du module dans votre
référentiel de modules Perl du système, mais vous pouvez installer des modules dans n'importe quel répertoire que vous
souhaiter. Par exemple, là où je dis "perl Makefile.PL", vous pouvez remplacer "perl Makefile.PL
PREFIX=/my/perl_directory" pour installer les modules dans /mon/répertoire_perl. Ensuite vous pouvez
utilisez les modules de vos programmes Perl avec "use lib "/my/perl_directory/lib/site_perl" ;"
ou parfois simplement "utiliser "/my/perl_directory";". Si vous êtes sur un système qui nécessite
accès superutilisateur/root pour installer les modules dans les répertoires que vous voyez lorsque vous tapez "perl
-e "print qq(@INC)"", vous voudrez les installer dans un répertoire local (comme votre
répertoire personnel) et utilisez cette approche.

· If Vous êtes on a Unix or Unix ,

Vous pouvez utiliser le module CPAN d'Andreas Koenig ( http://www.cpan.org/modules/by-module/CPAN
) pour automatiser les étapes suivantes, de DECOMPRESSER à INSTALLER.

A. DÉCOMPRESSER

Décompressez le fichier avec "gzip -d votremodule.tar.gz"

Vous pouvez obtenir gzip à partir de ftp://prep.ai.mit.edu/pub/gnu/

Ou, vous pouvez combiner cette étape avec la suivante pour économiser de l'espace disque :

gzip -dc votremodule.tar.gz | goudron -xof -

B. DÉBALLER

Décompressez le résultat avec "tar -xof yourmodule.tar"

C. CONSTRUIRE

Allez dans le répertoire nouvellement créé et tapez :

perl Makefile.PL
faire un test

or

perl Makefile.PL PREFIX=/mon/répertoire_perl

pour l'installer localement. (Rappelez-vous que si vous faites cela, vous devrez mettre "use lib
"/my/perl_directory";" près du haut du programme qui doit utiliser ce module.

D. INSTALLER

Toujours dans ce répertoire, tapez :

make install

Assurez-vous d'avoir les autorisations appropriées pour installer le module dans votre Perl 5
répertoire de la bibliothèque. Souvent, vous aurez besoin d'être root.

C'est tout ce que vous devez faire sur les systèmes Unix avec liaison dynamique. La plupart des systèmes Unix
avoir un lien dynamique. Si ce n'est pas le cas, ou si pour une autre raison vous avez un
perl lié statiquement, et le module nécessite une compilation, vous devrez construire un
nouveau binaire Perl qui inclut le module. Encore une fois, vous aurez probablement besoin d'être root.

· If Vous êtes Running ActivePerl (Win95/98/2K/NT/XP, Linux, Solaris),

Tout d'abord, tapez "ppm" à partir d'un shell et voyez si le référentiel PPM d'ActiveState a votre
module. Si c'est le cas, vous pouvez l'installer avec "ppm" et vous n'aurez pas à vous soucier de l'un des
les autres étapes ici. Vous pourrez peut-être utiliser les instructions CPAN du "Unix
ou Linux" ci-dessus également ; essayez-le. Sinon, vous devrez suivre les
étapes ci-dessous.

A. DÉCOMPRESSER

Vous pouvez utiliser le partagiciel Winzip ( http://www.winzip.com ) pour décompresser et déballer
modules.

B. DÉBALLER

Si vous avez utilisé WinZip, cela a déjà été fait pour vous.

C. CONSTRUIRE

Vous aurez besoin de l'utilitaire "nmake", disponible sur
http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/nmake15.exe ou dmake,
disponible sur CPAN. http://search.cpan.org/dist/dmake/

Le module nécessite-t-il une compilation (c'est-à-dire a-t-il des fichiers qui se terminent par .xs, .c, .h,
.y, .cc, .cxx ou .C) ? Si c'est le cas, la vie est maintenant officiellement dure pour vous, parce que vous
devez compiler le module vous-même (pas facile sous Windows). Vous aurez besoin d'un compilateur
comme Visual C++. Alternativement, vous pouvez télécharger un package PPM pré-construit à partir de
État Actif. http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/

Allez dans le répertoire nouvellement créé et tapez :

perl Makefile.PL
test nmake

D. INSTALLER

Toujours dans ce répertoire, tapez :

nmake installer

· If Vous êtes en utilisant a Macintosh avec "Classique" MacOS et Mac Perl,

A. DÉCOMPRESSER

Tout d'abord, assurez-vous d'avoir la dernière cpan-mac Distribution (
http://www.cpan.org/authors/id/CNANDOR/ ), qui a des utilitaires pour faire tous les
pas. Lisez attentivement les instructions de cpan-mac et installez-le. Si vous choisissez de ne pas
utilisez cpan-mac pour une raison quelconque, il existe des alternatives répertoriées ici.

Après avoir installé cpan-mac, déposez l'archive du module sur le décompresser gouttelette, qui
va décompresser et déballer pour vous.

Or, vous pouvez soit utiliser le shareware Fourre-le Expander programme (
http://my.smithmicro.com/mac/stuffit/ ) ou le logiciel gratuit MacGzip programme (
http://persephone.cps.unizar.es/general/gente/spd/gzip/gzip.html ).

B. DÉBALLER

Si vous utilisez untarzipme ou StuffIt, l'archive doit être extraite maintenant. Or, Vous
peut utiliser le logiciel gratuit soleil or Goudron (
http://hyperarchive.lcs.mit.edu/HyperArchive/Archive/cmp/ ).

C. CONSTRUIRE

Vérifiez le contenu de la distribution. Lisez la documentation du module, recherchez
raisons pour lesquelles vous pourriez avoir des difficultés à l'utiliser avec MacPerl. Chercher .xs et .c fichiers,
qui indiquent normalement que la distribution doit être compilée, et vous ne pouvez pas installer
il "hors de la boîte". (Voir "PORTABILITÉ".)

D. INSTALLER

Si vous utilisez cpan-mac, déposez simplement le dossier sur le installer moi gouttelette et utilisez le
module.

Or, si vous n'utilisez pas cpan-mac, effectuez un travail manuel.

Assurez-vous que les nouvelles lignes des modules sont au format Mac et non au format Unix. Si ils
ne le sont pas, vous les avez peut-être mal décompressés. Vérifiez votre décompression
et décompresser les paramètres des utilitaires pour s'assurer qu'ils traduisent des fichiers texte
correctement.

En dernier recours, vous pouvez utiliser le one-liner perl :

perl -i.bak -pe 's/(?:\015)?\012/\015/g'

sur les fichiers sources.

Déplacez ensuite les fichiers (probablement juste le .pm fichiers, bien qu'il puisse y avoir des
les uns aussi ; consulter la documentation du module) jusqu'à leur destination finale :
probablement être dans "$ENV{MACPERL}site_lib:" (c'est-à-dire, "HD:MacPerl folder:site_lib:"). Vous pouvez
ajouter de nouveaux chemins au @INC par défaut dans l'élément de menu Préférences de MacPerl
application ("$ENV{MACPERL}site_lib:" est ajouté automatiquement). Créer n'importe quoi
des structures de répertoires sont requises (c'est-à-dire, pour "Some::Module", créez
"$ENV{MACPERL}site_lib:Some:" et placez "Module.pm" dans ce répertoire).

Ensuite, exécutez le script suivant (ou quelque chose comme ça):

#!perl-w
utilisez la division automatique ;
mon $dir = "${MACPERL}site_perl" ;
autosplit("$dir:Some:Module.pm", "$dir:auto", 0, 1, 1);

· If Vous êtes on le DJGPP port of DOS,

A. DÉCOMPRESSER

djtarx ( ftp://ftp.delorie.com/pub/djgpp/current/v2/ ) décompressera et
déballer.

B. DÉBALLER

Voir au dessus.

C. CONSTRUIRE

Allez dans le répertoire nouvellement créé et tapez :

perl Makefile.PL
faire un test

Vous aurez besoin des packages mentionnés dans LISEZ-MOI.dos dans la distribution Perl.

D. INSTALLER

Toujours dans ce répertoire, tapez :

make install

Vous aurez besoin des packages mentionnés dans LISEZ-MOI.dos dans la distribution Perl.

· If Vous êtes on OS / 2,

Obtenez la suite de développement EMX et gzip/tar, de Hobbes (
http://hobbes.nmsu.edu ) ou Lion ( http://www.leo.org ), puis suivez les
instructions pour Unix.

· If Vous êtes on VMS,

Lors du téléchargement depuis CPAN, enregistrez votre fichier avec une extension ".tgz" au lieu de
".tar.gz". Tous les autres points du nom de fichier doivent être remplacés par des traits de soulignement.
Par exemple, "Votre-Module-1.33.tar.gz" doit être téléchargé en tant que "Votre-Module-1_33.tgz".

A. DÉCOMPRESSER

Type

gzip -d Votre-Module.tgz

ou, pour les modules zippés, tapez

décompressez Votre-Module.zip

Exécutables pour gzip, zip et VMStar :

http://www.hp.com/go/openvms/freeware/

et leur code source :

http://www.fsf.org/order/ftp.html

Notez que le package gzip/gunzip de GNU n'est pas le même que le package zip/unzip d'Info-ZIP. Les
ancien est un outil de compression simple ; ce dernier permet la création de multi-fichiers
archives.

B. DÉBALLER

Si vous utilisez VMStar :

VMStar xf Votre-Module.tar

Ou, si vous aimez la syntaxe des commandes VMS :

tar/extraire/verbeux Votre_Module.tar

C. CONSTRUIRE

Assurez-vous d'avoir MMS (de Digital) ou le logiciel gratuit MMK (disponible auprès de MadGoat à
http://www.madgoat.com ). Tapez ensuite ceci pour créer le DESCRIP.MMS pour le module :

perl Makefile.PL

Vous êtes maintenant prêt à créer :

test mms

Remplacez "mmk" par "mms" ci-dessus si vous utilisez MMK.

D. INSTALLER

Type

mms installer

Remplacez "mmk" par "mms" ci-dessus si vous utilisez MMK.

· If Vous êtes on MVS,

Présentez l' .tar.gz fichier dans un HFS en tant que binaire ; ne traduisez pas de l'ASCII vers
EBCDIC.

A. DÉCOMPRESSER

Décompressez le fichier avec "gzip -d votremodule.tar.gz"

Vous pouvez obtenir gzip à partir de http://www.s390.ibm.com/products/oe/bpxqp1.html

B. DÉBALLER

Déballez le résultat avec

pax -o to=IBM-1047,from=ISO8859-1 -r < votremodule.tar

Les étapes BUILD et INSTALL sont identiques à celles d'Unix. Certains modules génèrent
Makefiles qui fonctionnent mieux avec GNU make, disponible sur
http://www.mks.com/s390/gnu/

PORTABILITÉ

Notez que tous les modules ne fonctionneront pas sur toutes les plateformes. Voir perlport pour plus
informations sur les problèmes de portabilité. Lisez la documentation pour voir si le module fonctionnera
sur votre système. Il existe essentiellement trois catégories de modules qui ne fonctionneront pas "
de la boîte" avec toutes les plateformes (avec une certaine possibilité de chevauchement) :

· Ceux qui devrait, mais ne fais pas ça. Ceux-ci doivent être corrigés; pensez à contacter l'auteur
et éventuellement écrire un patch.

· Ceux qui need à be compilé, où le l'objectif plateforme ne pas avons compilateurs
facilement disponible. (Ces modules contiennent .xs or .c fichiers, généralement.) Vous pourriez être
capable de trouver des binaires existants sur le CPAN ou ailleurs, ou vous voudrez peut-être essayer
obtenir des compilateurs et le construire vous-même, puis publier le binaire pour d'autres pauvres
âmes à utiliser.

· Ceux qui sommes-nous des campagnes marketing ciblées, at a groupe de neurones plate-forme. (Comme les modules Win32 ::.) Si
le module s'adresse spécifiquement à une autre plateforme que la vôtre, vous n'avez plus de
chance, probablement.

Vérifiez les testeurs CPAN si un module doit fonctionner avec votre plate-forme mais qu'il ne se comporte pas comme
vous attendez, ou vous n'êtes pas sûr qu'un module fonctionnera ou non sous votre plate-forme.
Si le module que vous voulez n'y figure pas, vous pouvez le tester vous-même et laisser les testeurs CPAN
savoir, vous pouvez rejoindre les testeurs CPAN, ou vous pouvez demander qu'il soit testé.

http://testers.cpan.org/

HEY

Si vous avez des suggestions de modifications pour cette page, faites-le moi savoir. S'il vous plaît ne m'envoyez pas de courrier
demander de l'aide sur la façon d'installer vos modules. Il y a trop de modules et trop peu
Orwants, que je puisse répondre ou même accuser réception de toutes vos questions. Contacter le
l'auteur du module à la place, ou postez sur comp.lang.perl.modules, ou demandez à quelqu'un qui connaît
Perl sur votre système d'exploitation.

Utilisez perlmodinstall en ligne à l'aide des services onworks.net