Git リポジトリのルール

問題を報告 ソースを表示 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

次の関数は @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 をチェックアウトして、そのターゲットをバインディングに使用できるようにします。また、実際にチェックアウトされた commit の ID とその日付を確認し、このルールの再現可能なバージョンを提供するパラメータを含む辞書を返します(タグは必ずしもそうとは限りません)。

属性

name 名前(必須)

このリポジトリの一意の名前。

branch 文字列(省略可)

チェックアウトします。branch、tag、commit のいずれかを 1 つだけ指定する必要があります。

build_file ラベル(省略可)

このリポジトリの BUILD ファイルとして使用するファイル。この属性は絶対ラベルです(メイン リポジトリの場合は「@//」を使用します)。ファイル名は BUILD にする必要はありませんが、BUILD にすることもできます(リポジトリの実際の BUILD ファイルと区別するために、BUILD.new-repo-name などの名前を付けるとよいでしょう。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 コマンドの順序。この属性が設定されていない場合、patch_cmds は Windows で実行されます。この場合、Bash バイナリが存在している必要があります。

patch_tool 文字列(省略可)

使用する patch(1) ユーティリティ。これが指定されている場合、Bazel は Bazel ネイティブのパッチ実装ではなく、指定されたパッチツールを使用します。

patches ラベルのリスト(省略可)

アーカイブの抽出後にパッチとして適用されるファイルのリスト。デフォルトでは、Bazel ネイティブのパッチ実装が使用されますが、これはファズ マッチとバイナリ パッチをサポートしていません。ただし、patch_tool 属性が指定されている場合、または patch_args 属性に「-p」以外の引数がある場合は、Bazel はパッチ コマンドライン ツールを使用します。

recursive_init_submodules ブール値(省略可)

リポジトリ内でサブモジュールを再帰的にクローンを作成するかどうか。

remote 文字列(必須)

リモートの Git リポジトリの URI

shallow_since 文字列(省略可)

指定した commit より前ではない日付(省略可)。タグが指定されている場合(深度 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 をチェックアウトして、そのターゲットをバインディングに使用できるようにします。また、実際にチェックアウトされた 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 コマンドの順序。この属性が設定されていない場合、patch_cmds は Windows で実行されます。この場合、Bash バイナリが存在している必要があります。

patch_tool 文字列(省略可)

使用する patch(1) ユーティリティ。これが指定されている場合、Bazel は Bazel ネイティブのパッチ実装ではなく、指定されたパッチツールを使用します。

patches ラベルのリスト(省略可)

アーカイブの抽出後にパッチとして適用するファイルのリスト。デフォルトでは、Bazel ネイティブのパッチ実装が使用されますが、これはファズ マッチとバイナリ パッチをサポートしていません。ただし、patch_tool 属性が指定されている場合、または patch_args 属性に「-p」以外の引数がある場合は、Bazel はパッチ コマンドライン ツールを使用します。

recursive_init_submodules ブール値(省略可)

リポジトリ内でサブモジュールを再帰的にクローンを作成するかどうか。

remote 文字列(必須)

リモートの Git リポジトリの URI

shallow_since 文字列(省略可)

指定した commit より前ではない日付(省略可)。タグが指定されている場合(深度 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」のいずれかを指定するか、どちらも指定しないことができます。両方を指定することはできません。