Thông tin mặc định

Báo cáo sự cố Xem nguồn Hằng đêm · 7,3 · 7.2 · 7.1 · 7,0 · 6,5

Một nhà cung cấp cung cấp thông tin chung về các tệp trực tiếp và tệp bắc cầu của mục tiêu. Mọi loại quy tắc đều có trình cung cấp này, ngay cả khi chức năng triển khai của quy tắc không trả về một cách rõ ràng. Mỗi thực thể DefaultInfo có các trường sau:

  • files
  • files_to_run
  • data_runfiles
  • default_runfiles
Xem trang quy tắc để biết hướng dẫn mở rộng về cách sử dụng nhà cung cấp này.

Hội viên

DefaultInfo

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

Hàm khởi tạo DefaultInfo.

Tham số

Thông số Mô tả
files depset; hoặc None; giá trị mặc định là None
Một depset đối tượng File đại diện cho dữ liệu đầu ra mặc định cần tạo khi mục tiêu này được chỉ định trên dòng lệnh bazel. Theo mặc định, đó là mọi dữ liệu đầu ra được khai báo trước.
runfiles runfiles; hoặc None; giá trị mặc định là None
mô tả runfile mô tả các tệp mà mục tiêu này cần khi chạy (thông qua lệnh run hoặc dưới dạng phần phụ thuộc công cụ).
data_runfiles runfiles; hoặc None; giá trị mặc định là None

Bạn nên tránh sử dụng thông số này (xem bài viết "các tính năng cần tránh của runfile")

mô tả runfile mô tả các runfile mà mục tiêu này cần chạy khi nó là một phần phụ thuộc thông qua thuộc tính data.
default_runfiles runfiles; hoặc None; giá trị mặc định là None

Bạn nên tránh sử dụng thông số này (xem bài viết "các tính năng cần tránh của runfile")

chỉ số mô tả runfile mô tả các runfile mà mục tiêu này cần chạy khi nó là một phần phụ thuộc thông qua bất kỳ thuộc tính nào khác ngoài thuộc tính data.
executable Tệp; hoặc None; giá trị mặc định là None
Nếu quy tắc này được đánh dấu là executable hoặc test, thì đây là đối tượng File đại diện cho tệp cần được thực thi để chạy mục tiêu. Theo mặc định, đó là dữ liệu đầu ra được khai báo trước ctx.outputs.executable.

data_runfiles

runfiles DefaultInfo.data_runfiles

mô tả runfiles mô tả các tệp mà mục tiêu này cần khi chạy trong điều kiện đó là thuộc tính phần phụ thuộc data. Trong hầu hết các trường hợp, hãy sử dụng tham số default_runfiles. Xem bài viết "các tính năng cần tránh của runfile" để biết thông tin chi tiết. Có thể trả về None.

default_runfiles

runfiles DefaultInfo.default_runfiles

mô tả runfile mô tả các tệp mà mục tiêu này cần khi chạy (thông qua lệnh run hoặc dưới dạng phần phụ thuộc công cụ). Có thể trả về None.

tệp

depset DefaultInfo.files

Một depset của đối tượng File đại diện cho dữ liệu đầu ra mặc định để tạo khi mục tiêu này được chỉ định trên dòng lệnh bazel. Theo mặc định, đó là mọi dữ liệu đầu ra được khai báo trước. Có thể trả về None.

files_to_run

FilesToRunProvider DefaultInfo.files_to_run

Đối tượng FilesToRunProvider chứa thông tin về tệp thực thi và các tệp chạy của mục tiêu. Có thể trả về None.

to_json

string DefaultInfo.to_json()

Không dùng nữa. API này không được dùng nữa và sẽ sớm bị xoá. Vui lòng đừng phụ thuộc vào tính năng này. Tính năng này đã bị tắt với ---incompatible_struct_has_no_methods. Sử dụng cờ này để xác minh rằng mã của bạn tương thích với yêu cầu sắp xoá.
Tạo một chuỗi JSON từ tham số cấu trúc. Phương thức này chỉ hiệu quả nếu tất cả các phần tử cấu trúc (theo đệ quy) là chuỗi, số nguyên, boolean, cấu trúc khác, danh sách các loại này hoặc từ điển có khoá chuỗi và giá trị thuộc các kiểu này. Các dấu ngoặc kép và các dòng mới trong chuỗi là ký tự thoát. Ví dụ:
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"}}}
.

Không dùng nữa: thay vào đó, hãy sử dụng json.encode(x) hoặc json.encode_indent(x). Tệp này phù hợp với các giá trị không phải cấu trúc và không gây ô nhiễm không gian tên của trường cấu trúc.

to_proto

string DefaultInfo.to_proto()

Không dùng nữa. API này không được dùng nữa và sẽ sớm bị xoá. Vui lòng đừng phụ thuộc vào tính năng này. Tính năng này đã bị tắt với ---incompatible_struct_has_no_methods. Sử dụng cờ này để xác minh rằng mã của bạn tương thích với yêu cầu sắp xoá.
Tạo một tin nhắn văn bản từ tham số cấu trúc. Phương thức này chỉ hoạt động nếu tất cả các phần tử cấu trúc (theo đệ quy) là chuỗi, int, boolean, các cấu trúc khác, lệnh chính tả hoặc danh sách thuộc các loại này. Các dấu ngoặc kép và các dòng mới trong chuỗi là ký tự thoát. Khoá cấu trúc được lặp lại theo thứ tự được sắp xếp. Ví dụ:
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
# }

Không dùng nữa: thay vào đó hãy sử dụng proto.encode_text(x).