ใช้กฎที่เก็บ

คุณโหลดฟังก์ชันต่อไปนี้ได้จาก @bazel_tools//tools/build_defs/repo:utils.bzl

ยูทิลิตีสำหรับการจัดการที่เก็บภายนอกเมื่อดึงข้อมูลแล้ว

ตั้งค่า

โดยยูทิลิตีเหล่านี้มีไว้สำหรับใช้กับกฎของที่เก็บอื่นๆ โดยสามารถโหลดได้ดังนี้

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)

ฟังก์ชันยูทิลิตีสำหรับการดาวน์โหลดไฟล์ระยะไกล

กฎนี้มีไว้ใช้ในฟังก์ชันการใช้งานของกฎที่เก็บ โดยจะถือว่าพารามิเตอร์ remote_file_urls และ remote_file_integrity อยู่ใน ctx.attr

พารามิเตอร์

get_auth

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

get_auth(ctx, urls)

ฟังก์ชันยูทิลิตีเพื่อรับพจนานุกรมการตรวจสอบสิทธิ์ที่ถูกต้องสำหรับรายการ URL จากไฟล์ .netrc

รองรับแอตทริบิวต์ netrc และ auth_patterns ที่ไม่บังคับ หากมี

พารามิเตอร์

การคืนสินค้า

พจนานุกรมการตรวจสอบสิทธิ์ที่ส่งไปยัง repository_ctx.download ได้

อาจจะ

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

maybe(repo_rule, name, kwargs)

ฟังก์ชันยูทิลิตีสําหรับการเพิ่มที่เก็บข้อมูลเฉพาะในกรณีที่ยังไม่มี

ซึ่งเป็นการใช้แมโคร safe_repositories.bzl ที่ระบุไว้ใน https://bazel.build/rules/deploying#dependencies

พารามิเตอร์

การคืนสินค้า

ไม่มีอะไรเลย กำหนดที่เก็บเมื่อจำเป็นเป็นผลข้างเคียง

parse_netrc

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

parse_netrc(contents, filename)

ฟังก์ชันยูทิลิตีเพื่อแยกวิเคราะห์ไฟล์ .netrc ขั้นพื้นฐานอย่างน้อย

พารามิเตอร์

การคืนสินค้า

การแมป dict ชื่อเครื่องกับ dict ที่มีข้อมูลที่ระบุ เกี่ยวกับเครื่อง

แพตช์

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

patch(ctx, patches, patch_cmds, patch_cmds_win, patch_tool, patch_args, auth)

การติดตั้งใช้งานการแก้ไขที่เก็บที่แยกออกมาแล้ว

กฎนี้มีไว้ใช้ในฟังก์ชันการใช้งานของกฎที่เก็บ หากไม่ได้ระบุพารามิเตอร์ patches, patch_tool, patch_args, patch_cmds และ patch_cmds_win ระบบจะนำค่าจาก ctx.attr มาใช้

พารามิเตอร์

read_netrc

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

read_netrc(ctx, filename)

ฟังก์ชันยูทิลิตีเพื่อแยกวิเคราะห์ไฟล์ .netrc ขั้นพื้นฐานอย่างน้อย

พารามิเตอร์

การคืนสินค้า

การแมป dict ชื่อเครื่องกับ dict ที่มีข้อมูลที่ระบุ เกี่ยวกับเครื่อง

read_user_netrc

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

read_user_netrc(ctx)

อ่านไฟล์ .netrc เริ่มต้นของผู้ใช้

พารามิเตอร์

การคืนสินค้า

การแมป dict ชื่อเครื่องกับ dict ที่มีข้อมูลที่ระบุเกี่ยวกับเครื่อง

update_attrs

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

update_attrs(orig, keys, override)

ฟังก์ชันยูทิลิตีสำหรับการแก้ไขและเพิ่มแอตทริบิวต์ที่ระบุในการเรียกใช้กฎที่เก็บที่เฉพาะเจาะจง

ซึ่งใช้เพื่อทำให้กฎสามารถทำซ้ำได้

พารามิเตอร์

การคืนสินค้า

พจนานุกรมของแอตทริบิวต์ที่มีคีย์จากการแทนที่ที่แทรก/อัปเดต

use_netrc

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

use_netrc(netrc, urls, patterns)

คำนวณพจนานุกรมการตรวจสอบสิทธิ์จากไฟล์ .netrc ที่แยกวิเคราะห์แล้วและรายการ URL

พารามิเตอร์

การคืนสินค้า

dict เหมาะสมเป็นอาร์กิวเมนต์การตรวจสอบสิทธิ์สำหรับ ctx.download กล่าวคือ dict จะแมป URL ทั้งหมดที่ไฟล์ .netrc ระบุข้อมูลเข้าสู่ระบบและรหัสผ่านไปยัง dict ที่มีข้อมูลเข้าสู่ระบบ รหัสผ่าน และรูปแบบการให้สิทธิ์ที่ไม่บังคับที่เกี่ยวข้อง รวมถึงการแมป "type" เป็น "basic" หรือ "pattern"

workspace_and_buildfile

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

workspace_and_buildfile(ctx)

ฟังก์ชันยูทิลิตีสำหรับการเขียนไฟล์ BUILD

กฎนี้มีไว้ใช้ในฟังก์ชันการใช้งานของกฎที่เก็บ โดยจะถือว่าพารามิเตอร์ name, build_file และ build_file_content อยู่ใน ctx.attr โดย 2 พารามิเตอร์หลังอาจมีค่าเป็น None

พารามิเตอร์