ข้อมูลเริ่มต้น

รายงานปัญหา ดูแหล่งที่มา

ผู้ให้บริการที่ให้ข้อมูลทั่วไปเกี่ยวกับไฟล์โดยตรงและไฟล์ทางอ้อมของเป้าหมาย กฎทุกประเภทจะมีผู้ให้บริการนี้ แม้ว่าจะไม่แสดงอย่างชัดแจ้งจากฟังก์ชันการใช้งานของกฎก็ตาม อินสแตนซ์ของ DefaultInfo แต่ละรายการจะมีช่องต่อไปนี้
  • files
  • files_to_run
  • data_runfiles
  • default_runfiles
โปรดดูหน้ากฎเพื่อดูคำแนะนำเพิ่มเติมเกี่ยวกับวิธีใช้ผู้ให้บริการรายนี้

สมาชิก

DefaultInfo

DefaultInfo DefaultInfo(files=None, runfiles=None, data_runfiles=None, default_runfiles=None, executable=None)

ตัวสร้าง DefaultInfo

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
files depset หรือ None โดยค่าเริ่มต้นคือ None
ออบเจ็กต์ depset ของ File ที่แสดงถึงเอาต์พุตเริ่มต้นที่จะสร้างเมื่อมีการระบุเป้าหมายนี้ในบรรทัดคำสั่งแบบเบเซล โดยค่าเริ่มต้นจะเป็นเอาต์พุตที่ประกาศไว้ล่วงหน้าทั้งหมด
runfiles runfiles หรือ None ค่าเริ่มต้นคือ None
runfiles descriptor ซึ่งอธิบายไฟล์ที่เป้าหมายนี้ต้องการเมื่อเรียกใช้ (ผ่านคำสั่ง run หรือในฐานะทรัพยากร Dependency เครื่องมือ)
data_runfiles runfiles หรือ None ค่าเริ่มต้นคือ None

ขอแนะนําให้หลีกเลี่ยงการใช้พารามิเตอร์นี้ (ดู "ฟีเจอร์เรียกใช้ไฟล์เพื่อหลีกเลี่ยง")

Runfiles descriptor ที่อธิบายเกี่ยวกับ Runfiles เป้าหมายนี้จำเป็นต้องเรียกใช้เมื่อเป็นทรัพยากร Dependency ผ่านแอตทริบิวต์ data
default_runfiles runfiles หรือ None ค่าเริ่มต้นคือ None

ขอแนะนําให้หลีกเลี่ยงการใช้พารามิเตอร์นี้ (ดู "ฟีเจอร์เรียกใช้ไฟล์เพื่อหลีกเลี่ยง")

Runfiles descriptor ที่อธิบายเกี่ยวกับ Runfile ที่เป้าหมายนี้จำเป็นต้องเรียกใช้เมื่อเป็นทรัพยากร Dependency ผ่านแอตทริบิวต์อื่นๆ นอกเหนือจากแอตทริบิวต์ data
executable ไฟล์ หรือ None ค่าเริ่มต้นคือ None
หากมีการทำเครื่องหมายกฎนี้ executable หรือ test จะเป็นออบเจ็กต์ File ที่แสดงถึงไฟล์ที่ควรดำเนินการเพื่อเรียกใช้เป้าหมาย โดยค่าเริ่มต้น จะเป็นเอาต์พุตที่ประกาศไว้ล่วงหน้า ctx.outputs.executable

data_runfiles

runfiles DefaultInfo.data_runfiles

Runfiles descriptor ซึ่งอธิบายไฟล์ที่เป้าหมายนี้ต้องการเมื่อเรียกใช้ในเงื่อนไขที่ว่าเป็นแอตทริบิวต์ทรัพยากร Dependency data ในสถานการณ์ส่วนใหญ่ ให้ใช้พารามิเตอร์ default_runfiles แทน ดูรายละเอียดใน "ฟีเจอร์ Runfiles ที่ควรหลีกเลี่ยง" อาจส่งคืน None

default_runfiles

runfiles DefaultInfo.default_runfiles

Runfiles descriptor ซึ่งอธิบายไฟล์ที่เป้าหมายนี้ต้องการเมื่อเรียกใช้ (ผ่านคำสั่ง run หรือในรูปแบบทรัพยากร Dependency ของเครื่องมือ) อาจส่งคืน None

files

depset DefaultInfo.files

ออบเจ็กต์ depset จาก File รายการที่แสดงถึงเอาต์พุตเริ่มต้นที่จะสร้างเมื่อมีการระบุเป้าหมายนี้ในบรรทัดคำสั่ง Bay โดยค่าเริ่มต้นจะเป็นเอาต์พุตที่ประกาศไว้ล่วงหน้าทั้งหมด อาจส่งคืน None

files_to_run

FilesToRunProvider DefaultInfo.files_to_run

ออบเจ็กต์ FilesToRunProvider ที่มีข้อมูลเกี่ยวกับไฟล์ปฏิบัติการและ Runfile ของเป้าหมาย อาจส่งคืน None

to_json

string DefaultInfo.to_json()

เลิกใช้งานแล้ว API นี้เลิกใช้งานแล้วและจะถูกนำออกเร็วๆ นี้ โปรดอย่าพึ่งพาสิ่งนี้ ถูกปิดใช้กับ ---incompatible_struct_has_no_methods ใช้แฟล็กนี้เพื่อยืนยันว่าโค้ดเข้ากันได้กับการนําออกที่กำลังจะเกิดขึ้น
สร้างสตริง JSON จากพารามิเตอร์ Struct เมธอดนี้จะใช้งานได้ก็ต่อเมื่อองค์ประกอบ Struct ทั้งหมด (แสดงซ้ำๆ) เป็นสตริง, ints, บูลีน, Struct อื่นๆ รายการประเภทเหล่านี้ หรือพจนานุกรมที่มีคีย์สตริงและค่าประเภทดังกล่าว เครื่องหมายคำพูดและบรรทัดใหม่ในสตริงจะใช้อักขระหลีก ตัวอย่าง:
struct(key=123).to_json()
# {"key":123}

struct(key=True).to_json()
# {"key":true}

struct(key=[1, 2, 3]).to_json()
# {"key":[1,2,3]}

struct(key='text').to_json()
# {"key":"text"}

struct(key=struct(inner_key='text')).to_json()
# {"key":{"inner_key":"text"}}

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json()
# {"key":[{"inner_key":1},{"inner_key":2}]}

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json()
# {"key":{"inner_key":{"inner_inner_key":"text"}}}

เลิกใช้งาน: ใช้ json.encode(x) หรือ json.encode_indent(x) แทน ซึ่งใช้ได้กับค่าอื่นๆ ที่ไม่ใช่ Struct และไม่ทำให้เนมสเปซของช่อง Struct เสียหาย

to_proto

string DefaultInfo.to_proto()

เลิกใช้งานแล้ว API นี้เลิกใช้งานแล้วและจะถูกนำออกเร็วๆ นี้ โปรดอย่าพึ่งพาสิ่งนี้ ถูกปิดใช้กับ ---incompatible_struct_has_no_methods ใช้แฟล็กนี้เพื่อยืนยันว่าโค้ดเข้ากันได้กับการนําออกที่กำลังจะเกิดขึ้น
สร้าง SMS จากพารามิเตอร์ Struct วิธีการนี้จะใช้งานได้ก็ต่อเมื่อองค์ประกอบ Struct ทั้งหมด (แบบเรียกซ้ำ) เป็นสตริง, ints, บูลีน, Struct หรือคำสั่งอื่นๆ หรือรายการประเภทเหล่านี้ เครื่องหมายคำพูดและบรรทัดใหม่ในสตริงจะใช้อักขระหลีก คีย์โครงสร้างจะทำซ้ำตามลำดับที่จัดเรียง ตัวอย่าง:
struct(key=123).to_proto()
# key: 123

struct(key=True).to_proto()
# key: true

struct(key=[1, 2, 3]).to_proto()
# key: 1
# key: 2
# key: 3

struct(key='text').to_proto()
# key: "text"

struct(key=struct(inner_key='text')).to_proto()
# key {
#   inner_key: "text"
# }

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto()
# key {
#   inner_key: 1
# }
# key {
#   inner_key: 2
# }

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto()
# key {
#    inner_key {
#     inner_inner_key: "text"
#   }
# }

struct(foo={4: 3, 2: 1}).to_proto()
# foo: {
#   key: 4
#   value: 3
# }
# foo: {
#   key: 2
#   value: 1
# }

เลิกใช้งาน: ใช้ proto.encode_text(x) แทน