utils 存放區規則

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

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

擷取後用於操控外部存放區的工具。

設定

這些公用程式可供其他存放區規則使用。這些結構可以按照下列方式載入。

load(
    "@bazel_tools//tools/build_defs/repo:utils.bzl",
    "workspace_and_buildfile",
    "patch",
    "update_attrs",
)

get_auth

get_auth(ctx, urls)

運用公用程式函式,從 .netrc 檔案取得網址清單的正確驗證字典。

支援選填的 netrc 和 auth_patterns 屬性 (如有)。

參數

ctx 必要元素。

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

urls 必要元素。

要讀取的網址清單

傳回

可傳遞至 repository_ctx.download 的授權字典

也許

maybe(repo_rule, name, kwargs)

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

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

參數

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 檔案和網址清單,計算驗證字典。

參數

netrc 必要元素。

已剖析為字典的 netrc 檔案,例如從 read_netrc 取得的檔案

urls 必要元素。

網址清單。

patterns 系統要求。

授權模式網址字典 (選填)

傳回

適合作為 ctx.download 的驗證引數的字典;更精確地說,字典會將所有網址對應至提供登入和密碼的 netrc 檔案,並在字典中加入對應的登入、密碼和選用授權模式,以及「type」與「basic」或「pattern」的對應。

workspace_and_buildfile

workspace_and_buildfile(ctx)

用於編寫 WORKSPACE 和 BUILD 檔案的公用程式函式 (如果要求的話)。

這項規則是為了在存放區規則的實作函式中使用。假設參數 namebuild_filebuild_file_contentworkspace_fileworkspace_file_content 會出現在 ctx.attr 中;後四個參數的值可能為 None。

參數

ctx 必要元素。

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