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

Bạn có thể tải các hàm sau đây từ @bazel_tools//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 tại 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.

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 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ữ đã trích xuất.

Quy tắc này dùng để sử 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ố

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 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 cần chạy để 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 chuỗi. Nếu giá trị boolean của tham số này là false, thì patch_cmds sẽ được sử 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á cần thực thi để áp dụng 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 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

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.

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

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

Thông số

orig bắt buộc.

từ điển các thuộc tính thực sự được đặt (một cách 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ừ điển các thuộc tính cần 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.

Thông số

netrc bắt buộc.

tệp netrc đã phân tích cú pháp thành từ điển, chẳng hạn như tệp thu được từ read_netrc

urls bắt buộc.

danh sách URL.

patterns bắt buộ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 TỆP KHÔNG GIAN LÀM VIỆC và tệp BUILD (nếu được yêu cầu).

Quy tắc này dùng để sử dụng trong hàm triển khai của quy tắc kho lưu trữ. Quy tắc 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à 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.