อาร์กส์

ออบเจ็กต์ที่ห่อหุ้มข้อมูลด้วยวิธีที่ประหยัดหน่วยความจำเพื่อสร้างบรรทัดคำสั่งบางส่วนหรือทั้งหมด

บ่อยครั้งที่การดำเนินการต้องใช้บรรทัดคำสั่งขนาดใหญ่ซึ่งมีค่าที่สะสมจากทรัพยากร Dependency แบบทรานซิทีฟ เช่น บรรทัดคำสั่งของโปรแกรมลิงก์อาจแสดงไฟล์ออบเจ็กต์ทุกไฟล์ที่จุลสารทั้งหมดที่ลิงก์ไว้ต้องใช้ คุณควรจัดเก็บข้อมูลทรานซิชันดังกล่าวไว้ใน depset เพื่อให้แชร์โดยหลายเป้าหมายได้ อย่างไรก็ตาม หากผู้เขียนกฎต้องแปลง Depset เหล่านี้เป็นรายการสตริงเพื่อสร้างบรรทัดคำสั่งการดำเนินการ จะเอาชนะการเพิ่มประสิทธิภาพการแชร์หน่วยความจำนี้ได้

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

Args สร้างขึ้นโดยการเรียกใช้ ctx.actions.args() โดยสามารถส่งเป็นพารามิเตอร์ arguments ของ ctx.actions.run() หรือ ctx.actions.run_shell() การเปลี่ยนรูปแบบแต่ละรายการของออบเจ็กต์ Args จะเพิ่มค่าต่อท้ายบรรทัดคำสั่ง

ฟีเจอร์ map_each ให้คุณปรับแต่งวิธีเปลี่ยนรูปแบบรายการเป็นสตริงได้ หากคุณไม่ได้ระบุฟังก์ชัน map_each การแปลงมาตรฐานจะเป็นดังนี้

• ค่าที่เป็นสตริงอยู่แล้วจะยังคงเดิม
• ระบบจะเปลี่ยนออบเจ็กต์ File เป็นค่า File.path
• ออบเจ็กต์ Label จะเปลี่ยนเป็นการแสดงสตริงที่แปลงกลับไปเป็นออบเจ็กต์เดียวกันเมื่อแก้ไขในบริบทของที่เก็บหลัก หากเป็นไปได้ การแสดงสตริงจะใช้ชื่อที่ชัดเจนของที่เก็บแทนชื่อตามแบบฉบับของที่เก็บ ซึ่งทำให้การแสดงนี้เหมาะสำหรับใช้ในไฟล์ BUILD แม้ว่าเราจะไม่สามารถรับประกันรูปแบบที่แน่นอนของการแสดง แต่ตัวอย่างทั่วไปคือ //foo:bar, @repo//foo:bar และ @@canonical_name+//foo:bar.bzl
• ระบบจะเปลี่ยนประเภทอื่นๆ ทั้งหมดให้เป็นสตริงในลักษณะที่ไม่ได้ระบุ ด้วยเหตุนี้ คุณจึงควรหลีกเลี่ยงการส่งค่าที่ไม่ใช่สตริงหรือประเภท File ไปยัง add() และหากคุณส่งไปยัง add_all() หรือ add_joined() คุณควรระบุฟังก์ชัน map_each

เมื่อใช้การจัดรูปแบบสตริง (พารามิเตอร์ format, format_each และ format_joined ของเมธอด add*()) ระบบจะตีความเทมเพลตรูปแบบในลักษณะเดียวกับการแทนที่ % ในสตริง ยกเว้นว่าเทมเพลตต้องมีตัวยึดตําแหน่งการแทนที่เพียงรายการเดียวและต้องเป็นตัวยึดตําแหน่ง %s เปอร์เซ็นต์จริงอาจกำหนดเป็น %% ได้ ใช้การจัดรูปแบบหลังจากแปลงค่าเป็นสตริงตามวิธีข้างต้นแล้ว

เมธอด add*() แต่ละรายการมีรูปแบบอื่นที่ยอมรับพารามิเตอร์ตำแหน่งเพิ่มเติม ซึ่งเป็นสตริง "ชื่ออาร์กิวเมนต์" เพื่อแทรกไว้ก่อนอาร์กิวเมนต์ที่เหลือ สำหรับ add_all และ add_joined ระบบจะไม่เพิ่มสตริงอื่นๆ หากลำดับว่างเปล่า ตัวอย่างเช่น การใช้งานเดียวกันนี้อาจเพิ่ม --foo val1 val2 val3 --bar หรือเพียง --bar ลงในบรรทัดคำสั่ง โดยขึ้นอยู่กับว่าลำดับที่ระบุมี val1..val3 หรือว่างเปล่า

หากขนาดของบรรทัดคำสั่งยาวเกินขนาดสูงสุดที่ระบบอนุญาต ระบบจะแสดงอาร์กิวเมนต์ในไฟล์พารามิเตอร์ โปรดดูuse_param_file() และ set_param_file_format()

ตัวอย่าง: สมมติว่าเราต้องการสร้างบรรทัดคำสั่ง

--foo foo1.txt foo2.txt ... fooN.txt --bar bar1.txt,bar2.txt,...,barM.txt --baz

# foo_deps and bar_deps are depsets containing
# File objects for the foo and bar .txt files.
args = ctx.actions.args()
args.add_all("--foo", foo_deps)
args.add_joined("--bar", bar_deps, join_with=",")
args.add("--baz")
ctx.actions.run(
  ...
  arguments = [args],
  ...
)

สมาชิก

• เพิ่ม
• add_all
• add_joined
• set_param_file_format
• use_param_file

เพิ่ม

Args Args.add(arg_name_or_value, value=unbound, *, format=None)

พารามิเตอร์

add_all

Args Args.add_all(arg_name_or_values, values=unbound, *, map_each=None, format_each=None, before_each=None, omit_if_empty=True, uniquify=False, expand_directories=True, terminate_with=None, allow_closure=False)

การประมวลผลส่วนใหญ่เกิดขึ้นกับรายการอาร์กิวเมนต์ที่จะเพิ่มต่อท้ายตามขั้นตอนต่อไปนี้

1. รายการ File แต่ละรายการในไดเรกทอรีจะแทนที่ด้วย File ทั้งหมดที่อยู่ในไดเรกทอรีนั้นแบบซ้ำ
2. หากระบุ map_each ไว้ ระบบจะนำไปใช้กับแต่ละรายการ และรายการสตริงที่ได้จะเชื่อมโยงกันเพื่อสร้างรายการอาร์กิวเมนต์เริ่มต้น มิฉะนั้น รายการอาร์กิวเมนต์เริ่มต้นจะเป็นผลลัพธ์จากการใช้การเปลี่ยนรูปแบบมาตรฐานกับแต่ละรายการ
3. อาร์กิวเมนต์แต่ละรายการในรายการจะมีการจัดรูปแบบด้วย format_each (หากมี)
4. หาก uniquify เป็นจริง ระบบจะนำอาร์กิวเมนต์ที่ซ้ำกันออก รายการแรกคือรายการที่จะยังคงอยู่
5. หากระบุสตริง before_each ระบบจะแทรกสตริงดังกล่าวเป็นอาร์กิวเมนต์ใหม่ก่อนอาร์กิวเมนต์ที่มีอยู่แต่ละรายการในรายการ ซึ่งจะช่วยเพิ่มจำนวนอาร์กิวเมนต์ที่จะเพิ่มเข้ามาด้วยจุดนี้ได้อย่างมีประสิทธิภาพ
6. ยกเว้นในกรณีที่ลิสต์ว่างและ omit_if_empty เป็นจริง (ค่าเริ่มต้น) ระบบจะแทรกชื่ออาร์กิวเมนต์และ terminate_with เป็นอาร์กิวเมนต์แรกและสุดท้ายตามลำดับ หากระบุไว้

พารามิเตอร์

add_joined

Args Args.add_joined(arg_name_or_values, values=unbound, *, join_with, map_each=None, format_each=None, format_joined=None, omit_if_empty=True, uniquify=False, expand_directories=True, allow_closure=False)

การประมวลผลคล้ายกับ add_all() แต่รายการของอาร์กิวเมนต์ที่ได้มาจาก values จะรวมกันเป็นอาร์กิวเมนต์เดียวเสมือนเป็นด้วย join_with.join(...) จากนั้นจะจัดรูปแบบโดยใช้เทมเพลตสตริง format_joined ที่ระบุ ซึ่งต่างจาก add_all() ตรงที่ไม่มีพารามิเตอร์ before_each หรือ terminate_with เนื่องจากโดยทั่วไปแล้วพารามิเตอร์เหล่านี้ไม่มีประโยชน์เมื่อรวมรายการต่างๆ เข้าด้วยกันเป็นอาร์กิวเมนต์เดียว

หากไม่มีสตริงให้ผนวกในอาร์กิวเมนต์หลังจากการกรอง และ omit_if_empty เป็น True (ค่าเริ่มต้น) ก็จะไม่มีการประมวลผลใดๆ หรือหากไม่มีสตริงที่จะรวม แต่ omit_if_empty เป็นเท็จ สตริงที่รวมจะเป็นสตริงว่าง

พารามิเตอร์

set_param_file_format

Args Args.set_param_file_format(format)

พารามิเตอร์

use_param_file

Args Args.use_param_file(param_file_arg, *, use_always=False)

Bazel อาจเลือกที่จะละเว้นการเขียนไฟล์ params ลงในต้นไม้เอาต์พุตระหว่างการดำเนินการเพื่อประสิทธิภาพ หากคุณกำลังแก้ไขข้อบกพร่องของการดำเนินการและต้องการตรวจสอบไฟล์ param ให้ส่ง --materialize_param_files ไปยังบิลด์

พารามิเตอร์