Bạn có thể tải các hàm sau đây từ @bazel_tools//tools/build_defs/repo:utils.bzl.
Tiện ích để thao tác với các kho lưu trữ bên ngoài sau khi được tìm nạp.
Thiết lập
Các tiện ích này được dùng cho các quy tắc khác của kho lưu trữ. Bạn có thể tải các tệp này như sau.
load(
"@bazel_tools//tools/build_defs/repo:utils.bzl",
"workspace_and_buildfile",
"patch",
"update_attrs",
)
có thể
maybe(repo_rule, name, kwargs)
Hàm tiện ích chỉ thêm một kho lưu trữ nếu kho lưu trữ đó 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.
Thông 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. |
Giá trị trả về
Không có gì, xác định kho lưu trữ khi cần thiết như một tác dụng phụ.
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.
Thông 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. giá trị mặc định là None
tên tệp để sử dụng trong thông báo lỗi (nếu có). |
Giá trị trả về
dict ánh xạ tên máy đến dict có thông tin được cung cấp về chúng
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 một 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.
Thông 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. giá trị mặc định là None
Các tệp bản vá cần áp dụng. Danh sách các chuỗi, nhãn hoặc đường dẫn. |
patch_cmds |
không bắt buộc. giá trị mặc định là None
Các lệnh Bash để chạy cho việc vá, được truyền từng lệnh một đến bash -c. Danh sách chuỗi |
patch_cmds_win |
không bắt buộc. giá trị mặc định là None
Các lệnh Powershell cần chạy để vá, được truyền từng lệnh một đến powershell /c. Danh sách các chuỗi. Nếu giá trị boolean của tham số này là false, thì patch_cmds sẽ được dùng và tham số này sẽ bị bỏ qua. |
patch_tool |
không bắt buộc. giá trị mặc định là None
Đường dẫn của công cụ vá để thực thi cho việc áp dụng các bản vá. Chuỗi. |
patch_args |
không bắt buộc. giá trị mặc định là None
Các đối số cần truyền đến công cụ vá. Danh sách các chuỗi. |
auth |
không bắt buộc. giá trị mặc định là None
Một 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.
Thông 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 |
Giá trị trả về
dict ánh xạ tên máy đến dict có thông tin được cung cấp về chúng
read_user_netrc
read_user_netrc(ctx)
Đọc tệp netrc mặc định của người dùng.
Thông 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. |
Giá trị trả về
dict ánh xạ tên máy đến dict có thông tin được cung cấp về các tên máy đó.
update_attrs
update_attrs(orig, keys, override)
Hàm số hiệu dụng để thay đổi và thêm các thuộc tính được chỉ định vào một lệnh gọi quy tắc kho lưu trữ cụ thể.
Điều này được dùng để tạo ra một quy tắc có thể tái tạo.
Thông số
orig |
bắt buộc.
dict gồm các thuộc tính thực sự được đặt (một cách rõ ràng hoặc ngầm ẩn) bằng 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.
dict thuộc tính để ghi đè hoặc thêm vào orig |
Giá trị trả về
dict gồm các thuộc tính có khoá được chèn/cập nhật từ override
use_netrc
use_netrc(netrc, urls, patterns)
Tính toán một từ điển uỷ quyền từ tệp netrc đã phân tích cú pháp và danh sách URL.
Thông 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ư nhận được từ read_netrc |
urls |
bắt buộc.
một danh sách URL. |
patterns |
bắt buộc.
từ điển không bắt buộc về URL đến các mẫu uỷ quyền |
Giá trị trả về
dict phù hợp làm đối số uỷ quyền cho ctx.download; chính xác hơn, dict sẽ ánh xạ tất cả các URL mà tệp netrc cung cấp thông tin đăng nhập và mật khẩu thành một dict chứa thông tin đăng nhập, mật khẩu tương ứng và mẫu uỷ quyền không bắt buộc, cũng như việc ánh xạ "type" thành "basic" hoặc "pattern".
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 một quy tắc kho lưu trữ.
Thành phần 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ị None.
Thông 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. |