次の関数は @bazel_tools//tools/build_defs/repo:git.bzl
から読み込むことができます。
git_repository
git_repository(name, branch, build_file, build_file_content, commit, init_submodules, patch_args, patch_cmds, patch_cmds_win, patch_tool, patches, recursive_init_submodules, remote, shallow_since, strip_prefix, tag, verbose, workspace_file, workspace_file_content)
外部の git リポジトリのクローンを作成します。
Git リポジトリのクローンを作成し、指定されたタグまたは commit をチェックアウトして、そのターゲットをバインディングに使用できるようにします。また、実際にチェックアウトされたコミットの ID とその日付を特定し、このルールの再現可能なバージョンを提供するパラメータを含む辞書を返します(タグは必ずしもそうではありません)。
属性
name |
名前。必須
このリポジトリの一意の名前。 |
branch |
文字列。省略可
リモート リポジトリのブランチをチェックアウトします。branch、tag、commit のいずれか 1 つを指定する必要があります。 |
build_file |
ラベル(省略可) このリポジトリの BUILD ファイルとして使用するファイル。この属性は絶対ラベルです(メイン リポジトリには「@//」を使用します)。ファイル名は BUILD にする必要はありませんが、BUILD.new-repo-name のように、リポジトリの実際の BUILD ファイルと区別しやすい名前にするとよいでしょう。build_file または build_file_content のいずれかを指定する必要があります。 |
build_file_content |
文字列。省略可
このリポジトリの BUILD ファイルの内容。build_file または build_file_content のいずれかを指定する必要があります。 |
commit |
文字列。省略可
チェックアウトする特定の commit。branch、tag、commit のいずれか 1 つを指定する必要があります。 |
init_submodules |
ブール値。省略可
リポジトリ内のサブモジュールをクローンするかどうか。 |
patch_args |
文字列のリスト。省略可 パッチツールに指定された引数。デフォルトは -p0 ですが、git で生成されたパッチには通常 -p1 が必要です。複数の -p 引数が指定されている場合は、最後の引数が有効になります。-p 以外の引数が指定されている場合、Bazel は Bazel ネイティブのパッチ実装ではなく、パッチ コマンドライン ツールを使用するようにフォールバックします。パッチ コマンドライン ツールにフォールバックし、patch_tool 属性が指定されていない場合は、`patch` が使用されます。 |
patch_cmds |
文字列のリスト。省略可 パッチの適用後に Linux/macOS に適用される Bash コマンドのシーケンス。 |
patch_cmds_win |
文字列のリスト。省略可 パッチの適用後に Windows に適用される PowerShell コマンドのシーケンス。この属性が設定されていない場合、Windows で patch_cmds が実行されます。これには Bash バイナリが存在する必要があります。 |
patch_tool |
文字列。省略可
使用する patch(1) ユーティリティ。指定すると、Bazel は Bazel ネイティブのパッチ実装ではなく、指定されたパッチツールを使用します。 |
patches |
ラベルのリスト。省略可 アーカイブの抽出後にパッチとして適用されるファイルのリスト。デフォルトでは、ファジー マッチとバイナリ パッチをサポートしていない Bazel ネイティブのパッチ実装を使用しますが、`patch_tool` 属性が指定されている場合や、`patch_args` 属性に `-p` 以外の引数がある場合は、Bazel はパッチ コマンドライン ツールを使用するようにフォールバックします。 |
recursive_init_submodules |
ブール値。省略可
リポジトリでサブモジュールを再帰的にクローンするかどうか。 |
remote |
文字列。必須。 リモートの Git リポジトリの URI |
shallow_since |
文字列。省略可
オプションの日付。指定されたコミットより後の日付は指定できません。タグが指定されている場合(深さ 1 でのクローン作成が可能)、この引数は使用できません。このような日付を指定された commit の近くに設定すると、リポジトリのクローンをより浅く作成できるため、帯域幅と実時間を節約できます。 |
strip_prefix |
文字列。省略可
抽出されたファイルから削除するディレクトリ接頭辞。 |
tag |
文字列。省略可
タグをチェックアウトします。branch、tag、commit のいずれか 1 つを指定する必要があります。 |
verbose |
ブール値。省略可 |
workspace_file |
ラベル(省略可) このリポジトリの `WORKSPACE` ファイルとして使用するファイル。`workspace_file` または `workspace_file_content` のいずれか、または両方とも指定できますが、両方を指定することはできません。 |
workspace_file_content |
文字列。省略可
このリポジトリの WORKSPACE ファイルのコンテンツ。`workspace_file` または `workspace_file_content` のいずれか、または両方とも指定できますが、両方を指定することはできません。 |
new_git_repository
new_git_repository(name, branch, build_file, build_file_content, commit, init_submodules, patch_args, patch_cmds, patch_cmds_win, patch_tool, patches, recursive_init_submodules, remote, shallow_since, strip_prefix, tag, verbose, workspace_file, workspace_file_content)
外部の git リポジトリのクローンを作成します。
Git リポジトリのクローンを作成し、指定されたタグまたは commit をチェックアウトして、そのターゲットをバインディングに使用できるようにします。また、実際にチェックアウトされたコミットの ID とその日付を特定し、このルールの再現可能なバージョンを提供するパラメータを含む辞書を返します(タグは必ずしもそうではありません)。
属性
name |
名前。必須
このリポジトリの一意の名前。 |
branch |
文字列。省略可
リモート リポジトリのブランチをチェックアウトします。branch、tag、commit のいずれか 1 つを指定する必要があります。 |
build_file |
ラベル(省略可) このリポジトリの BUILD ファイルとして使用するファイル。この属性は絶対ラベルです(メイン リポジトリには「@//」を使用します)。ファイル名は BUILD にする必要はありませんが、BUILD.new-repo-name のように、リポジトリの実際の BUILD ファイルと区別しやすい名前にするとよいでしょう。build_file または build_file_content のいずれかを指定する必要があります。 |
build_file_content |
文字列。省略可
このリポジトリの BUILD ファイルの内容。build_file または build_file_content のいずれかを指定する必要があります。 |
commit |
文字列。省略可
チェックアウトする特定の commit。branch、tag、commit のいずれか 1 つを指定する必要があります。 |
init_submodules |
ブール値。省略可
リポジトリ内のサブモジュールをクローンするかどうか。 |
patch_args |
文字列のリスト。省略可 パッチツールに指定された引数。デフォルトは -p0 ですが、git で生成されたパッチには通常 -p1 が必要です。複数の -p 引数が指定されている場合は、最後の引数が有効になります。-p 以外の引数が指定されている場合、Bazel は Bazel ネイティブのパッチ実装ではなく、パッチ コマンドライン ツールを使用するようにフォールバックします。パッチ コマンドライン ツールにフォールバックし、patch_tool 属性が指定されていない場合は、`patch` が使用されます。 |
patch_cmds |
文字列のリスト。省略可 パッチの適用後に Linux/macOS に適用される Bash コマンドのシーケンス。 |
patch_cmds_win |
文字列のリスト。省略可 パッチの適用後に Windows に適用される PowerShell コマンドのシーケンス。この属性が設定されていない場合、Windows で patch_cmds が実行されます。これには Bash バイナリが存在する必要があります。 |
patch_tool |
文字列。省略可
使用する patch(1) ユーティリティ。指定すると、Bazel は Bazel ネイティブのパッチ実装ではなく、指定されたパッチツールを使用します。 |
patches |
ラベルのリスト。省略可 アーカイブの抽出後にパッチとして適用されるファイルのリスト。デフォルトでは、ファジー マッチとバイナリ パッチをサポートしていない Bazel ネイティブのパッチ実装を使用しますが、`patch_tool` 属性が指定されている場合や、`patch_args` 属性に `-p` 以外の引数がある場合は、Bazel はパッチ コマンドライン ツールを使用するようにフォールバックします。 |
recursive_init_submodules |
ブール値。省略可
リポジトリでサブモジュールを再帰的にクローンするかどうか。 |
remote |
文字列。必須。 リモートの Git リポジトリの URI |
shallow_since |
文字列。省略可
オプションの日付。指定されたコミットより後の日付は指定できません。タグが指定されている場合(深さ 1 でのクローン作成が可能)、この引数は使用できません。このような日付を指定された commit の近くに設定すると、リポジトリのクローンをより浅く作成できるため、帯域幅と実時間を節約できます。 |
strip_prefix |
文字列。省略可
抽出されたファイルから削除するディレクトリ接頭辞。 |
tag |
文字列。省略可
タグをチェックアウトします。branch、tag、commit のいずれか 1 つを指定する必要があります。 |
verbose |
ブール値。省略可 |
workspace_file |
ラベル(省略可) このリポジトリの `WORKSPACE` ファイルとして使用するファイル。`workspace_file` または `workspace_file_content` のいずれか、または両方とも指定できますが、両方を指定することはできません。 |
workspace_file_content |
文字列。省略可
このリポジトリの WORKSPACE ファイルのコンテンツ。`workspace_file` または `workspace_file_content` のいずれか、または両方とも指定できますが、両方を指定することはできません。 |