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

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

ผู้ให้บริการที่ให้ข้อมูลทั่วไปเกี่ยวกับไฟล์โดยตรงและไฟล์สื่อกลางของเป้าหมาย กฎทุกประเภทจะมีผู้ให้บริการนี้ แม้ว่าฟังก์ชันการใช้งานของกฎจะไม่แสดงผลอย่างชัดแจ้งก็ตาม อินสแตนซ์ 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 ที่แสดงถึงเอาต์พุตเริ่มต้นที่จะสร้างเมื่อระบุเป้าหมายนี้ในบรรทัดคำสั่งของ Bazel โดยค่าเริ่มต้นจะเป็นเอาต์พุตที่ประกาศไว้ล่วงหน้าทั้งหมด
runfiles runfiles หรือ None ค่าเริ่มต้นคือ None
ตัวบ่งชี้ runfiles ที่อธิบายไฟล์ที่เป้าหมายนี้ต้องใช้เมื่อเรียกใช้ (ผ่านคำสั่ง run หรือเป็นเครื่องมือที่ต้องพึ่งพา)
data_runfiles runfiles หรือ None ค่าเริ่มต้นคือ None

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

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

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

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

data_runfiles

runfiles DefaultInfo.data_runfiles

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

default_runfiles

runfiles DefaultInfo.default_runfiles

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

ไฟล์

depset DefaultInfo.files

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

files_to_run

FilesToRunProvider DefaultInfo.files_to_run

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

to_json

string DefaultInfo.to_json()

เลิกใช้งาน API นี้เลิกใช้งานแล้วและจะถูกนำออกเร็วๆ นี้ โปรดอย่าใช้ข้อมูลนี้ ปิดใช้กับ ---incompatible_struct_has_no_methods ใช้ Flag นี้เพื่อยืนยันว่าโค้ดของคุณเข้ากันได้กับการนําออกที่กําลังจะเกิดขึ้น
สร้างสตริง JSON จากพารามิเตอร์ Struct วิธีนี้ใช้ได้เฉพาะในกรณีที่องค์ประกอบ Struct ทั้งหมด (แบบเรียกซ้ำ) เป็นสตริง int บูลีน 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) แทน ซึ่งใช้ได้กับค่าอื่นๆ นอกเหนือจากโครงสร้างและไม่ทำให้เนมสเปซของช่องโครงสร้างรก

to_proto

string DefaultInfo.to_proto()

เลิกใช้งาน เลิกใช้งาน API นี้แล้ว และจะนำออกเร็วๆ นี้ โปรดอย่าใช้ข้อมูลนี้ ปิดใช้กับ ---incompatible_struct_has_no_methods ใช้ Flag นี้เพื่อยืนยันว่าโค้ดของคุณเข้ากันได้กับการนําออกที่กําลังจะเกิดขึ้น
สร้าง SMS จากพารามิเตอร์ Struct วิธีการนี้จะใช้งานได้ก็ต่อเมื่อองค์ประกอบ Struct ทั้งหมด (แบบเรียกซ้ำ) เป็นสตริง, int, บูลีน, Struct หรือ Dict อื่นๆ หรือลิสต์ประเภทเหล่านี้ ระบบจะหลีกหนีเครื่องหมายคำพูดและบรรทัดใหม่ในสตริง คีย์โครงสร้างจะทำซ้ำตามลำดับที่จัดเรียง ตัวอย่าง:
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) แทน