sử dụng quy tắc kho lưu trữ

Các hàm sau đây có thể được tải 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 tìm nạp.

Thiết lập

Những phần mềm tiện ích này dành cho các quy tắc khác về kho lưu trữ. Chúng có thể được tải như sau.

load(
    "@bazel_tools//tools/build_defs/repo:utils.bzl",
    "workspace_and_buildfile",
    "patch",
    "update_attrs",
)

download_remote_files

load("@bazel//tools/build_defs/repo:utils.bzl", "download_remote_files")

download_remote_files(ctx, auth)

Hàm tiện ích để tải tệp từ xa xuống.

Quy tắc này được dùng trong chức năng triển khai của quy tắc kho lưu trữ. Hàm này giả định các tham số remote_file_urls và remote_file_integrity sẽ xuất hiện trong ctx.attr.

Tham số

get_auth

load("@bazel//tools/build_defs/repo:utils.bzl", "get_auth")

get_auth(ctx, urls)

Hàm tiện ích để lấy lệnh chính xác xác thực chính xác cho danh sách các URL trong tệp .netrc.

Hỗ trợ các thuộc tính netrc và auth_patterns không bắt buộc nếu có.

Tham số

Giá trị trả về

lệnh chính xác thực có thể được truyền đến kho_ctx.download

có thể

load("@bazel//tools/build_defs/repo:utils.bzl", "maybe")

maybe(repo_rule, name, **kwargs)

Hàm tiện ích chỉ dùng để thêm kho lưu trữ nếu chưa có kho lưu trữ.

Việc này là để triển khai repository.bzl macro an toàn được ghi lại trong https://bazel.build/rules/deploying#dependencies.

Tham số

Giá trị trả về

Không có gì, định nghĩa kho lưu trữ khi cần ở dạng hiệu ứng phụ.

parse_netrc

load("@bazel//tools/build_defs/repo:utils.bzl", "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ố

Giá trị trả về

dict ánh xạ tên máy với một dict với thông tin được cung cấp về họ

bản vá

load("@bazel//tools/build_defs/repo:utils.bzl", "patch")

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 chức năng triển khai của quy tắc kho lưu trữ. Nếu các tham số patches, patch_tool, patch_args, patch_cmds và patch_cmds_win chưa được chỉ định thì chúng sẽ được lấy từ ctx.attr.

Tham số

read_netrc

load("@bazel//tools/build_defs/repo:utils.bzl", "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ố

Giá trị trả về

dict ánh xạ tên máy với một dict với thông tin được cung cấp về họ

read_user_netrc

load("@bazel//tools/build_defs/repo:utils.bzl", "read_user_netrc")

read_user_netrc(ctx)

Đọc tệp netrc mặc định của người dùng.

Tham số

Giá trị trả về

dict ánh xạ tên máy với một lệnh dict kèm theo thông tin được cung cấp về chúng.

update_attrs

load("@bazel//tools/build_defs/repo:utils.bzl", "update_attrs")

update_attrs(orig, keys, override)

Hàm tiện ích 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ể.

Quy tắc này được dùng để tạo quy tắc có thể tái tạo.

Tham số

Giá trị trả về

nhập chính tả các thuộc tính có khoá từ chế độ ghi đè đã chèn/cập nhật

use_netrc

load("@bazel//tools/build_defs/repo:utils.bzl", "use_netrc")

use_netrc(netrc, urls, patterns)

Tính toán một lệnh chính xác xác thực từ một tệp netrc đã phân tích cú pháp và một danh sách các URL.

Tham số

Giá trị trả về

dict thích hợp làm đối số xác thực cho ctx.download; chính xác hơn, lệnh chính tả 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 chính tả chứa thông tin đăng nhập, mật khẩu và mẫu uỷ quyền tuỳ chọn tương ứng, cũng như việc liên kết "loại" thành "cơ bản" hoặc "pattern" (hoa văn).

workspace_and_buildfile

load("@bazel//tools/build_defs/repo:utils.bzl", "workspace_and_buildfile")

workspace_and_buildfile(ctx)

Hàm tiện ích để ghi WORKSPACE và nếu được yêu cầu, hãy thêm tệp BUILD.

Quy tắc này được dùng trong chức năng triển khai của một 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 sẽ trở thành có trong ctx.attr; bốn số sau có thể có giá trị Không có.

Tham số