cấu hình

Đây là một mô-đun cấp cao nhất để tạo các quá trình chuyển đổi cấu hình và các bộ mô tả chế độ cài đặt bản dựng. Các bộ mô tả này 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à một flag, tức 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
• exec
• int
• string
• string_list

bool

BuildSetting config.bool(flag=False)

Một chế độ cài đặt bản dựng có kiểu bool

Thông số

Thông số	Mô tả
flag	mặc định là False Cho dù 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 hiệu ứng chuyển đổi thực thi.

Thông số

Thông số	Mô tả
exec_group	string; hoặc None; mặc định là None Tên của nhóm thực thi mà nền tảng thực thi 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ó kiểu số nguyên

Thông số

Thông số	Mô tả
flag	mặc định là False Cho dù chế độ cài đặt bản dựng này có thể gọi được trên dòng lệnh hay không.

chuỗi

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

Một chế độ cài đặt bản dựng có kiểu chuỗi

Thông số

Thông số	Mô tả
flag	mặc định là False Cho dù 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	mặc định là False Không được 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ờ khi được truy cập trong các hàm triển khai chế độ cài đặt bản dựng và quá trình chuyển đổi 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ý danh sách này sau 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ó kiểu danh sách chuỗi. Trên dòng lệnh, hãy truyền một danh sách bằng cách sử dụng giá trị được phân tách bằng dấu phẩy, chẳng hạn như --//my/setting=foo,bar.

Thông số

Thông số	Mô tả
flag	mặc định là False Cho dù 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 một 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 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ả 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 sau trong hàm triển khai chế độ cài đặt bản dựng nếu muốn có hành vi khác.