次の関数は、
@bazel_tools//tools/build_defs/repo:utils.bzl から読み込むことができます。
外部リポジトリをフェッチした後に操作するためのユーティリティ。
設定
これらのユーティリティは、他のリポジトリ ルールで使用することを目的としています。次のように読み込むことができます。
load(
"@bazel_tools//tools/build_defs/repo:utils.bzl",
"workspace_and_buildfile",
"patch",
"update_attrs",
)
どちらでもない
maybe(repo_rule, name, kwargs)
リポジトリがまだ存在しない場合にのみ追加するユーティリティ関数。
これは、 https://bazel.build/rules/deploying#dependencies に記載されている safe repositories.bzl マクロを実装するためのものです。
パラメータ
repo_rule |
必須。
リポジトリ ルール関数。 |
name |
必須。
作成するリポジトリの名前。 |
kwargs |
省略可。
repo_rule 関数に渡される残りの引数。 |
戻り値
なし。必要に応じて、副作用としてリポジトリを定義します。
parse_netrc
parse_netrc(contents, filename)
少なくとも基本的な .netrc ファイルを解析するユーティリティ関数。
パラメータ
contents |
必須。
パーサーの入力。 |
filename |
省略可。
デフォルトは None
エラー メッセージで使用するファイル名（存在する場合）。 |
戻り値
マシン名を、そのマシンに関する情報を含む辞書にマッピングする辞書
patch
patch(ctx, patches, patch_cmds, patch_cmds_win, patch_tool, patch_args, auth)
すでに抽出されたリポジトリにパッチを適用する実装。
このルールは、リポジトリ ルールの実装関数で
使用することを目的としています。パラメータ patches、patch_tool、
patch_args、patch_cmds、patch_cmds_win が指定されていない
場合は、ctx.attr から取得されます。
パラメータ
ctx |
必須。
このユーティリティ 関数。 |
patches |
省略可。
デフォルトは None
適用するパッチファイル。文字列、ラベル、パスのリスト。 |
patch_cmds |
省略可。
デフォルトは None
パッチ適用用に実行する Bash コマンド。bash -c に 1 つずつ渡されます。文字列のリスト |
patch_cmds_win |
省略可。
デフォルトは None
パッチ適用用に実行する Powershell コマンド。 powershell /c に 1 つずつ渡されます。文字列のリスト。このパラメータの ブール値が false の場合、patch_cmds が 使用され、このパラメータは無視されます。 |
patch_tool |
省略可。
デフォルトは None
パッチ適用用に実行するパッチツールのパス。 文字列。 |
patch_args |
省略可。
デフォルトは None
パッチツールに渡す引数。文字列のリスト。 |
auth |
省略可。
デフォルトは None
一部の URL の認証情報を指定する省略可能な辞書。 |
read_netrc
read_netrc(ctx, filename)
少なくとも基本的な .netrc ファイルを解析するユーティリティ関数。
パラメータ
ctx |
必須。
このユーティリティ 関数。 |
filename |
必須。
読み取る .netrc ファイルの名前 |
戻り値
マシン名を、そのマシンに関する情報を含む辞書にマッピングする辞書
read_user_netrc
read_user_netrc(ctx)
ユーザーのデフォルトの netrc ファイルを読み取ります。
パラメータ
ctx |
必須。
このユーティリティ関数を呼び出すリポジトリ ルールのリポジトリ コンテキスト。 |
戻り値
マシン名を、そのマシンに関する情報を含む辞書にマッピングする辞書。
update_attrs
update_attrs(orig, keys, override)
特定の属性を変更して、特定のリポジトリ ルールの呼び出しに追加するユーティリティ関数。
これは、ルールを再現可能にするために使用されます。
パラメータ
orig |
必須。
特定ルールの呼び出しによって実際に設定された属性の辞書（明示的または暗黙的） |
keys |
必須。
このルールで定義されている属性の完全なセット |
override |
必須。
orig をオーバーライドまたは追加する属性の辞書 |
戻り値
override のキーが挿入または更新された属性の辞書
use_netrc
use_netrc(netrc, urls, patterns)
解析済みの netrc ファイルと URL のリストから認証辞書を計算します。
パラメータ
netrc |
必須。
すでに辞書に解析された netrc ファイル（ read_netrc から取得したファイルなど） |
urls |
必須。
URL のリスト。 |
patterns |
必須。
URL から認証パターンへの省略可能な辞書 |
戻り値
ctx.download の auth 引数として適切な辞書。具体的には、辞書 は、netrc ファイルがログインとパスワードを提供するすべての URL を、対応するログイン、パスワード、省略可能な認証パターンを含む 辞書にマッピングします。 また、「type」を「basic」または「pattern」にマッピングします。
workspace_and_buildfile
workspace_and_buildfile(ctx)
WORKSPACE と、必要に応じて BUILD ファイルを書き込むユーティリティ関数。
このルールは、リポジトリ ルールの実装関数で使用することを目的としています。パラメータ name、build_file、build_file_content、
workspace_file、workspace_file_content が ctx.attr に存在することを前提としています。最後の 4 つは値が None の可能性があります。
パラメータ
ctx |
必須。
このユーティリティ 関数。 |