กฎ
sh_binary
ดูแหล่งที่มาของกฎsh_binary(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, exec_compatible_with, exec_properties, features, licenses, output_licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
ใช้กฎ sh_binary
เพื่อประกาศสคริปต์เชลล์ที่สั่งการได้
(sh_binary
เป็นคำที่สะกดผิด: เอาต์พุตอาจไม่ใช่ไบนารีเสมอไป) กฎนี้ดูแลให้มีการสร้างทรัพยากร Dependency ทั้งหมดและปรากฏในพื้นที่ runfiles
ขณะดำเนินการ
เราขอแนะนำให้คุณตั้งชื่อกฎ sh_binary()
หลังชื่อของสคริปต์ลบด้วยนามสกุล (เช่น .sh
) ชื่อกฎและชื่อไฟล์ต้องแตกต่างกัน
sh_binary
เคารพหน้าม้า ดังนั้นสามารถใช้ล่ามใดก็ได้ที่มีอยู่ (เช่น
#!/bin/zsh
)
ตัวอย่าง
สำหรับสคริปต์ Shell แบบง่ายที่ไม่มีทรัพยากร Dependency และไฟล์ข้อมูลบางส่วน ให้ทำดังนี้
sh_binary( name = "foo", srcs = ["foo.sh"], data = glob(["datafiles/*.txt"]), )
อาร์กิวเมนต์
Attributes | |
---|---|
name |
ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ |
deps
|
รายการป้ายกำกับ ค่าเริ่มต้นคือ deps ได้ที่แอตทริบิวต์ทั่วไปที่กำหนดโดยกฎบิลด์ส่วนใหญ่
แอตทริบิวต์นี้ควรใช้เพื่อแสดงกฎ |
srcs
|
รายการป้ายกำกับ ต้องระบุ ไฟล์ที่มีสคริปต์ Shell
แอตทริบิวต์นี้ต้องเป็นรายการ Singleton ซึ่งมีองค์ประกอบที่เป็นสคริปต์ Shell
สคริปต์นี้ต้องเป็นไฟล์ปฏิบัติการและอาจเป็นไฟล์ต้นฉบับหรือไฟล์ที่สร้างขึ้น
ไฟล์อื่นๆ ทั้งหมดที่ต้องใช้ขณะรันไทม์ (ไม่ว่าจะเป็นสคริปต์หรือข้อมูล) จะอยู่ในแอตทริบิวต์ |
sh_library
ดูแหล่งที่มาของกฎsh_library(name, deps, srcs, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
การใช้งานหลักของกฎนี้คือการรวบรวม "ไลบรารี" เชิงตรรกะที่ประกอบด้วยสคริปต์ที่เกี่ยวข้องกัน ซึ่งเป็นโปรแกรมในภาษาที่แปลโดยอินเทอร์พรีเตอร์ที่ไม่ต้องคอมไพล์หรือลิงก์ เช่น Bourne Shell และข้อมูลใดๆ ที่โปรแกรมเหล่านั้นต้องการขณะรันไทม์ จากนั้นคุณจะใช้ "ไลบรารี" ดังกล่าวจากแอตทริบิวต์ data
ของกฎ sh_binary
ได้อย่างน้อย 1 รายการ
คุณสามารถใช้กฎ filegroup
เพื่อรวมไฟล์ข้อมูลได้
ในภาษาโปรแกรมที่แปลโดยอินเทอร์พรีเตอร์ ไม่มีความแตกต่างที่ชัดเจนระหว่าง "โค้ด" กับ "ข้อมูล" เสมอไป เพราะท้ายที่สุดแล้ว โปรแกรมเป็นเพียง "ข้อมูล" จากมุมมองของล่าม ด้วยเหตุนี้ กฎนี้จึงมีแอตทริบิวต์ 3 รายการซึ่งล้วนเหมือนกันทุกประการคือ srcs
, deps
และ data
การใช้งานในปัจจุบันไม่ได้แยกความแตกต่างระหว่างองค์ประกอบของรายการเหล่านี้
แอตทริบิวต์ทั้ง 3 รายการจะยอมรับกฎ ไฟล์แหล่งที่มา และไฟล์ที่สร้างขึ้น
อย่างไรก็ตาม คุณควรใช้แอตทริบิวต์ตามวัตถุประสงค์ปกติ (เช่นเดียวกับกฎอื่นๆ)
ตัวอย่าง
sh_library( name = "foo", data = [ ":foo_service_script", # an sh_binary with srcs ":deploy_foo", # another sh_binary with srcs ], )
อาร์กิวเมนต์
Attributes | |
---|---|
name |
ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ |
deps
|
รายการป้ายกำกับ ค่าเริ่มต้นคือ deps ได้ที่แอตทริบิวต์ทั่วไปที่กำหนดโดยกฎบิลด์ส่วนใหญ่
แอตทริบิวต์นี้ควรใช้เพื่อแสดงกฎ |
srcs
|
รายการป้ายกำกับ ค่าเริ่มต้นคือ
แอตทริบิวต์นี้ควรใช้เพื่อแสดงรายการไฟล์ต้นทางของสคริปต์ Shell ที่อยู่ในไลบรารีนี้ สคริปต์โหลดสคริปต์อื่นๆ ได้โดยใช้คำสั่ง |
sh_test
ดูแหล่งที่มาของกฎsh_test(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, licenses, local, restricted_to, shard_count, size, tags, target_compatible_with, testonly, timeout, toolchains, visibility)
กฎ sh_test()
จะสร้างการทดสอบที่เขียนเป็นสคริปต์ Shell ของ Bourne
ดู แอตทริบิวต์ทั่วไปในกฎการทดสอบทั้งหมด (*_test)
ตัวอย่าง
sh_test( name = "foo_integration_test", size = "small", srcs = ["foo_integration_test.sh"], deps = [":foo_sh_lib"], data = glob(["testdata/*.txt"]), )
อาร์กิวเมนต์
Attributes | |
---|---|
name |
ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ |
deps
|
รายการป้ายกำกับ ค่าเริ่มต้นคือ deps ได้ที่แอตทริบิวต์ทั่วไปที่กำหนดโดยกฎบิลด์ส่วนใหญ่
แอตทริบิวต์นี้ควรใช้เพื่อแสดงกฎ |
srcs
|
รายการป้ายกำกับ ต้องระบุ ไฟล์ที่มีสคริปต์ Shell
แอตทริบิวต์นี้ต้องเป็นรายการ Singleton ซึ่งมีองค์ประกอบที่เป็นสคริปต์ Shell
สคริปต์นี้ต้องเป็นไฟล์ปฏิบัติการและอาจเป็นไฟล์ต้นฉบับหรือไฟล์ที่สร้างขึ้น
ไฟล์อื่นๆ ทั้งหมดที่ต้องใช้ขณะรันไทม์ (ไม่ว่าจะเป็นสคริปต์หรือข้อมูล) จะอยู่ในแอตทริบิวต์ |