Bạn có thể tải các hàm sau từ @bazel_tools//tools/build_defs/repo:utils.bzl.
có thể
maybe(repo_rule, name, kwargs)
Hàm tiện ích chỉ thêm kho lưu trữ nếu chưa có.
Đây là để triển khai macro repositories.bzl an toàn được ghi lại trong https://bazel.build/rules/deploying#dependencies.
Tham số
repo_rule |
bắt buộc.
hàm quy tắc kho lưu trữ. |
name |
bắt buộc.
tên của kho lưu trữ cần tạo. |
kwargs |
không bắt buộc.
các đối số còn lại được truyền đến hàm repo_rule. |
parse_netrc
parse_netrc(contents, filename)
Hàm tiện ích để phân tích cú pháp ít nhất một tệp .netrc cơ bản.
Tham số
contents |
bắt buộc.
đầu vào cho trình phân tích cú pháp. |
filename |
không bắt buộc. mặc định là None
tên tệp để sử dụng trong thông báo lỗi (nếu có). |
bản vá
patch(ctx, patches, patch_cmds, patch_cmds_win, patch_tool, patch_args, auth)
Triển khai việc vá một kho lưu trữ đã được trích xuất.
Quy tắc này được dùng trong hàm triển khai của quy tắc kho lưu trữ. Nếu bạn không chỉ định các tham số patches, patch_tool, patch_args, patch_cmds và patch_cmds_win, thì các tham số này sẽ được lấy từ ctx.attr.
Tham số
ctx |
bắt buộc.
Ngữ cảnh kho lưu trữ của quy tắc kho lưu trữ gọi hàm tiện ích này. |
patches |
không bắt buộc. mặc định là None
Các tệp bản vá cần áp dụng. Danh sách chuỗi, Nhãn hoặc đường dẫn. |
patch_cmds |
không bắt buộc. mặc định là None
Các lệnh Bash để chạy nhằm vá, được truyền lần lượt vào bash -c. Danh sách chuỗi |
patch_cmds_win |
không bắt buộc. mặc định là None
Các lệnh Powershell để chạy cho việc vá, được truyền lần lượt đến powershell /c. Danh sách chuỗi. Nếu giá trị boolean của tham số này là false, patch_cmds sẽ được sử dụng và tham số này sẽ bị bỏ qua. |
patch_tool |
không bắt buộc. mặc định là None
Đường dẫn của công cụ vá để thực thi việc áp dụng bản vá. Chuỗi. |
patch_args |
không bắt buộc. mặc định là None
Đối số để truyền đến công cụ vá. Danh sách chuỗi. |
auth |
không bắt buộc. mặc định là None
Một tập hợp từ điển không bắt buộc chỉ định thông tin xác thực cho một số URL. |
read_netrc
read_netrc(ctx, filename)
Hàm tiện ích để phân tích cú pháp ít nhất một tệp .netrc cơ bản.
Tham số
ctx |
bắt buộc.
Ngữ cảnh kho lưu trữ của quy tắc kho lưu trữ gọi hàm tiện ích này. |
filename |
bắt buộc.
tên của tệp .netrc cần đọc |
read_user_netrc
read_user_netrc(ctx)
Đọc tệp netrc mặc định của người dùng.
Tham số
ctx |
bắt buộc.
Ngữ cảnh kho lưu trữ của quy tắc kho lưu trữ gọi hàm tiện ích này. |
update_attrs
update_attrs(orig, keys, override)
Hàm tiện ích để thay đổi và thêm các thuộc tính đã chỉ định vào một lệnh gọi quy tắc kho lưu trữ cụ thể.
Phương thức này dùng để tạo quy tắc có thể tái tạo.
Tham số
orig |
bắt buộc.
dict của các thuộc tính đã đặt thực sự (rõ ràng hoặc ngầm ẩn) theo một lệnh gọi quy tắc cụ thể |
keys |
bắt buộc.
tập hợp đầy đủ các thuộc tính được xác định trên quy tắc này |
override |
bắt buộc.
tập hợp các thuộc tính để ghi đè hoặc thêm vào orig |
use_netrc
use_netrc(netrc, urls, patterns)
Tính toán một từ điển xác thực từ tệp netrc đã phân tích cú pháp và danh sách URL.
Tham số
netrc |
bắt buộc.
tệp netrc đã được phân tích cú pháp thành một từ điển, ví dụ: như được lấy từ read_netrc |
urls |
bắt buộc.
danh sách URL. |
patterns |
bắt buộc.
tập hợp các từ điển không bắt buộc của URL đến các mẫu uỷ quyền |
workspace_and_buildfile
workspace_and_buildfile(ctx)
Hàm tiện ích để ghi WORKSPACE và tệp BUILD (nếu được yêu cầu).
Quy tắc này được dùng trong hàm triển khai của quy tắc kho lưu trữ.
Hàm này giả định các tham số name, build_file, build_file_content, workspace_file và workspace_file_content có trong ctx.attr; 4 tham số sau có thể có giá trị là Không.
Tham số
ctx |
bắt buộc.
Ngữ cảnh kho lưu trữ của quy tắc kho lưu trữ gọi hàm tiện ích này. |