การเปลี่ยน

Nightly · 9.2 · 9.1 · 9.0 · 8.7 · 8.6

แสดงการเปลี่ยนการกำหนดค่าในขอบการอ้างอิง เช่น หาก //package:foo ขึ้นอยู่กับ //package:bar ที่มีการเปลี่ยนการกำหนดค่า การกำหนดค่าของ //package:bar (และการขึ้นต่อกัน) จะเป็นการกำหนดค่าของ //package:foo บวกกับการเปลี่ยนแปลงที่ฟังก์ชันการเปลี่ยนระบุ

สมาชิก

การเปลี่ยนผ่าน

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 callable; required
ฟังก์ชันที่ใช้การเปลี่ยนสถานะนี้ ฟังก์ชันนี้มีพารามิเตอร์ 2 รายการเสมอ ได้แก่ settings และ attr settings param คือพจนานุกรมที่มีชุดคีย์ซึ่งกำหนดโดยพารามิเตอร์อินพุต ดังนั้น สำหรับการตั้งค่าบิลด์แต่ละรายการ --//foo=bar หาก inputs มี //foo settings จะมีรายการ settings['//foo']='bar'

พารามิเตอร์ attr คือการอ้างอิงถึง ctx.attr ซึ่งจะทำให้ฟังก์ชันการติดตั้งใช้งานเข้าถึงแอตทริบิวต์ของกฎได้เพื่อให้การเปลี่ยนผ่านที่กำหนดพารามิเตอร์แอตทริบิวต์เป็นไปได้

ฟังก์ชันนี้ต้องส่งคืน dict จากตัวระบุการตั้งค่าบิลด์ไปยังค่าการตั้งค่าบิลด์ ซึ่งแสดงถึงการเปลี่ยนการกำหนดค่า: สำหรับแต่ละรายการใน dict ที่ส่งคืน การเปลี่ยนจะอัปเดตการตั้งค่านั้นเป็นค่าใหม่ การตั้งค่าอื่นๆ ทั้งหมดจะไม่มีการเปลี่ยนแปลง ฟังก์ชันนี้ยังแสดงlistของdictหรือdictของdictในกรณีที่มีการเปลี่ยนฉากแบบแยกได้ด้วย

inputs ลำดับของสตริง ต้องระบุ
รายการการตั้งค่าการสร้างที่การเปลี่ยนนี้อ่านได้ ซึ่งจะกลายเป็นชุดคีย์ของพารามิเตอร์การตั้งค่าของพารามิเตอร์ฟังก์ชันการติดตั้งใช้งาน
outputs ลำดับของสตริง ต้องระบุ
รายการการตั้งค่าบิลด์ที่การเปลี่ยนผ่านนี้เขียนได้ ซึ่งต้องเป็นซูเปอร์เซ็ตของชุดคีย์ของพจนานุกรมที่การเปลี่ยนผ่านนี้ส่งคืน

and_then

transition transition.and_then(transition)

แสดงผลการเปลี่ยนฉากใหม่ที่ใช้การเปลี่ยนฉากนี้ตามด้วยการเปลี่ยนฉากที่ระบุ การเปลี่ยนฉากที่ 2 จะอ่านการตั้งค่าบิลด์ที่สร้างโดยการเปลี่ยนฉากนี้ ส่วนการเปลี่ยนฉากเดิมจะไม่มีการเปลี่ยนแปลง ผลลัพธ์คือการเปลี่ยนฉากและอาจประกอบกันต่อไป

คุณสามารถใช้การคอมโพสเป็นการเปลี่ยนกฎหรือแอตทริบิวต์ได้ทุกที่ที่ใช้การเปลี่ยนคอมโพเนนต์ได้ การเปลี่ยนฉากที่ประกอบขึ้นอาจกำหนดเป้าหมายการกำหนดค่า exec ได้อย่างมากที่สุด 1 รายการ (เช่น config.exec) เมื่อการเปลี่ยนฉาก 2 รายการในเชนแยกการกำหนดค่า ผลลัพธ์จะมีการครอสโปรดักต์ของการแยกเหล่านั้น คีย์สำหรับการแยกที่รวมกันแต่ละรายการคือการต่อกันของคีย์คอมโพเนนต์ที่คั่นด้วยคอมมา

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
transition การเปลี่ยนผ่าน ต้องระบุ
การเปลี่ยนผ่านที่จะใช้หลังจากนี้