cpanmp - Online sa Cloud

PROGRAMA:

NAME

cpanm - kumuha, mag-unpack ng build at mag-install ng mga module mula sa CPAN

SINOPSIS

cpanm Test::Higit pa # install Test::Higit pa
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # buong distribution path
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # pag-install mula sa URL
cpanm ~/dists/MyCompany-Enterprise-1.00.tar.gz # i-install mula sa isang lokal na file
cpanm --interactive na Gawain::Kensho # I-configure nang interactive
cpanm . # i-install mula sa lokal na direktoryo
cpanm --installdeps . # i-install ang lahat ng mga deps para sa kasalukuyang direktoryo
cpanm -L extlib Plack # i-install ang Plack at lahat ng non-core deps sa extlib
cpanm --salamin http://cpan.cpantesters.org/ DBI # gamitin ang mabilis na pag-sync na salamin
cpanm --mula sa https://cpan.metacpan.org/ Plack # gamitin lang ang HTTPS mirror

UTOS

(mga argumento)
Ang mga argumento ng command line ay maaaring alinman sa isang pangalan ng module, pamamahagi ng file, lokal na file
path, HTTP URL o git repository URL. Ang pagsunod sa mga utos ay gagana lahat gaya ng iyong inaasahan.

cpanm Plack
cpanm Plack/Request.pm
cpanm MIYAGAWA/Plack-1.0000.tar.gz
cpanm /path/to/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

Bilang karagdagan, maaari mong gamitin ang notasyon gamit ang "~" at "@" upang tukuyin ang bersyon para sa a
ibinigay na modyul. Tinutukoy ng "~" ang kinakailangan sa bersyon sa format na CPAN::Meta::Spec,
habang pini-pin ng "@" ang eksaktong bersyon, at isang shortcut para sa "~"== VERSION"".

cpanm Plack~1.0000 # 1.0000 o mas bago
cpanm Plack~">= 1.0000, < 2.0000" # latest of 1.xxxx
cpanm [protektado ng email] # partikular na bersyon. katulad ng Plack~"== 0.9990"

Ang query ng bersyon kasama ang partikular na bersyon o saklaw ay ipapadala sa MetaCPAN sa
maghanap para sa mga nakaraang release. Ang query ay maghahanap ng BackPAN archive bilang default,
maliban kung tinukoy mo ang "--dev" na opsyon, kung saan, ang mga naka-archive na bersyon ay sasalain
out.

Para sa isang git repository, maaari mong tukuyin ang isang sangay, tag, o i-commit ang SHA upang bumuo. Ang
default ay "master"

cpanm git://github.com/plack/[protektado ng email] # tag
cpanm git://github.com/plack/Plack.git@devel # branch

-i, --i-install
Ini-install ang mga module. Ito ay isang default na gawi at ito ay isang compatibility lamang
pagpipilian upang gawin itong gumana tulad ng cpan o cpanp.

--pag-upgrade sa sarili
Mga upgrade mismo. Isa lang itong alias para sa:

cpanm App::cpanminus

--impormasyon
Ipinapakita ang impormasyon sa pamamahagi sa "AUTHOR/Dist-Name-ver.tar.gz" na format sa
standard out.

--installdeps
Ini-install ang mga dependency ng target na pamamahagi ngunit hindi bubuo sa sarili nito. Madaling gamitin kung
gusto mong subukan ang application mula sa isang bersyon na kinokontrol na repository tulad ng git.

cpanm --installdeps .

--tingnan mo
I-download at i-unpack ang pamamahagi at pagkatapos ay buksan ang direktoryo gamit ang iyong shell.
Madaling sundutin ang source code o gumawa ng manu-manong pagsubok.

-h, --tulong
Ipinapakita ang mensahe ng tulong.

-V, --versi
Ipinapakita ang numero ng bersyon.

Opsyon

Maaari mong tukuyin ang mga default na opsyon sa "PERL_CPANM_OPT" na environment variable.

-f, --puwersa
Pilitin ang pag-install ng mga module kahit na nabigo ang pagsubok.

-n, --tala
Laktawan ang pagsubok ng mga module. Gamitin lang ito kapag gusto mo lang makatipid ng oras
pag-install ng daan-daang mga distribusyon sa parehong perl at arkitektura na mayroon ka na
sinubukan upang matiyak na maayos itong buuin.

Default sa false, at maaari mong sabihin ang "--no-notest" upang i-override kapag nakatakda ito sa
mga default na opsyon sa "PERL_CPANM_OPT".

--test-lamang
Patakbuhin lamang ang mga pagsubok, at huwag i-install ang tinukoy na module o mga distribusyon. Madaling gamitin kung
gusto mong i-verify na ang mga bago (o kahit na luma) na mga release ay pumasa sa mga unit test nito nang wala
pag-install ng module.

Tandaan na kung tinukoy mo ang opsyong ito sa isang module o distribusyon na mayroon
dependencies, mai-install ang mga dependency na ito kung wala ka sa kasalukuyan.

-S, --sudo
Lumipat sa root user gamit ang "sudo" kapag nag-i-install ng mga module. Gamitin ito kung gusto mo
i-install ang mga module sa system perl isama ang landas.

Default sa false, at maaari mong sabihin ang "--no-sudo" upang i-override kapag ito ay nakatakda sa
mga default na opsyon sa "PERL_CPANM_OPT".

-v, --verbose
Ginagawang verbose ang output. Binibigyang-daan din nito ang interactive na pagsasaayos. (Tingnan
--interactive)

-q, --tahimik
Ginagawang mas tahimik ang output kaysa sa default. Ipinapakita lamang nito ang matagumpay/nabigo
dependencies sa output.

-l, --local-lib
Itinatakda ang local::lib compatible path kung saan mag-install ng mga module. Hindi mo kailangang itakda ito
kung na-configure mo na ang mga variable ng kapaligiran ng shell gamit ang local::lib, ngunit ito
maaaring gamitin upang i-override din iyon.

-L, --local-lib-contained
Pareho sa "--local-lib" ngunit may --self-contained set. Ang lahat ng hindi pangunahing dependency ay gagawin
mai-install kahit na naka-install na ang mga ito.

Halimbawa,

cpanm -L extlib Plack

ay mag-i-install ng Plack at lahat ng mga non-core dependencies nito sa direktoryo na "extlib",
na maaaring i-load mula sa iyong aplikasyon ng:

gumamit ng local::lib '/path/to/extlib';

Tandaan na ginagawa ng pagpipiliang ito HINDI mapagkakatiwalaang gumagana sa perl installation na ibinibigay ng
mga vendor ng operating system na nagtatanggal ng mga karaniwang module mula sa perl, gaya ng RHEL, Fedora
at CentOS, KUNG HINDI nag-i-install ka rin ng mga pakete na nagsusuplay ng lahat ng mga module na naging
hinubaran. Para sa mga system na ito ay malamang na gusto mong i-install ang "perl-core" meta-
package na ginagawa lang iyon.

--self-contained
Kapag sinusuri ang mga dependency, ipagpalagay na walang mga non-core na module ang naka-install sa
sistema. Madaling gamitin kung gusto mong i-bundle ang mga dependency ng application sa isang direktoryo upang ikaw
maaaring ipamahagi sa iba pang mga makina.

--bukod-nagbebenta
Huwag isama ang mga module na naka-install sa ilalim ng mga 'vendor' path kapag naghahanap ng core
module kapag ang "--self-contained" na flag ay may bisa. Ibinabalik nito ang pag-uugali
mula sa bago ang bersyon 1.7023

--salamin
Tinutukoy ang base URL para sa CPAN mirror na gagamitin, gaya ng
"http://cpan.cpantesters.org/" (maaari mong alisin ang trailing slash). Maaari mong tukuyin
maramihang mirror URL sa pamamagitan ng pag-uulit ng command line na opsyon.

Maaari kang gumamit ng isang lokal na direktoryo na may istraktura ng salamin ng CPAN (na nilikha ng mga tool tulad ng
bilang OrePAN o Pinto) sa pamamagitan ng paggamit ng espesyal na scheme ng URL na "file://". Kung magsisimula ang ibinigay na URL
na may `/` (nang walang anumang scheme), ito ay itinuturing din bilang isang file scheme.

cpanm --mirror file:///path/to/mirror
cpanm --salamin ~/minicpan # Dahil lumalawak ang shell ~ sa /home/user

Default sa "http://www.cpan.org/".

--salamin-lamang
I-download ang 02packages.details.txt.gz index file ng salamin sa halip na i-query ang
CPAN Meta DB. Ito rin ay epektibong mag-o-opt out sa pagpapadala ng iyong lokal na perl na mga bersyon sa
backend database server tulad ng CPAN Meta DB at MetaCPAN.

Piliin ang opsyong ito kung gumagamit ka ng lokal na salamin ng CPAN, gaya ng minicpan kung kailan
ikaw ay offline, o ang iyong sariling CPAN index (aka darkpan).

--galing
cpanm -M https://cpan.metacpan.org/
cpanm --mula sa https://cpan.metacpan.org/

Gamitin ang ibinigay na mirror URL at ang index nito bilang ang lamang pinagmulan upang maghanap at mag-download
mga module mula sa.

Gumagana ito katulad ng "--mirror" at "--mirror-only" na pinagsama, na may maliit na pagkakaiba:
hindi tulad ng "--salamin" na append ang URL sa listahan ng mga salamin, "--mula sa" (o "-M" para sa
short) ay gumagamit ng tinukoy na URL bilang nito lamang pinagmulan kung saan ida-download ang index at mga module.
Ginagawa nitong palaging na-override ng opsyon ang default na salamin, na maaaring naitakda
sa pamamagitan ng mga pandaigdigang opsyon gaya ng itinakda ng "PERL_CPANM_OPT" na environment variable.

Tip: Maaaring maging kapaki-pakinabang kung pangalanan mo ang mga opsyong ito gamit ang iyong mga shell alias, tulad ng:

alias minicpanm='cpanm --mula sa ~/minicpan'
alias darkpan='cpanm --mula sa http://mycompany.example.com/DPAN'

--mirror-index
NALALAMAN: Tinutukoy ang path ng file sa "02packages.details.txt" para sa paghahanap ng module
index.

--cpanmetadb
NALALAMAN: Tumutukoy ng kahaliling URI para sa CPAN MetaDB index lookup.

--metacpan
Mas pinipili ang MetaCPAN API kaysa sa CPAN MetaDB.

--cpanfile
NALALAMAN: Tinukoy ang isang alternatibong landas para sa cpanfile na hahanapin, kung kailan
Ginagamit ang command na "--installdeps". Default sa "cpanfile".

--prompt
Nagpo-prompt kapag nabigo ang isang pagsubok upang maaari mong laktawan, pilitin ang pag-install, subukang muli o tumingin sa
shell upang makita kung ano ang nangyayari mali. Nag-prompt din ito kapag nabigo ang isa sa dependency kung
gusto mong ituloy ang pag-install.

Default sa false, at maaari mong sabihin ang "--no-prompt" na i-override kung ito ay nakatakda sa
mga default na opsyon sa "PERL_CPANM_OPT".

--dev
NALALAMAN: maghanap din ng mas bagong release ng developer. Default sa false.

--i-install muli
cpanm, kapag binigyan ng pangalan ng module sa command line (ibig sabihin, "cpanm Plack"), sinusuri ang
lokal na naka-install na bersyon muna at nilalaktawan kung naka-install na ito. Ang pagpipiliang ito
ginagawa nitong laktawan ang tseke, kaya:

cpanm --reinstall ang Plack

ay muling i-install ang Plack kahit na ang iyong lokal na naka-install na bersyon ay pinakabago, o mas bago
(na mangyayari kung mag-i-install ka ng developer release mula sa version control
mga repositoryo).

Default sa false.

--interactive
Ginagawang interactive ang configuration (gaya ng "Makefile.PL" at "Build.PL"), para magawa mo
sagutin ang mga tanong sa pamamahagi na nangangailangan ng custom na configuration o Gawain::
distribusyon.

Default sa false, at maaari mong sabihin ang "--no-interactive" upang i-override kapag ito ay nakatakda sa
mga default na opsyon sa "PERL_CPANM_OPT".

--pp, --pureperl
Mas gusto ang Pure perl build ng mga module sa pamamagitan ng pagtatakda ng "PUREPERL_ONLY=1" para sa MakeMaker at
"--pureperl-only" para sa Build.PL based distribution. Tandaan na hindi lahat ng CPAN
Sinusuportahan pa ng mga module ang kumbensyong ito.

--with-recommend, --with-suggests
NALALAMAN: Nag-install ng mga dependency na idineklara bilang "nagrerekomenda" at "nagmumungkahi"
ayon sa pagkakabanggit, ayon sa META spec. Kapag hindi na-install ang mga dependency na ito, magpapatuloy ang cpanm
ang pag-install, dahil ang mga ito ay rekomendasyon/suhestyon lamang.

Ang pagpapagana nito ay posibleng makagawa ng circular dependency para sa ilang module sa CPAN,
kapag nagdagdag ang "recommend" ng module na "recommend" back the module in return.

Mayroon ding "--without-recommend" at "--without-suggests" para i-override ang default
naunang ginawang desisyon sa "PERL_CPANM_OPT".

Default sa false para sa pareho.

--sa-develop
NALALAMAN: Ang mga pag-install ay nagkakaroon ng mga phase dependencies sa META file o "cpanfile" kapag
ginamit sa "--installdeps". Default sa false.

--with-feature, --without-feature, --with-all-features
NALALAMAN: Tinutukoy ang tampok na paganahin, kung sinusuportahan ng isang module ang mga opsyonal na tampok
bawat META spec 2.0.

cpanm --with-feature=opt_csv Spreadsheet::Basahin

ang mga tampok ay maaari ding interactive na mapili kapag ang "--interactive" na opsyon ay pinagana.

Ang "--with-all-features" ay nagbibigay-daan sa lahat ng opsyonal na feature, at ang "--without-feature" ay maaaring
pumili ng feature na idi-disable.

--configure-timeout, --build-timeout, --test-timeout
Tukuyin ang haba ng timeout (sa mga segundo) upang maghintay para sa pag-configure, pagbuo at pagsubok
proseso. Ang mga kasalukuyang default na halaga ay: 60 para sa pag-configure, 3600 para sa build at 1800 para sa
pagsubok.

--configure-args, --build-args, --test-args, --install-args
NALALAMAN: Ipasa ang mga argumento para sa configure/build/test/install commands ayon sa pagkakabanggit,
para mai-install ang isang ibinigay na module.

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

Ang argumento ay pinagana lamang para sa module na ipinasa bilang isang command line argument, hindi
dependencies.

--scandeps
DEPRECATE NA: Ini-scan ang mga depencencies ng mga ibinigay na module at i-output ang tree sa isang text
pormat. (Tingnan ang "--format" sa ibaba para sa higit pang mga opsyon)

Dahil ang command na ito ay hindi aktwal na nag-i-install ng anumang mga distribusyon, ito ay magiging kapaki-pakinabang
na sa pamamagitan ng pag-type ng:

cpanm --scandeps Catalyst::Runtime

maaari mong tiyakin kung anong mga module ang mai-install.

Isinasaalang-alang ng command na ito kung aling mga module ang na-install mo na sa iyong
sistema. Kung gusto mong makita kung anong mga module ang mai-install laban sa isang vanilla perl
pag-install, maaaring gusto mong pagsamahin ito sa opsyong "-L".

--format
DEPRECATE NA: Tinutukoy kung anong format ang ipapakita ang na-scan na dependency tree. Available
ang mga pagpipilian ay "puno", "json", "yaml" at "dists".

tree Ipinapakita ang puno sa isang plain text na format. Ito ang default na halaga.

json, yaml
Inilalabas ang puno sa JSON o YAML na format. Ang mga module ng JSON at YAML ay kailangang
naka-install ayon sa pagkakabanggit. Ang output tree ay kinakatawan bilang isang recursive tuple
ng:

[ pamamahagi, dependencies ]

at ang lalagyan ay isang array na naglalaman ng mga elemento ng ugat. Tandaan na doon
maaaring maraming root node, dahil maaari kang magbigay ng maramihang mga module sa
"--scandeps" na utos.

dists "dists" ay isang espesyal na format ng output, kung saan ito nagpi-print ng distribution filename
nasa lalim una order pagkatapos ng resolusyon ng dependency, tulad ng:

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

na nangangahulugan na maaari mong i-install ang mga distribusyon na ito sa pagkakasunud-sunod na ito nang walang dagdag
dependencies. Kapag pinagsama sa "-L" na opsyon, magiging kapaki-pakinabang ang pag-replay
mga pag-install sa iba pang mga makina.

--save-dists
Tinutukoy ang opsyonal na path ng direktoryo upang kopyahin ang mga na-download na tarball sa salamin ng CPAN
katugmang istraktura ng direktoryo ie authors/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

Kung ang distro tarball ay hindi nagmula sa CPAN, halimbawa mula sa isang lokal na file o mula sa
GitHub, pagkatapos ay mase-save ito sa ilalim vendor/Foo-Bar-version.tar.gz.

--uninst-shadows
Ina-uninstall ang mga shadow file ng pamamahagi na iyong ini-install. Ito
inaalis ang pagkalito kung sinusubukan mong mag-install ng mga core (dual-life) na module mula sa
CPAN laban sa perl 5.10 o mas matanda, o mga module na dating nakabatay sa XS ngunit lumipat sa
purong perl sa ilang bersyon.

Kung magpapatakbo ka ng cpanm bilang root at gumamit ng "INSTALL_BASE" o katumbas nito upang tukuyin ang custom
landas sa pag-install, DAPAT mong i-disable ang opsyong ito para hindi mo sinasadyang ma-uninstall
Kasama sa mga dual-life module mula sa core ang landas.

Default sa true kung ang iyong perl na bersyon ay mas maliit sa 5.12, at maaari mong i-disable iyon
na may "--no-uninst-shadows".

NOTA: Dahil ang bersyon 1.3000 ay naka-off ang flag na ito bilang default para sa perl na mas bago kaysa
5.12, dahil may 5.12 @INC ay naglalaman ng direktoryo ng site_perl bago ang perl core library
path, at ang pag-uninstall ng mga anino ay hindi na kailangan at mas nakakapinsala sa pamamagitan ng pagtanggal
mga file mula sa pangunahing landas ng library.

--uninstall, -U
Ina-uninstall ang isang module mula sa path ng library. Nakahanap ito ng packlist para sa mga ibinigay na module, at
inaalis ang lahat ng mga file na kasama sa parehong pamamahagi.

Kung pinagana mo ang local::lib, inaalis lang nito ang mga file mula sa local::lib na direktoryo.

Kung susubukan mong i-uninstall ang isang module sa "perl" na direktoryo (ibig sabihin, core module), magkakaroon ng error
itapon.

Ipo-prompt ang isang dialog upang kumpirmahin ang mga file na tatanggalin. Kung pumasa ka sa "-f" na opsyon
pati na rin, ang dialog ay lalaktawan at ang pag-uninstall ay pipilitin.

--cascade-search
NALALAMAN: Tinutukoy kung i-cascade ang paghahanap kapag tumukoy ka ng maraming salamin
at ang salamin ay walang module o may mas mababang bersyon ng module kaysa
hiniling. Default sa false.

--skip-installed
Tinutukoy kung ang isang module na ibinigay sa command line ay nilaktawan kung ang pinakabagong bersyon nito
Naka-install na. Default sa true.

NOTA: Ang variable na environment na "PERL5LIB" ay kailangang itakda nang tama para gumana ito
na may mga module na naka-install gamit ang local::lib, maliban kung palagi mong ginagamit ang opsyong "-l".

--skip-satisfied
NALALAMAN: Tinutukoy kung ang isang module (at bersyon) na ibinigay sa command line ay
nilaktawan kung naka-install na ito.

Kung tatakbo ka:

cpanm --skip-satisfied CGI DBI~1.2

Hindi mai-install ng cpanm ang mga ito kung mayroon ka nang CGI (para sa anumang mga bersyon) o may DBI
na may bersyon na mas mataas sa 1.2. Ito ay katulad ng "--skip-installed" ngunit habang
Sinusuri ng "--skip-installed" kung ang pinakahuli bersyon ng CPAN ay naka-install,
Sinusuri ng "--skip-satisfied" kung ang isang hiniling na bersyon (o hindi, na nangangahulugang anumang bersyon) ay
-install.

Default sa false.

-I-verify
I-verify ang integridad ng mga file ng pamamahagi na nakuha mula sa PAUSE gamit ang CHECKSUMS at
MGA PIRMA (kung natagpuan). Default sa false.

--report-perl-version
Iniuulat man nito ang lokal na naka-install na bersyon ng perl sa iba't ibang web server bilang
bahagi ng User-Agent. Default sa true maliban kung ang mga variable ng environment na nauugnay sa CI gaya ng
Naka-enable ang "TRAVIS", "CI" o "AUTOMATED_TESTING". Maaari mong i-disable ito sa pamamagitan ng paggamit
"--no-report-perl-version".

--auto-cleanup
Tinutukoy ang bilang ng mga araw kung kailan mag-e-expire ang mga direktoryo ng trabaho ng cpanm. Default sa 7,
na nangangahulugan na ang mga lumang direktoryo ng trabaho ay lilinisin sa loob ng isang linggo.

Maaari mong itakda ang halaga sa 0 upang hindi kailanman linisin ng cpan ang mga direktoryo na iyon.

--man-pages
Bumubuo ng mga man page para sa mga executable (man1) at mga library (man3).

Default sa true (mga man page na nabuo) maliban kung ang "-L|--local-lib-contained" na opsyon ay
ibinigay kung saan ito ay nakatakda sa false. Maaari mo itong i-disable gamit ang "--no-man-pages".

--lwp
Gumagamit ng LWP module upang mag-download ng mga bagay sa HTTP. Default sa true, at masasabi mo
"--no-lwp" upang huwag paganahin ang paggamit ng LWP, kapag gusto mong i-upgrade ang LWP mula sa CPAN sa ilang sirang
perl system.

--wget
Gumagamit ng GNU Wget (kung magagamit) para mag-download ng mga bagay-bagay. Default sa true, at masasabi mo
"--no-wget" upang huwag paganahin ang paggamit ng Wget (mga bersyon ng Wget na mas matanda sa 1.9 ay hindi sumusuporta sa
"--retry-connrefused" na opsyon na ginamit ng cpanm).

--kulot
Gumagamit ng cURL (kung available) para mag-download ng mga bagay-bagay. Default sa true, at masasabi mo
"--no-curl" upang huwag paganahin ang paggamit ng cURL.

Karaniwang may mga opsyon na "--lwp", "--wget" at "--curl" na nakatakda sa true (na kung saan ay ang
default) sinusubukan ng cpanm ang LWP, Wget, cURL at HTTP::Tiny (sa ayos na iyon) at ginagamit ang una
magagamit ang isa.

Gumamit ng cpanmp online gamit ang mga serbisyo ng onworks.net