thuộc tí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 dùng để xác định 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ố trong từ điển attrs của rule() và aspect().

Xem trang Quy tắc để tìm hiểu thêm về cách xác định và sử dụng thuộc tính.

Hội viên

• bool
• số nguyên
• int_list
• nhãn
• label_keyed_string_dict
• label_list
• đầu ra
• output_list
• string
• string_dict
• string_list
• string_list_dict

bool

Attribute attr.bool(configurable=unbound, default=False, doc=None, mandatory=False)

Tạo giản đồ cho một thuộc tính boolean. Thuộc tính ctx.attr tương ứng sẽ thuộc loại bool.

Tham số

Thông số	Mô tả
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	bool; giá trị mặc định là False 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 cung cấp khi tạo thực thể quy tắc.
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).

int

Attribute attr.int(configurable=unbound, default=0, doc=None, mandatory=False, values=[])

Tạo giản đồ cho một thuộc tính số nguyên. Giá trị phải nằm trong dải ô 32 bit có dấu. Thuộc tính ctx.attr tương ứng sẽ thuộc loại int.

Tham số

Thông số	Mô tả
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	int; giá trị mặc định là 0 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 cung cấp khi tạo thực thể quy tắc.
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).
values	trình tự của số nguyên; 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)

Tạo giản đồ cho thuộc tính danh sách số nguyên. Mỗi phần tử đều phải nằm trong dải ô 32 bit có dấu.

Tham số

Thông số	Mô tả
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).
allow_empty	bool; giá trị mặc định là True Đúng nếu thuộc tính có thể để trống.
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	trình tự của số nguyên; 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 cung cấp khi tạo thực thể quy tắc.
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.

nhãn

Attribute attr.label(configurable=unbound, default=None, doc=None, executable=False, allow_files=None, allow_single_file=None, mandatory=False, skip_validations=False, providers=[], allow_rules=None, cfg=None, aspects=[], flags=[])

Tạo giản đồ cho thuộc tính nhãn. Đây là thuộc tính phần phụ thuộc.

Thuộc tính này chứa các giá trị Label duy nhất. 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 tương ứng với gói của mục tiêu đã tạo thực thể.

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, nhãn sẽ được thay thế bằng các Target tương ứng. Nhờ vậy, bạn có thể truy cập vào các trình cung cấp 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, cũng giống như các tệp nguồn. Để tránh việc 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ã hóa cố định 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 riêng tư bằng cách đặt tên cho thuộc tính bắt đầu bằng dấu gạch dưới. Xem trang Quy tắc để biết thêm thông tin.

Tham số

Thông số	Mô tả
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	Nhãn; hoặc chuỗi; hoặc LateBoundDefault; hoặc NativeComputedDefault; hoặc hàm; hoặc None; mặc định là None Một 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 cung cấp khi tạo thực thể cho quy tắc.Hãy sử dụng một chuỗi hoặc hàm Label để chỉ định một giá trị mặc định, chẳng hạn như attr.label(default = "//a:b").
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
executable	bool; giá trị mặc định là False Đúng nếu phần phụ thuộc phải có thể thực thi. Điều này có nghĩa là nhãn phải tham chiếu đến tệp thực thi hoặc quy tắc xuất ra tệp thực thi. Truy cập vào nhãn bằng ctx.executable.<attribute_name>.
allow_files	bool; hoặc trình tự của chuỗi; hoặc None; giá trị mặc định là None Liệu File mục tiêu có được cho phép hay không. Có thể là True, False (mặc định) hoặc một danh sách đuôi tệp được phép (ví dụ: [".cc", ".cpp"]).
allow_single_file	giá trị mặc định là None Điều này tương tự như allow_files, nhưng có quy định hạn chế là nhãn phải tương ứng với một Tệp. Truy cập thông qua ctx.file.<attribute_name>.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).
skip_validations	bool; giá trị mặc định là False Nếu đúng, các hành động 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	trình tự; giá trị mặc định là [] Các trình cung cấp phải được cung cấp qua bất kỳ phần phụ thuộc nào có trong thuộc tính này. Định dạng của đối số này là danh sách danh sách trình cung cấp – các đối tượng *Info do provider() trả về (hoặc tên chuỗi của trình cung cấp trong trường hợp nhà cung cấp cũ). Phần phụ thuộc phải trả về TẤT CẢ trình cung cấp được đề cập trong ít nhất ONE trong các danh sách bên trong. Để thuận tiện, đối số này cũng có thể là danh sách các trình cung cấp một cấp. Trong trường hợp đó, đối số này được bao bọc trong một danh sách ngoài có một phần tử. Bạn KHÔNG bắt buộc phải quy tắc của phần phụ thuộc quảng cáo các trình cung cấp đó trong tham số provides. Tuy nhiên, đây được coi là phương pháp hay nhất.
allow_rules	trình tự của chuỗi; hoặc None; mặc định là None Mục tiêu quy tắc nào (tên lớp) được phép. Tính năng này không còn được dùng nữa (chỉ giữ lại để đảm bảo khả năng tương thích), thay vào đó, hãy sử dụng nhà cung cấp.
cfg	giá trị mặc định là None Cấu hình của thuộc tính. Đó có thể là "exec" (cho biết phần phụ thuộc này được tạo cho execution platform) hoặc "target" (cho biết phần phụ thuộc này đượ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 trong khi execution platform là Linux, macOS hoặc Windows. Tham số này là bắt buộc nếu executable là True để đề phòng việc vô tình tạo các công cụ của máy chủ lưu trữ trong cấu hình đích. "target" không có hiệu ứng ngữ nghĩa, vì vậy, đừng đặt thuộc tính này khi executable là False trừ phi thao tác này thực sự giúp làm rõ ý định của bạn.
aspects	trình tự của Khung hình; mặc định là [] Các khía cạnh cần áp dụng cho phần phụ thuộc hoặc các phần phụ thuộc do thuộc tính này chỉ định.
flags	trình tự của chuỗi; mặc định là [] Không được 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=[], flags=[], mandatory=False, cfg=None, aspects=[])

Tạo giản đồ cho một thuộc tính chứa từ điển, trong đó khoá là nhãn và giá trị là chuỗi. Đây là thuộc tính phần phụ thuộc.

Thuộc tính này chứa các giá trị Label duy nhất. 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 tương ứng với gói của mục tiêu đã tạo thực thể.

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, nhãn sẽ được thay thế bằng các Target tương ứng. Nhờ vậy, bạn có thể truy cập vào các trình cung cấp các phần phụ thuộc của mục tiêu hiện tại.

Tham số

Thông số	Mô tả
allow_empty	bool; giá trị mặc định là True Đúng nếu thuộc tính có thể để trống.
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	dict; hoặc hàm; 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 cung cấp khi tạo thực thể quy tắc.Sử dụng 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; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
allow_files	bool; hoặc trình tự của chuỗi; hoặc None; giá trị mặc định là None Liệu File mục tiêu có được cho phép hay không. Có thể là True, False (mặc định) hoặc một danh sách đuôi tệp được phép (ví dụ: [".cc", ".cpp"]).
allow_rules	trình tự của chuỗi; hoặc None; mặc định là None Mục tiêu quy tắc nào (tên lớp) được phép. Tính năng này không còn được dùng nữa (chỉ giữ lại để đảm bảo khả năng tương thích), thay vào đó, hãy sử dụng nhà cung cấp.
providers	trình tự; giá trị mặc định là [] Các trình cung cấp phải được cung cấp qua bất kỳ phần phụ thuộc nào có trong thuộc tính này. Định dạng của đối số này là danh sách danh sách trình cung cấp – các đối tượng *Info do provider() trả về (hoặc tên chuỗi của trình cung cấp trong trường hợp nhà cung cấp cũ). Phần phụ thuộc phải trả về TẤT CẢ trình cung cấp được đề cập trong ít nhất ONE trong các danh sách bên trong. Để thuận tiện, đối số này cũng có thể là danh sách các trình cung cấp một cấp. Trong trường hợp đó, đối số này được bao bọc trong một danh sách ngoài có một phần tử. Bạn KHÔNG bắt buộc phải quy tắc của phần phụ thuộc quảng cáo các trình cung cấp đó trong tham số provides. Tuy nhiên, đây được coi là phương pháp hay nhất.
flags	trình tự của chuỗi; mặc định là [] Không được dùng nữa, sẽ bị xoá.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).
cfg	giá trị mặc định là None Cấu hình của thuộc tính. Đó có thể là "exec" (cho biết phần phụ thuộc này được tạo cho execution platform) hoặc "target" (cho biết phần phụ thuộc này đượ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 trong khi execution platform là Linux, macOS hoặc Windows.
aspects	trình tự của Khung hình; mặc định là [] Các khía cạnh cần áp dụng cho phần phụ thuộc hoặc 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=[], doc=None, allow_files=None, allow_rules=None, providers=[], flags=[], mandatory=False, skip_validations=False, cfg=None, aspects=[])

Tạo giản đồ cho thuộc tính danh sách nhãn. Đây là thuộc tính phần phụ thuộc. Thuộc tính ctx.attr tương ứng sẽ thuộc loại danh sách Target.

Thuộc tính này chứa các giá trị Label duy nhất. 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 tương ứng với gói của mục tiêu đã tạo thực thể.

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, nhãn sẽ được thay thế bằng các Target tương ứng. Nhờ vậy, bạn có thể truy cập vào các trình cung cấp các phần phụ thuộc của mục tiêu hiện tại.

Tham số

Thông số	Mô tả
allow_empty	bool; giá trị mặc định là True Đúng nếu thuộc tính có thể để trống.
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	trình tự của Nhãn; hoặc hàm; giá trị mặc định là [] Một 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 cung cấp khi tạo thực thể cho quy tắc.Sử dụng chuỗi hoặc hàm Label để chỉ định giá trị mặc định, chẳng hạn như attr.label_list(default = ["//a:b", "//a:c"]).
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
allow_files	bool; hoặc trình tự của chuỗi; hoặc None; giá trị mặc định là None Liệu File mục tiêu có được cho phép hay không. Có thể là True, False (mặc định) hoặc một danh sách đuôi tệp được phép (ví dụ: [".cc", ".cpp"]).
allow_rules	trình tự của chuỗi; hoặc None; mặc định là None Mục tiêu quy tắc nào (tên lớp) được phép. Tính năng này không còn được dùng nữa (chỉ giữ lại để đảm bảo khả năng tương thích), thay vào đó, hãy sử dụng nhà cung cấp.
providers	trình tự; giá trị mặc định là [] Các trình cung cấp phải được cung cấp qua bất kỳ phần phụ thuộc nào có trong thuộc tính này. Định dạng của đối số này là danh sách danh sách trình cung cấp – các đối tượng *Info do provider() trả về (hoặc tên chuỗi của trình cung cấp trong trường hợp nhà cung cấp cũ). Phần phụ thuộc phải trả về TẤT CẢ trình cung cấp được đề cập trong ít nhất ONE trong các danh sách bên trong. Để thuận tiện, đối số này cũng có thể là danh sách các trình cung cấp một cấp. Trong trường hợp đó, đối số này được bao bọc trong một danh sách ngoài có một phần tử. Bạn KHÔNG bắt buộc phải quy tắc của phần phụ thuộc quảng cáo các trình cung cấp đó trong tham số provides. Tuy nhiên, đây được coi là phương pháp hay nhất.
flags	trình tự của chuỗi; mặc định là [] Không được dùng nữa, sẽ bị xoá.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).
skip_validations	bool; giá trị mặc định là False Nếu đúng, các hành động 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	giá trị mặc định là None Cấu hình của thuộc tính. Đó có thể là "exec" (cho biết phần phụ thuộc này được tạo cho execution platform) hoặc "target" (cho biết phần phụ thuộc này đượ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 trong khi execution platform là Linux, macOS hoặc Windows.
aspects	trình tự của Khung hình; mặc định là [] Các khía cạnh cần áp dụng cho phần phụ thuộc hoặc 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 giản đồ cho thuộc tính đầu ra (nhãn).

Thuộc tính này chứa các giá trị Label duy nhất. 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 tương ứng với gói của mục tiêu đã tạo thực thể.

Tại thời điểm phân tích, bạn có thể truy xuất File tương ứng bằng ctx.outputs.

Tham số

Thông số	Mô tả
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).

output_list

Attribute attr.output_list(allow_empty=True, *, doc=None, mandatory=False)

Tạo giản đồ cho thuộc tính danh sách đầu ra.

Thuộc tính này chứa các giá trị Label duy nhất. 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 tương ứng với gói của mục tiêu đã tạo thực thể.

Tại thời điểm phân tích, bạn có thể truy xuất File tương ứng bằng ctx.outputs.

Tham số

Thông số	Mô tả
allow_empty	bool; giá trị mặc định là True Đúng nếu thuộc tính có thể để trống.
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).

string

Attribute attr.string(configurable=unbound, default='', doc=None, mandatory=False, values=[])

Tạo giản đồ cho thuộc tính chuỗi.

Tham số

Thông số	Mô tả
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	string; hoặc NativeComputedDefault; 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 được cung cấp khi tạo thực thể quy tắc.
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).
values	trình tự của chuỗi; 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)

Tạo giản đồ cho một thuộc tính chứa từ điển, trong đó khoá và giá trị là chuỗi.

Tham số

Thông số	Mô tả
allow_empty	bool; giá trị mặc định là True Đúng nếu thuộc tính có thể để trống.
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	dict; 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 được cung cấp khi tạo thực thể quy tắc.
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).

string_list

Attribute attr.string_list(mandatory=False, allow_empty=True, *, configurable=unbound, default=[], doc=None)

Tạo giản đồ cho thuộc tính danh sách chuỗi.

Tham số

Thông số	Mô tả
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).
allow_empty	bool; giá trị mặc định là True Đúng nếu thuộc tính có thể để trống.
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	trình tự của chuỗi; 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 cung cấp khi tạo thực thể quy tắc.
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.

string_list_dict

Attribute attr.string_list_dict(allow_empty=True, *, configurable=unbound, default={}, doc=None, mandatory=False)

Tạo giản đồ cho một thuộc tính chứa từ điển, trong đó khoá là chuỗi và giá trị là danh sách chuỗi.

Tham số

Thông số	Mô tả
allow_empty	bool; giá trị mặc định là True Đúng nếu thuộc tính có thể để trống.
configurable	bool; hoặc không bị ràng buộc; giá trị mặc định là unbound Bạn chỉ có thể chỉ định đối số này cho thuộc tính của macro biểu tượng. Nếu configurable được đặt rõ ràng thành False, thì thuộc tính macro biểu tượng sẽ không thể định cấu hình được – nói cách khác, thuộc tính này không thể nhận giá trị select(). Nếu configurable không được liên kết hoặc được đặt rõ ràng thành True, thì thuộc tính này có thể định cấu hình và có thể nhận giá trị select(). Đối với thuộc tính của một quy tắc hoặc khía cạnh, configurable phải không được liên kết. Hầu hết các thuộc tính quy tắc của Starlark luôn định cấu hình được, ngoại trừ các thuộc tính quy tắc attr.output(), attr.output_list() và attr.license() luôn không thể định cấu hình.
default	dict; 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 được cung cấp khi tạo thực thể quy tắc.
doc	string; hoặc None; giá trị mặc định là None Nội dung mô tả về thuộc tính có thể được trích xuất bằng các công cụ tạo tài liệu.
mandatory	bool; giá trị mặc định là False Nếu đúng, bạn phải chỉ định giá trị này một cách rõ ràng (ngay cả khi có default).