การกำหนดค่า

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

เช่น ทำเครื่องหมายกฎต่อไปนี้เป็นการตั้งค่าบิลด์โดยการตั้งค่าพารามิเตอร์ build_setting ของฟังก์ชัน rule() กล่าวอย่างเจาะจงคือ เป็นการตั้งค่าบิลด์ประเภท int และเป็น flag ซึ่งหมายความว่าการตั้งค่าบิลด์นี้เรียกใช้ได้ในบรรทัดคำสั่ง

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

สมาชิก

bool

BuildSetting config.bool(flag=False)

การตั้งค่าบิลด์ที่ประเภทบูลีน

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
flag default = False
เรียกการตั้งค่าของบิลด์นี้ในบรรทัดคำสั่งได้หรือไม่

exec

ExecTransitionFactory config.exec(exec_group=None)

สร้างการเปลี่ยนการดำเนินการ

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
exec_group string; or None; ค่าเริ่มต้น = ไม่มี
ชื่อกลุ่มการดำเนินการที่จะใช้แพลตฟอร์มการดำเนินการของการเปลี่ยนนี้ หากไม่ระบุ การเปลี่ยนการดำเนินการนี้จะใช้แพลตฟอร์มการดำเนินการเริ่มต้นของเป้าหมาย

int

BuildSetting config.int(flag=False)

การตั้งค่าบิลด์ที่พิมพ์เป็นจำนวนเต็ม

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
flag default = False
เรียกการตั้งค่าของบิลด์นี้ในบรรทัดคำสั่งได้หรือไม่

สตริง

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

การตั้งค่าบิลด์ที่พิมพ์ด้วยสตริง

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
flag default = False
เรียกการตั้งค่าของบิลด์นี้ในบรรทัดคำสั่งได้หรือไม่
allow_multiple default = False
เลิกใช้งานแล้ว ให้ใช้การตั้งค่า string_list กับ repeatable = True แทน หากตั้งค่าไว้ ระบบจะอนุญาตให้ใช้แฟล็กนี้หลายครั้งในบรรทัดคำสั่ง ค่าของแฟล็กที่มีการเข้าถึงในการเปลี่ยนแปลงและฟังก์ชันการใช้งานการตั้งค่าบิลด์จะเป็นรายการสตริง จะรักษาทั้งใบสั่งซื้อการใส่โฆษณาและค่าที่ซ้ำกัน รายการนี้สามารถประมวลผลภายหลังได้ในฟังก์ชันการใช้งานการตั้งค่าบิลด์ หากต้องการลักษณะการทำงานแบบอื่น

string_list

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

การตั้งค่าบิลด์ที่พิมพ์ด้วยรายการสตริง ในบรรทัดคำสั่ง ให้ส่งรายการโดยใช้ค่าที่คั่นด้วยคอมมา เช่น "--//my/setting=foo,bar"

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
flag default = False
เรียกการตั้งค่าของบิลด์นี้ในบรรทัดคำสั่งได้หรือไม่
repeatable ค่าเริ่มต้น = เท็จ
หากตั้งค่าไว้ แทนที่จะใช้ค่าที่คั่นด้วยคอมมา ระบบจะอนุญาตให้ผู้ใช้ตั้งค่าแฟล็กนี้หลายครั้งในบรรทัดคำสั่งโดยให้แต่ละค่าเป็นสตริงเดียวสำหรับเพิ่มลงในค่ารายการ จะรักษาทั้งใบสั่งซื้อการใส่โฆษณาและค่าที่ซ้ำกัน รายการนี้สามารถประมวลผลภายหลังได้ในฟังก์ชันการใช้งานการตั้งค่าบิลด์ หากต้องการลักษณะการทำงานแบบอื่น