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

รายงานปัญหา ดูแหล่งที่มา รุ่นรายวัน · 8.0 · 7.4 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

ไม่แน่

maybe(repo_rule, name, kwargs)

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

การดำเนินการนี้มีไว้เพื่อใช้มาโคร repositories.bzl ที่ปลอดภัยซึ่งมีการอธิบายไว้ใน https://bazel.build/rules/deploying#dependencies

พารามิเตอร์

repo_rule ต้องระบุ

ฟังก์ชันกฎของที่เก็บ

name ต้องระบุ

ชื่อที่เก็บที่จะสร้าง

kwargs ไม่บังคับ

อาร์กิวเมนต์ที่เหลือซึ่งส่งไปยังฟังก์ชัน repo_rule

parse_netrc

parse_netrc(contents, filename)

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

พารามิเตอร์

contents ต้องระบุ

อินพุตสําหรับโปรแกรมแยกวิเคราะห์

filename ไม่บังคับ ค่าเริ่มต้นคือ None

ชื่อไฟล์ที่จะใช้ในข้อความแสดงข้อผิดพลาด (หากมี)

แพตช์

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

พารามิเตอร์

ctx ต้องระบุ

บริบทที่เก็บของกฎที่เก็บซึ่งเรียกใช้ฟังก์ชันยูทิลิตีนี้

patches ไม่บังคับ ค่าเริ่มต้นคือ None

ไฟล์แพตช์ที่จะใช้ รายการสตริง ป้ายกำกับ หรือเส้นทาง

patch_cmds ไม่บังคับ ค่าเริ่มต้นคือ None

คำสั่ง Bash เพื่อเรียกใช้การแพตช์ โดยส่งทีละรายการไปยัง bash -c รายการสตริง

patch_cmds_win ไม่บังคับ ค่าเริ่มต้นคือ None

คำสั่ง PowerShell เพื่อเรียกใช้การแพตช์ ซึ่งส่งทีละรายการไปยัง powershell /c รายการสตริง หากค่าบูลีนของพารามิเตอร์นี้เป็นเท็จ ระบบจะใช้ patch_cmds และละเว้นพารามิเตอร์นี้

patch_tool ไม่บังคับ ค่าเริ่มต้นคือ None

เส้นทางของเครื่องมือแพตช์ที่จะเรียกใช้เพื่อติดตั้งแพตช์ สตริง

patch_args ไม่บังคับ ค่าเริ่มต้นคือ None

อาร์กิวเมนต์ที่จะส่งไปยังเครื่องมือแพตช์ รายการสตริง

auth ไม่บังคับ ค่าเริ่มต้นคือ None

พจนานุกรมที่ไม่บังคับซึ่งระบุข้อมูลการตรวจสอบสิทธิ์สําหรับ URL บางรายการ

read_netrc

read_netrc(ctx, filename)

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

พารามิเตอร์

ctx ต้องระบุ

บริบทที่เก็บของกฎที่เก็บซึ่งเรียกใช้ฟังก์ชันยูทิลิตีนี้

filename ต้องระบุ

ชื่อไฟล์ .netrc ที่จะอ่าน

read_user_netrc

read_user_netrc(ctx)

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

พารามิเตอร์

ctx ต้องระบุ

บริบทที่เก็บของกฎที่เก็บซึ่งเรียกใช้ฟังก์ชันยูทิลิตีนี้

update_attrs

update_attrs(orig, keys, override)

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

ใช้เพื่อทําให้กฎทําซ้ำได้

พารามิเตอร์

orig ต้องระบุ

พจนานุกรมของแอตทริบิวต์ที่ตั้งค่าจริง (ทั้งแบบชัดแจ้งหรือโดยนัย) โดยการเรียกใช้กฎหนึ่งๆ

keys ต้องระบุ

ชุดแอตทริบิวต์ที่สมบูรณ์ซึ่งกําหนดไว้ในกฎนี้

override ต้องระบุ

dict ของแอตทริบิวต์ที่จะลบล้างหรือเพิ่มลงในต้นฉบับ

use_netrc

use_netrc(netrc, urls, patterns)

คํานวณคําแนะนําการเข้าสู่ระบบจากไฟล์ netrc ที่แยกวิเคราะห์แล้วและรายการ URL

พารามิเตอร์

netrc ต้องระบุ

ไฟล์ netrc ที่แยกวิเคราะห์เป็นพจนานุกรมแล้ว เช่น ที่ได้มาจาก read_netrc

urls ต้องระบุ

รายการ URL

patterns ต้องระบุ

พจนานุกรมรูปแบบ URL ที่ไม่บังคับสำหรับรูปแบบการให้สิทธิ์

workspace_and_buildfile

workspace_and_buildfile(ctx)

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

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

พารามิเตอร์

ctx ต้องระบุ

บริบทที่เก็บของกฎที่เก็บซึ่งเรียกใช้ฟังก์ชันยูทิลิตีนี้