属性

ルールまたはアスペクトの属性スキーマを定義するための最上位モジュールです。各関数は、1 つの属性のスキーマを表すオブジェクトを返します。これらのオブジェクトは、rule()aspect()attrs ディクショナリ引数の値として使用されます。

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

メンバー

ブール値

Attribute attr.bool(default=False, doc='', mandatory=False)

ブール値属性のスキーマを作成します。

パラメータ

パラメータ 説明
default デフォルト = False
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。

int

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

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

パラメータ

パラメータ 説明
default デフォルト = 0
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。
values sequence of ints、 デフォルト = []
属性で許可される値のリスト。その他の値を指定すると、エラーが発生します。

int_list

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

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

パラメータ

パラメータ 説明
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。
allow_empty デフォルト = True
属性を空にできる場合は true。
default sequence of ints、 デフォルト = []
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。

ラベル

Attribute attr.label(default=None, doc='', executable=False, allow_files=None, allow_single_file=None, mandatory=False, providers=[], allow_rules=None, cfg=None, aspects=[])

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

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

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

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

パラメータ

パラメータ 説明
default Label; or string; or LateBoundDefault; or NativeComputedDefault; or function; or None、 デフォルト = None
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。文字列または Label 関数を使用してデフォルト値を指定します(例: attr.label(default = "//a:b"))。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。
executable デフォルト = False
依存関係を実行可能にする必要がある場合は true に設定します。つまり、実行可能なファイル、または実行可能ファイルを出力するルールを参照している必要があります。ctx.executable.<attribute_name> でラベルにアクセスします。
allow_files bool; or sequence of strings; or None、 デフォルト = None
File ターゲットを許可するかどうか。TrueFalse(デフォルト)、または許可されているファイル拡張子のリスト(例: [".cc", ".cpp"])を指定できます。
allow_single_file デフォルト = None
これは allow_files と似ていますが、ラベルは単一の File に対応している必要があります。ctx.file.<attribute_name> からアクセスしてください。
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。
providers デフォルト = []
この属性に含まれる依存関係によって指定する必要があるプロバイダ。

この引数の形式はプロバイダのリストです。provider() から返される *Info オブジェクトです(以前のプロバイダの場合は文字列名)。依存関係は、内部リストの少なくとも 1 つに言及されているすべてのプロバイダを返す必要があります。便宜上、この引数はプロバイダの単一レベルのリストにすることもできます。その場合、1 つの要素を含む外側のリストにラップされます。

allow_rules sequence of strings; or None、 デフォルト = None
許可されるルール ターゲット(クラスの名前)これは非推奨です(互換性確保のためだけに維持されます)。代わりにプロバイダを使用してください。
cfg デフォルト = None
属性の Configuration"exec"(依存関係が execution platform 用にビルドされたことを示す)または "target"(依存関係が target platform 用にビルドされたことを示す)のいずれかになります。この違いの一般的な例としては、モバイルアプリをビルドする場合が挙げられます。この場合、target platformAndroid または iOS で、execution platformLinuxmacOS、または Windows です。executable が True の場合、ターゲット構成でホストツールが誤ってビルドされないように、このパラメータは必須です。"target" には意味的効果がないため、意図を明確にするのに役立つ場合を除き、executable が False の場合に設定しないでください。
aspects sequence of Aspects、 デフォルト = []
この属性で指定された依存関係に適用する必要があるアスペクト。

label_keyed_string_dict

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

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

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

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

パラメータ

パラメータ 説明
allow_empty デフォルト = True
属性を空にできる場合は true。
default dict; or function、 default = {}
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。文字列または Label 関数を使用してデフォルト値を指定します(例: attr.label_keyed_string_dict(default = {"//a:b": "value", "//a:c": "string"}))。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。
allow_files bool; or sequence of strings; or None、 デフォルト = None
File ターゲットを許可するかどうか。TrueFalse(デフォルト)、または許可されているファイル拡張子のリスト(例: [".cc", ".cpp"])を指定できます。
allow_rules sequence of strings; or None、 デフォルト = None
許可されるルール ターゲット(クラスの名前)これは非推奨です(互換性確保のためだけに維持されます)。代わりにプロバイダを使用してください。
providers デフォルト = []
この属性に含まれる依存関係によって指定する必要があるプロバイダ。

この引数の形式はプロバイダのリストです。provider() から返される *Info オブジェクトです(以前のプロバイダの場合は文字列名)。依存関係は、内部リストの少なくとも 1 つに言及されているすべてのプロバイダを返す必要があります。便宜上、この引数はプロバイダの単一レベルのリストにすることもできます。その場合、1 つの要素を含む外側のリストにラップされます。

flags sequence of strings、 デフォルト = []
非推奨により削除されます。
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。
cfg デフォルト = None
属性の Configuration"exec"(依存関係が execution platform 用にビルドされたことを示す)または "target"(依存関係が target platform 用にビルドされたことを示す)のいずれかになります。この違いの一般的な例としては、モバイルアプリをビルドする場合が挙げられます。この場合、target platformAndroid または iOS で、execution platformLinuxmacOS、または Windows です。
aspects sequence of Aspects、 デフォルト = []
この属性で指定された依存関係に適用する必要があるアスペクト。

label_list

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

list-of-labels 属性のスキーマを作成します。これは依存関係属性です。

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

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

パラメータ

パラメータ 説明
allow_empty デフォルト = True
属性を空にできる場合は true。
default sequence of Labels; or function、 デフォルト = []
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。文字列または Label 関数を使用してデフォルト値を指定します(例: attr.label_list(default = ["//a:b", "//a:c"]))。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。
allow_files bool; or sequence of strings; or None、 デフォルト = None
File ターゲットを許可するかどうか。TrueFalse(デフォルト)、または許可されているファイル拡張子のリスト(例: [".cc", ".cpp"])を指定できます。
allow_rules sequence of strings; or None、 デフォルト = None
許可されるルール ターゲット(クラスの名前)これは非推奨です(互換性確保のためだけに維持されます)。代わりにプロバイダを使用してください。
providers デフォルト = []
この属性に含まれる依存関係によって指定する必要があるプロバイダ。

この引数の形式はプロバイダのリストです。provider() から返される *Info オブジェクトです(以前のプロバイダの場合は文字列名)。依存関係は、内部リストの少なくとも 1 つに言及されているすべてのプロバイダを返す必要があります。便宜上、この引数はプロバイダの単一レベルのリストにすることもできます。その場合、1 つの要素を含む外側のリストにラップされます。

flags sequence of strings、 デフォルト = []
非推奨により削除されます。
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。
cfg デフォルト = None
属性の Configuration"exec"(依存関係が execution platform 用にビルドされたことを示す)または "target"(依存関係が target platform 用にビルドされたことを示す)のいずれかになります。この違いの一般的な例としては、モバイルアプリをビルドする場合が挙げられます。この場合、target platformAndroid または iOS で、execution platformLinuxmacOS、または Windows です。
aspects sequence of Aspects、 デフォルト = []
この属性で指定された依存関係に適用する必要があるアスペクト。

output

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

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

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

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

パラメータ

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

output_list

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

list-of-outputs 属性のスキーマを作成します。

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

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

パラメータ

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

文字列

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

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

パラメータ

パラメータ 説明
default string; or NativeComputedDefault、 デフォルト = ''
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。
values sequence of strings、 デフォルト = []
属性で許可される値のリスト。その他の値を指定すると、エラーが発生します。

string_dict

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

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

パラメータ

パラメータ 説明
allow_empty デフォルト = True
属性を空にできる場合は true。
default default = {}
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。

string_list

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

list-of-strings 属性のスキーマを作成します。

パラメータ

パラメータ 説明
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。
allow_empty デフォルト = True
属性を空にできる場合は true。
default sequence of strings; or NativeComputedDefault、 デフォルト = []
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。

string_list_dict

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

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

パラメータ

パラメータ 説明
allow_empty デフォルト = True
属性を空にできる場合は true。
default default = {}
ルールをインスタンス化する際に、この属性に値が指定されていない場合に使用するデフォルト値。
doc デフォルト = ''
ドキュメント生成ツールで抽出できる属性の説明。
mandatory デフォルト = False
true の場合、値は(default がある場合でも)明示的に指定する必要があります。