これは、構成遷移とビルド設定記述子を作成するための最上位モジュールです。この記述子は、ルールがどのようなビルド設定であるか（存在する場合）を記述します。
例: 次のルールは、rule() 関数の build_setting パラメータを設定することで、ビルド設定としてマークされます。具体的には、int タイプのビルド設定であり、flag です。つまり、このビルド設定はコマンドラインで呼び出すことができます。
my_rule = rule(
implementation = _impl,
build_setting = config.int(flag = True),
...
)
メンバー
ブール値
BuildSetting config.bool(flag=False)ブール型のビルド設定
パラメータ
| パラメータ | 説明 |
|---|---|
flag
|
bool;
デフォルトは Falseこのビルド設定をコマンドラインで呼び出せるかどうか。 |
exec
ExecTransitionFactory config.exec(exec_group=None)実行遷移を作成します。
パラメータ
| パラメータ | 説明 |
|---|---|
exec_group
|
文字列、または None。デフォルトは None。この遷移で使用する実行プラットフォームの exec グループの名前。指定しない場合、この exec 遷移ではターゲットのデフォルトの実行プラットフォームが使用されます。 |
int
BuildSetting config.int(flag=False)整数型のビルド設定
パラメータ
| パラメータ | 説明 |
|---|---|
flag
|
bool;
デフォルトは Falseこのビルド設定をコマンドラインで呼び出せるかどうか。 |
なし
transition config.none()すべての構成を削除し、すべてのフラグを設定解除する遷移を作成します。依存関係がデータのみで、ビルドが必要なコードが含まれておらず、1 回だけ分析する必要がある場合に使用します。
文字列
BuildSetting config.string(flag=False, allow_multiple=False)文字列型のビルド設定
パラメータ
| パラメータ | 説明 |
|---|---|
flag
|
bool;
デフォルトは Falseこのビルド設定をコマンドラインで呼び出せるかどうか。 |
allow_multiple
|
bool;
デフォルトは False非推奨。代わりに repeatable = True で string_list 設定を使用してください。このフラグを設定する場合は、コマンドラインで複数回設定できます。遷移とビルド設定の実装関数でアクセスされるフラグの値は、文字列のリストになります。広告掲載オーダーと重複する値はどちらも保持されます。異なる動作が必要な場合は、このリストをビルド設定の実装関数で後処理できます。
|
string_list
BuildSetting config.string_list(flag=False, repeatable=False)文字列リスト型のビルド設定。コマンドラインでは、
--//my/setting=foo,bar のようにカンマ区切りの値を使用してリストを渡します。
パラメータ
| パラメータ | 説明 |
|---|---|
flag
|
bool;
デフォルトは Falseこのビルド設定をコマンドラインで呼び出せるかどうか。 |
repeatable
|
bool。デフォルトは False。設定すると、カンマ区切りの値ではなく、このフラグをコマンドラインで複数回設定できます。各値はリスト値に追加する単一の文字列として扱われます。広告掲載オーダーと重複する値はどちらも保持されます。異なる動作が必要な場合は、このリストをビルド設定の実装関数で後処理できます。 |
ターゲット
transition config.target()ターゲット遷移を作成します。これは、遷移オブジェクトが必要なものの、実際に何も変更しない場合に想定された、無効な遷移です。
attr.label() の cfg = "target" に相当します。