.bzl 檔案

回報問題 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

所有 .bzl 檔案中可用的全域方法。

成員

analysis_test_transition

transition analysis_test_transition(settings)

建立要套用至分析測試規則依附元件的設定轉換。這個轉場效果只能套用至含有 analysis_test = True 的規則屬性。這類規則的功能受限 (例如,依附元件樹狀結構的大小受限),因此使用此函式建立的轉場,潛在範圍會比使用 transition() 建立的轉場受限。

這個函式主要用於協助分析測試架構核心程式庫。如需最佳做法,請參閱說明文件 (或實作方式)。

參數

參數 說明
settings required
字典,其中包含應透過此設定轉換作業設定的設定資訊。鍵是建構設定標籤,值則是新的轉換後值。所有其他設定則維持不變。您可以使用這個選項宣告通過分析測試才能通過的具體配置設定。

切面

Aspect aspect(implementation, attr_aspects=[], attrs={}, required_providers=[], required_aspect_providers=[], provides=[], requires=[], fragments=[], host_fragments=[], toolchains=[], incompatible_use_toolchain_transition=False, doc=None, *, apply_to_generating_rules=False, exec_compatible_with=[], exec_groups=None, subrules=[])

建立新的面向。此函式的結果必須儲存在全域值中。詳情請參閱「Aspects」簡介

參數

參數 說明
implementation 必要
Starlark 函式,用於實作此面向,共有兩個參數:Target (要套用面向的目標) 和 ctx (建立目標的規則內容)。目標屬性可透過 ctx.rule 欄位使用。這個函式會在分析階段評估,每次將某個面向套用至目標時都會評估。
attr_aspects 字串序列;預設為 []
。屬性名稱清單。此面向會沿著目標屬性中指定的依附元件 (使用這些名稱) 傳播。常見的值包括 depsexports。清單也可以包含單一字串 "*",以便沿著目標的所有依附元件傳播。
attrs dict; 預設為 {}
宣告各個面向的所有屬性的字典。它會將屬性名稱對應至屬性物件,例如 `attr.label` 或 `attr.string` (請參閱 attr 模組)。實作函式可使用面向實體屬性做為 ctx 參數的欄位。

_ 開頭的隱含屬性必須有預設值,且類型為 labellabel_list

明確屬性必須是 string 類型,且必須使用 values 限制。明確屬性會限制相片集合,只允許使用具有相同名稱、類型和有效值的規則。

required_providers 預設為 []
這個屬性可讓面向限制其傳播範圍,只限於規則宣傳其必要供應者的目標。值必須是包含個別供應商或供應商清單的清單,但不能同時包含兩者。舉例來說,[[FooInfo], [BarInfo], [BazInfo, QuxInfo]] 是有效值,而 [FooInfo, BarInfo, [BazInfo, QuxInfo]] 則不是有效值。

未巢狀的供應商清單會自動轉換為包含一個供應商清單的清單。也就是說,[FooInfo, BarInfo] 會自動轉換為 [[FooInfo, BarInfo]]

如要讓部分規則 (例如 some_rule) 的目標對象對某個面向可見,some_rule 必須宣傳至少一個必要供應者清單中的所有供應者。舉例來說,如果某個面向的 required_providers[[FooInfo], [BarInfo], [BazInfo, QuxInfo]],則只有在 some_rule 提供 FooInfo BarInfo BazInfo QuxInfo 時,這個面向才能看到 some_rule 目標。

required_aspect_providers 預設值為 []
這個屬性可讓此切面檢查其他層面。這個值必須是清單,且只能包含個別供應商或供應商清單,不能同時包含兩者。舉例來說,[[FooInfo], [BarInfo], [BazInfo, QuxInfo]] 是有效值,而 [FooInfo, BarInfo, [BazInfo, QuxInfo]] 則不是有效值。

未巢狀的供應商清單會自動轉換為包含一個供應商清單的清單。也就是說,[FooInfo, BarInfo] 會自動轉換為 [[FooInfo, BarInfo]]

如要讓這個面向顯示其他部分 (例如 other_aspect),other_aspect 必須提供至少其中一份清單中的所有供應商。在 [[FooInfo], [BarInfo], [BazInfo, QuxInfo]] 的範例中,只有在 other_aspect 提供 FooInfo BarInfo BazInfo QuxInfo 的情況下,此切面才可看到 other_aspect

provides 預設為 []
implementation 函式必須傳回的供應商清單。

如果實作函式省略傳回值中列出的任何提供者類型,則會發生錯誤。不過,實作函式可能會傳回此處未列出的其他供應工具。

清單中的每個元素都是 provider() 傳回的 *Info 物件,但舊版提供者會以其字串名稱表示。如果規則的目標用於宣告必要提供者的目標的依附元件,則不必在此指定該提供者。只要實作函式傳回即可。不過,雖然這不是必要條件,但我們建議您指定該值。不過,資產required_providers 欄位確實需要在這裡指定提供者。

requires 切面序列;預設為 []
。 必須在這個切面之前傳播的切面清單。
fragments 序列字串;預設值為 []
切面在目標設定中使用的設定片段名稱清單。
host_fragments 字串序列;預設值為 []
。 主機設定中,此面向主機的元素所需的設定片段名稱清單。
toolchains sequence; 預設為 []
。 如果已設定,則為此規則所需的工具鍊集。清單可包含字串、標籤或 StarlarkToolchainTypeApi 物件,且可任意組合。系統會檢查目前的平台來尋找工具鏈,並透過 ctx.toolchain 將其提供給規則實作。
incompatible_use_toolchain_transition 預設值為 False
已淘汰,不再使用,應予以移除。
doc stringNone; 預設為 None
說明說明文件產生工具可擷取的層面。
apply_to_generating_rules 預設為 False
如果為 true,則在套用至輸出檔案時,會改為套用至輸出檔案的產生規則。

舉例來說,假設某個層面會透過屬性 `deps` 傳播,並套用至目標 `alpha`。假設 `alpha` 有 `deps = [':beta_output']`,其中 `beta_output` 是目標 `beta` 的已宣告輸出內容。假設 `beta` 有目標 `charlie` 做為其中一個 `deps`。如果層面為 `apply_to_generating_rules=True`,則層面會透過 `alpha`、`beta` 和 `charlie` 傳播。如果為 False,則層面只會傳播至 `alpha`。

預設為 False。

exec_compatible_with 字串sequence;預設為 []
執行平台的限制清單,適用於該切面的所有執行個體。
exec_groups dictNone;預設為 None
。執行群組名稱 (字串) 與 exec_group 的字典。如果已設定,則可讓面向在單一例項中執行多個執行平台的動作。詳情請參閱執行群組說明文件
subrules 「Subrule」sequence;預設為 []
實驗功能:此方面使用的子規則清單。

configuration_field

LateBoundDefault configuration_field(fragment, name)

參照 label 類型屬性的延遲繫結預設值。如果值需要先建立設定才能判斷值,則為「延遲繫結」。任何使用此值做為值的屬性都必須是私有屬性

以下是範例使用方式:

定義規則屬性:

'_foo': attr.label(default=configuration_field(fragment='java', name='toolchain'))

在規則實作中存取:

  def _rule_impl(ctx):
    foo_info = ctx.attr._foo
    ...

參數

參數 說明
fragment 必要
包含延遲值的設定片段名稱。
name required
From the configuration fragment, the name of the value to obtain.

depset

depset depset(direct=None, order="default", *, transitive=None)

建立 depsetdirect 參數是 depset 的直接元素清單,而 transitive 參數則是 depset 的清單,其中元素會成為所建立 depset 的間接元素。order 參數會指定將 depset 轉換為清單時,元素的傳回順序。詳情請參閱「Depset 總覽」。

依據 type(x) 運算式取得的 depset 所有元素 (直接和間接) 都必須屬於相同類型。

由於雜湊式集是用於在疊代期間刪除重複項目,因此解碼集的所有元素都必須可供雜湊處理。不過,目前並未在所有建構函式中一致檢查此不變量。使用 --incompatible_always_check_depset_elements 標記啟用一致檢查功能,這將成為日後版本的預設行為;請參閱 Issue 10313

此外,元素目前必須是不可變動的,但這項限制日後會放寬。

建立的 depset 順序應與其 transitive depset 順序相容"default" 順序與任何其他順序相容,所有其他順序只與自身相容。

參數

參數 說明
direct 序列; 或 None;預設值為 None
直接直接直接元素元素。
order 預設為 "default"
新 depset 的遍歷策略。如要查看可能的值,請參閱這裡
transitive depset序列;或 None; 預設為 None
depset 清單,其元素會成為 depset 的間接元素。

exec_group

exec_group exec_group(toolchains=[], exec_compatible_with=[])

建立執行群組,可用於在規則導入期間為特定執行平台建立動作。

參數

參數 說明
toolchains sequence;預設為 []
。這個執行群組所需的工具鍊組合。清單可包含字串、標籤或 StarlarkToolchainTypeApi 物件,且可任意組合。
exec_compatible_with 字串序列;預設值為 []
。 執行平台的限制清單。

module_extension

unknown module_extension(implementation, *, tag_classes={}, doc=None, environ=[], os_dependent=False, arch_dependent=False)

建立新的模組擴充功能。將其儲存為全域值,以便匯出並用於 MODULE.bazel 檔案。

參數

參數 說明
implementation required
實作此模組擴充功能的函式。必須使用單一參數 module_ctx。系統會在建構開始時呼叫此函式,藉此決定可用的存放區組合。
tag_classes 預設為 {}
用於宣告擴充功能所使用的所有標記類別的字典。它會將標記類別名稱對應至 tag_class 物件。
doc 字串None;預設為 None
。 說明模組擴充功能,可由說明文件產生工具擷取。
environ 字串序列;預設為 []
。提供此模組擴充功能依附的環境變數清單。如果這份清單中的環境變數有所變更,系統會重新評估擴充功能。
os_dependent 預設為 False
指出此擴充功能是否依 OS 而異
arch_dependent 預設值為 False
表示這項擴充功能是否取決於架構

供應商

unknown provider(doc=None, *, fields=None, init=None)

定義供應者符號。您可以透過呼叫供應器來例項化供應器,也可以直接將其用作索引鍵,從目標中擷取該供應器的例項。範例:
MyInfo = provider()
...
def _my_library_impl(ctx):
    ...
    my_info = MyInfo(x = 2, y = 3)
    # my_info.x == 2
    # my_info.y == 3
    ...

如需供應商使用方法的完整指南,請參閱「規則 (供應商)」一文。

如未指定 init,系統會傳回 Provider 可呼叫值。

如果指定 init,則會傳回 2 個元素的元組:Provider 可呼叫值和原始建構函式可呼叫值。詳情請參閱「 規則 (自訂供應者的自訂初始化)」一文,以及下方 init 參數的討論內容。

參數

參數 說明
doc 字串None; 預設值為 None
提供者說明,可由文件產生工具擷取。
fields 字串序列;或 字典;或 None;預設為 None
。 如果指定,則會限制允許的欄位集。
可能的值包括:
  • 欄位清單:
    provider(fields = ['a', 'b'])

  • 字典欄位名稱 -> 說明文件:
    provider(
           fields = { 'a' : 'Documentation for a', 'b' : 'Documentation for b' })
所有欄位均為選填欄位。
init 可叫用的函式;或 None; 預設值為 None
在例項化期間,用於預先處理及驗證提供者欄位值的選用回呼。如果指定 initprovider() 會傳回 2 個元素的元組:一般提供者符號和原始建構函式

以下提供詳細說明。如需直覺的討論和用途,請參閱「規則 (供應者的自訂初始化作業)」。

P 成為透過呼叫 provider() 建立的提供者符號。概念上來說,P 的例項是透過呼叫預設建構函式 c(*args, **kwargs) 產生,而該函式會執行以下操作:

  • 如果 args 非空白,就會發生錯誤。
  • 如果在呼叫 provider() 時指定 fields 參數,且 kwargs 包含 fields 中未列出的任何鍵,就會發生錯誤。
  • 否則,c 會傳回 kwargs 中每個 k: v 項目的新例項,也就是名為 k 且值為 v 的欄位。
如果未提供 init 回呼,呼叫符號 P 本身會視為呼叫預設建構函式 c;換句話說,P(*args, **kwargs) 會傳回 c(*args, **kwargs)。舉例來說,
MyInfo = provider()
m = MyInfo(foo = 1)
會直接將 m 設為含有 m.foo == 1MyInfo 例項。

但如果指定 init,呼叫 P(*args, **kwargs) 會改為執行下列步驟:

  1. 回呼會被叫用為 init(*args, **kwargs),也就是與傳遞至 P 完全相同的位置和關鍵字引數。
  2. init 的傳回值應為字典 d,其鍵為欄位名稱字串。否則會發生錯誤。
  3. 系統會產生新的 P 例項,就像呼叫預設建構函式,並將 d 的項目做為關鍵字引數,如 c(**d) 所示。

注意:上述步驟表示,如果 *args**kwargsinit 的簽名不符、init 主體的評估作業失敗 (或許刻意透過呼叫 fail()),或是 init 的傳回值與預期的結構定義不符,就會發生錯誤。

因此,init 回呼會允許位置引數和任意邏輯,用於預先處理和驗證,進而將一般提供者建構程序泛用化。不會讓您規避允許的 fields 清單。

指定 init 後,provider() 的回傳值會變成元組 (P, r),其中 r原始建構函式。事實上,r 的行為正是上述預設建構函式 c 的行為。通常,r 會繫結至名稱前面有底線的變數,因此只有目前的 .bzl 檔案可以直接存取該變數:

MyInfo, _new_myinfo = provider(init = ...)

repository_rule

callable repository_rule(implementation, *, attrs=None, local=False, environ=[], configure=False, remotable=False, doc=None)

建立新的存放區規則。將其儲存為全域值,以便從 WORKSPACE 檔案載入及呼叫。

參數

參數 說明
implementation 必要
實作此規則的函式。必須有單一參數 repository_ctx。系統會在規則的每個例項載入階段中呼叫此函式。
attrs dict;或 None;預設為 None
字典,用於宣告規則的所有屬性。它會將屬性名稱對應至屬性物件 (請參閱 attr 模組)。開頭為 _ 的屬性屬於私人性質,可用於為檔案加上標籤的隱含依附元件 (存放區規則無法依附於產生的成果)。系統會隱含新增屬性 name,因此不必指定。
local 預設值為 False
表示這項規則會從本機系統擷取所有資料,且每次擷取時都應重新評估。
environ 「字串」的 sequence;預設值為 []
已淘汰。這個參數已淘汰。請遷移至 repository_ctx.getenv
提供這個存放區規則依附的環境變數清單。如果清單中的環境變數發生變更,系統會重新擷取存放區。
configure 預設為 False
表示存放區會檢查系統以進行設定
remotable 預設值為 False
實驗功能。這項參數仍在實驗階段,隨時可能變更。請勿依賴這項功能。你可以透過設定 ---experimental_repo_remote_exec
與遠端執行相容,
doc 字串None;預設為 None
。 Repository 規則的說明,可由說明文件產生工具擷取。

規則

callable rule(implementation, *, test=unbound, attrs={}, outputs=None, executable=unbound, output_to_genfiles=False, fragments=[], host_fragments=[], _skylark_testable=False, toolchains=[], incompatible_use_toolchain_transition=False, doc=None, provides=[], exec_compatible_with=[], analysis_test=False, build_setting=None, cfg=None, exec_groups=None, initializer=None, parent=None, extendable=None, subrules=[])

建立新規則,可從 BUILD 檔案或巨集呼叫,用於建立目標。

規則必須指派至 .bzl 檔案中的全域變數;全域變數的名稱就是規則的名稱。

測試規則的名稱必須以 _test 結尾,但所有其他規則不得使用這個後置字串。(這項限制僅適用於規則,不適用於其目標)。

參數

參數 說明
implementation 必要
實作這項規則的 Starlark 函式只能包含一個參數:ctx。系統會在分析階段為每個規則例項呼叫這項函式。可存取使用者提供的屬性。必須建立動作,才能產生所有宣告的輸出內容。
test bool;預設值為 unbound
。是否為測試規則,也就是是否可成為 blaze test 指令的主體。所有測試規則都會自動視為「可執行」;您不必為測試規則明確設定 executable = True,因此不需要 (不建議) 採取這種做法。預設值為 False。詳情請參閱 規則頁面
attrs dict;預設為 {}
字典,用於宣告規則的所有屬性。它會將屬性名稱對應至屬性物件 (請參閱 attr 模組)。以 _ 開頭的屬性為私有,可用於在標籤上新增隱含的依附元件。系統會隱含新增 name 屬性,因此您不需要指定。系統會隱含新增 visibilitydeprecationtagstestonlyfeatures 屬性,且無法覆寫。大部分規則只需要幾個屬性。為了限制記憶體用量,規則函式設有曝光事件大小上限。
outputs 字典;或 None;或函式;預設為 None
已淘汰。此參數已淘汰,並將在近期內移除。請勿仰賴這項功能。這項功能已停用 ---incompatible_no_rule_outputs_param。使用這個標記,驗證您的程式碼是否與即將移除的標記相容。
此參數已淘汰。請將規則遷移為改用 OutputGroupInfoattr.output

用於定義預先宣告輸出的結構定義。與 outputoutput_list 屬性不同,使用者不會為這些檔案指定標籤。如要進一步瞭解預先宣告的輸出內容,請參閱「規則」頁面。

這個引數的值是字典,或是產生字典的回呼函式。回呼的運作方式與計算依附元件屬性類似:函式的參數名稱會與規則的屬性進行比對,舉例來說,如果您傳遞 outputs = _my_func 並使用定義 def _my_func(srcs, deps): ...,函式就能存取 srcsdeps 屬性。無論是直接指定字典或透過函式指定,系統都會依下列方式解讀字典。

字典中的每個項目都會建立預先宣告的輸出內容,其中索引鍵是 ID,值則是決定輸出標籤的字串範本。在規則的實作函式中,這個 ID 會成為欄位名稱,用於在 ctx.outputs 中存取輸出的 File。輸出標籤的套件與規則相同,套件後方部分則是將表單 "%{ATTR}" 的每個預留位置,替換為以屬性 ATTR 值所形成的字串:

  • 字串類型屬性會逐字替換。
  • 標籤類型屬性會成為套件後方的標籤部分,但不含副檔名。舉例來說,標籤 "//pkg:a/b.c" 會變成 "a/b"
  • 輸出類型屬性會成為套件後面的標籤部分,包括副檔名 (在上述範例中為 "a/b.c")。
  • 在預留位置中使用的所有清單型屬性 (例如 attr.label_list) 都必須只有一個元素。轉換與非清單版本相同 (attr.label)。
  • 其他屬性類型可能不會顯示在預留位置中。
  • 特殊的非屬性預留位置 %{dirname}%{basename} 會展開為規則標籤的這些部分,不含其套件。例如,在 "//pkg:a/b.c" 中,dirname 為 a,basename 為 b.c

實際上,最常見的替換預留位置是 "%{name}"。舉例來說,如果目標名稱為「foo」,輸出字典 {"bin": "%{name}.exe"} 會預先宣告名為 foo.exe 的輸出項目,在實作函式中可透過 ctx.outputs.bin 存取。

executable bool; 預設為 unbound
是否將此規則視為可執行,也就是是否可成為 blaze run 指令的主體。預設值為 False。詳情請參閱 規則頁面
output_to_genfiles 預設為 False
如果為 true,檔案會在 genfiles 目錄中產生,而不是在 bin 目錄中產生。除非您需要為現有規則提供相容性 (例如產生 C++ 標頭檔案時),否則請勿設定此標記。
fragments 字串序列;預設值為 []
。 列出規則在目標設定中所需的設定片段名稱。
host_fragments 字串序列;預設值為 []
。 列出規則在主機設定中所需的設定片段名稱。
_skylark_testable 預設值為 False
(實驗功能)

如果設為 true,這項規則會透過 Actions 供應器,根據需要使用這項規則的規則公開檢查動作。提供者也可以呼叫 ctx.created_actions(),以存取規則本身。

這個方法只能用來測試 Starlark 規則的分析時間行為。這個標記日後可能會移除。
toolchains sequence; 預設為 []
。 如果已設定,則為此規則所需的工具鍊集。清單可包含字串、標籤或 StarlarkToolchainTypeApi 物件,且可任意組合。系統會檢查目前的平台來尋找工具鏈,並透過 ctx.toolchain 將其提供給規則實作。
incompatible_use_toolchain_transition 預設值為 False
已淘汰,不再使用,應予以移除。
doc string; 或 None;預設為 None
說明文件產生工具可擷取的規則說明。
provides 預設為 []
implementation 函式必須傳回的供應商清單。

如果實作函式省略傳回值中列出的任何提供者類型,則會發生錯誤。不過,實作函式可能會傳回此處未列出的其他供應工具。

清單中的每個元素都是 provider() 傳回的 *Info 物件,但舊版提供者會以其字串名稱表示。如果規則的目標用於宣告必要提供者的目標的依附元件,則不必在此指定該提供者。只要實作函式傳回即可。不過,儘管這不是必要步驟,仍建議您指定最佳做法。不過,aspectrequired_providers 欄位需要指定提供者。

exec_compatible_with 字串序列;預設為 []
。 執行平台的限制清單,適用於此規則類型的所有目標。
analysis_test 預設為 False
如果為 true,則系統會將此規則視為分析測試。

注意:分析測試規則主要使用核心 Starlark 程式庫提供的基礎架構定義。如需相關指南,請參閱「測試」一節。

如果規則定義為分析測試規則,則可使用以 analysis_test_transition 定義的設定轉換,但會採用下列限制:

  • 這個規則的目標可能會有的間接相依項目數量有限。
  • 系統會將該規則視為測試規則 (就像已設定 test=True 一樣)。這會取代 test 的值
  • 規則實作函式可能不會註冊動作。而是必須透過提供 AnalysisTestResultInfo 註冊通過/失敗結果。
build_setting BuildSetting;或 None; 預設為 None
如果已設定,則會說明此規則是哪種 build setting。請參閱 config 模組。如果設定這項政策,系統會自動將名為「build_setting_default」的必要屬性加入這項規則,並將與此處傳入的值相對應的類型。
cfg 預設為 None
如果已設定,則會指向規則在分析前套用至自身設定的設定轉換。
exec_groups dict; 或 None; 根據預設為 None
執行群組名稱 (字串) 到 exec_groups。如果設定這項功能,規則就能在單一目標內的多個執行平台上執行動作。詳情請參閱執行群組說明文件
initializer 預設為 None
Experimental:Stalark 函式會初始化規則的屬性。

系統會針對每個規則執行個體,於載入時呼叫此函式。這個方法會使用 name 和規則定義的公開屬性值 (而非泛型屬性,例如 tags) 呼叫。

其必須從屬性名稱傳回字典到所需的值。未傳回的屬性則不受影響。如果傳回 None 做為值,則會使用屬性定義中指定的預設值。

系統會先評估初始化器,再評估屬性定義中指定的預設值。因此,如果初始化的簽章中包含預設值的參數,就會覆寫屬性定義中的預設值 (除非傳回 None)。

同樣地,如果初始化器簽章中的參數沒有預設值,該參數就會變成必要參數。在這種情況下,建議您省略屬性定義中的預設/必要設定。

對於未處理的屬性,建議使用 **kwargs

在延伸規則的情況下,所有初始化器都會從子項開始,依序呼叫上層。每個初始化器只會傳遞其瞭解的公開屬性。

parent 預設為 None
Experimental:擴充的 Stalark 規則。設定後,系統會合併公開屬性和宣傳的供應商。規則會比對父項中的 executabletest。系統會合併 fragmentstoolchainsexec_compatible_withexec_groups 的值。您可能無法設定舊版或已淘汰的參數。父項的傳入設定轉換 cfg 會在 thisrule 的傳入設定後套用。
extendable bool; 或 Label;,或 string; 或 None;預設值為 None
實驗功能:許可清單,定義哪些規則可以擴充這項規則。您也可以把這個參數設為 True/False,以一律允許/禁止擴充。Bazel 預設一律允許擴充功能。
subrules 子規則序列;預設值為 []
。 (實驗功能):這項規則使用的子規則清單。

選取

unknown select(x, no_match_error='')

select() 是使規則屬性「可設定」的輔助函式。詳情請參閱「建構百科全書」。

參數

參數 說明
x required
Dict,可將設定條件對應至值。每個鍵都是 標籤或標籤字串,用於識別 config_setting 或 constraint_value 例項。如要瞭解何時應使用標籤而非字串,請參閱 巨集說明文件
no_match_error 預設值為 ''
如果沒有相符的條件,系統就會回報這個自訂錯誤。

子規則

Subrule subrule(implementation, attrs={}, toolchains=[], fragments=[], subrules=[])

建構子規則的新例項。這個函式的結果必須儲存在全域變數中,才能使用。

參數

參數 說明
implementation function; 必要
Starlark 函式,用於實作此子規則
attrs dict; 預設為 {}
用於宣告子規則的所有 (私人) 屬性的字典。

子規則只能包含標籤型別 (即標籤或標籤清單) 的私人屬性。與這些標籤對應的解析值會自動由 Bazel 傳送至子規則的實作函式,做為具名引數 (因此,實作函式必須接受與屬性名稱相符的具名參數)。這些值的類型如下:

  • 具有 executable=True 的標籤屬性表示為 FilesToRunProvider
  • File 適用於標籤屬性,且含有 allow_single_file=True
  • Target 用於所有其他標籤屬性
  • [Target] 適用於所有標籤清單屬性
toolchains sequence; 預設為 []
如果已設定,則為此子規則所需的工具鍊組合。清單中可包含 String、Label 或 StarlarkToolchainTypeApi 物件,任意組合。查看目前的平台後即可找到工具鍊,並透過 ctx.toolchains 提供給子規則實作。
fragments 字串序列;預設為 []
。 列出子規則在目標設定中所需的設定片段名稱。
subrules 子規則序列;預設值為 []
。 列出這個子規則所需的其他子規則。

tag_class

tag_class tag_class(attrs={}, *, doc=None)

建立新的 tag_class 物件,為類別的代碼定義屬性架構,這些代碼是模組擴充功能可使用的資料物件。

參數

參數 說明
attrs 預設為 {}
用於宣告此標記類別的所有屬性。它會將屬性名稱對應至屬性物件 (請參閱 attr 模組)。
doc stringNone;預設為 None
。 可由說明文件產生工具擷取的標記類別說明。

顯示設定

None visibility(value)

設定目前正在初始化的 .bzl 模組的載入可見度。

模組的載入可見度會決定其他 BUILD 和 .bzl 檔案是否可以載入該模組。(這與底層 .bzl 來源檔案的目標可見度不同,後者會決定檔案是否會顯示為其他目標的依附元件)。載入可見度會在套件層級運作:如要載入模組,進行載入的檔案必須位於已授予模組可見度的套件中。無論可見性為何,模組一律會在其自身套件中載入。

每個 .bzl 檔案只能呼叫 visibility() 一次,且只能在頂層呼叫,而非在函式內呼叫。建議的樣式是將此呼叫放在 load() 陳述式下方,以及確定引數所需的任何簡短邏輯下方。

如果標記 --check_bzl_visibility 設為 false,載入可見度違規會發出警告,但不會導致建構失敗。

參數

參數 說明
value 必要
package_specification_strings 清單或單一 package_specification_string。

套件規格採用與 package_group 相同的格式,但不允許負面套件規格。也就是說,規格可能有以下形式:

  • "//foo":套件 //foo
  • "//foo/..."//foo 套件及其所有子套件。
  • "public""private":分別代表所有套件或沒有套件

不允許使用「@」語法;所有規格皆根據目前模組的存放區解譯。

如果 value 是字串清單,授予這個模組瀏覽權限的套件組合,就是每個規格代表的套件聯集。(空白清單的作用與 private 相同)。如果 value 是單一字串,系統會將其視為單一清單 [value]

請注意,旗標 --incompatible_package_group_has_public_syntax--incompatible_fix_package_group_reporoot_syntax 對這個引數沒有任何影響。"public""private" 值一律可用,而 "//..." 一律會解讀為「目前存放區中的所有套件」。