Đây là một mô-đun cấp cao nhất để xác định các giản đồ thuộc tính của một quy tắc hoặc khía cạnh. Mỗi hàm trả về một đối tượng đại diện cho giản đồ của một thuộc tính duy nhất. Các đối tượng này được dùng làm giá trị của đối số từ điển attrs trong rule(), aspect(), repository_rule() và tag_class().
Hãy xem trang Quy tắc để biết thêm thông tin về cách xác định và sử dụng các thuộc tính.
Hội viên
- bool
- int
- int_list
- nhãn
- label_keyed_string_dict
- label_list
- output
- output_list
- string
- string_dict
- string_keyed_label_dict
- string_list
- string_list_dict
bool
Attribute attr.bool(configurable=unbound, default=False, doc=None, mandatory=False)
ctx.attr tương ứng sẽ thuộc loại bool.
Thông số
| Thông số | Mô tả |
|---|---|
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
bool;
default is FalseGiá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này được đưa ra khi khởi tạo quy tắc. |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
int
Attribute attr.int(configurable=unbound, default=0, doc=None, mandatory=False, values=[])
ctx.attr tương ứng sẽ thuộc loại int.
Thông số
| Thông số | Mô tả |
|---|---|
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
int;
mặc định là 0Giá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này được đưa ra khi tạo thực thể quy tắc. |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
values
|
sequence của ints;
mặc định là []Danh sách các giá trị được phép cho thuộc tính. Lỗi sẽ xảy ra nếu bạn cung cấp bất kỳ giá trị nào khác. |
int_list
Attribute attr.int_list(mandatory=False, allow_empty=True, *, configurable=unbound, default=[], doc=None)
Thông số
| Thông số | Mô tả |
|---|---|
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
allow_empty
|
bool;
default is TrueTrue if the attribute can be empty. |
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
sequence của ints;
mặc định là []Giá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này khi tạo thực thể quy tắc. |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
nhãn
Attribute attr.label(configurable=unbound, default=None, materializer=None, doc=None, executable=False, allow_files=None, allow_single_file=None, mandatory=False, skip_validations=False, providers=[], for_dependency_resolution=unbound, allow_rules=None, cfg=None, aspects=[], flags=[])
Tạo một giản đồ cho thuộc tính nhãn. Đây là một thuộc tính phụ thuộc.
Thuộc tính này chứa các giá trị riêng biệt của Label. Nếu một chuỗi được cung cấp thay cho Label, thì chuỗi đó sẽ được chuyển đổi bằng hàm khởi tạo nhãn. Các phần tương đối của đường dẫn nhãn, bao gồm cả kho lưu trữ (có thể được đổi tên), được phân giải liên quan đến gói của mục tiêu được khởi tạo.
Tại thời điểm phân tích (trong hàm triển khai của quy tắc), khi truy xuất giá trị thuộc tính từ ctx.attr, các nhãn sẽ được thay thế bằng Target tương ứng. Điều này cho phép bạn truy cập vào các nhà cung cấp của các phần phụ thuộc của mục tiêu hiện tại.
Ngoài các tệp nguồn thông thường, loại thuộc tính này thường được dùng để tham chiếu đến một công cụ, chẳng hạn như trình biên dịch. Những công cụ như vậy được coi là các phần phụ thuộc, giống như các tệp nguồn. Để tránh yêu cầu người dùng chỉ định nhãn của công cụ mỗi khi họ sử dụng quy tắc trong tệp BUILD, bạn có thể mã hoá cứng nhãn của một công cụ chuẩn làm giá trị default của thuộc tính này. Nếu cũng muốn ngăn người dùng ghi đè giá trị mặc định này, bạn có thể đặt thuộc tính ở chế độ riêng tư bằng cách đặt cho thuộc tính đó một tên bắt đầu bằng dấu gạch dưới. Hãy xem trang Quy tắc để biết thêm thông tin.
Thông số
| Thông số | Mô tả |
|---|---|
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
Label; hoặc string; hoặc LateBoundDefault; hoặc NativeComputedDefault; hoặc function; hoặc None;
mặc định là NoneGiá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này khi tạo thực thể của quy tắc.Sử dụng một chuỗi hoặc hàm Label để chỉ định một giá trị mặc định, ví dụ: attr.label(default = "//a:b").
|
materializer
|
function;
mặc định là NoneThử nghiệm. Đây là một thông số thử nghiệm và có thể thay đổi bất cứ lúc nào. Vui lòng không phụ thuộc vào thông tin này. Bạn có thể bật tính năng này theo cách thử nghiệm bằng cách đặt --experimental_dormant_deps Nếu được đặt, thuộc tính sẽ hiện thực hoá các phần phụ thuộc không hoạt động từ bao đóng bắc cầu. Giá trị của tham số này phải là một hàm có quyền truy cập vào các giá trị của thuộc tính trong quy tắc không phải là phần phụ thuộc hoặc được đánh dấu là có sẵn để phân giải phần phụ thuộc. Bạn phải trả về một phần phụ thuộc không hoạt động hoặc một danh sách các phần phụ thuộc đó, tuỳ thuộc vào loại thuộc tính |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
executable
|
bool;
default is FalseTrue if the dependency has to be executable. Điều này có nghĩa là nhãn phải tham chiếu đến một tệp thực thi hoặc đến một quy tắc xuất ra một tệp thực thi. Truy cập vào nhãn bằng ctx.executable.<attribute_name>.
|
allow_files
|
bool; hoặc sequence của strings; hoặc None;
mặc định là NoneCó cho phép các mục tiêu File hay không. Có thể là True, False (mặc định) hoặc danh sách các đuôi tệp được phép (ví dụ: [".cc", ".cpp"]).
|
allow_single_file
|
mặc định là NoneTương tự như allow_files, nhưng có hạn chế là nhãn phải tương ứng với một Tệp duy nhất. Truy cập vào mục này thông qua ctx.file.<attribute_name>.
|
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
skip_validations
|
bool;
mặc định là FalseNếu đúng, các thao tác xác thực của các phần phụ thuộc bắc cầu từ thuộc tính này sẽ không chạy. Đây là biện pháp giảm thiểu tạm thời và SẼ bị xoá trong tương lai. |
providers
|
sequence;
mặc định là []Các trình cung cấp phải được cung cấp bởi mọi phần phụ thuộc xuất hiện trong thuộc tính này. Định dạng của đối số này là danh sách các danh sách nhà cung cấp – các đối tượng |
for_dependency_resolution
|
mặc định là unboundNếu bạn đặt thuộc tính này, thì thuộc tính này sẽ có sẵn cho các trình hiện thực hoá. Bạn chỉ được phép tham chiếu các quy tắc được đánh dấu bằng cờ có cùng tên thông qua những thuộc tính như vậy. |
allow_rules
|
sequence của strings; hoặc None;
default is NoneWhich rule targets (name of the classes) are allowed. Chính sách này không được dùng nữa (chỉ giữ lại để tương thích), hãy sử dụng các nhà cung cấp. |
cfg
|
mặc định là NoneCấu hình của thuộc tính. Đó có thể là "exec", cho biết phần phụ thuộc được tạo cho execution platform hoặc "target", cho biết phần phụ thuộc được tạo cho target platform. Một ví dụ điển hình về sự khác biệt này là khi tạo ứng dụng di động, trong đó target platform là Android hoặc iOS, còn execution platform là Linux, macOS hoặc Windows. Tham số này là bắt buộc nếu executable là True để tránh vô tình tạo các công cụ lưu trữ trong cấu hình đích. "target" không có hiệu ứng ngữ nghĩa, vì vậy, đừng đặt giá trị này khi executable là False, trừ phi giá trị này thực sự giúp làm rõ ý định của bạn.
|
aspects
|
sequence của Aspects; giá trị mặc định là []Các khía cạnh cần áp dụng cho (các) phần phụ thuộc do thuộc tính này chỉ định. |
flags
|
sequence của strings; giá trị mặc định là []Không dùng nữa, sẽ bị xoá. |
label_keyed_string_dict
Attribute attr.label_keyed_string_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, allow_files=None, allow_rules=None, providers=[], for_dependency_resolution=unbound, flags=[], mandatory=False, skip_validations=False, cfg=None, aspects=[])
Tạo một giản đồ cho một thuộc tính chứa từ điển, trong đó các khoá là nhãn và các giá trị là chuỗi. Đây là một thuộc tính phụ thuộc.
Thuộc tính này chứa các giá trị riêng biệt của Label. Nếu một chuỗi được cung cấp thay cho Label, thì chuỗi đó sẽ được chuyển đổi bằng hàm khởi tạo nhãn. Các phần tương đối của đường dẫn nhãn, bao gồm cả kho lưu trữ (có thể được đổi tên), được phân giải liên quan đến gói của mục tiêu được khởi tạo.
Tại thời điểm phân tích (trong hàm triển khai của quy tắc), khi truy xuất giá trị thuộc tính từ ctx.attr, các nhãn sẽ được thay thế bằng Target tương ứng. Điều này cho phép bạn truy cập vào các nhà cung cấp của các phần phụ thuộc của mục tiêu hiện tại.
Thông số
| Thông số | Mô tả |
|---|---|
allow_empty
|
bool;
default is TrueTrue if the attribute can be empty. |
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
dict; hoặc function; giá trị mặc định là {}Giá trị mặc định sẽ dùng nếu không có giá trị nào cho thuộc tính này khi khởi tạo quy tắc.Sử dụng các chuỗi hoặc hàm Label để chỉ định giá trị mặc định, ví dụ: attr.label_keyed_string_dict(default = {"//a:b": "value", "//a:c": "string"}).
|
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
allow_files
|
bool; hoặc sequence của strings; hoặc None;
mặc định là NoneCó cho phép các mục tiêu File hay không. Có thể là True, False (mặc định) hoặc danh sách các đuôi tệp được phép (ví dụ: [".cc", ".cpp"]).
|
allow_rules
|
sequence của strings; hoặc None;
default is NoneWhich rule targets (name of the classes) are allowed. Chính sách này không được dùng nữa (chỉ giữ lại để tương thích), hãy sử dụng các nhà cung cấp. |
providers
|
sequence;
mặc định là []Các trình cung cấp phải được cung cấp bởi mọi phần phụ thuộc xuất hiện trong thuộc tính này. Định dạng của đối số này là danh sách các danh sách nhà cung cấp – các đối tượng |
for_dependency_resolution
|
mặc định là unboundNếu bạn đặt thuộc tính này, thì thuộc tính này sẽ có sẵn cho các trình hiện thực hoá. Bạn chỉ được phép tham chiếu các quy tắc được đánh dấu bằng cờ có cùng tên thông qua những thuộc tính như vậy. |
flags
|
sequence của strings; giá trị mặc định là []Không dùng nữa, sẽ bị xoá. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
skip_validations
|
bool;
mặc định là FalseNếu đúng, các thao tác xác thực của các phần phụ thuộc bắc cầu từ thuộc tính này sẽ không chạy. Đây là biện pháp giảm thiểu tạm thời và SẼ bị xoá trong tương lai. |
cfg
|
mặc định là NoneCấu hình của thuộc tính. Đó có thể là "exec", cho biết phần phụ thuộc được tạo cho execution platform hoặc "target", cho biết phần phụ thuộc được tạo cho target platform. Một ví dụ điển hình về sự khác biệt này là khi tạo ứng dụng di động, trong đó target platform là Android hoặc iOS, còn execution platform là Linux, macOS hoặc Windows.
|
aspects
|
sequence của Aspects; giá trị mặc định là []Các khía cạnh cần áp dụng cho (các) phần phụ thuộc do thuộc tính này chỉ định. |
label_list
Attribute attr.label_list(allow_empty=True, *, configurable=unbound, default=[], materializer=None, doc=None, allow_files=None, allow_rules=None, providers=[], for_dependency_resolution=unbound, flags=[], mandatory=False, skip_validations=False, cfg=None, aspects=[])
Tạo một giản đồ cho thuộc tính danh sách nhãn. Đây là một thuộc tính phụ thuộc. Thuộc tính ctx.attr tương ứng sẽ thuộc loại list của Targets.
Thuộc tính này chứa các giá trị riêng biệt của Label. Nếu một chuỗi được cung cấp thay cho Label, thì chuỗi đó sẽ được chuyển đổi bằng hàm khởi tạo nhãn. Các phần tương đối của đường dẫn nhãn, bao gồm cả kho lưu trữ (có thể được đổi tên), được phân giải liên quan đến gói của mục tiêu được khởi tạo.
Tại thời điểm phân tích (trong hàm triển khai của quy tắc), khi truy xuất giá trị thuộc tính từ ctx.attr, các nhãn sẽ được thay thế bằng Target tương ứng. Điều này cho phép bạn truy cập vào các nhà cung cấp của các phần phụ thuộc của mục tiêu hiện tại.
Thông số
| Thông số | Mô tả |
|---|---|
allow_empty
|
bool;
default is TrueTrue if the attribute can be empty. |
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
trình tự của Nhãn; hoặc hàm; giá trị mặc định là []Giá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này khi khởi tạo quy tắc.Sử dụng các chuỗi hoặc hàm Label để chỉ định giá trị mặc định, ví dụ: attr.label_list(default = ["//a:b", "//a:c"]).
|
materializer
|
function;
mặc định là NoneThử nghiệm. Đây là một thông số thử nghiệm và có thể thay đổi bất cứ lúc nào. Vui lòng không phụ thuộc vào thông tin này. Bạn có thể bật tính năng này theo cách thử nghiệm bằng cách đặt --experimental_dormant_deps Nếu được đặt, thuộc tính sẽ hiện thực hoá các phần phụ thuộc không hoạt động từ bao đóng bắc cầu. Giá trị của tham số này phải là một hàm có quyền truy cập vào các giá trị của thuộc tính trong quy tắc không phải là phần phụ thuộc hoặc được đánh dấu là có sẵn để phân giải phần phụ thuộc. Bạn phải trả về một phần phụ thuộc không hoạt động hoặc một danh sách các phần phụ thuộc đó, tuỳ thuộc vào loại thuộc tính |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
allow_files
|
bool; hoặc sequence của strings; hoặc None;
mặc định là NoneCó cho phép các mục tiêu File hay không. Có thể là True, False (mặc định) hoặc danh sách các đuôi tệp được phép (ví dụ: [".cc", ".cpp"]).
|
allow_rules
|
sequence của strings; hoặc None;
default is NoneWhich rule targets (name of the classes) are allowed. Chính sách này không được dùng nữa (chỉ giữ lại để tương thích), hãy sử dụng các nhà cung cấp. |
providers
|
sequence;
mặc định là []Các trình cung cấp phải được cung cấp bởi mọi phần phụ thuộc xuất hiện trong thuộc tính này. Định dạng của đối số này là danh sách các danh sách nhà cung cấp – các đối tượng |
for_dependency_resolution
|
mặc định là unboundNếu bạn đặt thuộc tính này, thì thuộc tính này sẽ có sẵn cho các trình hiện thực hoá. Bạn chỉ được phép tham chiếu các quy tắc được đánh dấu bằng cờ có cùng tên thông qua những thuộc tính như vậy. |
flags
|
sequence của strings; giá trị mặc định là []Không dùng nữa, sẽ bị xoá. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
skip_validations
|
bool;
mặc định là FalseNếu đúng, các thao tác xác thực của các phần phụ thuộc bắc cầu từ thuộc tính này sẽ không chạy. Đây là biện pháp giảm thiểu tạm thời và SẼ bị xoá trong tương lai. |
cfg
|
mặc định là NoneCấu hình của thuộc tính. Đó có thể là "exec", cho biết phần phụ thuộc được tạo cho execution platform hoặc "target", cho biết phần phụ thuộc được tạo cho target platform. Một ví dụ điển hình về sự khác biệt này là khi tạo ứng dụng di động, trong đó target platform là Android hoặc iOS, còn execution platform là Linux, macOS hoặc Windows.
|
aspects
|
sequence của Aspects; giá trị mặc định là []Các khía cạnh cần áp dụng cho (các) phần phụ thuộc do thuộc tính này chỉ định. |
output
Attribute attr.output(doc=None, mandatory=False)
Tạo một giản đồ cho thuộc tính đầu ra (nhãn).
Thuộc tính này chứa các giá trị riêng biệt của Label. Nếu một chuỗi được cung cấp thay cho Label, thì chuỗi đó sẽ được chuyển đổi bằng hàm khởi tạo nhãn. Các phần tương đối của đường dẫn nhãn, bao gồm cả kho lưu trữ (có thể được đổi tên), được phân giải liên quan đến gói của mục tiêu được khởi tạo.
Tại thời điểm phân tích, bạn có thể truy xuất File tương ứng bằng cách sử dụng ctx.outputs.
Thông số
| Thông số | Mô tả |
|---|---|
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
output_list
Attribute attr.output_list(allow_empty=True, *, doc=None, mandatory=False)
Thuộc tính này chứa các giá trị riêng biệt của Label. Nếu một chuỗi được cung cấp thay cho Label, thì chuỗi đó sẽ được chuyển đổi bằng hàm khởi tạo nhãn. Các phần tương đối của đường dẫn nhãn, bao gồm cả kho lưu trữ (có thể được đổi tên), được phân giải liên quan đến gói của mục tiêu được khởi tạo.
Tại thời điểm phân tích, bạn có thể truy xuất File tương ứng bằng cách sử dụng ctx.outputs.
Thông số
| Thông số | Mô tả |
|---|---|
allow_empty
|
bool;
default is TrueTrue if the attribute can be empty. |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
chuỗi
Attribute attr.string(configurable=unbound, default='', doc=None, mandatory=False, values=[])
Thông số
| Thông số | Mô tả |
|---|---|
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
string; hoặc NativeComputedDefault;
mặc định là ''Giá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này được đưa ra khi khởi tạo quy tắc. |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
values
|
sequence của strings; giá trị mặc định là []Danh sách các giá trị được phép cho thuộc tính. Lỗi sẽ xảy ra nếu bạn cung cấp bất kỳ giá trị nào khác. |
string_dict
Attribute attr.string_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, mandatory=False)
Thông số
| Thông số | Mô tả |
|---|---|
allow_empty
|
bool;
default is TrueTrue if the attribute can be empty. |
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
dict;
mặc định là {}Giá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này khi khởi tạo quy tắc. |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
string_keyed_label_dict
Attribute attr.string_keyed_label_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, allow_files=None, allow_rules=None, providers=[], for_dependency_resolution=unbound, flags=[], mandatory=False, cfg=None, aspects=[])
Tạo một giản đồ cho một thuộc tính có giá trị là một từ điển, trong đó các khoá là chuỗi và các giá trị là nhãn. Đây là một thuộc tính phụ thuộc.
Thuộc tính này chứa các giá trị riêng biệt của Label. Nếu một chuỗi được cung cấp thay cho Label, thì chuỗi đó sẽ được chuyển đổi bằng hàm khởi tạo nhãn. Các phần tương đối của đường dẫn nhãn, bao gồm cả kho lưu trữ (có thể được đổi tên), được phân giải liên quan đến gói của mục tiêu được khởi tạo.
Tại thời điểm phân tích (trong hàm triển khai của quy tắc), khi truy xuất giá trị thuộc tính từ ctx.attr, các nhãn sẽ được thay thế bằng Target tương ứng. Điều này cho phép bạn truy cập vào các nhà cung cấp của các phần phụ thuộc của mục tiêu hiện tại.
Thông số
| Thông số | Mô tả |
|---|---|
allow_empty
|
bool;
default is TrueTrue if the attribute can be empty. |
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
dict; hoặc function; giá trị mặc định là {}Giá trị mặc định sẽ dùng nếu không có giá trị nào cho thuộc tính này khi khởi tạo quy tắc.Sử dụng các chuỗi hoặc hàm Label để chỉ định giá trị mặc định, ví dụ: attr.string_keyed_label_dict(default = {"foo": "//a:b", "bar": "//a:c"}).
|
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
allow_files
|
bool; hoặc sequence của strings; hoặc None;
mặc định là NoneCó cho phép các mục tiêu File hay không. Có thể là True, False (mặc định) hoặc danh sách các đuôi tệp được phép (ví dụ: [".cc", ".cpp"]).
|
allow_rules
|
sequence của strings; hoặc None;
default is NoneWhich rule targets (name of the classes) are allowed. Chính sách này không được dùng nữa (chỉ giữ lại để tương thích), hãy sử dụng các nhà cung cấp. |
providers
|
sequence;
mặc định là []Các trình cung cấp phải được cung cấp bởi mọi phần phụ thuộc xuất hiện trong thuộc tính này. Định dạng của đối số này là danh sách các danh sách nhà cung cấp – các đối tượng |
for_dependency_resolution
|
mặc định là unboundNếu bạn đặt thuộc tính này, thì thuộc tính này sẽ có sẵn cho các trình hiện thực hoá. Bạn chỉ được phép tham chiếu các quy tắc được đánh dấu bằng cờ có cùng tên thông qua những thuộc tính như vậy. |
flags
|
sequence của strings; giá trị mặc định là []Không dùng nữa, sẽ bị xoá. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
cfg
|
mặc định là NoneCấu hình của thuộc tính. Đó có thể là "exec", cho biết phần phụ thuộc được tạo cho execution platform hoặc "target", cho biết phần phụ thuộc được tạo cho target platform. Một ví dụ điển hình về sự khác biệt này là khi tạo ứng dụng di động, trong đó target platform là Android hoặc iOS, còn execution platform là Linux, macOS hoặc Windows.
|
aspects
|
sequence của Aspects; giá trị mặc định là []Các khía cạnh cần áp dụng cho (các) phần phụ thuộc do thuộc tính này chỉ định. |
string_list
Attribute attr.string_list(mandatory=False, allow_empty=True, *, configurable=unbound, default=[], doc=None)
Thông số
| Thông số | Mô tả |
|---|---|
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|
allow_empty
|
bool;
default is TrueTrue if the attribute can be empty. |
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
sequence của string; hoặc NativeComputedDefault;
mặc định là []Giá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này khi khởi tạo quy tắc. |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
string_list_dict
Attribute attr.string_list_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, mandatory=False)
Thông số
| Thông số | Mô tả |
|---|---|
allow_empty
|
bool;
default is TrueTrue if the attribute can be empty. |
configurable
|
bool; hoặc không liên kết; giá trị mặc định là unboundBạn chỉ có thể chỉ định đối số này cho một thuộc tính của macro tượng trưng. Nếu Đối với một thuộc tính của quy tắc hoặc khía cạnh, bạn phải để |
default
|
dict;
mặc định là {}Giá trị mặc định để sử dụng nếu không có giá trị nào cho thuộc tính này khi khởi tạo quy tắc. |
doc
|
string; hoặc None;
mặc định là NoneNội dung mô tả về thuộc tính mà các công cụ tạo tài liệu có thể trích xuất. |
mandatory
|
bool;
mặc định là FalseNếu là true, bạn phải chỉ định giá trị một cách rõ ràng (ngay cả khi giá trị đó có default).
|