cấu hình

Báo cáo sự cố Xem nguồn

Đây là mô-đun cấp cao nhất để tạo hoạt động chuyển đổi cấu hình và trình mô tả chế độ cài đặt bản dựng, giúp mô tả loại chế độ cài đặt bản dựng (nếu có) của quy tắc.

ví dụ: quy tắc sau đây đượ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à một flag, 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 được nhập kiểu bool

Các tham số

Thông số Nội dung mô tả
flag mặc định là False
Liệ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 quá trình chuyển đổi thực thi.

Các tham số

Thông số Nội dung mô tả
exec_group string; hoặc None; giá trị mặc định là None
Tên của nhóm executor 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 nhập số nguyên

Các tham số

Thông số Nội dung mô tả
flag mặc định là False
Liệ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.

string

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

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

Các tham số

Thông số Nội dung mô tả
flag mặc định là False
Liệ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 giá trị mặc định là False
Không dùng nữa, hãy dùng chế độ cài đặt string_list với repeatable = True. Nếu được đặt, cờ này sẽ được phép đặt nhiều lần trên dòng lệnh. Giá trị của cờ khi được truy cập trong quá trình chuyển đổi và hàm triển khai cài đặt bản dựng sẽ là một danh sách các chuỗi. Các giá trị lặp lại và thứ tự chèn đều được duy trì. Danh sách này có thể được xử lý hậu 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 dạng danh sách chuỗi. Trên dòng lệnh, hãy chuyển một danh sách sử dụng giá trị được phân tách bằng dấu phẩy như --//my/setting=foo,bar.

Các tham số

Thông số Nội dung mô tả
flag mặc định là False
Liệ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 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, bạn có thể đặt cờ này nhiều lần trên dòng lệnh với mỗi giá trị riêng lẻ được coi là một chuỗi duy nhất để thêm vào giá trị danh sách. Các giá trị lặp lại và thứ tự chèn đều được duy trì. Danh sách này có thể được xử lý hậu trong hàm triển khai chế độ cài đặt bản dựng nếu muốn có hành vi khác.