Empfohlen
Weitere ähnliche Inhalte
Andere mochten auch
Andere mochten auch (13)
Ähnlich wie 2013年のCPANモジュール作成事情
Ähnlich wie 2013年のCPANモジュール作成事情 (10)
Mehr von charsbar
Mehr von charsbar (16)
2013年のCPANモジュール作成事情
- 1. 2013年のCPAN モジュール作成事情 Kenichi Ishigaki (@charsbar) Fukuoka Perl Workshop #24 Oct 26, 2013 (Happy CPAN birthday)
- 2. 例によってCPANTSネタです • 昨年こちらで話した分析の元ネタ • この一年で、いろんなことがありました • YAPC本編でもその一部について話してき ました • 今日はその続きとして、papixさんが話す はずだったネタについて話します
- 4. Top 10 (2012年版) 1 XAICRON 2 PAWAPAWA (new) (2011-) 3 BAYASHI 4 MORIYA 5 SATOH 6 MATTN (new) (2007-) 7 TOMITA 8 TYPESTER 9 CHIBA 10 YAMAMOTO (new) (2006-)
- 7. それから1年
- 8. 採点基準の変化 • 春のQA Hackathon以降、採点基準が7増 12減しています(YAPC後に1増しました) • 実装の方もだいぶ修正しました • が、今日もまた例外的なディストリビュー ションの作者氏からバグレポートが… • 明日にでもまた1つ基準を増やそうと思っ ています
- 9. 日本人のデータに もかなりの脱落が… 0.130307 2013/03/07 - turned out to have long ignored authors whose emails are CENSORED; added nearly hundred people to the list.
- 10. 実はYAPC後にもいろいろ発覚 0.130930 2013/09/30 - applied more liberal detection rule and added twelve people (hideo55++) 0.131002 2013/10/02 - applied more liberal detection rule and added twelve people (again) (motemen++)
- 14. Top 10 (2013年10月版) 1 BAYASHI (2008-) 2 YAKEX (new) (2012-) 3 MOZNION (new) (2012-) 3 HIDEAKIO (new) (2011-) 5 SYOHEX (new) (2011-) 5 AKIYM (new) (2012-) 7 SYAGI (new) (2012-) 7 ZIGUZAGU (new) (2007-) 7 CHIBA (inactive) (2007-) 10 ANAZAWA (new) (2011-) 10 PAPIX (new) (2012-) 10 SOH (new) (2012-) 10 PAWAPAWA (2011-) 10 MORIYA (inactive) (2009-) 10 RINTARO (inactive) (2007-)
- 18. ディストリビューションを作成する ツールの変化？ • ひな形を作成するツールの分析はなかなか大変 • 生成されたドキュメントに痕跡が残っていることも ありますが… • インストールまわりのツールについてはCPAN Meta filesを見ればある程度分析可能
- 19. CPAN Meta files • META.yml/META.json • いちいちMakefile.PL/Build.PLを実 行しなくてもいいように • 本格的な普及は2005年くらいから • どんなツールで生成したかの情報が 記録されている
- 20. Stats on META Generator http://cpants.cpanauthors.org/stats/meta_generator
- 29. Top10作者とMETA generators BAYASHI YAKEX MOZNION HIDEAKIO SYOHEX Module::Build, Minilla Dist::Zilla Minilla, Module::Build Module::Build, Minilla Minilla, Module::Install AKIYM Minilla, Module::Install, Module::Build SYAGI ExtUtils::MakeMaker, Module::Build ZIGUZAGU ANAZAWA Module::Install Module::Install Minilla, Module::Install, Module::Build Module::Install, Minilla Module::Install PAPIX SOH PAWAPAWA
- 30. これからモジュールを書くなら、 Minillaがおすすめ • Minillaを使うと初心者でも形式的な問題を起こしづらい • 最初はpmsetupとかModule::Setupでもいいんですが、 継続的なメンテを考えるとMinillaが有利 • いまもメンテナンスが続いている • Module::Installは時代に取り残されつつある • 大量の依存モジュールを気にしないならDist::Zillaや Millaでも • 知識があるならお好きなように
- 31. Minilla: CPANモジュールを 書く人のツール • (M::I - inc) + shipit + (dzil - plugins) • ひな形の作成からリリースまで、基本的なことは ひと通りできる • ほかのツールの使い方を覚える必要がない • tokuhiromさんの流儀にしたがえば設定も不要 • 依存モジュールが少なくインストールが楽 • Windowsでも問題なくインストールできる
- 33. 基本的な使い方
- 34. 新規の場合はまず ひな形を用意 $ minil new Foo-Bar $ cd Foo-Bar minil new Foo::Bar でも大丈夫
- 35. お好みで初期状態を コミットしておく $ git commit -m "initial import" git init && git add . はひな形作成時 に済んでいます。
- 36. .pmファイルやテスト ファイルを編集する 依存モジュールが増えたら cpanfile も更新すること gitの管理下にないファイルは無視されます prove派の人はaddのし忘れに注意 META.jsonやBuild.PLなどへの修正は無効 minil dist (minil release) 時に上書きされます • Changesの日付やバージョンは更新不要 • リリース前の変更は常に{{$NEXT}}の下に書いていく • • • •
- 37. テストを実行する $ minil test $ minil test --all リリース時に自動実行されるテストも試したい場合
- 39. tarballを生成 $ minil dist $ minil dist --no-test 事故防止のため ./Build dist は殺されています
- 40. 開発中のディストリビューション をインストールする $ minil install $ minil install --no-test • v0.8.0の時点ではデフォルトで二度テストが走ってしまう →修正を取り込んでもらったので次版からは大丈夫 • ./Build install でも可
- 41. リリースの前に… • buildtool_not_executable問題 • core.autocrlf • Windowsでも使えますが、リリー スだけは別の環境でするのがお すすめ
- 42. CPANにリリースする $ minil release $ minil release --trial • 書きかけのファイルが残っているとリリースできません • ひとまず.gitignoreに追加するか、ファイルの存在自体隠蔽したい 場合はファイル名に.bakをつけるなどしてください
- 43. Githubにのみリリースする (CPANにリリースしない) $ FAKE_RELEASE=1 minil release この辺、名前と実態があっていない気もします
- 44. CPANにもGithubにもリリース したくない場合は--dry-run $ minil release --dry-run
- 45. 既存のモジュールを Minilla化する $ minil migrate • subversionのリポジトリなどは先にgitのリポジトリに変換しておくこと • gitリポジトリになっていない場合、v0.8.0の段階では自前でgit init必要 →これも修正を取り込んでもらえました • 隠しファイルなどがあるとパーミッションエラーで変換が止まることも • v0.8.0 時点ではMakefile.PLからの移行時に多少ゴミが残るので、気に なる場合は削除
- 47. XSモジュールを新規作成する $ minil new -p XS Foo-XS XSモジュールのmigrateの場合は-pオプション不要
- 50. Questions?