cpanmp - Dalam talian di Awan

JADUAL:

NAMA

cpanm - dapatkan, bongkar binaan dan pasang modul daripada CPAN

SINOPSIS

Ujian cpanm::Lagi # pasang Ujian::Lagi
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # laluan pengedaran penuh
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # pasang dari URL
cpanm ~/dists/MyCompany-Enterprise-1.00.tar.gz # pasang daripada fail tempatan
cpanm --interactive Task::Kensho # Konfigurasikan secara interaktif
cpanm . # pasang dari direktori tempatan
cpanm --installdeps . # pasang semua deps untuk direktori semasa
cpanm -L extlib Plack # pasang Plack dan semua deps bukan teras ke dalam extlib
cpanm --cermin http://cpan.cpantesters.org/ DBI # gunakan cermin penyegerakan pantas
cpanm --dari https://cpan.metacpan.org/ Plack # gunakan cermin HTTPS sahaja

PERINTAH

(hujah)
Argumen baris arahan boleh sama ada nama modul, fail pengedaran, fail tempatan
laluan, URL HTTP atau URL repositori git. Mengikut arahan semuanya akan berfungsi seperti yang anda harapkan.

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

Selain itu, anda boleh menggunakan tatatanda menggunakan "~" dan "@" untuk menentukan versi a
modul yang diberikan. "~" menentukan keperluan versi dalam format CPAN::Meta::Spec,
manakala "@" menyematkan versi yang tepat dan merupakan pintasan untuk "~" == VERSION"".

cpanm Plack~1.0000 # 1.0000 atau lebih baru
cpanm Plack~">= 1.0000, < 2.0000" # terkini daripada 1.xxxx
cpanm [e-mel dilindungi] # versi khusus. sama seperti Plack~"== 0.9990"

Pertanyaan versi termasuk versi atau julat tertentu akan dihantar ke MetaCPAN ke
cari keluaran sebelumnya. Pertanyaan akan mencari arkib BackPAN secara lalai,
melainkan anda menentukan pilihan "--dev", dalam hal ini, versi yang diarkibkan akan ditapis
keluar.

Untuk repositori git, anda boleh menentukan cawangan, teg, atau komit SHA untuk membina. The
lalai ialah "tuan"

cpanm git://github.com/plack/[e-mel dilindungi] # tag
cpanm git://github.com/plack/Plack.git@devel # cawangan

-i, --pasang
Memasang modul. Ini ialah tingkah laku lalai dan ini hanyalah keserasian
pilihan untuk menjadikannya berfungsi seperti cpan atau cpanp.

--naik taraf diri
Menaik taraf sendiri. Ia hanyalah alias untuk:

Apl cpanm::cpanminus

--maklumat
Memaparkan maklumat pengedaran dalam format "AUTHOR/Dist-Name-ver.tar.gz" dalam format
standard keluar.

--installdeps
Memasang kebergantungan pengedaran sasaran tetapi tidak akan membina sendiri. Berguna jika
anda ingin mencuba aplikasi daripada repositori terkawal versi seperti git.

cpanm --installdeps .

--lihat
Muat turun dan bongkar pengedaran dan kemudian buka direktori dengan shell anda.
Berguna untuk mencari kod sumber atau melakukan ujian manual.

-h, --bantuan
Memaparkan mesej bantuan.

-V, - Penukaran
Memaparkan nombor versi.

PILIHAN

Anda boleh menentukan pilihan lalai dalam pembolehubah persekitaran "PERL_CPANM_OPT".

-f, --force
Paksa memasang modul walaupun ujian gagal.

-n, --nota
Langkau ujian modul. Gunakan ini hanya apabila anda hanya mahu menjimatkan masa
memasang beratus-ratus pengedaran ke perl dan seni bina yang sama yang anda telah lakukan
diuji untuk memastikan ia dibina dengan baik.

Lalai kepada palsu dan anda boleh menyebut "--no-notes" untuk mengatasi apabila ia ditetapkan dalam
pilihan lalai dalam "PERL_CPANM_OPT".

--ujian sahaja
Jalankan ujian sahaja, dan jangan pasang modul atau pengedaran yang ditentukan. Berguna jika
anda ingin mengesahkan keluaran baharu (atau lama) lulus ujian unitnya tanpa
memasang modul.

Ambil perhatian bahawa jika anda menentukan pilihan ini dengan modul atau pengedaran yang mempunyai
kebergantungan, kebergantungan ini akan dipasang jika anda tidak memilikinya pada masa ini.

-S, --sudo
Beralih kepada pengguna root dengan "sudo" semasa memasang modul. Gunakan ini jika anda mahu
pasang modul ke sistem perl include path.

Lalai kepada palsu, dan anda boleh menyebut "--no-sudo" untuk mengatasi apabila ia ditetapkan dalam
pilihan lalai dalam "PERL_CPANM_OPT".

-v, --verbose
Menjadikan output bertele-tele. Ia juga membolehkan konfigurasi interaktif. (Lihat
--interaktif)

-q, --senyap
Menjadikan output lebih senyap daripada lalai. Ia hanya menunjukkan yang berjaya/gagal
kebergantungan kepada output.

-l, --local-lib
Menetapkan laluan serasi local::lib untuk memasang modul. Anda tidak perlu menetapkan ini
jika anda sudah mengkonfigurasi pembolehubah persekitaran shell menggunakan local::lib, tetapi ini
boleh digunakan untuk mengatasinya juga.

-L, --local-lib-terkandung
Sama dengan "--local-lib" tetapi dengan --set serba lengkap. Semua kebergantungan bukan teras akan
dipasang walaupun ia telah dipasang.

Sebagai contoh,

cpanm -L extlib Plack

akan memasang Plack dan semua kebergantungan bukan terasnya ke dalam direktori "extlib",
yang boleh dimuatkan daripada aplikasi anda dengan:

gunakan local::lib '/path/to/extlib';

Ambil perhatian bahawa pilihan ini tidak TIDAK boleh dipercayai berfungsi dengan pemasangan perl yang dibekalkan oleh
vendor sistem pengendalian yang menanggalkan modul standard daripada perl, seperti RHEL, Fedora
dan CentOS, KECUALI anda juga memasang pakej yang membekalkan semua modul yang telah
dibogelkan. Untuk sistem ini, anda mungkin mahu memasang meta- "perl-core"
pakej yang melakukan perkara itu.

--berdikari
Apabila memeriksa kebergantungan, anggap tiada modul bukan teras dipasang pada
sistem. Berguna jika anda ingin menggabungkan kebergantungan aplikasi dalam satu direktori supaya anda
boleh edarkan ke mesin lain.

--kecualikan-vendor
Jangan sertakan modul yang dipasang di bawah laluan 'vendor' semasa mencari teras
modul apabila bendera "--self-contained" berkuat kuasa. Ini memulihkan tingkah laku
dari sebelum versi 1.7023

--cermin
Menentukan URL asas untuk cermin CPAN untuk digunakan, seperti
"http://cpan.cpantesters.org/" (anda boleh meninggalkan garis miring di belakang). Anda boleh menentukan
berbilang URL cermin dengan mengulangi pilihan baris arahan.

Anda boleh menggunakan direktori tempatan yang mempunyai struktur cermin CPAN (dicipta oleh alat seperti
sebagai OrePAN atau Pinto) dengan menggunakan skema URL khas "file://". Jika URL yang diberikan bermula
dengan `/` (tanpa sebarang skema), ia dianggap sebagai skema fail juga.

cpanm --mirror file:///path/to/mirror
cpanm --cermin ~/minicpan # Kerana shell mengembang ~ ke /home/user

Lalai kepada "http://www.cpan.org/".

--cermin sahaja
Muat turun fail indeks 02packages.details.txt.gz cermin dan bukannya menanyakan
CPAN Meta DB. Ini juga akan menarik diri daripada menghantar versi perl tempatan anda dengan berkesan
pelayan pangkalan data bahagian belakang seperti CPAN Meta DB dan MetaCPAN.

Pilih pilihan ini jika anda menggunakan cermin tempatan CPAN, seperti minicpan bila
anda di luar talian, atau indeks CPAN anda sendiri (aka darkpan).

--daripada, -M
cpanm -M https://cpan.metacpan.org/
cpanm --dari https://cpan.metacpan.org/

Gunakan URL cermin yang diberikan dan indeksnya sebagai hanyalah sumber untuk mencari dan memuat turun
modul daripada.

Ia berfungsi serupa dengan gabungan "--mirror" dan "--mirror-only", dengan perbezaan kecil:
tidak seperti "--cermin" yang melampirkan URL ke senarai cermin, "--dari" (atau "-M" untuk
short) menggunakan URL yang ditentukan sebagai URLnya hanyalah sumber untuk memuat turun indeks dan modul daripada.
Ini menjadikan pilihan sentiasa mengatasi cermin lalai, yang mungkin telah ditetapkan
melalui pilihan global seperti yang ditetapkan oleh pembolehubah persekitaran "PERL_CPANM_OPT".

Petua: Ia mungkin berguna jika anda menamakan pilihan ini dengan alias shell anda, seperti:

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

--cermin-indeks
PERCUBAAN: Menentukan laluan fail kepada "02packages.details.txt" untuk carian modul
indeks.

--cpanmetadb
PERCUBAAN: Menentukan URI ganti untuk carian indeks CPAN MetaDB.

--metacpan
Lebih suka MetaCPAN API daripada CPAN MetaDB.

--cpanfile
PERCUBAAN: Menentukan laluan alternatif untuk cpanfile mencari, bila
Perintah "--installdeps" sedang digunakan. Lalai kepada "cpanfile".

--prompt
Menggesa apabila ujian gagal supaya anda boleh melangkau, memasang paksa, mencuba semula atau melihat dalam
shell untuk melihat apa yang berlaku. Ia juga menggesa apabila salah satu pergantungan gagal jika
anda mahu meneruskan pemasangan.

Lalai kepada palsu dan anda boleh menyebut "--no-prompt" untuk membatalkan jika ia ditetapkan dalam
pilihan lalai dalam "PERL_CPANM_OPT".

--dev
PERCUBAAN: cari keluaran pembangun yang lebih baharu juga. Lalai kepada palsu.

--pasang semula
cpanm, apabila diberi nama modul dalam baris arahan (iaitu "cpanm Plack"), semak
versi yang dipasang secara tempatan dahulu dan langkau jika ia sudah dipasang. Pilihan ini
menjadikannya melangkau semak, jadi:

cpanm --pasang semula Plack

akan memasang semula Plack walaupun versi pemasangan tempatan anda adalah terkini, atau lebih baharu
(yang akan berlaku jika anda memasang keluaran pembangun daripada kawalan versi
repositori).

Lalai kepada palsu.

--interaktif
Menjadikan konfigurasi (seperti "Makefile.PL" dan "Build.PL") interaktif, supaya anda boleh
jawab soalan dalam pengedaran yang memerlukan konfigurasi tersuai atau Tugas::
pembahagian.

Lalai kepada palsu dan anda boleh menyebut "--no-interactive" untuk mengatasi apabila ia ditetapkan dalam
pilihan lalai dalam "PERL_CPANM_OPT".

--pp, --purperl
Lebih suka binaan modul Perl Tulen dengan menetapkan "PUREPERL_ONLY=1" untuk MakeMaker dan
"--pureperl-only" untuk pengedaran berasaskan Build.PL. Ambil perhatian bahawa bukan semua CPAN
modul menyokong konvensyen ini lagi.

--dengan-syor, --dengan-cadangan
PERCUBAAN: Memasang kebergantungan diisytiharkan sebagai "mengesyorkan" dan "mencadangkan"
masing-masing, mengikut spesifikasi META. Apabila kebergantungan ini gagal dipasang, cpanm diteruskan
pemasangan, kerana ia hanya cadangan/cadangan.

Mendayakan ini berpotensi membuat pergantungan bulat untuk beberapa modul pada CPAN,
apabila "mengesyorkan" menambah modul yang "mencadangkan" kembali modul sebagai balasan.

Terdapat juga "--tanpa-cadang" dan "--tanpa-cadang" untuk mengatasi lalai
keputusan yang dibuat lebih awal dalam "PERL_CPANM_OPT".

Lalai kepada palsu untuk kedua-duanya.

--dengan-membangunkan
PERCUBAAN: Pemasangan membangunkan kebergantungan fasa dalam fail META atau "cpanfile" apabila
digunakan dengan "--installdeps". Lalai kepada palsu.

--dengan-ciri, --tanpa-ciri, --dengan-semua-ciri
PERCUBAAN: Menentukan ciri untuk didayakan, jika modul menyokong ciri pilihan
mengikut spesifikasi META 2.0.

cpanm --with-feature=opt_csv Hamparan::Baca

ciri juga boleh dipilih secara interaktif apabila pilihan "--interactive" didayakan.

"--dengan-semua-ciri" membolehkan semua ciri pilihan, dan "--tanpa-ciri" boleh
pilih ciri untuk dilumpuhkan.

--configure-timeout, --build-timeout, --test-timeout
Tentukan tempoh tamat masa (dalam saat) untuk menunggu konfigurasi, bina dan ujian
proses. Nilai lalai semasa ialah: 60 untuk konfigurasi, 3600 untuk binaan dan 1800 untuk
ujian.

--configure-args, --build-args, --test-args, --install-args
PERCUBAAN: Lulus hujah masing-masing untuk konfigurasi/bina/uji/pasang,
untuk memasang modul tertentu.

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

Argumen hanya didayakan untuk modul yang diluluskan sebagai argumen baris arahan, bukan
kebergantungan.

--scandeps
TERDAPAT: Mengimbas ketergantungan modul yang diberikan dan mengeluarkan pokok dalam teks
format. (Lihat "--format" di bawah untuk lebih banyak pilihan)

Kerana arahan ini sebenarnya tidak memasang sebarang pengedaran, ia akan berguna
itu dengan menaip:

cpanm --scandeps Catalyst::Rtime

anda boleh memastikan modul apa yang akan dipasang.

Perintah ini mengambil kira modul mana yang telah anda pasang dalam anda
sistem. Jika anda ingin melihat modul apa yang akan dipasang pada perl vanila
pemasangan, anda mungkin mahu menggabungkannya dengan pilihan "-L".

--format
TERDAPAT: Menentukan format untuk memaparkan pokok pergantungan yang diimbas. Tersedia
pilihan ialah "pokok", "json", "yaml" dan "dists".

pokok Memaparkan pokok dalam format teks biasa. Ini ialah nilai lalai.

json, yaml
Mengeluarkan pepohon dalam format JSON atau YAML. Modul JSON dan YAML perlu
dipasang masing-masing. Pokok keluaran diwakili sebagai tupel rekursif
daripada:

[ pengedaran, tanggungan ]

dan bekas ialah tatasusunan yang mengandungi unsur akar. Perhatikan bahawa di sana
mungkin berbilang nod akar, kerana anda boleh memberikan berbilang modul kepada
Perintah "--scandeps".

dits "dists" ialah format keluaran khas, di mana ia mencetak nama fail pengedaran
dalam kedalaman pertama bagi selepas resolusi pergantungan, seperti:

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

yang bermaksud anda boleh memasang pengedaran ini dalam susunan ini tanpa tambahan
kebergantungan. Apabila digabungkan dengan pilihan "-L", ia berguna untuk dimainkan semula
pemasangan pada mesin lain.

--save-dists
Menentukan laluan direktori pilihan untuk menyalin tarball yang dimuat turun dalam cermin CPAN
struktur direktori yang serasi iaitu authors/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

Jika tarball distro tidak datang dari CPAN, contohnya dari fail tempatan atau dari
GitHub, maka ia akan disimpan di bawah vendor/Foo-Bar-version.tar.gz.

--tidak terhalang-bayang
Menyahpasang fail bayangan pengedaran yang anda pasang. ini
menghapuskan kekeliruan jika anda cuba memasang modul teras (dwi-hidup) daripada
CPAN terhadap perl 5.10 atau lebih lama, atau modul yang dahulunya berasaskan XS tetapi bertukar kepada
perl tulen pada beberapa versi.

Jika anda menjalankan cpanm sebagai root dan gunakan "INSTALL_BASE" atau yang setara untuk menentukan tersuai
laluan pemasangan, anda HARUS melumpuhkan pilihan ini supaya anda tidak akan menyahpasang secara tidak sengaja
modul dwi-hidup dari teras termasuk laluan.

Lalai kepada benar jika versi perl anda lebih kecil daripada 5.12, dan anda boleh melumpuhkannya
dengan "--no-uninst-shadows".

NOTA: Sejak versi 1.3000 bendera ini dimatikan secara lalai untuk perl yang lebih baru daripada
5.12, kerana dengan 5.12 @INC mengandungi direktori site_perl sebelum perpustakaan teras perl
laluan, dan menyahpasang bayang tidak perlu lagi dan mendatangkan lebih mudarat dengan memadam
fail daripada laluan perpustakaan teras.

--nyahpasang, -U
Menyahpasang modul daripada laluan perpustakaan. Ia mencari senarai pek untuk modul yang diberikan, dan
mengalih keluar semua fail yang disertakan dalam pengedaran yang sama.

Jika anda mendayakan local::lib, ia hanya mengalih keluar fail daripada direktori local::lib.

Jika anda cuba menyahpasang modul dalam direktori "perl" (iaitu modul teras), ralat akan berlaku
dilemparkan.

Dialog akan digesa untuk mengesahkan fail yang akan dipadamkan. Jika anda lulus pilihan "-f".
serta, dialog akan dilangkau dan penyahpasangan akan dipaksa.

--pencarian lata
PERCUBAAN: Menentukan sama ada untuk melonjakkan carian apabila anda menentukan berbilang cermin
dan cermin tidak mempunyai modul atau mempunyai versi modul yang lebih rendah daripada
diminta. Lalai kepada palsu.

--langkau-dipasang
Menentukan sama ada modul yang diberikan dalam baris arahan dilangkau jika versi terkininya
sudah dipasang. Lalai kepada benar.

NOTA: Pembolehubah persekitaran "PERL5LIB" perlu ditetapkan dengan betul agar ini berfungsi
dengan modul dipasang menggunakan local::lib, melainkan anda sentiasa menggunakan pilihan "-l".

--skip-puas hati
PERCUBAAN: Menentukan sama ada modul (dan versi) yang diberikan dalam baris arahan adalah
dilangkau jika ia sudah dipasang.

Jika anda menjalankan:

cpanm --langkau-CGI DBI yang berpuas hati~1.2

cpanm tidak akan memasangnya jika anda sudah mempunyai CGI (untuk apa-apa versi) atau mempunyai DBI
dengan versi lebih tinggi daripada 1.2. Ia serupa dengan "--skip-installed" tetapi sementara
"--langkau-dipasang" menyemak sama ada Terkini versi CPAN dipasang,
"--skip-satisfied" menyemak sama ada versi yang diminta (atau tidak, yang bermaksud mana-mana versi) adalah
dipasang.

Lalai kepada palsu.

--sahkan
Sahkan integriti fail pengedaran yang diambil daripada PAUSE menggunakan CHECKSUMS dan
TANDATANGAN (jika didapati). Lalai kepada palsu.

--report-perl-version
Sama ada ia melaporkan versi perl yang dipasang secara tempatan kepada pelbagai pelayan web sebagai
sebahagian daripada Ejen Pengguna. Lalai kepada benar melainkan pembolehubah persekitaran berkaitan CI seperti
"TRAVIS", "CI" atau "AUTOMATED_TESTING" didayakan. Anda boleh melumpuhkannya dengan menggunakan
"--no-report-perl-version".

--pembersihan automatik
Menentukan bilangan hari di mana direktori kerja cpanm tamat tempoh. Lalai kepada 7,
yang bermaksud direktori kerja lama akan dibersihkan dalam masa satu minggu.

Anda boleh menetapkan nilai kepada 0 untuk menjadikan cpan tidak pernah membersihkan direktori tersebut.

--halaman manusia
Menghasilkan halaman manual untuk boleh laku (man1) dan perpustakaan (man3).

Lalai kepada benar (halaman manual dijana) melainkan pilihan "-L|--local-lib-contained" ialah
dibekalkan dalam kes ini ia ditetapkan kepada palsu. Anda boleh melumpuhkannya dengan "--no-man-pages".

--lwp
Menggunakan modul LWP untuk memuat turun bahan melalui HTTP. Lalai kepada benar, dan anda boleh katakan
"--no-lwp" untuk melumpuhkan menggunakan LWP, apabila anda ingin menaik taraf LWP daripada CPAN pada beberapa yang rosak
sistem perl.

--wget
Menggunakan GNU Wget (jika ada) untuk memuat turun bahan. Lalai kepada benar, dan anda boleh katakan
"--no-wget" untuk melumpuhkan menggunakan Wget (versi Wget lebih lama daripada 1.9 tidak menyokong
Pilihan "--retry-connrefused" yang digunakan oleh cpanm).

--keriting
Menggunakan cURL (jika ada) untuk memuat turun bahan. Lalai kepada benar, dan anda boleh katakan
"--no-curl" untuk melumpuhkan penggunaan cURL.

Biasanya dengan pilihan "--lwp", "--wget" dan "--curl" ditetapkan kepada benar (iaitu
lalai) cpanm mencuba LWP, Wget, cURL dan HTTP::Tiny (dalam susunan itu) dan menggunakan yang pertama
satu tersedia.

Gunakan cpanmp dalam talian menggunakan perkhidmatan onworks.net