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

รายงานปัญหา ดูแหล่งที่มา Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

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

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

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

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

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

data_runfiles

runfiles DefaultInfo.data_runfiles

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

default_runfiles

runfiles DefaultInfo.default_runfiles

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