nDiki : バージョン管理

[ WiKicker ] 久しぶりにメンテナンス

CVS のリポジトリにチェックインしていなかったファイルが沢山あった。 コードの変更内容を確認しつつチェックイン。

WiKicker はRCSでバージョン管理をしているのだが、NaneyOrgWiki だと一部のページでかなりリビジョンが上がってきている。 それらはだいたいコメントフォームによる追記によるもの。

ということで以前から検討していた「追記だけの場合はチェックインしなようにする」オプションを追加する予定。

DiKicker の方も未実装のコードを実装しようとしたが、記憶が薄れてしまっているので今日はやめておく。

Module::Build でソースパッケージング

ExtUtils::MakeMaker

私が Perl が好きな理由の一つに、標準でExtUtils::MakeMakerという Makefile ジェネレータがついているところである。これを使って Makefile.PL を書くと

 perl Makefile.PL
 make manifest
 make
 make test
 make dist

で <pacakge>-<versionno>.tar.gz というソースパッケージを作ることができ、

 tar zxvf <pacakge>-<versionno>.tar.gz
 cd <pacakge>-<versionno>
 perl Makefile.PL
 make
 make test
 make install

という手順でインストールする事ができるようになる。 パッケージの作り方が確立されているので、容易に新しいパッケージを開発しはじめられる。

逆に Java でプログラムを書くのが億劫なのは、このあたりの準備が面倒だからである。 Ant を使っても結局ここら辺自分でやらなければならないし。

ちょっとしたアーカイブの作成

ちょっとしたパッケージを作りたいと思うことは良くある。 例えばいくつかのデータファイルと、READMEファイルなんかをひとまとめにしてアーカイブにするとか。

本当にちょっとしたであれば、手動でアーカイブすれば良いのだが、

• アーカイブしたいファイル群がバージョン管理下にあって、CVS ディレクトリや .svn ディレクトリがある (除外してアーカイブする必要がある)
• 同じディレクトリにある、作業用のファイルはアーカイブしたくない (除外してアーカイブする必要がある)
• アーカイブする前に、チェック用のリグレッションテスト一式を走らせたい (リグレッションテストをかけられるようにする)
• UNIX でも Windows でもアーカイブ化できるようにしたい。

あたりを考慮しなければならない時は面倒くさくなってくる。

自動化としては

• シェルスクリプト/バッチファイルを書く
• Makefile を書く
• GNU Autotools を使う

あたりがぱっと思い浮かぶ。 しかし、最初の2つは毎回同じようなものを書くのが面倒だし保守もしにくい。 GNU Autotools はちょっとごっつすぎだし、Windows での環境構築も面倒。

ExtUtils::MakeMaker の欠点

ということで最初は ExtUtils::MakeMaker を使うという線で考えてみた。 もともと Perl モジュール用で汎用用途にはちょっと邪魔な振舞いもあるが、使えないことはないと思う。 しかし make (GNU Make あるいは nmake など) に依存しているという欠点がある。

Module::Build で

ということで ExtUtils::MakeMaker の代替である Module::Build ベースで汎用用途に使えないか検討してみた。こちらは pure Perl で make を必要としない。

Module::Build も Perl モジュールビルドにあわせた振舞いがあるものの、ちょっとカスタマイズすれば使えそうだ。 で、いろいろいじった結果、次のような感じにすると使いやすそうだ。

 use Module::Build;
 my $class = Module::Build
   ->subclass(class => 'NonmoduleBuilder',
              code => q{
                        # Don't make blib
                        sub ACTION_code {};
                        # Don't make blib
                        sub ACTION_docs {};
                        # Don't make META.yml
                        sub ACTION_distmeta {
                          # no warning on ACTION_distdir
                          $_[0]->{metafile} = 'MANIFEST';
                        };
                        # Don't add MEATA.yml to MANIFEST
                        sub ACTION_manifest {
                          $_[0]->{metafile} = 'MANIFEST',
                          $_[0]->SUPER::ACTION_manifest(@_);
                        };
                       });

 # Set your archive name and version.
 $class->new(dist_name => 'mypackage',
             dist_version => '1.0.2',
             )->create_build_script;

カスタマイズした部分は以下(Module::Build 0.26 で動作確認)。

• Perl モジュールビルドに特有の blib ディレクトリを作らないようにする。
• META.yml を生成しないようにし、アーカイブに含まれないようにする。

上記のようなファイルを Build.PL という名前で作っておけば

 perl Build.PL
 ./Build manifest
 ./Build
 ./Build test
 ./Build dist

等として、アーカイブ作成が容易にできるようになる。

しばらくこの方法でいろいろ試してみることにしてみよう。

Windows 向けソフトウェア開発者はソースパッケージを作る習慣がない

GNU Autotools や ExtUtils::MakeMaker (とその仲間たち)で make dist するのがあたり前になっている自分には、気持ち悪い。

ビルドの自動化とソースパッケージ作成の自動化・バージョン管理のセットアップは、最初の仕事だと思うのだが。

Visual C# 2005 Express Edition ではどれを Subversion リポジトリに突っ込めば良いか?

Visual C# 2005 Express Edition で Windows アプリケーションテンプレートによる構成は下記 (名前を Example で作成した場合)。

ファイル名	対象
Example.sln	o	ソリューションファイル (テキストファイル)
Example.csproj	o	プロジェクトファイル (XML ファイル)
Example.suo		ソリューションユーザオプションファイル (バイナリファイル)
Program.cs	o	C# ソースファイル
Form1.cs	o	C# ソースファイル
Form1.Designer.cs	o	C# ソースファイル
Properties/AssemblyInfo.cs	o	C# ソースファイル
Properties/Resources.Designer.cs	o	C# ソースファイル
Properties/Settings.Designer.cs	o	C# ソースファイル
Properties/Resources.resx	o	リソースファイル (XML ファイル)
Properties/Settings.settings	o	設定ファイル (XML ファイル)
bin/*
obj/*

バージョン管理する必要があるのは「対象」のファイルで良いのかな? Form1 などはすぐ名前変更になるけれど。

参考

• http://msdn2.microsoft.com/...
• http://www.microsoft.com/...

追記

2007年12月4日

• Properties/Resources.Designer.cs を追加。

今日のさえずり: ロック方式のバージョン管理機能やっぱりお肌にあわない

2010年10月19日

• 10:25 素晴らしい。Data::MessagePack 0.34 のおかげで Xslate も Strawberry Perl 上にインストールできるようになりました。
• 11:57 Strawberry Perl + Twiggy + Plack + Mojolicious + DBIx::Skinny + PostgreSQL + Xslate でやろうかな。
• 12:06 和風牛丼 350円。 (@ なか卯 神田佐久間町店) http://4sq.com/9tdwTs
• 12:56 Git 使ったことないのでチュートリアル読んでる。
• 13:42 Red Hat Linux 8.0 (古)上で Git 1.7.3.1 のコンパイルに失敗したので先に OpenSSL 1.0.0a をコンパイルしていることろ。
• 14:20 駄目だ。Git のコンパイル通らん。
• 18:07 K-9 Mail 3.200 出た。 #Android
• 21:17 mopera U U ライトプランって日割じゃなかったのか。9月1日に廃止したけど9月は満額請求されてた。
• 22:12 Git ってまだ Windows 使うのは難があるのかな。だとオフィスの Linux サーバに Git インストールしておいても自分以外使う人いないので無駄だな。

2010年10月20日

• 09:43 秋葉原駅で女性専用のポケットティシュー配ってる。
• 09:48 缶コーヒー 100円。
• 12:07 おにぎり 343円。
• 12:11 Red Hat Linux 8.0 上での Git のビルド、最新の libcurl いれ、かつ --without-openssl したら通った。
• 13:13 WiKicker の文法説明ページ復活の要望もらった。
• 15:25 ロック方式のバージョン管理機能やっぱりお肌にあわない。
• 16:58 自社製品ソフトウェア起動しているところを見て @as_tone に驚かれた。……まあめったに起動しませんけどね。
• 18:22 受変電設備の定期点検による停電、今年は11月21日(日)との連絡が本日あり。今年はちょっと遅め。
• 22:31 マイライン登録内容のご案内はがききた。
• 22:51 東北新幹線はやて、ここ数年編成変わってないよね? 同じなら2008年8月/9月の時とと同じ塩梅で車両・座席指定したいのだけれど。
• 22:58 E2系 / E2系 + E3系のままっぽいな。
• 23:18 新しい eneloop mobile booster KBC-L2BS 明日発売か。 http://amzn.to/a33gUJ
• 24:08 Evernote 2.0 for Android Beta、オフラインノートブックに指定して同期しておくとオフラインでも見られるんだけれど検索はできない。リリース版になるころにはオフラインでも検索できるようになるといいな。

CVS リポジトリを Git リポジトリに cvs2git で移す

しばらく放置していたこの nDiki のコード(DiKicker)に手を入れようと思うのだけれど、CVS で管理し続けるのもなぁと思い、これを機会に Git に移行させることにした。移行は cvs2git で。ローカルで自分だけでバージョン管理していたものだし、ブランチも切ってなくてタグを売ってあるだけなので一番ちょろいケースか。

Debian GNU/Linux sid 上に cvs2svn Debian パッケージをインストール。以下の手順でコンバートした。

オプションファイルを作る

Git リポジトリ上できちんとユーザ名とメールアドレスが入るようにしたいため、オプションファイルを使うようにする。

 zcat /usr/share/doc/cvs2svn/examples/cvs2git-example.options.gz > cvs2git.options

でひな型をコピーして以下を書き換え。

• ctx.username = 'cvs2svn' のところを naney に。
• author_transforms に 'naney' : ('WATANABE Yoshimasa', 'naney@naney.org'), を追加
• run_options.set_project で CVS リポジトリのパスを r'/home/naney/path/to/cvsroot', のように指定。

git fast-import 用のファイルを生成

以下のコマンドで。

 cvs2git --options=cvs2git.options

Git リポジトリを作成しインポート

 mkdir <プロジェクト名>
 cd <プロジェクト名>
 git init
 cat ../cvs2svn-tmp/git-blob.dat ../cvs2svn-tmp/git-dump.dat | git fast-import

で QGit や git log などで、どのようにインポートされたかを確認。trunk のラインから、タグ毎に分岐したコミットができてそこに CVSROOT/ 以下が差分として入っているという形になっているのが特徴的。CVSROOT/ は特にいらないので、数が多くないし手でタグ打ち直すかなあという感じ。

git fast-import したままだと作業ツリーが空なので git checkout して master を checkout するなりすれば、後は普通に Git 上でバージョン管理をしていくことができる。

あっさり移行できたので一安心。

レクサー・リサーチ開発同窓会

2月の Developers Summit 2015 で zakwa 氏と再会したのをきっかけに、当時一緒に仕事をしていた気が置けないソフトウェア開発者4人で同窓会をすることになった。セッティングしてくれた zakwa 氏ありがとう!

COGS DINING KAGURAZAKA (コグス ダイニング 神楽坂)

手配してくれたお店は「焼きたてパンとワインのお店」COGS DINING KAGURAZAKA。神楽坂から路地に入ったところにあるお店で、上品な味の料理で満足だった。店内もうるさくなくて話しやすかったし、たばこを吸っている人もいなかったので快適だった。

• http://www.cogsdining.com/

ソフトウェア開発

現職のまま続けている1人と、別の場所で働くことになった3人だけれどみなそれぞれソフトウェア開発現場に関わっていて、それぞれの開発スタイルなどについて情報交換したり。

大企業だからしっかりした開発をしているとか、スタートアップだからモダンな開発をしているとかでは必ずしも無いよねという話だった。例えばバージョン管理一つにしてもうまくできていない(やっていない)場合も多いとのこと。当時を振り返ってみると小規模かつ独学の状況ながら、今では普通になってきたプラクティスやツールをその時から実践/活用していたなと自画自賛した。

• プロジェクト
  • ソフトウェアかんばん
  • ITS (影舞・Redmine) の利用
    • BTS やコミットメントリストとして。
  • スタンドアップでの朝会
  • すごい会議
  • 成果物完成毎の記念撮影
• 情報共有
  • 社内 Wiki
    • 2002年3月初設置。
  • 社内 Blog
    • 2006年あたり(記事)
• 開発ツール
  • バージョン管理 (CVS・Subversion・Git)
  • pLaTeX2e を使ったドキュメンテーション
• その他
  • 書けなくなったホワイトボードマーカーはその場で床に投げ捨て

「書けなくなったホワイトボードマーカーはその場で床に投げ捨て」に共感を持ってもらえていたのが、振り返って当時の自分の一番の成果だな。

退職時に使っていた社内 Wiki は Naney 謹製のものだったのでその後どうなったのかなとたまに気になっていたのだけれど、ビル管理会社の人に社内サーバの電源を切られたことによりサーバごと死んで闇に葬られたらしい。R.I.P.

その他

同窓会らしく「あのひとは今」的な話をしたり、当時フィルムカメラで撮っていた業務風景のアルバムを持ってきて盛り上がったり。あとはレーシックやドライアイ治療ひぇー的な話題が出たり。あとは展示会の時のレクサー・リサーチポロシャツ制作秘話とか。

そういえば出席はできなかった2013年2月開催の「LEXER設立20周年記念サロン・パーティ」で会社のるぐるロゴの立体置物が配られたと聞いて、あ、欲しかったなーと。