การกำหนดค่า

นี่คือโมดูลระดับบนสุดสำหรับการสร้างการเปลี่ยนการกำหนดค่าและตัวอธิบายการตั้งค่าบิลด์ ซึ่งอธิบายว่ากฎเป็นการตั้งค่าบิลด์ประเภทใด (หากมี)

เช่น กฎต่อไปนี้ถูกทำเครื่องหมายเป็นการตั้งค่าบิลด์โดยการตั้งค่าพารามิเตอร์ 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
ระบุว่าการตั้งค่าบิลด์นี้เรียกใช้ได้ในบรรทัดคำสั่งหรือไม่

สตริง

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
หากตั้งค่าไว้ ระบบจะอนุญาตให้ตั้งค่าแฟล็กนี้หลายครั้งในบรรทัดคำสั่ง โดยจะถือว่าค่าแต่ละค่าเป็นสตริงเดียวเพื่อเพิ่มลงในค่ารายการ แทนที่จะคาดหวังค่าที่คั่นด้วยคอมมา ระบบจะเก็บรักษาทั้งลำดับการแทรกและค่าที่ซ้ำกัน คุณสามารถประมวลผลรายการนี้ในฟังก์ชันการใช้งานการตั้งค่าบิลด์ได้หากต้องการลักษณะการทำงานที่แตกต่างออกไป