移行

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.7

依存関係エッジ間の構成の移行を表します。たとえば、//package:foo が構成の移行で //package:bar に依存している場合、これら 2 つのターゲットの構成は異なります。//package:bar の移行は、移行オブジェクトで定義された関数に従って //package:foo の移行によって決定されます。

メンバー

transition

transition transition(implementation, inputs, outputs)

一連の入力ビルド設定を読み取り、一連の出力ビルド設定を書き込むトランジション。

例:

def _transition_impl(settings, attr):
    # This transition just reads the current CPU value as a demonstration.
    # A real transition could incorporate this into its followup logic.
    current_cpu = settings["//command_line_option:cpu"]
    return {"//command_line_option:compilation_mode": "dbg"}

build_in_debug_mode = transition(
    implementation = _transition_impl,
    inputs = ["//command_line_option:cpu"],
    outputs = ["//command_line_option:compilation_mode"],
)

詳しくはこちらをご覧ください。

パラメータ

パラメータ 説明
implementation required
この移行を実装する関数。この関数には、常に settings と attr の 2 つのパラメータがあります。settings パラメータは、キーのセットが inputs パラメータで定義される辞書です。したがって、各ビルド設定 --//foo=bar について、inputs に //foo が含まれている場合、settings にはエントリ settings['//foo']='bar' が含まれます。

attr パラメータは ctx.attr への参照です。これにより、実装関数はルールの属性にアクセスして、属性パラメータ化された遷移を行うことができます。

この関数は、ビルド設定 ID からビルド設定値への dict を返す必要があります。これは構成の移行を表します。返された dict の各エントリについて、移行はその設定を新しい値に更新します。その他の設定は変更されません。分割遷移の場合、この関数は dict の list または dict の dict を返すこともできます。
inputs string の sequence。必須
この遷移で読み取ることができるビルド設定のリスト。これは、実装関数パラメータの設定パラメータのキーセットになります。
outputs 文字列のシーケンス。必須
このトランジションで書き込むことができるビルド設定のリスト。これは、このトランジションによって返される辞書のキーセットのスーパーセットである必要があります。