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

Bạn có thể tải các hàm sau từ @bazel_tools//tools/build_defs/repo:utils.bzl.

Các tiện ích để thao tác với kho lưu trữ bên ngoài sau khi tìm nạp.

Thiết lập

Các tiện ích này được dùng cho các quy tắc kho lưu trữ khác. Bạn có thể tải các tiện ích này 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.

Quy tắc này được dùng trong hàm triển khai của quy tắc kho lưu trữ. Quy tắc này giả định rằng các tham số remote_file_urls và remote_file_integrity có trong ctx.attr.

Thông số

get_auth

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

get_auth(ctx, urls)

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

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

Thông số

Giá trị trả về

từ điển xác thực có thể được truyền đến repository_ctx.download

maybe

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

maybe(repo_rule, name, **kwargs)

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

Hàm này dùng để triển khai macro repositories.bzl an toàn được ghi lại trong https://bazel.build/rules/deploying#dependencies.

Thông số

Giá trị trả về

Không có gì, xác định kho lưu trữ khi cần dưới dạng tác dụ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.

Thông số

Giá trị trả về

từ điển liên kết tên máy với một từ điển chứa thông tin được cung cấp về các tên máy đó

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 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.

Thông 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.

Thông số

Giá trị trả về

từ điển liên kết tên máy với một từ điển chứa thông tin được cung cấp về các tên máy đó

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.

Thông số

Giá trị trả về

từ điển liên kết tên máy với một từ điển chứa thông tin được cung cấp về các tên máy đó.

update_attrs

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

update_attrs(orig, keys, override)

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

Hàm này dùng để tạo một quy tắc có thể tái tạo.

Thông số

Giá trị trả về

từ điển của các thuộc tính có các khoá từ ghi đè được 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 từ điển xác thực từ tệp netrc đã phân tích cú pháp và danh sách URL.

Thông số

Giá trị trả về

từ điển phù hợp làm đối số xác thực cho ctx.download; cụ thể hơn, từ điển sẽ liên kết tất cả URL mà tệp netrc cung cấp thông tin đăng nhập và mật khẩu với một từ điển chứa thông tin đăng nhập, mật khẩu và mẫu uỷ quyền không bắt buộc tương ứng, cũng như mối liên kết của "type" với "basic" hoặc "pattern".

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à 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ữ. Quy tắc này giả định rằng 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à None.

Thông số