utils 代码库规则

报告问题 查看源代码 每夜 build · 8.0 . 7.47.3 · 7.2 · 7.1 · 7.0 · 6.5

可以从 @bazel_tools//tools/build_defs/repo:utils.bzl 加载以下函数。

可能

maybe(repo_rule, name, kwargs)

实用函数,用于仅在尚不存在代码库时添加代码库。

这是为了实现 https://bazel.build/rules/deploying#dependencies 中记录的安全 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)

实现了对已提取的代码库进行补丁修复。

此规则旨在用于代码库规则的实现函数中。如果未指定参数 patchespatch_toolpatch_argspatch_cmdspatch_cmds_win,则系统会从 ctx.attr 中获取这些参数。

参数

ctx 必填。

调用此实用程序函数的代码库规则的代码库上下文。

patches 可选。默认值为 None

要应用的补丁文件。字符串、标签或路径的列表。

patch_cmds 可选。默认值为 None

用于执行修补程序的 bash 命令,一次传递一个命令给 bash -c。字符串列表

patch_cmds_win 可选。默认值为 None

用于执行补丁的 Powershell 命令,一次传递一个到 powershell /c。字符串列表。如果此参数的布尔值为 false,则系统将使用 patch_cmds,并忽略此参数。

patch_tool 可选。默认值为 None

用于应用补丁的要执行的补丁工具的路径。字符串。

patch_args 可选。默认值为 None

要传递给补丁工具的参数。字符串列表。

auth 可选。默认值为 None

一个可选的字典,用于指定部分网址的身份验证信息。

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 必填。

要替换或添加到原始对象的属性的字典

use_netrc

use_netrc(netrc, urls, patterns)

根据解析的 netrc 文件和网址列表计算 auth 字典。

参数

netrc 必填。

已解析为字典的 netrc 文件,例如从 read_netrc 获取的文件

urls 必填。

网址列表。

patterns 必填。

可选的网址与授权模式对应的字典

workspace_and_buildfile

workspace_and_buildfile(ctx)

用于编写 WORKSPACE 和(如果需要)BUILD 文件的实用函数。

此规则旨在用于代码库规则的实现函数。它假定 ctx.attr 中存在参数 namebuild_filebuild_file_contentworkspace_fileworkspace_file_content;后四个参数的值可能是 None。

参数

ctx 必填。

调用此实用程序函数的代码库规则的代码库上下文。