Big Sky :: cpanfile とは何か、なぜそれを使いたいのか

超絶意訳

What is cpanfile and why do I want to use it - Tatsuhiko Miyagawa's blog

What is cpanfile and why do I want to use it So there seems to be a couple of blog posts and even co...
http://weblog.bulknews.net/post/44963580392/what-is-cpanfile-and-why-do-i-want-to-use-it

cpanfile について幾つかブログ記事やカンファレンスがある様です。素晴らしい事です。ですがそれは単に、それが何であるか、またそれらがなぜ必要なのか(もしくは必要じゃないのか)を、筆者の説明と共に書かれているだけなのです。

tl;dr 日本の方へ - この Hokkaido.pm でのスライドの冒頭にある「cpanfile とは何か」は素晴らしい。

cpanfile は以下の2つのユースケースを明確に分ける目的で作られました。二つ目については偶発的ですが。

1)「アプリケーション(ウェブアプリでコマンドライン・スクリプト)があり、そのCPANモジュール依存性をなんとかして管理したい。 CPANにリリースする予定はないが、その依存性等を記述する偽に Makefile.PL を書いた。」

2)「git リポジトリ上に perl モジュールがあり、またコントリビュータがリポジトリからインストール出来る様にしたい。でも inc/Moudle/Install.pm がロード出来ないって言ってるし、リポジトリに inc を含めたり META.yml の衝突は望ましくない。」

cpanfile は CPANモジュールの依存を記述する Module::Install のようなDSLです。そのファイルを解析するためのモジュールを付属してるけど、あらゆる特定のビルダーやインストーラにも結び付けられていない。

CPAN の依存について記述したい Perl アプリケーション開発者に有用で、carton install もしくは cpanm --installdeps . で簡単にインストール出来る。

CPAN module author へ。git リポジトリから簡単に(すぐさま)インストール出来るって恩恵が得られるんだけど、cpanfile は絶対に移行すべき物って訳じゃないよ。(すぐさま)と書いたのには理由があって、cpanm 1.6 の時点では、git リポジトリから提供される M::I ブートストラップ相当の機能はない。これは既知の問題なんだけど cpanm 1.7 の前あたりから取り組んでる。 (configure_requiresの中で Module::Install を指定するって代替手段はある。でも、CPANに送っても全く必要ないしそれって間違ってるよね。)

標準CPANインストーラー(CPAN.pm、CPANPLUS、cpanm)は依存性を検知するのに META ファイル(もしくはその後のMYMETA)で動作してる。

これが標準だし cpanfile はこれらの全部を置き換えるつもりは全く無い。

でももし CPANモジュールの依存物を記述するために cpanfile を使うと決めたなら、MYMETA プロトコルで透過的になる様に Module::Install::CPANfile もしくは Module::Build::Pluggable::CPANfile を使うべきだよ。

FAQ

僕は CPAN Author で、META.yml をリポジトリに含んでる。cpanfile にスィッチした方がいい？

君の設定が静的で、リポジトリにある META.yml の衝突を覚えているなら問題ないし、それって凄い事だよね。でも configure_requires に「Module::Install」(例えばだけど)を入れてても一旦CPANに送らたらもう必要ないよね。inc 以下をコミットするのは作者の好き勝手だけど、僕には必要無い様に思える。

ウェブアプリをクラウドにデプロイしたいんだけど、どのプロバイダが cpanfile をサポートしてるの？

ほとんどのPaaSプロバイダ(dotcloud、buildpackなどによるherokuとか)は依存物のインストールに cpanm -- installdeps を使ってる。 cpanm を 1.6 もしくはそれ以上のバージョンににアップグレードすれば、自動的にcpanfileから依存性を解決するよ。まだ 1.6 じゃないとしたら、なんでアップグレードを望まないの？