CPANモジュール作成の手順

2008-06-29

今年はCPANモジュールを何かリリースできればなぁと思っているのですが、CPANモジュール作成の手順を理解していないので少しまとめてみました。

ひな形作成
- pmsetup
  - http://d.hatena.ne.jp/tokuhirom/20080424/1209021402
  - http://coderepos.org/share/browser/lang/perl/misc/pmsetup/
開発時
- 依存モジュール追加
  - Makefile.PLのrequires, build_requires拡張
  - Test::Dependenciesでチェック
  - http://subtech.g.hatena.ne.jp/hirose31/20080612/1213271089
- モジュールに付属するスクリプトの追加
  - Makefile.PL に追加. install_script 'script/tool_name.pl';
- share ファイルや、スクリプトのCONFファイル等があれば
  - install_share 'conf';
テスト
- 単体
  - prove -bv t/hoge.t # でないとXSに対応しない
    - -bオプションはblib/libをpathに追加してくれるんですね
- 全体
  - perl Makefile.PL, make, make test
リリース前
- Manifest作成
  - make manifest
- META.yml作成
- テスト
  - make realclean, perl Makefile.PL, make, make test
  - make realclean, perl Makefile.PL, make, make disttest
    - Manifestに必要なファイルが不足していたら、make manifestをしてから、再度上記のmake disttest
    - shipitでもdisttestのstepがあるので、ここで確実に通さなくてもshipit時に必ずとまります
リリース
- shipit
  - http://blog.clouder.jp/archives/001044.html

色々と手順は抜けているような気がするので、このステップは絶対にないといけない！とかあったほうがいい！というステップがあれば、是非教えてください。

# id:dayflowerさんにテストが抜けてるよ！というツッコミをもらったので追記してみました。間違いがあればツッコミおねがいします！

# id:dankogaiさんの指摘から、prove -bvについて追記しました。blib