transition

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

Menunjukkan transisi konfigurasi di seluruh tepi dependensi. Misalnya, jika //package:foo bergantung pada //package:bar dengan transisi konfigurasi, maka konfigurasi kedua target ini akan berbeda: transisi //package:bar akan ditentukan oleh transisi //package:foo, sebagaimana tunduk pada fungsi yang ditentukan oleh objek transisi.

Anggota

transition

transition transition(implementation, inputs, outputs)

Transisi yang membaca serangkaian setelan build input dan menulis serangkaian setelan build output.

Contoh:

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"],
)

Untuk mengetahui detail selengkapnya, lihat di sini.

Parameter

Parameter Deskripsi
implementation callable; required
Fungsi yang menerapkan transisi ini. Fungsi ini selalu memiliki dua parameter: settings dan attr. Parameter settings adalah kamus yang set kunci-nya ditentukan oleh parameter input. Jadi, untuk setiap setelan build --//foo=bar, jika inputs berisi //foo, settings akan memiliki entri settings['//foo']='bar'.

Parameter attr adalah referensi ke ctx.attr. Hal ini memberi fungsi penerapan akses ke atribut aturan untuk memungkinkan transisi yang diparameterkan atribut.

Fungsi ini harus menampilkan dict dari ID setelan build ke nilai setelan build; ini merepresentasikan transisi konfigurasi: untuk setiap entri dalam dict yang ditampilkan, transisi memperbarui setelan tersebut ke nilai baru. Semua setelan lainnya tidak berubah. Fungsi ini juga dapat menampilkan list dari dict atau dict dari dict dalam kasus transisi terpisah.

inputs sequence dari string; required
Daftar setelan build yang dapat dibaca oleh transisi ini. Ini menjadi set kunci parameter setelan dari parameter fungsi penerapan.
outputs sequence dari string; required
Daftar setelan build yang dapat ditulis oleh transisi ini. Ini harus berupa superset dari set kunci kamus yang ditampilkan oleh transisi ini.