翻訳ドキュメント/UsingPlugins - Bazaar Wiki

このページは Bazaar 公式 Using Bazaar Plugins の日本語訳です。

---

Bazaar プラグインを使う

プラグインは Bazaar の機能を拡張するための外部コンポーネントで、Bazaar の機能を追加したり置き換えたりします。プラグインはしばしば、Bazaar の公式コードベースに格納される前の新機能の開発者向けテスト用として使用されることがあります。
プラグインはさまざまな事を実行することができます、コマンドのオーバーライド、追加された新しいコマンド、新しいネットワーク転送の提供、ログ出力のカスタマイズなどなどです。

The sky is the limit for the customization that can be done through plugins.

私たちは、Bazaar が数ある Revision Control System の中で最も広範囲なプラグインシステムを持つことを確実にするようにプラグインアーキテクチャに焦点を合わせました。

どこにプラグインがありますか？

私たちは、 BzrPlugins ページでプラグインのリストを更新しています。自由にあなたのプラグインをこのページに追加してください。

プラグインを書く

プラグインを書くための情報は、WritingPlugins ページで見つけることができます。

インストールされているプラグインをリストアップする

そのためのコマンドは "bzr plugins" です。このコマンドでインストールされているプラグインとプラグインがロードされている場所を表示します。( それぞれのプラグインのバージョンは将来の改良されるかもしれません。)

どうやってプラグインをインストールしますか？

プラグインをインストールするのは非常に簡単です！プラグインをインストールする場合、システム全体で使用するのか、そのユーザだけが使用するのか選択できます。両方の方法とも、"plugins" ディレクトリを作成し、その中にプラグイン用のサブディレクトリにプラグインを入れます。 例: "plugins/bzrtools/"

現在、プラグインの存在を2か所のディレクトリでチェックしています:
bzrlib/plugins ディレクトリ ( 通常 /usr/lib/python2.4/site-packages/bzrlib/plugins/ )
$HOME/.bazaar/plugins ( Windows では $APPDATA/bazaar/2.0/plugins )

もしプラグインをあなたの .bazaar/plugins/ ディレクトリにインストールしたい場合、エクステンションのディレクトリを移動して、そのなかで "python setup.py build_ext -i" を実行します。
BZR_PLUGIN_PATH にプラグインを含むディレクトリを設定することで、HOME ディレクトリのプラグインをオーバーライドすることができます。インストールされているプラグインは、"bzr plugins" コマンドを実行することでいつでも確認することができます。新しいコマンドは "bzr help commands" で見ることができます。

<!> Bazaar 0.15 から、プラグインフォルダは bzr-gtk のようにハイフンを含まないかも知れません。代わりに gtk のようにプラグインディレクトリ名をハイフンなしに変更してください。

開発者へのアドバイス

もしあなたが Bazaar の "tip" を追跡するのであれば、最新の開発版を使って最新の情報を得るようにしてください。大部分のプラグインが同じように簡単に行うことができます。
たとえば、bzrtools プラグインをあなたのメインアカウントにインストールするには、一つは以下のように実行します、

bzr branch http://panoramicfeedback.com/opensource/bzr/bzrtools
~/.bazaar/plugins/bzrtools

終了したら以下のようにして、いつでも bzrtools プラグインの tip をアップデートできます。

cd ~/.bazaar/plugins/bzrtools; bzr pull; cd -