cpanmp - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

cpanm - lấy, giải nén xây dựng và cài đặt mô-đun từ CPAN

SYNOPSIS

Kiểm tra cpanm :: Thêm # cài đặt Kiểm tra :: Thêm
cpanm MIYAGAWA / Plack-0.99_05.tar.gz # đường dẫn phân phối đầy đủ
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # cài đặt từ URL
cpanm ~ / dists / MyCompany-Enterprise-1.00.tar.gz # cài đặt từ một tệp cục bộ
cpanm - Nhiệm vụ tương tác :: Kensho # Định cấu hình tương tác
cpanm. # cài đặt từ thư mục cục bộ
cpanm --installdeps. # cài đặt tất cả các deps cho thư mục hiện tại
cpanm -L extlib Plack # cài đặt Plack và tất cả các deps không phải lõi vào extlib
cpanm --mirror http://cpan.cpantesters.org/ DBI # sử dụng gương đồng bộ hóa nhanh
cpanm - từ https://cpan.metacpan.org/ Plack # chỉ sử dụng máy nhân bản HTTPS

HÀNG

(tranh luận)
Đối số dòng lệnh có thể là tên mô-đun, tệp phân phối, tệp cục bộ
đường dẫn, URL HTTP hoặc URL kho lưu trữ git. Tất cả các lệnh sau sẽ hoạt động như bạn mong đợi.

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

Ngoài ra, bạn có thể sử dụng ký hiệu bằng "~" và "@" để chỉ định phiên bản cho
mô-đun đã cho. "~" chỉ định yêu cầu phiên bản trong định dạng CPAN :: Meta :: Spec,
trong khi "@" ghim phiên bản chính xác và là phím tắt cho "~" == VERSION "".

cpanm Plack ~ 1.0000 # 1.0000 trở lên
cpanm Plack ~ "> = 1.0000, <2.0000" # mới nhất của 1.xxxx
cpanm [email được bảo vệ] # phiên bản cụ thể. giống như Plack ~ "== 0.9990"

Truy vấn phiên bản bao gồm phiên bản hoặc phạm vi cụ thể sẽ được gửi đến MetaCPAN để
tìm kiếm các bản phát hành trước đó. Theo mặc định, truy vấn sẽ tìm kiếm các kho lưu trữ BackPAN,
trừ khi bạn chỉ định tùy chọn "--dev", trong trường hợp đó, các phiên bản đã lưu trữ sẽ được lọc
ngoài.

Đối với kho lưu trữ git, bạn có thể chỉ định một nhánh, thẻ hoặc cam kết SHA để xây dựng. Các
mặc định là "chính"

cpanm git: //github.com/plack/[email được bảo vệ] # nhãn
cpanm git: //github.com/plack/Plack.git@devel # branch

-i, --cài đặt
Cài đặt các mô-đun. Đây là một hành vi mặc định và đây chỉ là một sự tương thích
tùy chọn để làm cho nó hoạt động như cpan hoặc cpanp.

- tự nâng cấp
Tự nâng cấp. Nó chỉ là một bí danh cho:

Ứng dụng cpanm :: cpanminus

--thông tin
Hiển thị thông tin phân phối ở định dạng "AUTHOR / Dist-Name-ver.tar.gz" trong
ra tiêu chuẩn.

--installdeps
Cài đặt các phần phụ thuộc của bản phân phối đích nhưng sẽ không tự tạo. Tiện dụng nếu
bạn muốn dùng thử ứng dụng từ kho lưu trữ được kiểm soát phiên bản chẳng hạn như git.

cpanm --installdeps.

--nhìn
Tải xuống và giải nén bản phân phối, sau đó mở thư mục bằng trình bao của bạn.
Tiện dụng để xem mã nguồn hoặc kiểm tra thủ công.

-h, - trợ giúp
Hiển thị thông báo trợ giúp.

-V, - phiên bản
Hiển thị số phiên bản.

LỰA CHỌN

Bạn có thể chỉ định các tùy chọn mặc định trong biến môi trường "PERL_CPANM_OPT".

-f, - lực lượng
Buộc cài đặt các mô-đun ngay cả khi thử nghiệm không thành công.

-n, --chú ý
Bỏ qua việc kiểm tra các mô-đun. Chỉ sử dụng điều này khi bạn chỉ muốn tiết kiệm thời gian cho
cài đặt hàng trăm bản phân phối cho cùng một perl và kiến ​​trúc mà bạn đã có
đã được kiểm tra để đảm bảo rằng nó hoạt động tốt.

Mặc định là false và bạn có thể nói "--no-notest" để ghi đè khi nó được đặt trong
tùy chọn mặc định trong "PERL_CPANM_OPT".

- chỉ thử nghiệm
Chỉ chạy thử nghiệm và không cài đặt mô-đun hoặc bản phân phối được chỉ định. Tiện dụng nếu
bạn muốn xác minh các bản phát hành mới (hoặc thậm chí cũ) vượt qua các bài kiểm tra đơn vị của nó mà không
cài đặt mô-đun.

Lưu ý rằng nếu bạn chỉ định tùy chọn này với một mô-đun hoặc bản phân phối có
các phụ thuộc, các phụ thuộc này sẽ được cài đặt nếu bạn hiện chưa có.

-s, --sudo
Chuyển sang người dùng root với "sudo" khi cài đặt mô-đun. Sử dụng cái này nếu bạn muốn
cài đặt mô-đun vào hệ thống perl bao gồm đường dẫn.

Mặc định là false và bạn có thể nói "--no-sudo" để ghi đè khi nó được đặt trong
tùy chọn mặc định trong "PERL_CPANM_OPT".

-v, --verbose
Làm cho đầu ra dài dòng. Nó cũng cho phép cấu hình tương tác. (Nhìn thấy
- tương tác)

-q, --quiet
Làm cho đầu ra thậm chí còn yên tĩnh hơn so với mặc định. Nó chỉ hiển thị thành công / thất bại
phụ thuộc vào đầu ra.

-l, --local-lib
Đặt đường dẫn cục bộ :: lib tương thích để cài đặt các mô-đun. Bạn không cần thiết lập cái này
nếu bạn đã định cấu hình các biến môi trường shell bằng cách sử dụng local :: lib, nhưng điều này
cũng có thể được sử dụng để ghi đè điều đó.

-L, --local-lib-chứa
Tương tự với "--local-lib" nhưng với bộ chứa --self. Tất cả các phụ thuộc không phải cốt lõi sẽ
được cài đặt ngay cả khi chúng đã được cài đặt.

Ví dụ,

cpanm -L extlib Plack

sẽ cài đặt Plack và tất cả các phụ thuộc không phải cốt lõi của nó vào thư mục "extlib",
có thể được tải từ ứng dụng của bạn với:

sử dụng local :: lib '/ path / to / extlib';

Lưu ý rằng tùy chọn này không KHÔNG làm việc đáng tin cậy với các cài đặt perl được cung cấp bởi
các nhà cung cấp hệ điều hành loại bỏ các mô-đun tiêu chuẩn khỏi perl, chẳng hạn như RHEL, Fedora
và CentOS, TRỪ KHI bạn cũng cài đặt các gói cung cấp tất cả các mô-đun đã được
tước. Đối với những hệ thống này, bạn có thể sẽ muốn cài đặt meta- "perl-core"
gói mà chỉ làm điều đó.

- sống khép kín
Khi kiểm tra các phần phụ thuộc, giả sử không có mô-đun không phải lõi nào được cài đặt trên
hệ thống. Tiện dụng nếu bạn muốn nhóm các phụ thuộc ứng dụng trong một thư mục để bạn
có thể phân phối cho các máy khác.

--exclude-nhà cung cấp
Không bao gồm các mô-đun được cài đặt theo đường dẫn 'nhà cung cấp' khi tìm kiếm lõi
mô-đun khi cờ "- tự chứa" có hiệu lực. Điều này khôi phục hành vi
từ trước phiên bản 1.7023

--gương
Chỉ định URL cơ sở cho máy nhân bản CPAN sử dụng, chẳng hạn như
"http://cpan.cpantesters.org/"(bạn có thể bỏ qua dấu gạch chéo). Bạn có thể chỉ định
nhiều URL phản chiếu bằng cách lặp lại tùy chọn dòng lệnh.

Bạn có thể sử dụng một thư mục cục bộ có cấu trúc nhân bản CPAN (được tạo bởi các công cụ như
như OrePAN hoặc Pinto) bằng cách sử dụng lược đồ URL đặc biệt "tệp: //". Nếu URL đã cho bắt đầu
với `/` (không có bất kỳ lược đồ nào), nó cũng được coi là một lược đồ tệp.

tệp cpanm --mirror: /// path / to / mirror
cpanm --mirror ~ / minicpan # Vì shell mở rộng ~ thành / home / user

Mặc định là "http://www.cpan.org/".

--mirror chỉ
Tải xuống tệp chỉ mục 02packages.details.txt.gz của mirror thay vì truy vấn
CPAN Meta DB. Điều này cũng sẽ chọn không gửi các phiên bản perl cục bộ của bạn tới
máy chủ cơ sở dữ liệu phụ trợ như CPAN Meta DB và MetaCPAN.

Chọn tùy chọn này nếu bạn đang sử dụng máy nhân bản cục bộ của CPAN, chẳng hạn như minicpan khi
bạn đang ngoại tuyến hoặc chỉ số CPAN của riêng bạn (còn gọi là darkpan).

--từ, -M
cpanm -M https://cpan.metacpan.org/
cpanm - từ https://cpan.metacpan.org/

Sử dụng URL phản chiếu đã cho và chỉ mục của nó làm có thể nguồn để tìm kiếm và tải xuống
mô-đun từ.

Nó hoạt động tương tự như kết hợp "--mirror" và "--mirror-only", với một sự khác biệt nhỏ:
không giống như "--mirror" mà phụ họa URL của danh sách các bản sao, "--from" (hoặc "-M" cho
ngắn) sử dụng URL được chỉ định làm có thể nguồn để tải xuống chỉ mục và mô-đun từ.
Điều này làm cho tùy chọn luôn ghi đè gương mặc định, có thể đã được đặt
thông qua các tùy chọn chung, chẳng hạn như tùy chọn được đặt bởi biến môi trường "PERL_CPANM_OPT".

Mẹo: Nó có thể hữu ích nếu bạn đặt tên cho các tùy chọn này bằng bí danh shell của mình, chẳng hạn như:

bí danh minicpanm = 'cpanm --from ~ / minicpan'
bí danh darkpan = 'cpanm --from http://mycompany.example.com/DPAN'

--mirror-index
THỰC NGHIỆM: Chỉ định đường dẫn tệp đến "02packages.details.txt" để tìm kiếm mô-đun
mục lục.

--cpanmetadb
THỰC NGHIỆM: Chỉ định một URI thay thế để tra cứu chỉ mục CPAN MetaDB.

--metacpan
Thích MetaCPAN API hơn CPAN MetaDB.

--cpanfile
THỰC NGHIỆM: Đã chỉ định một đường dẫn thay thế cho cpanfile để tìm kiếm, khi
Lệnh "--installdeps" đang được sử dụng. Mặc định là "cpanfile".

--lời nhắc
Lời nhắc khi kiểm tra không thành công để bạn có thể bỏ qua, buộc cài đặt, thử lại hoặc xem
vỏ để xem những gì đang xảy ra. Nó cũng nhắc nhở khi một trong những phụ thuộc không thành công nếu
bạn muốn tiến hành cài đặt.

Mặc định là false và bạn có thể nói "--no-prompt" để ghi đè nếu nó được đặt trong
tùy chọn mặc định trong "PERL_CPANM_OPT".

--dev
THỰC NGHIỆM: tìm kiếm cả bản phát hành mới hơn dành cho nhà phát triển. Giá trị mặc định là false.

- cài đặt lại
cpanm, khi được cung cấp tên mô-đun trong dòng lệnh (tức là "cpanm Plack"), kiểm tra
phiên bản cài đặt cục bộ đầu tiên và bỏ qua nếu nó đã được cài đặt. Tùy chọn này
làm cho nó bỏ qua kiểm tra, vì vậy:

cpanm - cài đặt lại Plack

sẽ cài đặt lại Plack ngay cả khi phiên bản được cài đặt cục bộ của bạn là mới nhất hoặc thậm chí mới hơn
(điều này sẽ xảy ra nếu bạn cài đặt bản phát hành dành cho nhà phát triển từ quyền kiểm soát phiên bản
kho lưu trữ).

Giá trị mặc định là false.

- tương tác
Làm cho cấu hình (chẳng hạn như "Makefile.PL" và "Build.PL") tương tác, vì vậy bạn có thể
trả lời các câu hỏi trong bản phân phối yêu cầu cấu hình tùy chỉnh hoặc Tác vụ ::
các bản phân phối.

Mặc định là false và bạn có thể nói "--no-tương tác" để ghi đè khi nó được đặt trong
tùy chọn mặc định trong "PERL_CPANM_OPT".

--pp, --pureperl
Ưu tiên xây dựng mô-đun thuần perl bằng cách đặt "PUREPERL_ONLY = 1" cho MakeMaker và
"--pureperl-only" cho các bản phân phối dựa trên Build.PL. Lưu ý rằng không phải tất cả CPAN
mô-đun hỗ trợ quy ước này được nêu ra.

--with-suggest, --with-suggest
THỰC NGHIỆM: Cài đặt các phần phụ thuộc được khai báo là "đề xuất" và "đề xuất"
tương ứng, theo thông số META. Khi các phần phụ thuộc này không cài đặt được, cpanm vẫn tiếp tục
cài đặt, vì chúng chỉ là đề xuất / gợi ý.

Việc kích hoạt điều này có thể tạo ra sự phụ thuộc vòng tròn đối với một số mô-đun trên CPAN,
khi "đề xuất" thêm một mô-đun sẽ "đề xuất" trở lại mô-đun đó.

Ngoài ra còn có "--without-recommend" và "--without-suggest" để ghi đè lên giá trị mặc định
quyết định được đưa ra trước đó trong "PERL_CPANM_OPT".

Giá trị mặc định là false cho cả hai.

--với-phát triển
THỰC NGHIỆM: Cài đặt phát triển phụ thuộc giai đoạn trong tệp META hoặc "cpanfile" khi
được sử dụng với "--installdeps". Giá trị mặc định là false.

- có tính năng, - không có tính năng, - có tất cả các tính năng
THỰC NGHIỆM: Chỉ định tính năng để bật, nếu một mô-đun hỗ trợ các tính năng tùy chọn
theo thông số META 2.0.

cpanm --with-feature = opt_csv Bảng tính :: Đọc

các tính năng cũng có thể được chọn tương tác khi tùy chọn "- tương tác" được bật.

"--with-all-features" bật tất cả các tính năng tùy chọn và "--without-feature" có thể
chọn một tính năng để tắt.

--configure-timeout, --build-timeout, --test-timeout
Chỉ định khoảng thời gian chờ (tính bằng giây) để đợi cấu hình, xây dựng và kiểm tra
tiến trình. Giá trị mặc định hiện tại là: 60 cho cấu hình, 3600 cho bản dựng và 1800 cho
thử nghiệm.

--configure-args, --build-args, --test-args, --install-args
THỰC NGHIỆM: Truyền các đối số cho các lệnh cấu hình / xây dựng / kiểm tra / cài đặt tương ứng,
cho một mô-đun nhất định để cài đặt.

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

Đối số chỉ được kích hoạt cho mô-đun được truyền dưới dạng đối số dòng lệnh, không
sự phụ thuộc.

--scandep
KHÔNG DÙNG: Quét sự thiếu hụt của các mô-đun đã cho và xuất cây dưới dạng văn bản
định dạng. (Xem "--format" bên dưới để có thêm tùy chọn)

Bởi vì lệnh này không thực sự cài đặt bất kỳ bản phân phối nào, nó sẽ hữu ích
điều đó bằng cách gõ:

cpanm --scandeps Catalyst :: Thời gian chạy

bạn có thể chắc chắn rằng mô-đun nào sẽ được cài đặt.

Lệnh này tính đến mô-đun nào bạn đã cài đặt trong
hệ thống. Nếu bạn muốn xem những mô-đun nào sẽ được cài đặt trên một vani perl
cài đặt, bạn có thể muốn kết hợp nó với tùy chọn "-L".

--định dạng
KHÔNG DÙNG: Xác định định dạng để hiển thị cây phụ thuộc đã quét. Có sẵn
các tùy chọn là "tree", "json", "yaml" và "dists".

tree Hiển thị cây ở định dạng văn bản thuần túy. Đây là giá trị mặc định.

json, yaml
Kết xuất cây ở định dạng JSON hoặc YAML. Các mô-đun JSON và YAML cần phải
được cài đặt tương ứng. Cây đầu ra được biểu diễn dưới dạng một bộ tuple đệ quy
của:

[phân phối, phụ thuộc]

và vùng chứa là một mảng chứa các phần tử gốc. Lưu ý rằng có
có thể là nhiều nút gốc, vì bạn có thể cung cấp nhiều mô-đun cho
Lệnh "--scandeps".

dists "dists" là một định dạng đầu ra đặc biệt, nơi nó in tên tệp phân phối
trong chiều sâu Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên gọi món sau khi giải quyết phụ thuộc, như:

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

có nghĩa là bạn có thể cài đặt các bản phân phối này theo thứ tự này mà không cần thêm
sự phụ thuộc. Khi kết hợp với tùy chọn "-L", sẽ rất hữu ích để phát lại
cài đặt trên các máy khác.

--save-dists
Chỉ định đường dẫn thư mục tùy chọn để sao chép tarball đã tải xuống trong máy nhân bản CPAN
cấu trúc thư mục tương thích tức là tác giả / id / A / AU / AUTHORS / Foo-Bar-version.tar.gz

Nếu tarball bản phân phối không đến từ CPAN, ví dụ: từ một tệp cục bộ hoặc từ
GitHub, sau đó nó sẽ được lưu trong nhà cung cấp / Foo-Bar-version.tar.gz.

- bóng đen
Gỡ cài đặt các tệp bóng của bản phân phối mà bạn đang cài đặt. Cái này
loại bỏ sự nhầm lẫn nếu bạn đang cố gắng cài đặt các mô-đun lõi (đời kép) từ
CPAN so với perl 5.10 trở lên hoặc các mô-đun đã từng dựa trên XS nhưng đã chuyển sang
perl tinh khiết ở một số phiên bản.

Nếu bạn chạy cpanm dưới dạng root và sử dụng "INSTALL_BASE" hoặc tương đương để chỉ định tùy chỉnh
đường dẫn cài đặt, bạn NÊN tắt tùy chọn này để không vô tình gỡ cài đặt
mô-đun cuộc sống kép từ lõi bao gồm đường dẫn.

Giá trị mặc định là true nếu phiên bản perl của bạn nhỏ hơn 5.12 và bạn có thể tắt điều đó
với "--no-uninst-shadow".

LƯU Ý: Vì phiên bản 1.3000 cờ này bị tắt theo mặc định cho perl mới hơn
5.12, vì với 5.12 @INC chứa thư mục site_perl trước thư viện lõi perl
đường dẫn và gỡ cài đặt bóng đổ không cần thiết nữa và gây hại nhiều hơn bằng cách xóa
các tệp từ đường dẫn thư viện lõi.

--gỡ cài đặt, -U
Gỡ cài đặt một mô-đun khỏi đường dẫn thư viện. Nó tìm thấy một danh sách gói cho các mô-đun nhất định, và
loại bỏ tất cả các tệp có trong cùng một bản phân phối.

Nếu bạn bật local :: lib, nó chỉ xóa các tệp khỏi thư mục local :: lib.

Nếu bạn cố gỡ cài đặt một mô-đun trong thư mục "perl" (tức là mô-đun lõi), sẽ xảy ra lỗi
được ném.

Một hộp thoại sẽ được nhắc để xác nhận các tệp sẽ bị xóa. Nếu bạn vượt qua tùy chọn "-f"
đồng thời, hộp thoại sẽ bị bỏ qua và buộc phải gỡ cài đặt.

--cascade-tìm kiếm
THỰC NGHIỆM: Chỉ định xem có phân tầng tìm kiếm khi bạn chỉ định nhiều máy nhân bản hay không
và một máy nhân bản không có mô-đun hoặc có phiên bản mô-đun thấp hơn
yêu cầu. Giá trị mặc định là false.

--skip cài đặt
Chỉ định xem một mô-đun được cung cấp trong dòng lệnh có bị bỏ qua hay không nếu phiên bản mới nhất của nó
đã được cài đặt. Giá trị mặc định là true.

LƯU Ý: Biến môi trường "PERL5LIB" phải được đặt chính xác để biến này hoạt động
với các mô-đun được cài đặt bằng local :: lib, trừ khi bạn luôn sử dụng tùy chọn "-l".

--skip-hài lòng
THỰC NGHIỆM: Chỉ định xem một mô-đun (và phiên bản) được cung cấp trong dòng lệnh có phải là
bỏ qua nếu nó đã được cài đặt.

Nếu bạn chạy:

cpanm - CGI DBI hài lòng với ekip ~ 1.2

cpanm sẽ không cài đặt chúng nếu bạn đã có CGI (cho bất kỳ phiên bản nào) hoặc có DBI
với phiên bản cao hơn 1.2. Nó tương tự như "--skip-install" nhưng trong khi
"--skip-install" kiểm tra xem mới nhất phiên bản CPAN đã được cài đặt,
"--skip-thoả mãn" kiểm tra xem phiên bản được yêu cầu (hay không, có nghĩa là bất kỳ phiên bản nào) là
cài đặt.

Giá trị mặc định là false.

--xác nhận
Xác minh tính toàn vẹn của các tệp phân phối được truy xuất từ ​​TẠM DỪNG bằng CHECKSUMS và
CHỮ KÝ (nếu tìm thấy). Giá trị mặc định là false.

--report-perl-phiên bản
Cho dù nó báo cáo phiên bản perl được cài đặt cục bộ cho máy chủ web khác nhau như
một phần của Tác nhân người dùng. Mặc định là true trừ khi các biến môi trường liên quan đến CI như
"TRAVIS", "CI" hoặc "AUTOMATED_TESTING" được bật. Bạn có thể vô hiệu hóa nó bằng cách sử dụng
"--no-report-perl-version".

- tự động dọn dẹp
Chỉ định số ngày mà thư mục công việc của cpanm hết hạn. Mặc định là 7,
có nghĩa là các thư mục công việc cũ sẽ được dọn dẹp sau một tuần.

Bạn có thể đặt giá trị thành 0 để làm cho cpan không bao giờ dọn dẹp các thư mục đó.

--man-trang
Tạo trang người dùng cho tệp thực thi (man1) và thư viện (man3).

Giá trị mặc định là true (do các trang người đàn ông tạo ra) trừ khi tùy chọn "-L | --local-lib-chứa" là
được cung cấp trong trường hợp đó nó được đặt thành false. Bạn có thể tắt nó bằng "--no-man-pages".

--lwp
Sử dụng mô-đun LWP để tải xuống nội dung qua HTTP. Mặc định là true và bạn có thể nói
"--no-lwp" để tắt sử dụng LWP, khi bạn muốn nâng cấp LWP từ CPAN trên một số bị hỏng
hệ thống perl.

--wget
Sử dụng GNU Wget (nếu có) để tải xuống nội dung. Mặc định là true và bạn có thể nói
"--no-wget" để tắt bằng Wget (các phiên bản Wget cũ hơn 1.9 không hỗ trợ
Tùy chọn "--retry-connrefused" được cpanm sử dụng).

--Xoăn
Sử dụng cURL (nếu có) để tải xuống nội dung. Mặc định là true và bạn có thể nói
"--no-curl" để tắt bằng cURL.

Thông thường với các tùy chọn "--lwp", "--wget" và "--curl" được đặt thành true (là
mặc định) cpanm thử LWP, Wget, cURL và HTTP :: Tiny (theo thứ tự đó) và sử dụng
một cái có sẵn.

Sử dụng cpanmp trực tuyến bằng các dịch vụ onworks.net