tokuhirom's Blog

Minilla を用いた Perl モジュールの作り方

http://shanon-tech.blogspot.jp/2013/05/perl.html

Perl モジュールの作り方、2013年においては Authoring tool をつかって作るのがよいです。具体的には Minilla でつくるのがオススメであります。

perlbrew なり plenv なりで perl をいれたあとは、

% cpanm Minilla

として Minilla をインストールします。

% minil new Foo

とすると、Foo.pm のスケルトンができあがります。作者の名前などは ~/.gitconfig などから自動的にさがしてきますので、設定不要です。

できあがったディレクトリは以下のような形になっています。

Foo
├── Build.PL
├── Changes
├── cpanfile
├── lib
│   └── Foo.pm
├── LICENSE
├── META.json
├── README.md
└── t
    └── 00_compile.t

2 directories, 8 files

Build.PL は、Minilla が自動生成したファイルです。Rakefile とか Makefile とか、setup.py とか、Makefile.PL とか、そういったものに相当するファイルですね。直接編集することはありません。

META.json は、モジュールのメタデータがはいっているファイルです。cpanfile, lib/Foo.pm からモジュールの情報をかきあつめて、Machine readable なフォーマットとして出力したものです。自動生成可能なのですが、リポジトリにふくめておくと、cpanm でリポジトリから直接インストールできて便利です。基本的にはリポジトリにいれるようにしてください。

RAEDME.md は、lib/Foo.pm から自動生成されます。これは github での見栄えをよくする効果があります。github のためだけに存在するファイルであるといってもさしつかえありません。。

t/ ディレクトリはテストスクリプトを配置するディレクトリです。どんどん配置していってください。

LICENSE ファイルは、ライセンス情報がはいっているファイルです。minil new はデフォルトで Perl5 とおなじ Artistic License で LICENSE ファイルをつくります。

Changes ファイルは、モジュールの変更履歴を記述するファイルです。「リリースされる tar ball には s/{{$NEXT}}/$version $date/ したものがはいって元の changes には s/{{$NEXT}}/ {{$NEXT}}\n\n$version $date/ したものがはいる」という挙動をするのがちょっとわかりづらいところではありあます。。

テストをうごかす

% minil test とすると、テストスイートがうごきます。

% prove -rl t/ などとしても、シンプルな pure perl のモジュールの場合には問題ありません。

インストールする

% cpanm . でインストールできます。

tar ball をつくる

% minil dist で、カレントディレクトリに tar ball ができます。

リリースする

CPAN にあげたい場合には、minil release とうてば OK です。いろいろメッセージがでてきますので、その通りにやればいいです。