ฟังก์ชัน

เนื้อหา

• แพ็กเกจ
• package_group
• exports_files
• โลก
• select
• subpackages

พัสดุ

package(default_deprecation, default_package_metadata, default_testonly, default_visibility, features)

ฟังก์ชันนี้จะประกาศข้อมูลเมตาที่ใช้กับกฎทุกข้อในแพ็กเกจ ใช้ไม่เกิน 1 ครั้งภายในแพ็กเกจ (ไฟล์ BUILD)

สําหรับคู่ที่ประกาศข้อมูลเมตาที่ใช้กับกฎทุกข้อในที่เก็บทั้งหมด ให้ใช้ฟังก์ชัน repo() ในไฟล์ REPO.bazel ที่รูทของ repo ฟังก์ชัน repo() จะรับอาร์กิวเมนต์เหมือนกับ package() ทุกประการ

ควรเรียกฟังก์ชันแพ็กเกจ() หลังคำสั่ง remove() ทั้งหมดที่ด้านบนสุดของฟังก์ชัน ก่อนกฎใดๆ

อาร์กิวเมนต์

ตัวอย่าง

package(default_visibility = ["//foo:target"])

package_group

package_group(name, packages, includes)

ฟังก์ชันนี้จะกำหนดชุดของแพ็กเกจ แล้วเชื่อมโยงป้ายกำกับกับชุด สามารถอ้างอิงป้ายกำกับได้ใน visibility

กลุ่มแพ็กเกจใช้สำหรับการควบคุมระดับการเข้าถึงเป็นหลัก วิดีโอที่เผยแพร่ต่อสาธารณะ สามารถอ้างอิงเป้าหมายจากทุกแพ็กเกจในโครงสร้างต้นทาง วิดีโอส่วนตัว เป้าหมายที่แสดงสามารถอ้างอิงได้ภายในแพ็กเกจของตนเองเท่านั้น (ไม่ใช่แพ็กเกจย่อย) ในระหว่างระดับเหล่านี้ เป้าหมายอาจอนุญาตให้เข้าถึงแพ็กเกจของตนเอง รวมถึงแพ็กเกจที่กลุ่มแพ็กเกจอย่างน้อย 1 กลุ่มอธิบายไว้ ดูคำอธิบายโดยละเอียดเพิ่มเติมเกี่ยวกับระบบระดับการเข้าถึงได้ที่แอตทริบิวต์visibility

ระบบจะถือว่าแพ็กเกจหนึ่งๆ อยู่ในกลุ่มหากตรงกับแอตทริบิวต์ packages หรืออยู่ในกลุ่มแพ็กเกจอื่นที่กล่าวถึงในแอตทริบิวต์ includes

กลุ่มแพ็กเกจเป็นเป้าหมายทางเทคนิค แต่ไม่ได้สร้างโดยกฎ และไม่มีการป้องกันการแสดงผล

อาร์กิวเมนต์

ตัวอย่าง

การประกาศ package_group ต่อไปนี้ระบุกลุ่มแพ็กเกจชื่อ "tropical" ที่มีผลไม้เขตร้อน

package_group(
    name = "tropical",
    packages = [
        "//fruits/mango",
        "//fruits/orange",
        "//fruits/papaya/...",
    ],
)

ประกาศต่อไปนี้จะระบุกลุ่มแพ็กเกจของ แอปพลิเคชัน:

package_group(
    name = "fooapp",
    includes = [
        ":controller",
        ":model",
        ":view",
    ],
)

package_group(
    name = "model",
    packages = ["//fooapp/database"],
)

package_group(
    name = "view",
    packages = [
        "//fooapp/swingui",
        "//fooapp/webui",
    ],
)

package_group(
    name = "controller",
    packages = ["//fooapp/algorithm"],
)

exports_files

exports_files([label, ...], visibility, licenses)

exports_files() ระบุรายการไฟล์ที่อยู่ในแพ็กเกจนี้ซึ่งส่งออกไปยังแพ็กเกจอื่นๆ

ไฟล์ BUILD ของแพ็กเกจจะอ้างอิงไฟล์ต้นทางของแพ็กเกจอื่นได้โดยตรงก็ต่อเมื่อส่งออกไฟล์เหล่านั้นอย่างชัดเจนด้วยคำสั่ง exports_files() อ่านเพิ่มเติมเกี่ยวกับ การเปิดเผยไฟล์

ตามลักษณะการทำงานเดิม ระบบจะส่งออกไฟล์ที่ระบุว่าเป็นอินพุตของกฎด้วย ด้วยระดับการมองเห็นเริ่มต้นจนถึงธง --incompatible_no_implicit_file_export กลับด้าน อย่างไรก็ตาม คุณไม่ควรใช้ลักษณะการทํางานนี้และควรย้ายข้อมูลออก

อาร์กิวเมนต์

อาร์กิวเมนต์คือรายการชื่อไฟล์ภายในแพ็กเกจปัจจุบัน ต สามารถระบุการประกาศระดับการเข้าถึงได้อีกด้วย ในกรณีนี้ ไฟล์จะ แสดงต่อเป้าหมายที่ระบุ หากไม่ได้ระบุระดับการเข้าถึง ไฟล์จะแสดงให้ทุกแพ็กเกจเห็น แม้ว่าจะมีการระบุระดับการเข้าถึงเริ่มต้นของแพ็กเกจไว้ในฟังก์ชัน package ก็ตาม นอกจากนี้ คุณยังระบุใบอนุญาตได้ด้วย

ตัวอย่าง

ตัวอย่างต่อไปนี้จะส่งออก golden.txt ซึ่งเป็นไฟล์ข้อความจากแพ็กเกจ test_data เพื่อให้แพ็กเกจอื่นๆ ใช้ไฟล์ดังกล่าวได้ เช่น ในแอตทริบิวต์ data ของทดสอบ

# from //test_data/BUILD

exports_files(["golden.txt"])

glob

glob(include, exclude=[], exclude_directories=1, allow_empty=True)

Glob เป็นฟังก์ชันตัวช่วยที่จะค้นหาไฟล์ทั้งหมดที่ตรงกับรูปแบบเส้นทางบางรายการ และแสดงผลรายการเส้นทางใหม่ ที่เปลี่ยนแปลงและจัดเรียงได้ Glob จะค้นหาเฉพาะไฟล์ในแพ็กเกจของตัวเอง และจะค้นหาเฉพาะไฟล์ต้นฉบับ (ไม่ใช่ไฟล์ที่สร้างขึ้นหรือเป้าหมายอื่นๆ)

ป้ายกำกับของไฟล์ต้นฉบับจะรวมอยู่ในผลลัพธ์หากเส้นทางแบบสัมพัทธ์กับแพ็กเกจของไฟล์ตรงกับรูปแบบ include รูปแบบใดรูปแบบหนึ่งและไม่ตรงกับรูปแบบ exclude รูปแบบใดเลย

รายการ include และ exclude มีรูปแบบเส้นทาง ที่เกี่ยวข้องกับแพ็กเกจปัจจุบัน รูปแบบทุกรูปแบบอาจมีกลุ่มเส้นทางอย่างน้อย 1 กลุ่ม เช่นเดียวกับเส้นทาง Unix ส่วนต่างๆ เหล่านี้จะคั่นด้วย / ระบบจะจับคู่กลุ่มในรูปแบบกับกลุ่มของเส้นทาง กลุ่มอาจมีไวลด์การ์ด * ซึ่งตรงกันดังนี้ สตริงย่อยทั้งหมดในส่วนของเส้นทาง (รวมถึงสตริงย่อยที่ว่างเปล่า) ยกเว้น ตัวคั่นไดเรกทอรี / คุณใช้ไวลด์การ์ดนี้ได้หลายครั้งภายในกลุ่มเส้นทางเดียว นอกจากนี้ ไวลด์การ์ด ** ยังจับคู่ได้ กลุ่มเส้นทางที่สมบูรณ์ตั้งแต่ 0 รายการขึ้นไป แต่ต้องได้รับการประกาศเป็นแบบสแตนด์อโลน ส่วนเส้นทาง

• foo/bar.txt ตรงกับไฟล์ foo/bar.txt ในแพ็กเกจนี้ทุกประการ (เว้นแต่ foo/ จะเป็นแพ็กเกจย่อย)
• foo/*.txt จะจับคู่กับไฟล์ทุกไฟล์ในไดเรกทอรี foo/ หากไฟล์ลงท้ายด้วย .txt (เว้นแต่ foo/ จะเป็นแพ็กเกจย่อย)
• foo/a*.htm* ตรงกับทุกไฟล์ใน foo/ ที่ขึ้นต้นด้วย a และมีสตริงที่กำหนดเอง ( ว่างเปล่า) ตามด้วย .htm และลงท้ายด้วยสตริงที่กำหนดเองอีกสตริงหนึ่ง (เว้นแต่ foo/ เป็นแพ็กเกจย่อย) เช่น foo/axx.htm และ foo/a.html หรือ foo/axxx.html
• foo/* ตรงกับทุกไฟล์ในไดเรกทอรี foo/ (เว้นแต่ foo/ เป็นแพ็กเกจย่อย) ไม่ตรงกับ foo แม้ว่าจะตั้งค่า exclude_directories เป็น 0 ครั้ง
• foo/** จะจับคู่กับทุกไฟล์ในไดเรกทอรีย่อยที่ไม่ใช่แพ็กเกจย่อยทุกไดเรกทอรีภายใต้ไดเรกทอรีย่อยระดับแรกของแพ็กเกจ foo/ หากตั้งค่า exclude_directories เป็น 0 ไดเรกทอรี foo จะจับคู่กับรูปแบบด้วยเช่นกัน ในกรณีนี้ ระบบจะถือว่า ** จับคู่กับส่วนของเส้นทางที่เป็น 0
• **/a.txt ตรงกับ a.txt ไฟล์ในแพ็กเกจนี้ และไดเรกทอรีย่อยที่ไม่ใช่แพ็กเกจย่อย
• **/bar/**/*.txt ตรงกับทุก .txt ไฟล์ในทุก ไดเรกทอรีย่อยที่ไม่ใช่แพ็กเกจย่อยของแพ็กเกจนี้ หากมีอย่างน้อย 1 ไดเรกทอรีใน พาธผลลัพธ์มีชื่อว่า bar เช่น xxx/bar/yyy/zzz/a.txt หรือ bar/a.txt (อย่าลืมว่า ** ตรงกับกลุ่ม 0 กลุ่มด้วย) หรือ bar/zzz/a.txt
• ** ตรงกับทุกไฟล์ในไดเรกทอรีย่อยที่ไม่ใช่แพ็กเกจย่อยทั้งหมดของ พัสดุนี้
• foo**/a.txt เป็นรูปแบบที่ไม่ถูกต้อง เนื่องจาก ** ต้องอยู่เดี่ยวๆ เป็นกลุ่ม
• foo/ เป็นรูปแบบที่ไม่ถูกต้อง เนื่องจากกำหนดกลุ่มที่ 2 แล้ว หลังจาก / จะเป็นสตริงว่าง

หากเปิดใช้อาร์กิวเมนต์ exclude_directories (ตั้งค่าเป็น 1) ระบบจะไม่รวมไฟล์ของไดเรกทอรีประเภทนั้นไว้ในผลลัพธ์ (ค่าเริ่มต้นคือ 1)

หากตั้งค่าอาร์กิวเมนต์ allow_empty เป็น False ค่า ฟังก์ชัน glob จะแสดงข้อผิดพลาดหากผลลัพธ์จะเป็น รายการที่ว่างเปล่า

ข้อจำกัดและคำเตือนที่สำคัญมีดังนี้

1. เนื่องจาก glob() ทำงานระหว่างการประเมินไฟล์ BUILD glob() จะจับคู่ไฟล์ในโครงสร้างแหล่งที่มาเท่านั้น โดยไม่จับคู่กับ ไฟล์ที่สร้างขึ้น หากกำลังสร้างเป้าหมายที่ต้องใช้ทั้งไฟล์ต้นทางและไฟล์ที่สร้างขึ้น คุณต้องเพิ่มรายการไฟล์ที่สร้างขึ้นอย่างชัดเจนต่อท้ายนิพจน์ทั่วไป ดูตัวอย่างด้านล่างที่มี :mylib และ :gen_java_srcs

2. หากกฎมีชื่อเหมือนกับไฟล์แหล่งที่มาที่ตรงกัน กฎจะ "เงา" ไฟล์

   โปรดทราบว่า glob() จะแสดงรายการเส้นทาง ดังนั้นการใช้ glob() ในแอตทริบิวต์ของกฎอื่นๆ (เช่น srcs = glob(["*.cc"])) จะมีผลเหมือนกับการระบุเส้นทางที่ตรงกันอย่างชัดเจน ตัวอย่างเช่น glob() ให้ผลตอบแทน ["Foo.java", "bar/Baz.java"] แต่ก็มีกฎในส่วน แพ็กเกจชื่อ "Foo.java" (ซึ่งได้รับอนุญาต แม้ว่า Bazel จะเตือนเรื่องนี้แล้วก็ตาม) ผู้ใช้ glob() จะใช้ "Foo.java" กฎ (เอาต์พุต) แทน "Foo.java" ดูรายละเอียดเพิ่มเติมได้ที่ปัญหา #10395 ใน GitHub

3. Globs อาจจับคู่ไฟล์ในไดเรกทอรีย่อย และชื่อไดเรกทอรีย่อยอาจใช้ไวลด์การ์ดได้ อย่างไรก็ตาม...

4. ป้ายกำกับต้องอยู่ภายในขอบเขตของแพ็กเกจ และ Glob จะไม่จับคู่กับไฟล์ในแพ็กเกจย่อย

   เช่น นิพจน์ glob **/*.cc ในแพ็กเกจ x ไม่รวม x/y/z.cc หาก x/y มีลักษณะเป็นแพ็กเกจ (อาจเป็น x/y/BUILD หรือที่อื่นในเส้นทางแพ็กเกจ) ช่วงเวลานี้ หมายความว่าผลลัพธ์ของการแสดงออกของ glob ขึ้นอยู่กับ การมีอยู่ของไฟล์ BUILD กล่าวคือ นิพจน์ glob เดียวกันจะ รวม x/y/z.cc ถ้าไม่มีแพ็กเกจชื่อ x/y หรือมีการทำเครื่องหมายว่าลบแล้วโดยใช้ --deleted_packages แจ้ง

5. ข้อจำกัดข้างต้นมีผลกับนิพจน์ของ glob ทั้งหมด ไม่ว่าจะใช้ไวลด์การ์ดใด
6. ไฟล์ที่ซ่อนซึ่งมีชื่อไฟล์ขึ้นต้นด้วย . จะตรงกันทั้งหมดกับทั้งไวลด์การ์ด ** และ * หากต้องการจับคู่ไฟล์ที่ซ่อนอยู่ ที่มีรูปแบบแบบผสม รูปแบบของคุณจะต้องขึ้นต้นด้วย . เช่น * และ .*.txt จะจับคู่กับ .foo.txt แต่ *.txt จะไม่จับคู่ ระบบจะจับคู่ไดเรกทอรีที่ซ่อนอยู่ด้วยในลักษณะเดียวกัน ไดเรกทอรีที่ซ่อนอยู่อาจรวมไฟล์ที่ไม่จําเป็นต้องใช้เป็นอินพุต และอาจเพิ่มจํานวนไฟล์ที่รวมแบบ Glob โดยไม่จําเป็นและการใช้หน่วยความจํา เพื่อยกเว้น ไดเรกทอรีที่ซ่อนอยู่ ให้เพิ่มไดเรกทอรีเหล่านั้นในส่วน "ยกเว้น" แสดงรายการอาร์กิวเมนต์
7. ไวลด์การ์ด "**" มีกรณีพิเศษ 1 กรณีคือ รูปแบบ "**" ไม่ตรงกับเส้นทางไดเรกทอรีของแพ็กเกจ กล่าวคือ glob(["**"], exclude_directories = 0) จะจับคู่กับไฟล์และไดเรกทอรีทั้งหมดในไดเรกทอรีของแพ็กเกจปัจจุบันอย่างเคร่งครัด (แต่จะไม่เข้าไปในไดเรกทอรีของแพ็กเกจย่อย โปรดดูหมายเหตุก่อนหน้าเกี่ยวกับเรื่องนี้)

โดยทั่วไปคุณควรพยายามแสดงนามสกุลที่เหมาะสม (เช่น *.html) แทนที่จะใช้ "*" เปล่าสำหรับรูปแบบลูกโลก ชื่อที่ชัดเจนยิ่งขึ้นจะทําให้ทราบรายละเอียดของไฟล์เองและช่วยให้คุณไม่จับคู่ไฟล์สํารองหรือไฟล์ที่ emacs/vi/... บันทึกโดยอัตโนมัติโดยไม่ตั้งใจ

เมื่อเขียนกฎในการสร้าง คุณสามารถแจกแจงองค์ประกอบภาพโลกได้ ซึ่งช่วยให้สร้างกฎแยกต่างหากสําหรับอินพุตแต่ละรายการได้ เป็นต้น โปรดดู ตัวอย่าง glob ที่ขยายที่ด้านล่าง

ตัวอย่าง Glob

สร้างไลบรารี Java ที่สร้างขึ้นจากไฟล์ Java ทั้งหมดในไดเรกทอรีนี้ และไฟล์ทั้งหมดที่สร้างโดยกฎ :gen_java_srcs

java_library(
    name = "mylib",
    srcs = glob(["*.java"]) + [":gen_java_srcs"],
    deps = "...",
)

genrule(
    name = "gen_java_srcs",
    outs = [
        "Foo.java",
        "Bar.java",
    ],
    ...
)

รวมไฟล์ txt ทั้งหมดไว้ในไดเรกทอรี testdata ยกเว้น experimental.txt โปรดทราบว่าระบบจะไม่รวมไฟล์ในไดเรกทอรีย่อยของ testdata ถ้า หากคุณต้องการให้ไฟล์เหล่านั้นรวมอยู่ด้วย ให้ใช้ glob ที่เกิดซ้ำ (**)

sh_test(
    name = "mytest",
    srcs = ["mytest.sh"],
    data = glob(
        ["testdata/*.txt"],
        exclude = ["testdata/experimental.txt"],
    ),
)

ตัวอย่างลูกโลกที่เกิดซ้ำ

ทําให้การทดสอบใช้ไฟล์ txt ทั้งหมดในไดเรกทอรี testdata และไดเรกทอรีย่อยของไดเรกทอรีนั้น (และไดเรกทอรีย่อยของไดเรกทอรีย่อย และอื่นๆ) ระบบจะละเว้นไดเรกทอรีย่อยที่มีไฟล์ BUILD (ดูข้อจํากัดและข้อควรระวังด้านบน)

sh_test(
    name = "mytest",
    srcs = ["mytest.sh"],
    data = glob(["testdata/**/*.txt"]),
)

สร้างไลบรารีที่สร้างขึ้นจากไฟล์ Java ทั้งหมดในไดเรกทอรีนี้และทั้งหมด ไดเรกทอรีย่อย ยกเว้นไดเรกทอรีที่เส้นทางมีไดเรกทอรีที่ชื่อการทดสอบ ควรหลีกเลี่ยงรูปแบบนี้หากเป็นไปได้ เนื่องจากอาจลดการสร้างแบบเพิ่มทีละน้อยและทำให้เวลาในการสร้างนานขึ้น

java_library(
    name = "mylib",
    srcs = glob(
        ["**/*.java"],
        exclude = ["**/testing/**"],
    ),
)

ตัวอย่างของ Glob แบบขยาย

สร้าง Genrule แต่ละรายการสำหรับ *_test.cc ในไดเรกทอรีปัจจุบัน ที่นับจำนวนบรรทัดในไฟล์

# Conveniently, the build language supports list comprehensions.
[genrule(
    name = "count_lines_" + f[:-3],  # strip ".cc"
    srcs = [f],
    outs = ["%s-linecount.txt" % f[:-3]],
    cmd = "wc -l $< >$@",
 ) for f in glob(["*_test.cc"])]

หากไฟล์ BUILD ด้านบนอยู่ในแพ็กเกจ //foo และแพ็กเกจมี ไฟล์ที่ตรงกัน, a_test.cc, b_test.cc และ c_test.cc จากนั้นกำลังทำงาน bazel query '//foo:all' จะแสดงรายการกฎทั้งหมดที่สร้างขึ้น:

$ bazel query '//foo:all' | sort
//foo:count_lines_a_test
//foo:count_lines_b_test
//foo:count_lines_c_test

เลือก

select(
    {conditionA: valuesA, conditionB: valuesB, ...},
    no_match_error = "custom message"
)

select() คือฟังก์ชันตัวช่วยที่สร้างแอตทริบิวต์กฎ configurable สามารถใช้แทนที่ด้านขวามือของ เกือบ การกำหนดแอตทริบิวต์ทั้งหมด ดังนั้นค่าจะขึ้นอยู่กับแฟล็ก Bazel ในบรรทัดคำสั่ง คุณสามารถใช้เงื่อนไขนี้เพื่อกำหนดการอ้างอิงเฉพาะแพลตฟอร์ม หรือเพื่อฝังทรัพยากรต่างๆ ทั้งนี้ขึ้นอยู่กับว่ากฎสร้างขึ้นในโหมด "นักพัฒนาซอฟต์แวร์" หรือ "รุ่น"

การใช้งานขั้นพื้นฐานมีดังนี้

sh_binary(
    name = "mytarget",
    srcs = select({
        ":conditionA": ["mytarget_a.sh"],
        ":conditionB": ["mytarget_b.sh"],
        "//conditions:default": ["mytarget_default.sh"]
    })
)

ซึ่งทําให้แอตทริบิวต์ srcs ของ sh_binary ได้รับการกําหนดค่าได้โดยแทนที่การกําหนดรายการป้ายกำกับปกติด้วยคําเรียก select ที่แมปเงื่อนไขการกําหนดค่ากับค่าที่ตรงกัน แต่ละเงื่อนไขจะเป็นป้ายกำกับ การอ้างอิงถึง config_setting หรือ constraint_value, ซึ่ง "ตรง" หากการกำหนดค่าของเป้าหมายตรงกับชุดของ ค่าของ mytarget#srcs จะกลายเป็นค่าใดก็ได้ รายการป้ายกำกับตรงกับการเรียกใช้ปัจจุบัน

หมายเหตุ:

• เลือกเงื่อนไขเพียง 1 รายการในการเรียกใช้
• หากเงื่อนไขหลายข้อตรงกัน และข้อหนึ่งเป็นความเชี่ยวชาญพิเศษของอีกฝ่าย ความเชี่ยวชาญพิเศษจะมีความสำคัญเหนือกว่า ระบบจะถือว่าเงื่อนไข ข. เป็นเงื่อนไขเฉพาะของเงื่อนไข ก. หาก ข. มีแฟล็กและค่าข้อจำกัดเหมือนกับ ก. ทั้งหมด รวมถึงมีบางค่าแฟล็กหรือค่าข้อจำกัดเพิ่มเติม ยัง หมายความว่าความละเอียดของความเชี่ยวชาญพิเศษไม่ได้ออกแบบมาเพื่อสร้างการสั่งซื้อเป็น แสดงในตัวอย่างที่ 2 ด้านล่าง
• หากเงื่อนไขหลายข้อตรงกัน แต่มีข้อหนึ่งไม่ใช่ความเชี่ยวชาญพิเศษของทุก อื่นๆ Bazel ล้มเหลวโดยมีข้อผิดพลาด ยกเว้นกรณีที่เงื่อนไขทั้งหมดแก้ไขเป็นค่าเดียวกัน
• ป้ายกำกับปลอมพิเศษ //conditions:default คือ จะถือว่าตรงกันหากไม่มีเงื่อนไขอื่นๆ ที่ตรงกัน หากเงื่อนไขนี้ ไม่แสดง ต้องจับคู่กฎอื่นๆ เพื่อหลีกเลี่ยงข้อผิดพลาด
• select สามารถฝังภายในการกําหนดแอตทริบิวต์ที่ใหญ่ขึ้นได้ ดังนั้น srcs = ["common.sh"] + select({ ":conditionA": ["myrule_a.sh"], ...}) และ srcs = select({ ":conditionA": ["a.sh"]}) + select({ ":conditionB": ["b.sh"]}) เป็นนิพจน์ที่ถูกต้อง
• select ใช้ได้กับแอตทริบิวต์ส่วนใหญ่ แต่ไม่ใช่ทั้งหมด ใช้ร่วมกันไม่ได้ มีการทำเครื่องหมาย nonconfigurable ในเอกสารประกอบ

  แพ็กเกจย่อย

  subpackages(include, exclude=[], allow_empty=True)

  subpackages() เป็นฟังก์ชันตัวช่วยที่คล้ายกับ glob() ซึ่งแสดงรายการแพ็กเกจย่อยแทนไฟล์และไดเรกทอรี ซึ่งจะใช้รูปแบบเส้นทางเดียวกับ glob() และสามารถจับคู่กับแพ็กเกจย่อยใดก็ได้ที่เป็นแพ็กเกจย่อยโดยตรงของไฟล์ BUILD ที่กําลังโหลดอยู่ ดูคำอธิบายโดยละเอียดและตัวอย่างรูปแบบรวมและยกเว้นได้ที่ glob

  รายการแพ็กเกจย่อยที่แสดงผลจะอยู่ในลําดับที่เรียงแล้ว และมีเส้นทางที่เกี่ยวข้องกับแพ็กเกจที่กําลังโหลดอยู่ในปัจจุบันซึ่งตรงกับรูปแบบที่ระบุใน include ไม่ใช่ใน exclude

  ตัวอย่าง

  ตัวอย่างต่อไปนี้แสดงแพ็กเกจย่อยโดยตรงทั้งหมดสำหรับแพ็กเกจ foo/BUILD

  # The following BUILD files exist:
  # foo/BUILD
  # foo/bar/baz/BUILD
  # foo/bar/but/bad/BUILD
  # foo/sub/BUILD
  # foo/sub/deeper/BUILD
  #
  # In foo/BUILD a call to
  subs1 = subpackages(include = ["**"])
  
  # results in subs1 == ["sub", "bar/baz", "bar/but/bad"]
  #
  # 'sub/deeper' is not included because it is a subpackage of 'foo/sub' not of
  # 'foo'
  
  subs2 = subpackages(include = ["bar/*"])
  # results in subs2 = ["bar/baz"]
  #
  # Since 'bar' is not a subpackage itself, this looks for any subpackages under
  # all first level subdirectories of 'bar'.
  
  subs3 = subpackages(include = ["bar/**"])
  # results in subs3 = ["bar/baz", "bar/but/bad"]
  #
  # Since bar is not a subpackage itself, this looks for any subpackages which are
  # (1) under all subdirectories of 'bar' which can be at any level, (2) not a
  # subpackage of another subpackages.
  
  subs4 = subpackages(include = ["sub"])
  subs5 = subpackages(include = ["sub/*"])
  subs6 = subpackages(include = ["sub/**"])
  # results in subs4 and subs6 being ["sub"]
  # results in subs5 = [].
  #
  # In subs4, expression "sub" checks whether 'foo/sub' is a package (i.e. is a
  # subpackage of 'foo').
  # In subs5, "sub/*" looks for subpackages under directory 'foo/sub'. Since
  # 'foo/sub' is already a subpackage itself, the subdirectories will not be
  # traversed anymore.
  # In subs6, 'foo/sub' is a subpackage itself and matches pattern "sub/**", so it
  # is returned. But the subdirectories of 'foo/sub' will not be traversed
  # anymore.
  

  โดยทั่วไปแล้ว เราขอแนะนำให้ผู้ใช้ใช้โมดูล "subpackages" ของ skylib แทนการเรียกใช้ฟังก์ชันนี้โดยตรง