属性

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.7
これは、ルールまたはアスペクトの属性スキーマを定義するための最上位モジュールです。各関数は、単一の属性のスキーマを表すオブジェクトを返します。これらのオブジェクトは、rule()、aspect()、repository_rule()、tag_class() の attrs 辞書引数の値として使用されます。

属性の定義と使用の詳細については、[ルール] ページをご覧ください。

メンバー

ブール値

Attribute attr.bool(configurable=unbound, default=False, doc=None, mandatory=False)

ブール値属性のスキーマを作成します。対応する ctx.attr 属性の型は bool になります。

パラメータ

パラメータ 説明
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default bool; デフォルトは False
ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。

int

Attribute attr.int(configurable=unbound, default=0, doc=None, mandatory=False, values=[])

整数属性のスキーマを作成します。値は符号付き 32 ビットの範囲内である必要があります。対応する ctx.attr 属性の型は int になります。

パラメータ

パラメータ 説明
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default int; デフォルトは 0
ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。
values int のシーケンス。デフォルトは []
属性に指定できる値のリスト。他の値が指定された場合はエラーが発生します。

int_list

Attribute attr.int_list(mandatory=False, allow_empty=True, *, configurable=unbound, default=[], doc=None)

整数のリスト属性のスキーマを作成します。各要素は符号付き 32 ビットの範囲内である必要があります。

パラメータ

パラメータ 説明
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。
allow_empty bool; デフォルトは True
属性を空にできる場合は True。
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default int の sequence。デフォルトは []
です。 ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。

ラベル

Attribute attr.label(configurable=unbound, default=None, materializer=None, doc=None, executable=False, allow_files=None, allow_single_file=None, mandatory=False, skip_validations=False, providers=[], for_dependency_resolution=unbound, allow_rules=None, cfg=None, aspects=[], flags=[])

ラベル属性のスキーマを作成します。これは依存関係属性です。

この属性には、一意の Label 値が含まれます。Label の代わりに文字列が指定された場合は、ラベル コンストラクタを使用して変換されます。（名前が変更されている可能性のある）リポジトリを含むラベルパスの相対部分は、インスタンス化されたターゲットのパッケージに対して解決されます。

分析時（ルールの実装関数内）に ctx.attr から属性値を取得すると、ラベルは対応する Target に置き換えられます。これにより、現在のターゲットの依存関係のプロバイダにアクセスできます。

この種の属性は、通常のソースファイルに加えて、ツール（コンパイラなど）を参照するためによく使用されます。このようなツールは、ソースファイルと同様に依存関係と見なされます。ユーザーが BUILD ファイルでルールを使用するたびにツールのラベルを指定する必要がないように、正規ツールのラベルをこの属性の default 値としてハードコードできます。ユーザーがこのデフォルトをオーバーライドできないようにする場合は、アンダースコアで始まる名前を付けて属性を非公開にできます。詳細については、ルールのページをご覧ください。

パラメータ

パラメータ 説明
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default ラベル、文字列、LateBoundDefault、NativeComputedDefault、関数、None。デフォルトは None
です。 ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。文字列または Label 関数を使用して、デフォルト値を指定します（例: attr.label(default = "//a:b")）。
materializer function; デフォルトは None
です。 試験運用版。このパラメータは試験運用版であり、いつでも変更される可能性があります。これに依存しないでください。--experimental_dormant_deps
を設定することで、試験運用として有効にできます。設定すると、属性は推移閉包から休止中の依存関係を具体化します。このパラメータの値は、依存関係ではないか、依存関係の解決に使用可能としてマークされているルールの属性の値にアクセスする関数である必要があります。属性の型に応じて、休止中の依存関係またはそのリストのいずれかを返す必要があります。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
executable bool; デフォルトは False
依存関係が実行可能である必要がある場合は True。つまり、ラベルは実行可能ファイル、または実行可能ファイルを出力するルールを参照する必要があります。ctx.executable.<attribute_name> を使用してラベルにアクセスします。
allow_files bool、または string のシーケンス、または None。デフォルトは None
です。 File ターゲットが許可されているかどうか。True、False（デフォルト）、または許可されるファイル拡張子のリスト（[".cc", ".cpp"] など）を指定できます。
allow_single_file デフォルトは None
です。これは allow_files と似ていますが、ラベルは単一のファイルに対応している必要があります。ctx.file.<attribute_name> からアクセスします。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。
skip_validations bool; デフォルトは False
true の場合、この属性からの推移的依存関係の検証アクションは実行されません。これは一時的な緩和策であり、将来的に削除されます。
providers sequence; デフォルトは []
この属性に表示される依存関係によって提供される必要があるプロバイダ。

この引数の形式は、プロバイダのリストのリストです。つまり、provider() によって返される *Info オブジェクト（または、以前のプロバイダの場合はその文字列名）です。依存関係は、少なくとも 1 つの内部リストで言及されているすべてのプロバイダを返す必要があります。便宜上、この引数はプロバイダの単一レベルのリストにすることもできます。その場合、1 つの要素を含む外部リストでラップされます。依存関係のルールで provides パラメータにプロバイダを宣伝することは必須ではありませんが、ベスト プラクティスと見なされます。
for_dependency_resolution デフォルトは unbound
です。この設定を行うと、属性はマテリアライザーで使用できるようになります。このような属性で参照できるのは、同じ名前のフラグでマークされたルールのみです。
allow_rules string の sequence、または None。デフォルトは None
です。 許可されるルール ターゲット（クラスの名前）。これは非推奨です（互換性のためだけに残されています）。代わりにプロバイダを使用してください。
cfg デフォルトは None
です。 属性の構成。"exec"（依存関係が execution platform 用にビルドされていることを示す）または "target"（依存関係が target platform 用にビルドされていることを示す）のいずれかになります。違いの典型的な例は、モバイルアプリを構築する場合です。この場合、target platform は Android または iOS で、execution platform は Linux、macOS、または Windows です。executable が True の場合、このパラメータは必須です。これは、ターゲット構成でホストツールが誤ってビルドされるのを防ぐためです。"target" には意味的な効果がないため、意図を明確にするのに本当に役立つ場合を除き、executable が False の場合は設定しないでください。
aspects Aspect の sequence。デフォルトは []
です。 この属性で指定された依存関係に適用されるアスペクト。
flags string の sequence。デフォルトは []
です。 非推奨。削除されます。

label_keyed_string_dict

Attribute attr.label_keyed_string_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, allow_files=None, allow_rules=None, providers=[], for_dependency_resolution=unbound, flags=[], mandatory=False, cfg=None, aspects=[])

キーがラベルで値が文字列であるディクショナリを保持する属性のスキーマを作成します。これは依存関係属性です。

この属性には、一意の Label 値が含まれます。Label の代わりに文字列が指定された場合は、ラベル コンストラクタを使用して変換されます。（名前が変更されている可能性のある）リポジトリを含むラベルパスの相対部分は、インスタンス化されたターゲットのパッケージに対して解決されます。

分析時（ルールの実装関数内）に ctx.attr から属性値を取得すると、ラベルは対応する Target に置き換えられます。これにより、現在のターゲットの依存関係のプロバイダにアクセスできます。

パラメータ

パラメータ 説明
allow_empty bool; デフォルトは True
属性を空にできる場合は True。
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default dict または function。デフォルトは {}
です。 ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。文字列または Label 関数を使用してデフォルト値を指定します（例: attr.label_keyed_string_dict(default = {"//a:b": "value", "//a:c": "string"})）。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
allow_files bool、または string のシーケンス、または None。デフォルトは None
です。 File ターゲットが許可されているかどうか。True、False（デフォルト）、または許可されるファイル拡張子のリスト（[".cc", ".cpp"] など）を指定できます。
allow_rules string の sequence、または None。デフォルトは None
です。 許可されるルール ターゲット（クラスの名前）。これは非推奨です（互換性のためだけに残されています）。代わりにプロバイダを使用してください。
providers sequence; デフォルトは []
この属性に表示される依存関係によって提供される必要があるプロバイダ。

この引数の形式は、プロバイダのリストのリストです。つまり、provider() によって返される *Info オブジェクト（または、以前のプロバイダの場合はその文字列名）です。依存関係は、少なくとも 1 つの内部リストで言及されているすべてのプロバイダを返す必要があります。便宜上、この引数はプロバイダの単一レベルのリストにすることもできます。その場合、1 つの要素を含む外部リストでラップされます。依存関係のルールで provides パラメータにプロバイダを宣伝することは必須ではありませんが、ベスト プラクティスと見なされます。
for_dependency_resolution デフォルトは unbound
です。この設定を行うと、属性はマテリアライザーで使用できるようになります。このような属性で参照できるのは、同じ名前のフラグでマークされたルールのみです。
flags string の sequence。デフォルトは []
です。 非推奨。削除されます。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。
cfg デフォルトは None
です。 属性の構成。"exec"（依存関係が execution platform 用にビルドされていることを示す）または "target"（依存関係が target platform 用にビルドされていることを示す）のいずれかになります。この違いの典型的な例は、モバイルアプリを構築する場合です。この場合、target platform は Android または iOS で、execution platform は Linux、macOS、または Windows です。
aspects Aspect の sequence。デフォルトは []
です。 この属性で指定された依存関係に適用されるアスペクト。

label_list

Attribute attr.label_list(allow_empty=True, *, configurable=unbound, default=[], materializer=None, doc=None, allow_files=None, allow_rules=None, providers=[], for_dependency_resolution=unbound, flags=[], mandatory=False, skip_validations=False, cfg=None, aspects=[])

ラベルリスト属性のスキーマを作成します。これは依存関係属性です。対応する ctx.attr 属性は、Targets のリスト型になります。

この属性には、一意の Label 値が含まれます。Label の代わりに文字列が指定された場合は、ラベル コンストラクタを使用して変換されます。（名前が変更されている可能性のある）リポジトリを含むラベルパスの相対部分は、インスタンス化されたターゲットのパッケージに対して解決されます。

分析時（ルールの実装関数内）に ctx.attr から属性値を取得すると、ラベルは対応する Target に置き換えられます。これにより、現在のターゲットの依存関係のプロバイダにアクセスできます。

パラメータ

パラメータ 説明
allow_empty bool; デフォルトは True
属性を空にできる場合は True。
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default Label のシーケンス、または関数。デフォルトは []
です。 ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。文字列または Label 関数を使用してデフォルト値を指定します（例: attr.label_list(default = ["//a:b", "//a:c"])）。
materializer function; デフォルトは None
です。 試験運用版。このパラメータは試験運用版であり、いつでも変更される可能性があります。これに依存しないでください。--experimental_dormant_deps
を設定することで、試験運用として有効にできます。設定すると、属性は推移閉包から休止中の依存関係を具体化します。このパラメータの値は、依存関係ではないか、依存関係の解決に使用可能としてマークされているルールの属性の値にアクセスする関数である必要があります。属性の型に応じて、休止中の依存関係またはそのリストのいずれかを返す必要があります。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
allow_files bool、または string のシーケンス、または None。デフォルトは None
です。 File ターゲットが許可されているかどうか。True、False（デフォルト）、または許可されるファイル拡張子のリスト（[".cc", ".cpp"] など）を指定できます。
allow_rules string の sequence、または None。デフォルトは None
です。 許可されるルール ターゲット（クラスの名前）。これは非推奨です（互換性のためだけに残されています）。代わりにプロバイダを使用してください。
providers sequence; デフォルトは []
この属性に表示される依存関係によって提供される必要があるプロバイダ。

この引数の形式は、プロバイダのリストのリストです。つまり、provider() によって返される *Info オブジェクト（または、以前のプロバイダの場合はその文字列名）です。依存関係は、少なくとも 1 つの内部リストで言及されているすべてのプロバイダを返す必要があります。便宜上、この引数はプロバイダの単一レベルのリストにすることもできます。その場合、1 つの要素を含む外部リストでラップされます。依存関係のルールで provides パラメータにプロバイダを宣伝することは必須ではありませんが、ベスト プラクティスと見なされます。
for_dependency_resolution デフォルトは unbound
です。この設定を行うと、属性はマテリアライザーで使用できるようになります。このような属性で参照できるのは、同じ名前のフラグでマークされたルールのみです。
flags string の sequence。デフォルトは []
です。 非推奨。削除されます。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。
skip_validations bool; デフォルトは False
true の場合、この属性からの推移的依存関係の検証アクションは実行されません。これは一時的な緩和策であり、将来的に削除されます。
cfg デフォルトは None
です。 属性の構成。"exec"（依存関係が execution platform 用にビルドされていることを示す）または "target"（依存関係が target platform 用にビルドされていることを示す）のいずれかになります。この違いの典型的な例は、モバイルアプリを構築する場合です。この場合、target platform は Android または iOS で、execution platform は Linux、macOS、または Windows です。
aspects Aspect の sequence。デフォルトは []
です。 この属性で指定された依存関係に適用されるアスペクト。

output

Attribute attr.output(doc=None, mandatory=False)

出力（ラベル）属性のスキーマを作成します。

この属性には、一意の Label 値が含まれます。Label の代わりに文字列が指定された場合は、ラベル コンストラクタを使用して変換されます。（名前が変更されている可能性のある）リポジトリを含むラベルパスの相対部分は、インスタンス化されたターゲットのパッケージに対して解決されます。

分析時に、対応する File は ctx.outputs を使用して取得できます。

パラメータ

パラメータ 説明
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。

output_list

Attribute attr.output_list(allow_empty=True, *, doc=None, mandatory=False)

出力リスト属性のスキーマを作成します。

この属性には、一意の Label 値が含まれます。Label の代わりに文字列が指定された場合は、ラベル コンストラクタを使用して変換されます。（名前が変更されている可能性のある）リポジトリを含むラベルパスの相対部分は、インスタンス化されたターゲットのパッケージに対して解決されます。

分析時に、対応する File は ctx.outputs を使用して取得できます。

パラメータ

パラメータ 説明
allow_empty bool; デフォルトは True
属性を空にできる場合は True。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。

文字列

Attribute attr.string(configurable=unbound, default='', doc=None, mandatory=False, values=[])

文字列属性のスキーマを作成します。

パラメータ

パラメータ 説明
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default string、または NativeComputedDefault。デフォルトは ''
です。 ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。
values 文字列のシーケンス。デフォルトは []
です。 属性に指定できる値のリスト。他の値が指定された場合はエラーが発生します。

string_dict

Attribute attr.string_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, mandatory=False)

キーと値が文字列であるディクショナリを保持する属性のスキーマを作成します。

パラメータ

パラメータ 説明
allow_empty bool; デフォルトは True
属性を空にできる場合は True。
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default dict; デフォルトは {}
ルールをインスタンス化するときに、この属性の値が指定されていない場合に使用するデフォルト値。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。

string_keyed_label_dict

Attribute attr.string_keyed_label_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, allow_files=None, allow_rules=None, providers=[], for_dependency_resolution=unbound, flags=[], mandatory=False, cfg=None, aspects=[])

値がディクショナリである属性のスキーマを作成します。ディクショナリのキーは文字列で、値はラベルです。これは依存関係属性です。

この属性には、一意の Label 値が含まれます。Label の代わりに文字列が指定された場合は、ラベル コンストラクタを使用して変換されます。（名前が変更されている可能性のある）リポジトリを含むラベルパスの相対部分は、インスタンス化されたターゲットのパッケージに対して解決されます。

分析時（ルールの実装関数内）に ctx.attr から属性値を取得すると、ラベルは対応する Target に置き換えられます。これにより、現在のターゲットの依存関係のプロバイダにアクセスできます。

パラメータ

パラメータ 説明
allow_empty bool; デフォルトは True
属性を空にできる場合は True。
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default dict または function。デフォルトは {}
です。 ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。文字列または Label 関数を使用してデフォルト値を指定します（例: attr.string_keyed_label_dict(default = {"foo": "//a:b", "bar": "//a:c"})）。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
allow_files bool、または string のシーケンス、または None。デフォルトは None
です。 File ターゲットが許可されているかどうか。True、False（デフォルト）、または許可されるファイル拡張子のリスト（[".cc", ".cpp"] など）を指定できます。
allow_rules string の sequence、または None。デフォルトは None
です。 許可されるルール ターゲット（クラスの名前）。これは非推奨です（互換性のためだけに残されています）。代わりにプロバイダを使用してください。
providers sequence; デフォルトは []
この属性に表示される依存関係によって提供される必要があるプロバイダ。

この引数の形式は、プロバイダのリストのリストです。つまり、provider() によって返される *Info オブジェクト（または、以前のプロバイダの場合はその文字列名）です。依存関係は、少なくとも 1 つの内部リストで言及されているすべてのプロバイダを返す必要があります。便宜上、この引数はプロバイダの単一レベルのリストにすることもできます。その場合、1 つの要素を含む外部リストでラップされます。依存関係のルールで provides パラメータにプロバイダを宣伝することは必須ではありませんが、ベスト プラクティスと見なされます。
for_dependency_resolution デフォルトは unbound
です。この設定を行うと、属性はマテリアライザーで使用できるようになります。このような属性で参照できるのは、同じ名前のフラグでマークされたルールのみです。
flags string の sequence。デフォルトは []
です。 非推奨。削除されます。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。
cfg デフォルトは None
です。 属性の構成。"exec"（依存関係が execution platform 用にビルドされていることを示す）または "target"（依存関係が target platform 用にビルドされていることを示す）のいずれかになります。この違いの典型的な例は、モバイルアプリを構築する場合です。この場合、target platform は Android または iOS で、execution platform は Linux、macOS、または Windows です。
aspects Aspect の sequence。デフォルトは []
です。 この属性で指定された依存関係に適用されるアスペクト。

string_list

Attribute attr.string_list(mandatory=False, allow_empty=True, *, configurable=unbound, default=[], doc=None)

文字列リスト属性のスキーマを作成します。

パラメータ

パラメータ 説明
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。
allow_empty bool; デフォルトは True
属性を空にできる場合は True。
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default string の sequence、または NativeComputedDefault。デフォルトは []
です。 ルールをインスタンス化するときにこの属性の値が指定されていない場合に使用するデフォルト値。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。

string_list_dict

Attribute attr.string_list_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, mandatory=False)

キーが文字列で、値が文字列のリストであるディクショナリを保持する属性のスキーマを作成します。

パラメータ

パラメータ 説明
allow_empty bool; デフォルトは True
属性を空にできる場合は True。
configurable bool、またはバインドされていない。デフォルトは unbound
です。 この引数は、シンボリック マクロの属性に対してのみ指定できます。

configurable が明示的に False に設定されている場合、シンボリック マクロ属性は構成できません。つまり、select() 値を取得できません。configurable がバインドされていないか、明示的に True に設定されている場合、属性は構成可能で、select() 値を取ることができます。

ルールまたはアスペクトの属性の場合、configurable はバインドされていない状態にする必要があります。ほとんどの Starlark ルール属性は常に構成可能ですが、attr.output()、attr.output_list()、attr.license() のルール属性は常に構成できません。
default dict; デフォルトは {}
ルールをインスタンス化するときに、この属性の値が指定されていない場合に使用するデフォルト値。
doc string、または None。デフォルトは None
ドキュメント生成ツールで抽出できる属性の説明。
mandatory bool; デフォルトは False
true の場合、値は明示的に指定する必要があります（default がある場合でも）。