建置檔案

可在 BUILD 檔案中使用的函式。如要瞭解其他functions和建構規則 (也可用於 BUILD 檔案)，請參閱「建構百科全書」。

成員

• depset
• existing_rule
• existing_rules
• exports_files
• glob
• module_name
• module_version
• package
• package_group
• package_name
• package_relative_label
• repo_name
• repository_name
• 選取
• subpackages

depset

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

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

由於以雜湊為基礎的集合會在疊代期間用於消除重複項目，因此 depset 的所有元素都應可雜湊。不過，目前並未在所有建構函式中一致檢查此不變量。使用 --incompatible_always_check_depset_elements 標記啟用一致檢查功能，這將成為日後版本的預設行為；請參閱 Issue 10313。

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

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

參數

existing_rule

unknown existing_rule(name)

在此，不可變動的字典類型物件是指深層不可變動的物件 x，可支援字典類型的疊代作業、len(x)、name in x、x[name]、x.get(name)、x.items()、x.keys() 和 x.values()。

結果包含每個屬性的項目，但私人屬性 (名稱不以字母開頭) 和幾個無法表示的舊版屬性類型除外。此外，字典還包含規則例項的 name 和 kind 項目 (例如 'cc_binary')。

結果的值代表屬性值，如下所示：

• 屬性類型為 str、int 和 bool 時，會以原樣表示。
• 標籤會轉換為字串，如果是同一個套件中的目標，則為 ':foo' 格式；如果是不同套件中的目標，則為 '//pkg:name' 格式。
• 清單會以元組表示，字典會轉換為可變動的字典。其元素會以相同方式遞迴轉換。
• select 值會傳回，且內容會按照上述方式轉換。
• 在規則例項化期間未指定值，且系統計算出預設值的屬性，會從結果中排除。(計算的預設值必須在分析階段後才能計算)。

請盡量避免使用此函式。這會導致 BUILD 檔案變得脆弱且依序依賴。此外，請注意，這與將規則屬性值從內部格式轉換為 Starlark 的其他兩種轉換方式略有不同：一種是運算預設值使用，另一種是 ctx.attr.foo 使用。

參數

existing_rules

unknown existing_rules()

在此，不可變動的字典類型物件是指深層不可變動的物件 x，可支援字典類型的疊代作業、len(x)、name in x、x[name]、x.get(name)、x.items()、x.keys() 和 x.values()。

注意：請盡量避免使用這個函式。這會導致 BUILD 檔案變得脆弱且依序依賴。

exports_files

None exports_files(srcs, visibility=None, licenses=None)

sequence glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)

string module_name()

string module_version()

unknown package(**kwargs)

None package_group(name, packages=[], includes=[])

string package_name()

Label package_relative_label(input)

string repo_name()

string repository_name()

unknown select(x, no_match_error='')

sequence subpackages(include, exclude=[], allow_empty=False)