Đây là mô-đun cấp cao nhất để tạo các chuyển đổi cấu hình và mô tả chế độ cài đặt bản dựng, mô tả loại chế độ cài đặt bản dựng (nếu có) của một quy tắc.
ví dụ: quy tắc sau được đánh dấu là chế độ cài đặt bản dựng bằng cách đặt tham số build_setting của hàm rule(). Cụ thể, đây là một chế độ cài đặt bản dựng thuộc loại int và là flag, có nghĩa là chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh.
my_rule = rule(
implementation = _impl,
build_setting = config.int(flag = True),
...
)
Hội viên
bool
BuildSetting config.bool(flag=False)Chế độ cài đặt bản dựng kiểu bool
Tham số
| Thông số | Mô tả |
|---|---|
flag
|
bool;
mặc định là FalseLiệu chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không. |
exec
ExecTransitionFactory config.exec(exec_group=None)Tạo một quá trình chuyển đổi thực thi.
Tham số
| Thông số | Mô tả |
|---|---|
exec_group
|
string; hoặc None;
mặc định là NoneTên của nhóm thực thi có nền tảng thực thi mà quá trình chuyển đổi này sẽ sử dụng. Nếu không được cung cấp, quá trình chuyển đổi thực thi này sẽ sử dụng nền tảng thực thi mặc định của mục tiêu. |
int
BuildSetting config.int(flag=False)Chế độ cài đặt bản dựng kiểu số nguyên
Tham số
| Thông số | Mô tả |
|---|---|
flag
|
bool;
mặc định là FalseLiệu chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không. |
không có
transition config.none()Tạo một quá trình chuyển đổi xoá tất cả cấu hình, huỷ đặt tất cả cờ. Dành cho trường hợp phần phụ thuộc chỉ chứa dữ liệu và không chứa mã cần tạo, nhưng chỉ được phân tích một lần.
chuỗi
BuildSetting config.string(flag=False, allow_multiple=False)Chế độ cài đặt bản dựng có kiểu chuỗi
Tham số
| Thông số | Mô tả |
|---|---|
flag
|
bool;
mặc định là FalseLiệu chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không. |
allow_multiple
|
bool;
mặc định là FalseKhông dùng nữa, hãy sử dụng chế độ cài đặt string_list với repeatable = True. Nếu được đặt, bạn có thể đặt cờ này nhiều lần trên dòng lệnh. Giá trị của cờ được truy cập trong các hiệu ứng chuyển đổi và hàm triển khai chế độ cài đặt bản dựng sẽ là một danh sách các chuỗi. Cả thứ tự chèn và giá trị lặp lại đều được duy trì. Bạn có thể xử lý sau danh sách này trong hàm triển khai chế độ cài đặt bản dựng nếu muốn có hành vi khác.
|
string_list
BuildSetting config.string_list(flag=False, repeatable=False)Chế độ cài đặt bản dựng được nhập dưới dạng danh sách chuỗi. Trên dòng lệnh, hãy truyền một danh sách bằng giá trị được phân tách bằng dấu phẩy như
--//my/setting=foo,bar.
Tham số
| Thông số | Mô tả |
|---|---|
flag
|
bool;
mặc định là FalseLiệu chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không. |
repeatable
|
bool; giá trị mặc định là FalseNếu được đặt, thay vì chờ giá trị được phân tách bằng dấu phẩy, bạn có thể đặt cờ này nhiều lần trên dòng lệnh, trong đó mỗi giá trị riêng lẻ được coi là một chuỗi để thêm vào giá trị danh sách. Cả thứ tự chèn và giá trị lặp lại đều được duy trì. Bạn có thể xử lý sau danh sách này trong hàm triển khai chế độ cài đặt bản dựng nếu muốn có hành vi khác. |
mục tiêu
transition config.target()Tạo một chuyển đổi mục tiêu. Đây là hiệu ứng chuyển đổi không hoạt động dành cho trường hợp cần có đối tượng chuyển đổi nhưng không muốn thực sự thay đổi bất kỳ nội dung nào. Tương đương với
cfg = "target" trong attr.label().