cpan - Online in de cloud

PROGRAMMA:

NAAM

cpan - communiceer eenvoudig met CPAN vanaf de opdrachtregel

KORTE INHOUD

# met argumenten en geen schakelaars, installeert gespecificeerde modules
cpan modulenaam [ modulenaam ... ]

# met schakelaars, installeert modules met extra gedrag
cpan [-cfgimtTw] modulenaam [ modulenaam ... ]

# met alleen de punt, installeer vanuit de distributie in het
# huidige map
cpan.

# zonder argumenten, start CPAN.pm-shell
cpan

# forceer installatiemodules (meestal modules die niet slagen voor tests)
cpan -f modulenaam [ modulenaam ... ]

# installeer modules maar zonder ze te testen
cpan -T modulenaam [ modulenaam ... ]

# dump de configuratie
cpan-J

# laad een andere configuratie om Module::Foo te installeren
cpan -j een/ander/bestand Module::Foo

# zonder argumenten, maar enkele schakelaars
cpan [-ahrvACDlLO]

PRODUCTBESCHRIJVING

Dit script biedt een opdrachtinterface (geen shell) voor CPAN. Op dit moment gebruikt het
CPAN.pm om het werk te doen, maar het is geen one-shot command runner voor CPAN.pm.

Opties
-a Creëert een CPAN.pm autobundle met CPAN::Shell->autobundle.

-Een module [module ...]
Toont de primaire beheerders voor de opgegeven modules.

-c-module
Voert een `make clean` uit in de mappen van de opgegeven module.

-C-module [module ...]
Toon de Wijzigingen bestanden voor de opgegeven modules

-D-module [module ...]
Toon de moduledetails.

-f Forceer de opgegeven actie, terwijl deze normaal gesproken zou hebben gefaald. Gebruik dit om een
module, zelfs als de tests mislukken. Wanneer u deze optie gebruikt, is -i niet optioneel voor
een module installeren wanneer u deze moet forceren:

% cpan -f -i Module::Foo

-F Schakel de pogingen van CPAN.pm uit om iets te vergrendelen. Je moet hier sindsdien voorzichtig mee zijn
je zou kunnen eindigen met meerdere scripts die in dezelfde map proberen te mucken. Dit
is niet zo'n groot probleem als je een speciale configuratie laadt met "-j", en zo
config stelt zijn eigen werkmappen in.

-g module [ module ... ]
Downloadt de nieuwste distributie van de module naar de huidige map.

-G-module [module ...]
ONGEËMPLEMENTEERD

Download de nieuwste distributie van de modules naar de huidige map en pak ze allemaal uit
distributie, en maak een git-repository voor elke distributie.

Als je deze functie wilt, bekijk dan de "Git::CPAN::Patch"-distributie van Yanick Champoux.

-h Druk een helpbericht af en sluit af. Wanneer u "-h" opgeeft, negeert het alle andere
opties en argumenten.

-i Installeer de opgegeven modules.

-I Laad "local::lib" (denk aan "-I" voor het laden van lib-paden).

-j Configuratie.pm
Laad het bestand met de CPAN-configuratiegegevens. Dit zou hetzelfde formaat moeten hebben
als de standaard CPAN/Config.pm bestand, dat $CPAN::Config definieert als een anonieme hash.

-J Dump de configuratie in hetzelfde formaat dat CPAN.pm gebruikt. Dit is handig voor
het controleren van de configuratie en het gebruiken van de dump als uitgangspunt voor een nieuwe,
aangepaste configuratie.

-l Maak een lijst van alle geïnstalleerde modules met hun versies

-L auteur [ auteur ... ]
Vermeld de modules van de opgegeven auteurs.

-m Maak de opgegeven modules.

-O Toon de verouderde modules.

-p Ping de geconfigureerde spiegels

-P Vind de beste mirrors die u zou kunnen gebruiken (maar configureert ze nog niet)

-r Hercompileert dynamisch geladen modules met CPAN::Shell->recompile.

-t Voer een `make test` uit op de opgegeven modules.

-T Test geen modules. Installeer ze eenvoudig.

-u Upgrade alle geïnstalleerde modules. Door dit blindelings te doen, kunnen dingen echt kapot gaan, dus houd een
back-up.

-v Druk de scriptversie en de CPAN.pm-versie af en sluit vervolgens af.

-V Gedetailleerde informatie over de cpan-client afdrukken.

-w NIET UITGEVOERD

Schakel cpan-waarschuwingen in. Hiermee worden verschillende dingen gecontroleerd, zoals maprechten en
vertelt u over de problemen die u mogelijk heeft.

Voorbeelden
# een helpbericht afdrukken
cpan-h

# druk de versienummers af
cpan-v

# maak een automatische bundel
cpan-a

# hercompileer modules
cpan-r

# upgrade alle geïnstalleerde modules
cpan-u

# installeer modules (sole -i is optioneel)
cpan -i Netscape::Booksmarks Zakelijk::ISBN

# forceer installatiemodules (moet -i gebruiken)
cpan -fi CGI::Minimale URI

MILIEU VARIABELEN

Er zijn verschillende componenten in CPAN.pm die omgevingsvariabelen gebruiken. De bouw
tools, ExtUtils::MakeMaker en Module::Build gebruiken sommige, terwijl andere belangrijk zijn voor de
niveaus daarboven. Sommige hiervan zijn gespecificeerd door de Perl Toolchain Gang:

Lancaster-consensus:


Oslo-consensus:


CPAN_OPTS
"cpan" splitst deze variabele op in witruimte en zet die lijst vooraf aan @ARGV
het verwerkt de opdrachtregelargumenten. Bijvoorbeeld als je altijd wilt gebruiken
"local:lib", kunt u "CPAN_OPTS" instellen op "-I".

CPANSCRIPT_LOGLEVEL
Het logniveau dat moet worden gebruikt, met de ingebouwde, minimale logger of Log::Log4perl if
het is geïnstalleerd. Mogelijke waarden zijn hetzelfde als de "Log::Log4perl"-niveaus:
"TRACE", "DEBUG", "INFO", "WARN", "ERROR" en "FATAL". De standaardinstelling is "INFO".

GIT_COMMAND
Het pad naar het binaire bestand "git" dat moet worden gebruikt voor de Git-functies. De standaardwaarde is
"/usr/local/bin/git".

NONINTERACTIVE_TESTING
Stel dat niemand oplet en prompts overslaat voor distributies die dat doen
correct. cpan(1) stelt dit in op 1, tenzij het al een waarde heeft (zelfs als dat het geval is).
waarde is onwaar).

PERL_MM_USE_DEFAULT
Gebruik het standaardantwoord voor gestelde vragen. cpan(1) stelt dit in op 1, tenzij dit het geval is
heeft al een waarde (zelfs als die waarde onwaar is).

EXIT WAARDEN

Het script eindigt met nul als het denkt dat alles werkte, of met een positief getal als dat het geval is
denkt dat er iets is mislukt. Houd er echter rekening mee dat het in sommige gevallen een mislukking moet voorspellen
door de output van dingen waar hij geen controle over heeft. Voorlopig zijn de exitcodes vaag:

1 Een onbekende fout

2 Het was een extern probleem

4 Er was een intern probleem met het script

8 Een module kon niet worden geïnstalleerd

TO DO

* eenmalige configuratiewaarden vanaf de opdrachtregel

Gebruik cpan online met behulp van onworks.net-services