XÂY DỰNG các tệp

Các phương thức có trong tệp BUILD. Hãy xem thêm Bách khoa toàn thư về bản dựng để biết thêm functions và quy tắc bản dựng. Bạn cũng có thể sử dụng các hàm và quy tắc này trong tệp BUILD.

Hội viên

• depset
• existing_rule
• existing_rules
• exports_files
• glob
• module_name
• module_version
• gói
• package_group
• package_name
• package_relative_label
• repo_name
• repository_name
• chọn
• gói con

depset

depset depset(direct=None, order="default", *, transitive=None)

Tất cả phần tử (trực tiếp và gián tiếp) của một depset phải thuộc cùng một loại, như được biểu thức type(x) trả về.

Vì tập hợp dựa trên hàm băm được dùng để loại bỏ các phần tử trùng lặp trong quá trình lặp lại, nên tất cả các phần tử của một tập hợp phần phụ thuộc phải có thể băm. Tuy nhiên, hằng số này hiện không được kiểm tra nhất quán trong tất cả hàm khởi tạo. Sử dụng cờ --incompatible_always_check_depset_elements để bật tính năng kiểm tra nhất quán; đây sẽ là hành vi mặc định trong các bản phát hành sau này; xem Vấn đề 10313.

Ngoài ra, các phần tử hiện phải không thể thay đổi, mặc dù quy định hạn chế này sẽ được nới lỏng trong tương lai.

Thứ tự của nhóm phần phụ thuộc được tạo phải tương thích với thứ tự của các nhóm phần phụ thuộc transitive. Thứ tự "default" tương thích với mọi thứ tự khác, tất cả các thứ tự khác chỉ tương thích với chính chúng.

Tham số

existing_rule

unknown existing_rule(name)

Ở đây, đối tượng giống như tập hợp không thể thay đổi có nghĩa là một đối tượng x không thể thay đổi sâu sắc hỗ trợ hoạt động lặp lại giống như tập hợp, len(x), name in x, x[name], x.get(name), x.items(), x.keys() và x.values().

Kết quả chứa một mục nhập cho mỗi thuộc tính, ngoại trừ các thuộc tính riêng tư (tên không bắt đầu bằng chữ cái) và một số loại thuộc tính cũ không thể biểu thị. Ngoài ra, tập hợp này chứa các mục nhập cho name và kind của thực thể quy tắc (ví dụ: 'cc_binary').

Các giá trị của kết quả đại diện cho các giá trị thuộc tính như sau:

• Các thuộc tính thuộc loại str, int và bool được biểu thị như hiện có.
• Nhãn được chuyển đổi thành chuỗi có dạng ':foo' cho các mục tiêu trong cùng một gói hoặc '//pkg:name' cho các mục tiêu trong một gói khác.
• Danh sách được biểu thị dưới dạng các bộ dữ liệu và các từ điển được chuyển đổi thành các từ điển mới, có thể thay đổi. Các phần tử của chúng được chuyển đổi đệ quy theo cùng một cách.
• Các giá trị select được trả về với nội dung được chuyển đổi như mô tả ở trên.
• Những thuộc tính không có giá trị được chỉ định trong quá trình tạo bản sao quy tắc và có giá trị mặc định được tính toán sẽ bị loại trừ khỏi kết quả. (Không thể tính toán giá trị mặc định được tính toán cho đến giai đoạn phân tích).

Nếu có thể, hãy tránh sử dụng hàm này. Điều này khiến các tệp BUILD trở nên dễ hỏng và phụ thuộc vào thứ tự. Ngoài ra, hãy lưu ý rằng cách chuyển đổi này khác một chút so với hai cách chuyển đổi khác của giá trị thuộc tính quy tắc từ dạng nội bộ sang Starlark: một cách được sử dụng bởi giá trị mặc định được tính toán, cách còn lại được sử dụng bởi ctx.attr.foo.

Tham số

existing_rules

unknown existing_rules()

Ở đây, đối tượng giống như tập hợp không thể thay đổi có nghĩa là một đối tượng x không thể thay đổi sâu sắc hỗ trợ hoạt động lặp lại giống như tập hợp, len(x), name in x, x[name], x.get(name), x.items(), x.keys() và x.values().

Lưu ý: Nếu có thể, hãy tránh sử dụng hàm này. Điều này khiến các tệp BUILD trở nên dễ hỏng và phụ thuộc vào thứ tự.

exports_files

None exports_files(srcs, visibility=None, licenses=None)

sequence glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)

string module_name()

string module_version()

unknown package(**kwargs)

None package_group(name, packages=[], includes=[])

string package_name()

Label package_relative_label(input)

string repo_name()

string repository_name()

unknown select(x, no_match_error='')

sequence subpackages(include, exclude=[], allow_empty=False)