config

これは、構成の移行とビルド設定記述子を作成するための最上位モジュールです。ビルド設定記述子は、ルールがどのようなビルド設定であるかを記述します(ビルド設定がない場合もあります)。

例: 次のルールは、build_setting パラメータを設定することで、rule() 関数のビルド設定としてマークされます。具体的には、int タイプのビルド設定であり、flag であるため、このビルド設定はコマンドラインで呼び出すことができます。

  my_rule = rule(
    implementation = _impl,
    build_setting = config.int(flag = True),
    ...
  )

メンバー

ブール値

BuildSetting config.bool(flag=False)

ブール値型のビルド設定

パラメータ

パラメータ 説明
flag ブール値。 デフォルトは False
このビルド設定をコマンドラインで呼び出すことができるかどうか。

exec

ExecTransitionFactory config.exec(exec_group=None)

実行の移行を作成します。

パラメータ

パラメータ 説明
exec_group 文字列または None。 デフォルトは None
この移行で使用する実行プラットフォームの実行グループの名前。指定しない場合、この実行移行ではターゲットのデフォルトの実行プラットフォームが使用されます。

int

BuildSetting config.int(flag=False)

整数型のビルド設定

パラメータ

パラメータ 説明
flag ブール値。 デフォルトは False
このビルド設定をコマンドラインで呼び出すことができるかどうか。

なし

transition config.none()

すべての構成を削除し、すべてのフラグの設定を解除する移行を作成します。依存関係がデータのみで、ビルドする必要があるコードが含まれていないが、一度だけ分析する必要がある場合に使用します。

文字列

BuildSetting config.string(flag=False, allow_multiple=False)

文字列型のビルド設定

パラメータ

パラメータ 説明
flag ブール値。 デフォルトは False
このビルド設定をコマンドラインで呼び出すことができるかどうか。
allow_multiple ブール値。 デフォルトは False
非推奨です。代わりに string_list設定を使用してください。repeatable = True設定すると、このフラグをコマンドラインで複数回設定できます。移行とビルド設定実装関数でアクセスされるフラグの値は、文字列のリストになります。挿入順と重複する値はどちらも保持されます。異なる動作が必要な場合は、ビルド設定実装関数でこのリストを後処理できます。

string_list

BuildSetting config.string_list(flag=False, repeatable=False)

文字列リスト型のビルド設定。コマンドラインで、--//my/setting=foo,bar のようにカンマ区切りの値を使用してリストを渡します。

パラメータ

パラメータ 説明
flag ブール値。 デフォルトは False
このビルド設定をコマンドラインで呼び出すことができるかどうか。
repeatable ブール値。 デフォルトは False
設定すると、カンマ区切りの値が想定されるのではなく、このフラグをコマンドラインで複数回設定できます。各個別の値は、リスト値に追加する単一の文字列として扱われます。挿入順と重複する値はどちらも保持されます。異なる動作が必要な場合は、ビルド設定実装関数でこのリストを後処理できます。

ターゲット

transition config.target()

ターゲットの移行を作成します。これは、移行オブジェクトが必要だが、実際には何も変更したくない場合に使用する no-op 移行です。attr.label()cfg = "target" と同じです。