本頁面由 Cloud Translation API 翻譯而成。

utils 存放區規則

回報問題查看原始碼 Nightly · 8.0 . 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

下列函式可從 @bazel_tools//tools/build_defs/repo:utils.bzl 載入。

也許

maybe(repo_rule, name, kwargs)

公用函式，僅在未有存放區時才新增存放區。

這項做法是為了實作安全的 repositories.bzl 巨集，詳情請參閱 https://bazel.build/rules/deploying#dependencies。

parse_netrc(contents, filename)

用於剖析至少一個基本 .netrc 檔案的實用工具函式。

`contents`	必要元素。剖析器的輸入內容。
`filename`	選用。預設值為 `None`。在錯誤訊息中使用的檔案名稱 (如有)。

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。字串清單
`patch_cmds_win`	選用。預設值為 `None`。要執行的 Powershell 指令，一次傳送一項至 powershell /c。字串清單。如果這個參數的布林值為 false，系統會使用 patch_cmds，並忽略這個參數。
`patch_tool`	選用。預設值為 `None`。要執行以套用修補程式的修補程式工具路徑。字串。
`patch_args`	選用。預設值為 `None`。要傳遞至修補工具的引數。字串清單。
`auth`	選用。預設值為 `None`。可選的字典，可指定部分網址的驗證資訊。

read_netrc(ctx, filename)

用於剖析至少一個基本 .netrc 檔案的實用工具函式。

`ctx`	必要元素。呼叫此公用函式的存放區規則存放區內容。
`filename`	必要元素。要讀取的 .netrc 檔案名稱

read_user_netrc(ctx)

讀取使用者的預設 netrc 檔案。

ctx

必要元素。

呼叫此公用函式的存放區規則的存放區內容。

update_attrs(orig, keys, override)

公用函式，可用於變更特定存放區規則叫用作業的指定屬性，並將這些屬性新增至該作業。

這可用於讓規則可重現。

`orig`	必要元素。特定規則叫用時實際設定的屬性 (明確或隱含) 的字典
`keys`	必要元素。此規則中定義的完整屬性組合
`override`	必要元素。要覆寫或新增至原始屬性的屬性字典

use_netrc(netrc, urls, patterns)

根據剖析的 netrc 檔案和網址清單，計算驗證字典。

`netrc`	必要元素。已剖析為字典的 netrc 檔案，例如從 read_netrc 取得的檔案
`urls`	必要元素。網址清單。
`patterns`	必要元素。選用字典，其中包含網址與授權模式

workspace_and_buildfile(ctx)

用於寫入 WORKSPACE 和 (如有要求) BUILD 檔案的實用工具函式。

這個規則適用於存放區規則的實作函式。假設參數 name、build_file、build_file_content、workspace_file 和 workspace_file_content 會出現在 ctx.attr 中；後四個參數的值可能為 None。

ctx

必要元素。

呼叫此公用函式的存放區規則存放區內容。