下列函式可從 @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)
實作已解壓縮的存放區修補作業。
這項規則適用於存放區規則的實作函式。如果未指定 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
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 檔案的公用程式函式 (如果要求的話)。
這項規則是為了在存放區規則的實作函式中使用。假設參數 name
、build_file
、build_file_content
、workspace_file
和 workspace_file_content
會出現在 ctx.attr
中;後四個參數的值可能為 None。
參數
ctx |
必要元素。 呼叫此公用程式函式的存放區規則的存放區內容。 |