cpanmp - クラウドでオンライン

プログラム：

NAME

cpanm - CPAN からモジュールを取得、解凍し、ビルドおよびインストールします

SYNOPSIS

cpanm Test::More # install Test::More
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # フル配布パス
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # URLからインストール
cpanm ~/dists/MyCompany-Enterprise-1.00.tar.gz # ローカルファイルからインストール
cpanm --interactive Task::Kensho # 対話的に設定する
cpanm 。 # ローカルディレクトリからインストール
cpanm --installdeps 。 # 現在のディレクトリのすべてのdepsをインストールします
cpanm -L extlib Plack # Plack とすべての非コア DEP を extlib にインストールします
cpanm --ミラー http://cpan.cpantesters.org/ DBI # 高速同期ミラーを使用する
cpanm --from https://cpan.metacpan.org/ Plack # HTTPS ミラーのみを使用します

コマンド

(引数)
コマンドライン引数にはモジュール名、配布ファイル、ローカルファイルのいずれかを指定できます。
パス、HTTP URL、または git リポジトリ URL。 次のコマンドはすべて期待どおりに機能します。

cpanm プラック
cpanm Plack/Request.pm
cpanm 宮川/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

さらに、「~」と「@」を使用した表記を使用してバージョンを指定できます。
与えられたモジュール。 「~」はバージョン要件を CPAN::Meta::Spec 形式で指定します。
「@」は正確なバージョンを固定し、「~」== VERSION"" のショートカットです。

cpanm Plack~1.0000 # 1.0000以降
cpanm Plack~">= 1.0000, < 2.0000" # 1.xxxx の最新
cpanm [メール保護] # 特定のバージョン。 Plack と同じ~"== 0.9990"

特定のバージョンまたは範囲を含むバージョン クエリが MetaCPAN に送信され、
以前のリリースを検索します。 クエリはデフォルトで BackPAN アーカイブを検索します。
「--dev」オプションを指定しない限り、その場合、アーカイブされたバージョンがフィルタリングされます。
不足しています。

git リポジトリの場合、ビルドするブランチ、タグ、またはコミット SHA を指定できます。 の
デフォルトは「マスター」です

cpanm git://github.com/plack/[メール保護] ＃ 鬼ごっこ
cpanm git://github.com/plack/Plack.git@devel # ブランチ

-i、--install
モジュールをインストールします。 これはデフォルトの動作であり、単なる互換性です
cpan または cpanp のように動作させるオプション。

-自己アップグレード
それ自体をアップグレードします。 これは単なるエイリアスです。

cpanm アプリ::cpanminus

- 情報
配布情報を「AUTHOR/配布名-ver.tar.gz」の形式で表示します。
標準アウト。

--installdeps
ターゲット ディストリビューションの依存関係をインストールしますが、それ自体はビルドされません。 便利な場合
git などのバージョン管理されたリポジトリからアプリケーションを試してみたいと考えています。

cpanm --installdeps 。

- 見て
ディストリビューションをダウンロードして解凍し、シェルでディレクトリを開きます。
ソース コードを調べたり、手動テストを行ったりするのに便利です。

-h、-help
ヘルプメッセージを表示します。

-V、-version
バージョン番号を表示します。

OPTIONS

デフォルトのオプションは「PERL_CPANM_OPT」環境変数で指定できます。

-f、-force
テストが失敗した場合でもモジュールを強制的にインストールします。

-n、--notest
モジュールのテストをスキップします。 時間を節約したい場合にのみこれを使用してください
すでにインストールされているのと同じ Perl とアーキテクチャに何百ものディストリビューションをインストールする
正常に構築されることを確認するためにテストされました。

デフォルトは false で、設定されている場合は「--no-notest」と言ってオーバーライドできます。
「PERL_CPANM_OPT」のデフォルトのオプション。

-テストのみ
テストのみを実行し、指定されたモジュールやディストリビューションをインストールしないでください。 便利な場合
新しい (または古い) リリースが単体テストに合格することを確認したい場合
モジュールのインストール中。

モジュールまたはディストリビューションでこのオプションを指定した場合、
依存関係が存在しない場合は、これらの依存関係がインストールされます。

-S、--sudo
モジュールをインストールするときは、「sudo」を使用して root ユーザーに切り替えます。 必要な場合はこれを使用してください
モジュールをシステム Perl インクルード パスにインストールします。

デフォルトは false で、設定されている場合は「--no-sudo」と言ってオーバーライドできます。
「PERL_CPANM_OPT」のデフォルトのオプション。

-v、-verbose
出力を冗長にします。 また、対話型の構成も可能になります。 （見る
- 相互の作用）

-q、-quiet
出力をデフォルトよりもさらに静かにします。 成功/失敗のみが表示されます
出力への依存関係。

-l、--local-lib
モジュールをインストールする local::lib 互換パスを設定します。 これを設定する必要はありません
local::lib を使用してシェル環境変数をすでに設定している場合、しかしこれは
それをオーバーライドするためにも使用できます。

-L、--local-lib-contained
「--local-lib」も同様ですが、--self-contained set も同様です。 すべての非コア依存関係は、
すでにインストールされている場合でもインストールできます。

例えば、

cpanm -L extlib プラック

Plack とそのすべての非コア依存関係をディレクトリ「extlib」にインストールします。
これは、次のコマンドを使用してアプリケーションからロードできます。

local::lib '/path/to/extlib' を使用します。

このオプションは次のことを行うことに注意してください。 NOT によって提供される Perl インストールで確実に動作します。
Perl から標準モジュールを削除するオペレーティング システム ベンダー (RHEL、Fedora など)
そしてCentOS、 無限 また、これまでに提供されたすべてのモジュールを提供するパッケージもインストールします。
剥ぎ取られた。 これらのシステムの場合、おそらく「perl-core」メタ
まさにそれを行うパッケージ。

-自己完結型
依存関係を調べるときは、非コア モジュールがインストールされていないことを前提とします。
システム。 アプリケーションの依存関係を XNUMX つのディレクトリにバンドルして、
他のマシンに配布できます。

--除外ベンダー
コアを検索するときに、「ベンダー」パスの下にインストールされたモジュールを含めないでください
「--self-contained」フラグが有効な場合のモジュール。 これにより動作が復元されます
バージョン1.7023より前から

- 鏡
使用する CPAN ミラーのベース URL を指定します。たとえば、
"http://cpan.cpantesters.org/" (末尾のスラッシュは省略できます)。
コマンド ライン オプションを繰り返して、複数のミラー URL を作成します。

CPAN ミラー構造を持つローカル ディレクトリを使用できます (CPAN ミラー構造などのツールによって作成されます)。
特別な URL スキーム「file://」を使用して、OrePAN または Pinto として) を使用します。 指定された URL が始まる場合
`/` (スキームなし) を使用すると、ファイル スキームとしても考慮されます。

cpanm --mirror file:///path/to/mirror
cpanm --ミラー ~/ミニパン # シェルが ~ を /home/user に展開するため

デフォルトは「http://www.cpan.org/".

--ミラーのみ
クエリを実行する代わりに、ミラーの 02packages.details.txt.gz インデックス ファイルをダウンロードします。
CPAN メタ DB。 これにより、ローカル Perl バージョンの送信も事実上オプトアウトされます。
CPAN Meta DB や MetaCPAN などのバックエンド データベース サーバー。

CPAN のローカル ミラー（minicpan など）を使用している場合は、このオプションを選択します。
オフラインであるか、独自の CPAN インデックス (別名 darkpan)。

--から、-M
cpanm-M https://cpan.metacpan.org/
cpanm --https://cpan.metacpan.org/ から

指定されたミラー URL とそのインデックスを の 検索してダウンロードするソース
からのモジュール。

これは、「--mirror」と「--mirror-only」を組み合わせたものと同様に機能しますが、わずかな違いがあります。
「--mirror」とは異なります。 追加します ミラーのリストへの URL、「--from」（または「-M」）
short) は、指定された URL をその URL として使用します。 の インデックスとモジュールをダウンロードするソース。
これにより、このオプションは、設定されている可能性のあるデフォルトのミラーを常にオーバーライドします。
「PERL_CPANM_OPT」環境変数で設定されたものなどのグローバル オプションを使用します。

ヒント： 次のように、これらのオプションにシェルの別名を付けて名前を付けると便利な場合があります。

エイリアス minicpanm='cpanm --from ~/ミニパン'
エイリアス darkpan='cpanm --from http://mycompany.example.com/DPAN'

--ミラーインデックス
実験: モジュール検索用「02packages.details.txt」へのファイルパスを指定します
インデックス。

--cpanmetadb
実験: CPAN MetaDB インデックス ルックアップの代替 URI を指定します。

--メタパン
CPAN MetaDB よりも MetaCPAN API を優先します。

--cpanfile
実験: 検索する cpanfile の代替パスを指定しました。
「--installdeps」コマンドが使用されています。 デフォルトは「cpanfile」です。

- 促す
テストが失敗したときにプロンプ​​トを表示し、スキップ、強制インストール、再試行、または内容の確認を行うことができます。
シェルを使用して何が問題なのかを確認してください。 また、依存関係の XNUMX つが失敗した場合にもプロンプトが表示されます。
インストールを続行したいとします。

デフォルトは false で、設定されている場合は「--no-prompt」と言ってオーバーライドできます。
「PERL_CPANM_OPT」のデフォルトのオプション。

--dev
実験: 新しい開発者リリースも検索します。 デフォルトは false です。

-再インストール
cpanm は、コマンドラインでモジュール名 (つまり「cpanm Plack」) を指定すると、
ローカルにインストールされているバージョンが最初にインストールされ、すでにインストールされている場合はスキップされます。 このオプション
チェックをスキップするので、次のようになります。

cpanm --Plack を再インストールする

ローカルにインストールされているバージョンが最新またはそれより新しい場合でも、Plack を再インストールします
(これは、バージョン管理から開発者リリースをインストールした場合に起こります)
リポジトリ)。

デフォルトは false です。

- 相互の作用
構成 (「Makefile.PL」や「Build.PL」など) を対話型にすることで、
カスタム構成またはタスク:: を必要とするディストリビューション内の質問に回答します。
分布

デフォルトは false で、設定されている場合は「--no-interactive」と言ってオーバーライドできます。
「PERL_CPANM_OPT」のデフォルトのオプション。

--pp、--pureperl
MakeMaker に対して「PUREPERL_ONLY=1」を設定して、モジュールの Pure perl ビルドを優先します。
Build.PL ベースのディストリビューションの場合は「--pureperl-only」。 すべての CPAN がサポートされるわけではないことに注意してください。
モジュールはまだこの規則をサポートしています。

--with-recommends、--with-suggests
実験: 「推奨」および「提案」として宣言された依存関係をインストールします。
それぞれ META 仕様ごとに。 これらの依存関係のインストールに失敗しても、cpanm は続行します。
これらは単なる推奨/提案であるため、インストールについては説明しません。

これを有効にすると、CPAN 上のいくつかのモジュールに循環依存関係が生じる可能性があります。
"recommends" を実行するとモジュールが追加され、そのモジュールがそのモジュールを "recommends" として返します。

デフォルトをオーバーライドする「--without-recommend」と「--without-suggests」もあります。
「PERL_CPANM_OPT」で以前に決定されました。

どちらもデフォルトは false です。

--with-develop
実験: 開発フェーズの依存関係を META ファイルまたは「cpanfile」にインストールします。
「--installdeps」とともに使用されます。 デフォルトは false です。

--with-feature、--without-feature、--with-all-features
実験: モジュールがオプション機能をサポートしている場合、有効にする機能を指定します。
META 仕様 2.0 に準拠。

cpanm --with-feature=opt_csv スプレッドシート::読み取り

「--interactive」オプションが有効な場合は、機能を対話的に選択することもできます。

「--with-all-features」はすべてのオプション機能を有効にし、「--without-feature」はすべてのオプション機能を有効にします。
無効にする機能を選択します。

--configure-timeout、--build-timeout、--test-timeout
構成、ビルド、テストを待機するタイムアウトの長さを秒単位で指定します。
プロセス。 現在のデフォルト値は、構成の場合は 60、ビルドの場合は 3600、ビルドの場合は 1800 です。
テスト。

--configure-args、--build-args、--test-args、--install-args
実験:configure/build/test/install コマンドにそれぞれ引数を渡します。
特定のモジュールをインストールします。

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

引数は、コマンド ライン引数として渡されたモジュールに対してのみ有効です。
依存関係。

--スキャンデプス
廃止: 指定されたモジュールの依存関係をスキャンし、ツリーをテキストで出力します。
フォーマット。 (その他のオプションについては、以下の「--format」を参照してください)

このコマンドは実際にはディストリビューションをインストールしないため、役に立ちます。
次のように入力すると、

cpanm --scandeps Catalyst::ランタイム

どのモジュールがインストールされるかを確認できます。

このコマンドは、すでにインストールされているモジュールを考慮します。
システム。 バニラ Perl に対してどのようなモジュールがインストールされるかを確認したい場合
インストールする場合は、「-L」オプションと組み合わせることをお勧めします。

- フォーマット
廃止: スキャンされた依存関係ツリーを表示する形式を決定します。 利用可能
オプションは「tree」、「json」、「yaml」、「dists」です。

ツリー ツリーをプレーンテキスト形式で表示します。 これがデフォルト値です。

json、yaml
ツリーを JSON または YAML 形式で出力します。 JSON および YAML モジュールは次のようにする必要があります。
それぞれインストールされています。 出力ツリーは再帰タプルとして表されます。
の：

[ ディストリビューション、依存関係 ]

コンテナはルート要素を含む配列です。 そこに注意してください
複数のモジュールを与えることができるため、複数のルート ノードになる可能性があります。
「--scandeps」コマンド。

dists 「dists」は特別な出力形式で、配布ファイル名を出力します。
セクションに 深さ 最初の 注文 依存関係の解決後は次のようになります。

GAAS/MIME-Base64-3.13.tar.gz
GAAS/URI-1.58.tar.gz
PETDANCE/HTML-タグセット-3.20.tar.gz
GAAS/HTML-Parser-3.68.tar.gz
GAAS/libwww-perl-5.837.tar.gz

つまり、これらのディストリビューションをこの順序で追加せずにインストールできます。
依存関係。 「-L」オプションと組み合わせると、リプレイに便利です。
他のマシンへのインストール。

--save-dists
ダウンロードした tarball を CPAN ミラーにコピーするためのオプションのディレクトリ パスを指定します
互換性のあるディレクトリ構造、すなわち 著者/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

ディストリビューション tarball が CPAN から取得されたものではない場合 (たとえば、ローカル ファイルや
GitHub の場合、以下に保存されます ベンダー/Foo-Bar-version.tar.gz.

--uninst-shadows
インストールしているディストリビューションのシャドウ ファイルをアンインストールします。 これ
コア (デュアルライフ) モジュールをインストールしようとしている場合の混乱を解消します。
Perl 5.10 以前に対する CPAN、または以前は XS ベースであったが XS ベースに切り替えられたモジュール
バージョンによっては純粋な Perl。

cpanm を root として実行し、「INSTALL_BASE」または同等のものを使用してカスタムを指定する場合
インストール パスを誤ってアンインストールしないように、このオプションを無効にする必要があります。
コアからのデュアルライフ モジュールにはパスが含まれます。

Perl バージョンが 5.12 より小さい場合、デフォルトは true になり、これを無効にすることができます。
「--no-uninst-shadows」を使用します。

注意: バージョン 1.3000 以降、このフラグは、それ以降の Perl ではデフォルトでオフになっています。
5.12 (5.12 では @INC に site_perl ディレクトリが含まれているため) Perlコアライブラリ
パスを削除するため、シャドウをアンインストールする必要はなくなり、削除することでさらに害が生じます。
コア ライブラリ パスからのファイル。

--アンインストール、-U
ライブラリ パスからモジュールをアンインストールします。 指定されたモジュールのパックリストを検索し、
同じディストリビューションに含まれるすべてのファイルを削除します。

local::lib を有効にすると、local::lib ディレクトリからファイルのみが削除されます。

「perl」ディレクトリ内のモジュール（つまり、コアモジュール）をアンインストールしようとすると、エラーが発生します。
投げられる。

削除するファイルを確認するダイアログが表示されます。 「-f」オプションを渡す場合
同様に、ダイアログはスキップされ、アンインストールが強制されます。

--カスケード検索
実験: 複数のミラーを指定した場合にカスケード検索を行うかどうかを指定します
ミラーにはモジュールがないか、ミラーよりも低いバージョンのモジュールが含まれています。
要求されました。 デフォルトは false です。

--スキップインストール済み
コマンドラインで指定されたモジュールが最新バージョンの場合にスキップされるかどうかを指定します
はすでにインストールされています。 デフォルトは true です。

注意: これが機能するには、「PERL5LIB」環境変数が正しく設定されている必要があります
常に "-l" オプションを使用する場合を除き、local::lib を使用してモジュールをインストールします。

--スキップ-満足
実験: コマンドラインで指定されたモジュール (およびバージョン) が
すでにインストールされている場合はスキップされます。

実行する場合:

cpanm --skip-satisfied CGI DBI~1.2

すでに CGI (バージョンを問わず) を持っている場合、または DBI を持っている場合、cpanm はそれらをインストールしません。
バージョン 1.2 以降。 「--skip-installed」に似ていますが、
「--skip-installed」は、 最新の CPAN のバージョンがインストールされている場合、
「--skip-satisfied」は、要求されたバージョン (またはそうでない、つまり任意のバージョン) が
インストールされています。

デフォルトは false です。

- 確認
CHECKSUMS を使用して PAUSE から取得した配布ファイルの整合性を検証し、
署名 (見つかった場合)。 デフォルトは false です。

--レポート-perl-バージョン
ローカルにインストールされた Perl バージョンをさまざまな Web サーバーに報告するかどうか
ユーザーエージェントの一部。 CI 関連の環境変数がない限り、デフォルトは true になります。
「TRAVIS」、「CI」または「AUTOMATED_TESTING」が有効になっています。 を使用して無効にできます
「--no-report-perl-version」。

--自動クリーンアップ
cpanm の作業ディレクトリが期限切れになる日数を指定します。 デフォルトは 7、
つまり、古い作業ディレクトリは XNUMX 週間以内にクリーンアップされます。

値を 0 に設定すると、cpan がこれらのディレクトリをクリーンアップしないようにできます。

--man-ページ
実行可能ファイル (man1) とライブラリ (man3) のマニュアル ページを生成します。

「-L|--local-lib-contained」オプションが指定されていない限り、デフォルトは true (man ページが生成される) です。
指定された場合は false に設定されます。 「--no-man-pages」で無効にできます。

--lwp
LWP モジュールを使用して HTTP 経由でダウンロードします。 デフォルトは true です。次のように言えます。
「--no-lwp」は、壊れたデバイスで CPAN から LWP をアップグレードする場合に、LWP の使用を無効にします。
パールシステム。

--wget
GNU Wget (利用可能な場合) を使用してダウンロードします。 デフォルトは true です。次のように言えます。
「--no-wget」は、Wget の使用を無効にします (1.9 より古いバージョンの Wget は、
cpanm によって使用される「--retry-connrefred」オプション）。

- カール
cURL (利用可能な場合) を使用してダウンロードします。 デフォルトは true です。次のように言えます。
「--no-curl」は cURL の使用を無効にします。

通常、「--lwp」、「--wget」、および「--curl」オプションを true に設定します（これは
デフォルト）cpanm は、LWP、Wget、cURL、HTTP::Tiny を（この順序で）試行し、最初のものを使用します。
XNUMX つ利用可能です。

onworks.net サービスを使用してオンラインで cpanmp を使用する