cấu hình

Báo cáo vấn đề Xem nguồn Hằng đêm · 7,3 · 7.2 · 7.1 · 7 · 6,5

Đây là mô-đun cấp cao nhất để tạo chuyển đổi cấu hình và mô tả chế độ cài đặt bản dựng, trong đó mô tả loại chế độ cài đặt bản dựng (nếu có) là 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ể, đó là 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 nhập bool

Tham số

Thông số Mô tả
flag bool; giá trị mặc định là False
Liệu chế độ cài đặt bản dựng này có thể gọi trên dòng lệnh hay không.

giám đốc điều hành

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; giá trị mặc định là None
Tê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 exec 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 có dạng số nguyên

Tham số

Thông số Mô tả
flag bool; giá trị mặc định là False
Liệu chế độ cài đặt bản dựng này có thể gọi trên dòng lệnh hay không.

string

BuildSetting config.string(flag=False, allow_multiple=False)

Chế độ cài đặt bản dựng có dạng chuỗi

Tham số

Thông số Mô tả
flag bool; giá trị mặc định là False
Liệu chế độ cài đặt bản dựng này có thể gọi trên dòng lệnh hay không.
allow_multiple bool; giá trị mặc định là False
Khô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 sẽ được phép đặt cờ này nhiều lần trên dòng lệnh. Giá trị của cờ được truy cập trong hàm triển khai cài đặt bản dựng và chuyển đổi sẽ là một danh sách các chuỗi. Thứ tự chèn và giá trị lặp lại đều được duy trì. Bạn có thể xử lý 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)

Một chế độ cài đặt bản dựng có dạng danh sách chuỗi. Trên dòng lệnh, hãy chuyển danh sách bằng cách sử dụ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; giá trị mặc định là False
Liệu chế độ cài đặt bản dựng này có thể gọi trên dòng lệnh hay không.
repeatable bool; giá trị mặc định là False
Nếu được đặt, thay vì mong đợi giá trị được phân tách bằng dấu phẩy, cờ này được phép đặt 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 đơn để thêm vào giá trị danh sách. Thứ tự chèn và giá trị lặp lại đều được duy trì. Bạn có thể xử lý 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 hiệu ứng chuyển đổi mục tiêu. Đây là quá trình chuyển đổi không hoạt động dành cho trường hợp cần đối tượng chuyển đổi nhưng không muốn thực sự thay đổi bất cứ điều gì. Tương đương với cfg = "target" trong attr.label().