TortoiseSVN の全コマンドはコマンドラインパラメータから制御できるため、バッチスクリプトや、他のプログラム (例: お好みのテキストエディタ) から指定したコマンドやダイアログを起動するのを自動化できます。
TortoiseSVN は GUI クライアントであることを忘れないでください。またこの自動化ガイドは、ユーザの入力を集めるのに TortoiseSVN ダイアログを表示させる方法を説明しています。入力を全くさせないようなスクリプトを書く場合は、公式 Subversion コマンドラインクライアントの方を使用してください。
TortoiseSVN GUI プログラムは TortoiseProc.exe で呼び出されます。すべてのコマンドで /command:abcd パラメータを指定できます。abcd にはコマンド名が必要です。ほとんどのコマンドは /path:"some\path" という形で、少なくともひとつのパスを引数に渡す必要があります。以下の表で、/command:abcd パラメータに渡すコマンドと、/path:"some\path" パラメータに渡すパスを説明しています。
いくつかのコマンドは対象のパスを複数与えられる (例: コミット時に複数ファイルを指定) ので、/path パラメータには * で区切って複数のパスを与えます。
TortoiseSVN は、シェル拡張とメインプログラムの間で複数の引数を渡すのに、一時ファイルを使用します。TortoiseSVN 1.5.0 以降から、/notempfile パラメータはサポートされなくなり、追加する必要はなくなります。
コミットや更新、その他たくさんのコマンドで使用する進行ダイアログは、通常 ボタンを押すまで、コマンドが終了した後も開いたままになります。設定ダイアログにある該当オプションをチェックして、動作を変更できます。しかしそれでは、バッチファイルからコマンドを起動しても、TortoiseSVN コンテキストメニューから起動しても、進行ダイアログは閉じてしまいます。
異なる場所にある設定ファイルを指定するには、/configdir:"path\to\config\directory" パラメータを使用してください。レジストリに設定されているデフォルトパスを上書きします。
永続的な設定を行わずに、コマンド終了時に進行ダイアログを自動で閉じるには、/closeonend パラメータを渡すことで行えます。
/closeonend:0 自動でダイアログを閉じません。
/closeonend:1 エラーがなければ自動で閉じます。
/closeonend:2 エラーや競合がなければ自動で閉じます。
/closeonend:3 エラー、競合、マージがなければ自動で閉じます。
/closeonend:4 エラー、競合、マージが手元の操作で起きなければ自動で閉じます。
以下の表には、TortoiseProc.exe のコマンドラインで使用してアクセスする、すべてのコマンドを一覧しています。上で述べたように、/command:abcd の形で使用してください。表では、紙面を節約するため、頭に付ける /command は省略しています。
表D.1 使用できるコマンドとオプションの一覧
| コマンド | 説明 |
|---|---|
| :about | about ダイアログを表示します。コマンドを与えなくても表示します。 |
| :log | ログダイアログを開きます。/path にはログを表示するファイルやフォルダを指定します。以下の 3 種のオプションを設定できます。/startrev:xxx, /endrev:xxx, /strict |
| :checkout | チェックアウトダイアログを開きます。/path には対象ディレクトリを指定し、/url にはチェックアウト元の URL を指定します。 |
| :import | インポートダイアログを開きます。/path にインポートするデータのディレクトリを指定します。 |
| :update | /path で指定した作業コピーを最新 (HEAD) に更新します。/rev を与えると、どのリビジョンに更新するかをユーザに尋ねるダイアログを表示します。リビジョン番号を指定するダイアログを表示しないようにするには、/rev:1234 としてください。その他のオプションには /nonrecursive や /ignoreexternals があります。 |
| :commit | コミットダイアログを開きます。コミットする対象ディレクトリかファイルリストを、/path に指定します。/logmsg スイッチで、コミットダイアログに渡す定義済みのログメッセージを指定することもできます。または、コマンドラインからログメッセージを渡したくなければ、/logmsgfile:path を使用してください。path にはログメッセージのファイルを指定します。(バグ追跡システムの属性で統合の設定をしてある場合) バグ ID ボックスをあらかじめ入力しておくには、/bugid:"the bug id here" を使用できます。 |
| :add | /path のファイルをバージョン管理に追加します。 |
| :revert | 作業コピーの手元の更新を取り消します。/path には取り消す項目を指定します。 |
| :cleanup | 割り込み・中止した操作のクリーンアップをし、/path に指定した作業コピーのロックを解除します。 |
| :resolve | /path で指定した競合ファイルを解消としてマークします。/noquestion が与えられると、本当に行ってもよいか確認せずに解消を実行します。 |
| :repocreate | /path にリポジトリを作成します。 |
| :switch | 切り替えダイアログを開きます。/path に対象ディレクトリを指定します。 |
| :export | /path の作業コピーを別のディレクトリにエクスポートします。/path がバージョン管理外ディレクトリを指定していれば、/pathのディレクトリにエクスポートする URL を尋ねてきます。 |
| :merge | マージダイアログを開きます。/path にはターゲットディレクトリを指定します。マージするリビジョン範囲は以下のオプションを利用できます。/fromurl:URL, /revrange:string 2 つのリポジトリツリーをマージするには、以下のオプション得降利用できます。/fromurl:URL, /tourl:URL, /fromrev:xxx, /torev:xxx 以上はマージダイアログにあらかじめ設定した状態になります。 |
| :mergeall | すべてマージダイアログを開きます。/path に対象ディレクトリを指定します。 |
| :copy | ブランチ・タグダイアログを開きます。/path はブランチ・タグから作る作業コピーです。また、/url はターゲットの URL です。/logmsg スイッチで、ブランチ・タグダイアログに渡す定義済みのログメッセージを指定することもできます。または、コマンドラインからログメッセージを渡したくなければ、/logmsgfile:path を使用してください。path にはログメッセージのファイルを指定します。 |
| :settings | 設定ダイアログを開きます。 |
| :remove | /path のファイルをバージョン管理下から削除します。 |
| :rename | /path のファイルの名前を変更します。このファイルの新しい名前を入力するダイアログを表示します。同様のファイルの名前の変更を行う際、1 ステップで質問が発生しないようにするには、/noquestion を渡してください。 |
| :diff | TortoiseSVN の設定で指定した外部 diff プログラムを起動します。/path には初めのファイルを指定します。/path2 オプションを設定すると、その 2 ファイルに対して diff プログラムが起動します。/path2 を省略すると、/path とその BASE に対する diff を行います。リビジョン番号を明示するには、 /startrev:xxx や /endrev:xxx を使用してください。/blame を設定し、/path2 を設定しない場合、diff は与えられたリビジョンのファイルの first blaming を行います。 |
| :showcompare |
比較する URL とリビジョンにより、unified diff ( オプションの |
| :conflicteditor | /path の競合ファイルを修正するため、TortoiseSVN 設定で指定した競合エディタを起動します。 |
| :relocate | 再配置ダイアログを表示します。/path には、再配置する作業コピーのパスを指定します。 |
| :help | ヘルプファイルを開きます。 |
| :repostatus | 更新チェックダイアログを開きます。/path には作業コピーディレクトリを指定します。 |
| :repobrowser | /path で指定した作業コピーの URL や、/path で直接指定した URL に対して、リポジトリブラウザダイアログを起動します。リポジトリブラウザが表示するリビジョンを、/rev:xxx 追加オプションで指定できます。/rev:xxx を省略すると、デフォルトは HEAD になります。/path が URL を示す場合、プロジェクト属性を使用して読み取るパスを、/projectpropertiespath:path/to/wc と指定します。 |
| :ignore | /path の全対象を無視リストに追加します。つまり svn:ignore 属性をそのファイルに追加します。 |
| :blame |
|
| :cat | /path で与えたURL や作業コピーパスから、/savepath:path で与えた場所に保存します。/revision:xxx でリビジョンを指定します。指定したリビジョンのファイルを取得するのに使用できます。 |
| :createpatch | /path で与えたパスのパッチファイルを作成します。 |
| :revisiongraph | /path で指定したパスのリビジョングラフを表示します。 |
| :lock | /path で与えたファイルや、与えたディレクトリにあるすべてのファイルをロックします。ロック時のコメントを入力するよう「ロック」ダイアログを表示します。 |
| :unlock | /path で与えたファイルや、与えたディレクトリにあるすべてのファイルのロックを解除します。 |
| :rebuildiconcache | Windows のアイコンキャッシュを再生成します。Windows のアイコンが破損したときのみ使用します。これの (避けられない) 副作用として、デスクトップのアイコンを再配置してしまうことがあります。メッセージボックスの表示を抑制するには、/noquestion を渡してください。 |
| :properties | /path で指定したパスの属性ダイアログを表示します。 |
サンプル (一行で入力してください):
TortoiseProc.exe /command:commit
/path:"c:\svn_wc\file1.txt*c:\svn_wc\file2.txt"
/logmsg:"test log message" /closeonend:0
TortoiseProc.exe /command:update /path:"c:\svn_wc\" /closeonend:0
TortoiseProc.exe /command:log /path:"c:\svn_wc\file1.txt"
/startrev:50 /endrev:60 /closeonend:0