|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
1 |
バージョンの情報をエクスポートする |
2 |
================================== |
|
3 |
||
4 |
最新のリビジョン番号を得る |
|
5 |
-------------------------- |
|
6 |
||
7 |
ビルドスクリプトの中で最新のリビジョン番号だけが必要な場合、 ``revno`` コマンドを使用できます:: |
|
8 |
||
9 |
$ bzr revno |
|
10 |
3104 |
|
11 |
||
12 |
||
13 |
詳細なバージョン情報を得る |
|
14 |
--------------------------- |
|
15 |
||
16 |
最新バージョンに関する詳細な情報を出力するには ``version-info`` コマンドを使用できます:: |
|
17 |
||
18 |
$ bzr version-info |
|
19 |
revision-id: pqm@pqm.ubuntu.com-20071211175118-s94sizduj201hrs5 |
|
20 |
date: 2007-12-11 17:51:18 +0000 |
|
21 |
build-date: 2007-12-13 13:14:51 +1000 |
|
22 |
revno: 3104 |
|
23 |
branch-nick: bzr.dev |
|
24 |
||
25 |
オペレーティングシステムツールもしくはスクリプトを使用して出力を簡単にフィルタリングできます。 |
|
26 |
例です(Linux/Unix):: |
|
27 |
||
28 |
$ bzr version-info | grep ^date |
|
29 |
date: 2007-12-11 17:51:18 +0000 |
|
30 |
||
31 |
より高度な後処理のためにすべてのリビジョンに関するバージョン情報が必要であれば、 |
|
32 |
``--all`` オプションはその情報を実際にダンプします。 |
|
33 |
||
34 |
||
35 |
Pythonのプロジェクト |
|
36 |
-------------------- |
|
37 |
||
38 |
.. TODO: Figure out how to attach into ``setup.py`` |
|
39 |
||
40 |
||
41 |
プロジェクトファイルをビルドするためにMakefileを使う場合、 |
|
42 |
次のようにバージョン情報用のファイルを簡単に生成できます:: |
|
43 |
||
44 |
library/_version.py: |
|
45 |
bzr version-info --format python > library/_version.py |
|
46 |
||
47 |
これは3つのディレクトリを含むファイルを生成します: |
|
48 |
||
49 |
* `version_info`: 現在の状態に関する基本情報を含むディレクトリ。 |
|
50 |
||
51 |
* `revisions`: コミット時間とコミットメッセージと一緒に、 |
|
52 |
ツリーの履歴の中のすべてのリビジョンのリストを表示するディクショナリ。 |
|
53 |
``--all`` もしくは ``--include-history`` が提供されない限り、デフォルトではこれは空です。 |
|
54 |
リリースバージョンに含まれる、バグ修正などを追跡したい場合に便利です。 |
|
55 |
しかし多くのプロジェクトに対してこれは必要以上の情報です。 |
|
56 |
||
57 |
* `file_revisions`: プロジェクトのすべてのファイルに対する最終修正のリビジョンのリストを示すディクショナリ。 |
|
58 |
これは ``$Id$`` キーワードがCVSで管理されたファイルと同じように使われます。 |
|
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
59 |
最終修正の日付は ``revisions`` マップで探すことで決定されます。 |
|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
60 |
デフォルトではこれは空で、 ``--all`` もしくは ``--include-file-revisions`` によってのみ有効になります |
61 |
||
62 |
||
63 |
別のフォーマットでバージョン情報を得る |
|
64 |
-------------------------------------- |
|
65 |
||
66 |
任意のフォーマットのバージョン情報を取得するためにBazaarはテンプレートベースの方法をサポートします。 |
|
67 |
``version-info`` への ``--custom`` オプションは作業ツリーのステータスに基づいて拡張された変数を含む |
|
68 |
``--template`` 引数を提供することで使用できます。 |
|
69 |
||
70 |
たとえば、現在のリビジョン番号を含むフォーマットされた文字列を伴うCヘッダーファイルを生成するには:: |
|
71 |
||
72 |
bzr version-info --custom \ |
|
73 |
--template="#define VERSION_INFO \"Project 1.2.3 (r{revno})\"\n" \
|
|
74 |
> version_info.h |
|
75 |
||
76 |
``{revno}`` は作業ツリーのリビジョン番号に置き換えされます。
|
|
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
77 |
(上記の例があなたのOSで動作しない場合、一行ですべてのコマンドを入力してみてください) |
|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
78 |
テンプレートの中で利用できる変数の詳細な情報に関しては、 |
79 |
Bazaarのユーザーリファレンスの `Version Info`_ を参照してください。 |
|
80 |
||
81 |
.. _Version Info: ../user-reference/bzr_man.html#version-info |
|
82 |
||
83 |
特定の言語でバージョン情報をダンプするために予め定義されるフォーマットはは現在開発段階にあります。 |
|
84 |
この領域の要求に関してはメーリングリストで私達開発者に連絡して下さるようお願いします。 |
|
85 |
||
86 |
チェッククリーン |
|
87 |
----------------- |
|
88 |
||
89 |
プロジェクトの内容に関する大抵の情報はリビジョンエントリを読むだけで簡単に決定できます。 |
|
90 |
しかしながら、作業ツリーがパッケージされたときにそれが最新であったこと、 |
|
91 |
もしくはローカルな修正があったことを知るためには便利です。 |
|
92 |
``--all`` もしくは ``--check-clean`` のどちらかを提供することで ``bzr`` は作業ツリーを検査して、 |
|
93 |
``version_info`` ``clean`` を設定します。 |
|
94 |
同様に ``modified`` が適切である場合に ``file_revisions`` でエントリを設定します。 |
|
95 |
||
|
4853.1.1
by Patrick Regan
Removed trailing whitespace from files in doc directory |
96 |
.. |
|
4634.99.1
by Naoki INADA
import doc-ja rev90 |
97 |
vim: tw=74 ft=rst spell spelllang=en_us |