gốc

Một mô-đun tích hợp sẵn để hỗ trợ các quy tắc gốc và các hàm trợ giúp gói khác. Tất cả các quy tắc gốc sẽ xuất hiện dưới dạng hàm trong mô-đun này, ví dụ: native.cc_library. Xin lưu ý rằng mô-đun gốc chỉ có trong giai đoạn tải (tức là cho các macro, chứ không phải để triển khai quy tắc). Các thuộc tính sẽ bỏ qua các giá trị None và xử lý các giá trị đó như thể thuộc tính chưa được đặt.
Bạn cũng có thể dùng các hàm sau:

Hội viên

existing_rule

unknown native.existing_rule(name)

Trả về một đối tượng giống lệnh chính tả không thể thay đổi mô tả các thuộc tính của một quy tắc được tạo thực thể trong gói của luồng này hoặc None nếu không có thực thể quy tắc nào có tên đó.

Ở đâ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().

Nếu bạn đặt cờ --noincompatible_existing_rules_immutable_view, thì hàm này sẽ trả về một tập hợp con mới có thể thay đổi với cùng nội dung.

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, lệnh chính tả còn 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ả biểu thị các giá trị thuộc tính như sau:

  • Các thuộc tính kiểu str, int và bool được biểu thị nguyên trạng.
  • 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 kiểu.
  • Giá trị select được trả về cùng với nội dung của các giá trị đó đã biế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 làm cho tệp BUILD trở nên dễ vỡ 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.

Thông số

Thông số Mô tả
name bắt buộc
Tên của mục tiêu.

existing_rules

unknown native.existing_rules()

Trả về một đối tượng giống lệnh không thể thay đổi mô tả các quy tắc được tạo thực thể cho đến nay trong gói của luồng này. Mỗi mục của đối tượng giống như tập hợp từ điển sẽ liên kết tên của thực thể quy tắc với kết quả mà existing_rule(name) trả về.

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

Nếu bạn đặt cờ --noincompatible_existing_rules_immutable_view, thì hàm này sẽ trả về một tập hợp con mới có thể thay đổi với cùng nội dung.

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ự. Hơn nữa, nếu bạn đặt cờ --noincompatible_existing_rules_immutable_view , thì hàm này có thể sẽ rất tốn kém, đặc biệt là khi được gọi trong vòng lặp.

exports_files

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

Chỉ định danh sách các tệp thuộc gói này được xuất sang các gói khác.

Thông số

Thông số Mô tả
srcs sequence of strings; bắt buộc
Danh sách tệp cần xuất.
visibility sequence; or None; mặc định = Không có
Bạn có thể chỉ định nội dung khai báo về chế độ hiển thị. Các tệp sẽ hiển thị cho các mục tiêu đã chỉ định. Nếu bạn không chỉ định chế độ hiển thị, thì mọi gói sẽ xem được các tệp này.
licenses sequence of strings; or None; mặc định = Không có
Giấy phép cần chỉ định.

hình cầu

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

Glob trả về một danh sách mới, có thể thay đổi, được sắp xếp của mọi tệp trong gói hiện tại:
  • Khớp với ít nhất một mẫu trong include.
  • Không khớp với mẫu nào trong exclude (mặc định là []).
Nếu đối số exclude_directories được bật (được đặt thành 1), các tệp thuộc thư mục loại sẽ bị loại khỏi kết quả (1 mặc định).

Thông số

Thông số Mô tả
include sequence of strings; mặc định = []
Danh sách các mẫu cụm cầu cần đưa vào.
exclude sequence of strings; mặc định = []
Danh sách các mẫu cụm cầu cần loại trừ.
exclude_directories mặc định = 1
Cờ cho biết có loại trừ thư mục hay không.
allow_empty mặc định = không liên kết
Liệu chúng ta có cho phép các mẫu toàn cầu để không khớp không có giá trị nào. Nếu "allow_empty" là False, thì mỗi mẫu bao gồm riêng lẻ phải khớp với một nội dung nào đó và kết quả cuối cùng cũng phải có nội dung (sau khi loại trừ các kết quả khớp với mẫu "exclude").

package_group

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

Hàm này xác định một nhóm gói và gán nhãn cho nhóm đó. Bạn có thể tham chiếu nhãn trong các thuộc tính visibility.

Thông số

Thông số Mô tả
name bắt buộc
Tên duy nhất cho quy tắc này.
packages sequence of strings; default = []
Liệt kê đầy đủ các gói trong nhóm này.
includes sequence of strings; default = []
Các nhóm gói khác có trong nhóm này.

package_name

string native.package_name()

Tên của gói đang được đánh giá. Ví dụ: trong tệp BUILD some/package/BUILD, giá trị của tệp này sẽ là some/package. Nếu tệp BUILD gọi một hàm được xác định trong tệp .bzl, thì package_name() sẽ khớp với gói tệp BUILD của phương thức gọi. Hàm này tương đương với biến PACKAGE_NAME không dùng nữa.

package_relative_label

Label native.package_relative_label(input)

Chuyển đổi chuỗi đầu vào thành đối tượng Label (Nhãn) trong ngữ cảnh của gói đang được khởi chạy (tức là tệp BUILD mà macro hiện tại đang thực thi). Nếu dữ liệu đầu vào đã là Label, thì dữ liệu này sẽ được trả về mà không thay đổi.

Hàm này chỉ có thể được gọi trong khi đánh giá tệp BUILD và các macro mà hàm này gọi trực tiếp hoặc gián tiếp; nó có thể không được gọi trong (ví dụ) trong hàm triển khai quy tắc.

Kết quả của hàm này giống với giá trị Label như được tạo bằng cách truyền chuỗi đã cho vào thuộc tính nhãn có giá trị của mục tiêu được khai báo trong tệp BUILD.

Lưu ý sử dụng: Sự khác biệt giữa hàm này và Label() là Label() sử dụng ngữ cảnh của gói của tệp .bzl được gọi, chứ không phải gói của tệp BUILD. Sử dụng Label() khi bạn cần tham chiếu đến một mục tiêu cố định được mã hoá cứng vào macro, chẳng hạn như trình biên dịch. Sử dụng package_relative_label() khi bạn cần chuẩn hoá chuỗi nhãn mà tệp BUILD cung cấp cho đối tượng Label. (Không có cách nào để chuyển đổi chuỗi thành Label trong ngữ cảnh gói khác ngoài tệp BUILD hoặc tệp .bzl đang gọi. Do đó, các macro bên ngoài phải luôn ưu tiên truyền đối tượng Nhãn đến các macro bên trong thay vì chuỗi nhãn.)

Thông số

Thông số Mô tả
input string; or Label; bắt buộc
Chuỗi nhãn đầu vào hoặc đối tượng Nhãn. Nếu một đối tượng Nhãn được truyền, đối tượng đó sẽ được trả về nguyên trạng.

repository_name

string native.repository_name()

Tên của kho lưu trữ mà quy tắc hoặc tiện ích bản dựng được gọi từ đó. Ví dụ: trong các gói được gọi là tồn tại theo khổ WORKSPACE local_repository(name='local', path=...), thì gói này sẽ được đặt thành @local. Trong các gói trong kho lưu trữ chính, giá trị này sẽ được đặt thành @. Hàm này tương đương với biến REPOSITORY_NAME không dùng nữa.

gói con

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

Trả về một danh sách mới có thể thay đổi của mọi gói con trực tiếp của gói hiện tại, bất kể độ sâu thư mục hệ thống tệp. Danh sách được trả về được sắp xếp và chứa tên của các gói con liên quan đến gói hiện tại. Bạn nên sử dụng các phương thức trong mô-đun bazel_skylib.subpackages thay vì gọi trực tiếp hàm này.

Thông số

Thông số Mô tả
include sequence of strings; bắt buộc
Danh sách các mẫu cầu cầu cần đưa vào khi quét gói con.
exclude sequence of strings; mặc định = []
Danh sách các mẫu cầu cầu cần loại trừ khỏi quá trình quét gói con.
allow_empty mặc định = Sai
Liệu chúng ta có gặp lỗi hay không nếu lệnh gọi trả về danh sách trống. Theo mặc định, danh sách trống cho biết lỗi tiềm ẩn trong tệp BUILD, trong đó lệnh gọi đến subpackages() là thừa. Nếu bạn đặt thành true, thì hàm này có thể thành công trong trường hợp đó.