pyconjp で発表してきた #pyconjp

Python Conference Japan 2012 で機会を頂けたので発表してきました。 45分枠で70名くらいの方にご参加頂きました。

資料は Google Docs で作成してあり、プレゼンテーションは YouTube にアップされています。 プレゼンの終わりの方でノートパソコンが不調になってしまって５分くらい止まってしまい、せっかく聞きにきて頂いた方には申し訳ない感じです。 また機会があれば、もうちょっとちゃんと準備しておきたいと思います。。。

目次

• 資料など
• 補足
• 終わりに

waf を使って Sphinx で生成した HTML を ZIP にまとめる

ビルドツールである waf を使って、 Sphinx で生成した HTML ファイルを ZIP 形式にまとめるメモです。
コマンドラインで次のように実行すると、Sphinx でビルドして ZIP が作成されます。

$ waf configure build dist

(出力省略)

New archive created: sphinx-project-1.0.0.zip
'dist' finished successfully (7.701s)

Sphinx に関してはこちらの記事でも紹介されています。

• Sphinx を活用し、適切に構成されたドキュメントを容易に作成する (IBM developerWorks)

  Sphinx は Python で作成されており、元々は Python 言語のドキュメント作成用に作られたものですが、 必ずしもドキュメント作成の対象言語を Python のみに限定しているわけではありません。 場合によってはプログラマーの作成するドキュメントのみが対象というわけですらありません。 Sphinx の利用者は数多くおり、本をまるごと Sphinx で執筆する人もいます。

Waf と YUI Compressor で静的ファイルを圧縮する

Waf を使って JavaScript と CSS を探し、YUI Compressor の引数に渡すことで 静的ファイルを圧縮します。

Apache Ant で YUI Compressor を使う方法は、次の英語の記事で網羅的に説明されています。

• Building Web Applications With Apache Ant - Julien Lecomte's Blog

  • Apache Ant
  • Build types - 開発用、検証用、製品用に分けてビルドする
  • Concatenate your JavaScript and CSS files - 順番を意識してファイル内容を結合する
  • Preprocess your JavaScript files using CPP - C のプリプロセッサを使って条件付きビルドを実現する
  • Minify your JavaScript and CSS files - yuicompressor.jar を使って JavaScript と CSS を圧縮する
  • Work around caching issues - 変更のないファイルをキャッシュするためのテクニック
  • Deploy your application - サーバーにファイルを転送し、サービスを再起動する
  • Conclusion - みんながビルドプロセスを考慮すべき

この記事では yuicompressor.jar の使い方の部分だけを取り上げます。 なお、Python 関連では buildout も使えます。

• Minifying JavaScript and CSS with buildout (英語のブログ)

Waf を使って構文チェックしてからコピーする

インタープリタ型のプログラミング言語では、 ソースコードを記述したファイルをそのまま実行できます。 小さめのファイルなら簡単に動作を確認できて非常に便利です。 しかし、モジュールを区切って管理するようになると複数のファイルに依存関係が発生し、 こまめにテストしながら開発する必要があります。

ひとくちにテストと言っても様々なレベルが考えられますが、 ここでは、構文だけをテストします。 原理は同じですから、同様にして単体テストやドキュメントテストも実行できるようになります。 設定方法を工夫すれば結合テストもできるようになるはずですね。

Waf から Solr を起動させる

Waf を使うと、Python で色々な処理を記述できます。 Waf は普通は C 言語などのコンパイルに使いますが、 ある条件に従って何らかの処理を実行できると便利ですので、他のことにも流用してみます。 以前に、Solr をダウンロードして解凍できることを確認しましたので、 今回は、そこから Solr を起動させます。

• Waf を使う (2011年8月の記事)
• The Waf Book (Google Code)

Waf を使う

Waf を使ってみます。 ここでの Waf とは、Web Application Framework や Web Application Firewall の略ではなく、 Python で記述されたビルドシステムのことです。

• Waf - Google Code
• The Waf Book - Google Code

ツールの導入部分に関してはこちらの記事で紹介されています。

• waf チュートリアル (純粋関数型雑記帳)

この記事では、何かをビルドする、というわけではなく、 アーキテクチャに依存せずに手続きを実行できるようにします。