กฎ Python

กฎ

py_binary
py_library
py_test
py_runtime

py_binary

py_binary(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, exec_compatible_with, exec_properties, features, imports, legacy_create_init, licenses, main, output_licenses, python_version, restricted_to, srcs_version, stamp, tags, target_compatible_with, testonly, toolchains, visibility)

py_binary เป็นโปรแกรม Python ที่เป็นไฟล์ปฏิบัติการซึ่งประกอบไปด้วย ของคอลเล็กชันที่มีไฟล์ต้นฉบับ .py ไฟล์ (อาจเป็น กับกฎ py_library อื่นๆ) *.runfiles โครงสร้างไดเรกทอรีที่มีโค้ดและข้อมูลทั้งหมดที่จำเป็นสำหรับ และสคริปต์ต้นขั้วที่เริ่มต้นโปรแกรมด้วย ข้อมูลในสภาพแวดล้อมเริ่มต้นที่ถูกต้อง

ตัวอย่าง

py_binary(
    name = "foo",
    srcs = ["foo.py"],
    data = [":transform"],  # a cc_binary which we invoke at run time
    deps = [
        ":foolib",  # a py_library
    ],
)

หากต้องการเรียกใช้ py_binary จากภายในไบนารีอื่นหรือ (ตัวอย่างเช่น การใช้ไบนารี Python เพื่อตั้งค่าทรัพยากรจำลองจาก ภายใน java_test) วิธีที่ถูกต้องคือทำให้ไบนารีอื่นหรือ ขึ้นอยู่กับ py_binary ในส่วนข้อมูล อื่นๆ ไบนารีจะสามารถหา py_binary ที่สัมพันธ์กับแหล่งที่มาได้ ไดเรกทอรี

py_binary(
    name = "test_main",
    srcs = ["test_main.py"],
    deps = [":testlib"],
)

java_library(
    name = "testing",
    srcs = glob(["*.java"]),
    data = [":test_main"]
)

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

Attributes
`name`	`Name; required` ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ หากไม่ได้ระบุ `main` ค่านี้ควรเป็นชื่อเดียวกับชื่อ ของไฟล์ต้นฉบับที่เป็นจุดแรกเข้าหลักของแอปพลิเคชัน ลบส่วนขยาย ตัวอย่างเช่น ถ้าจุดแรกเข้าของคุณมีชื่อว่า `main.py` ชื่อของคุณควรเป็น `main`
`deps`	`List of labels; optional` รายการไลบรารีอื่นๆ ที่จะลิงก์กับเป้าหมายไบนารี ดูความคิดเห็นทั่วไปเกี่ยวกับ `deps` ที่ แอตทริบิวต์ทั่วไปที่กำหนดโดยกฎบิลด์ส่วนใหญ่ โดยทั่วไปแล้ว `py_library`
`srcs`	`List of labels; required` รายการไฟล์แหล่งที่มา (`.py`) ที่ประมวลผลเพื่อสร้างเป้าหมาย ซึ่งรวมถึงโค้ดเช็คอินทั้งหมดและไฟล์ต้นฉบับที่สร้างขึ้น เป้าหมายไลบรารี จะอยู่ใน `deps` แทน ส่วนไฟล์ไบนารีอื่นๆ ที่ต้องใช้ขณะรันไทม์ควรอยู่ใน `data`
`imports`	`List of strings; optional` รายการไดเรกทอรีนำเข้าที่จะเพิ่มใน `PYTHONPATH` ขึ้นอยู่กับการแทนที่ "Makeตัวแปร" การนำเข้าเหล่านี้ ไดเรกทอรีจะถูกเพิ่มสำหรับกฎนี้และกฎทั้งหมดที่เกี่ยวข้อง (หมายเหตุ: ไม่ใช่ ที่กฎนี้ใช้ ระบบจะเพิ่มแต่ละไดเรกทอรีไปยัง `PYTHONPATH` โดย กฎ `py_binary` รายการที่ขึ้นอยู่กับกฎนี้ เส้นทางสัมบูรณ์ (เส้นทางที่เริ่มต้นด้วย `/`) และเส้นทางที่อ้างอิงเส้นทาง เหนือรากการดำเนินการจะไม่ได้รับอนุญาต และจะเกิดข้อผิดพลาด
`legacy_create_init`	`Integer; optional; default is -1` ระบุว่าสร้างไฟล์ __init__.py ที่ว่างเปล่าโดยปริยายในโครงสร้าง Runfiles หรือไม่ รหัสเหล่านี้จะสร้างขึ้นในทุกไดเรกทอรีที่มีซอร์สโค้ด Python หรือ ไลบรารีที่ใช้ร่วมกัน และไดเรกทอรีระดับบนสุดทั้งหมดของไดเรกทอรีเหล่านั้น ยกเว้นรูทของที่เก็บ ไดเรกทอรี ค่าเริ่มต้น อัตโนมัติ หมายถึง "จริง" ยกเว้น ใช้งาน `--incompatible_default_to_explicit_init_py` หากเป็น "เท็จ" ผู้ใช้จะ มีหน้าที่สร้างไฟล์ __init__.py (ซึ่งอาจว่างเปล่า) และเพิ่มไฟล์ดังกล่าวไปยัง `srcs` ของเป้าหมาย Python ตามที่กำหนด
`main`	`Label; optional` ชื่อไฟล์ต้นฉบับซึ่งเป็นจุดแรกเข้าหลักของแอปพลิเคชัน ไฟล์นี้ต้องอยู่ใน `srcs` ด้วย หากไม่ได้ระบุไว้ ระบบจะใช้ `name` แทน (ดูด้านบน) หาก `name` ไม่ทำ ตรงกับชื่อไฟล์ใดก็ได้ใน `srcs` ต้องระบุ `main`
`python_version`	`String; optional; nonconfigurable; default is "_INTERNAL_SENTINEL"` จะสร้างเป้าหมายนี้ (และ `deps` แบบทรานซิชัน) สำหรับ Python 2 หรือ Python หรือไม่ 3. ค่าที่ถูกต้องคือ `"PY2"` และ `"PY3"` (ค่าเริ่มต้น) เวอร์ชัน Python จะรีเซ็ตเสมอ (โดยค่าเริ่มต้น) เป็นเวอร์ชันใดก็ตาม ที่ระบุโดยแอตทริบิวต์นี้ โดยไม่คำนึงถึงเวอร์ชันที่ระบุในบรรทัดคำสั่งหรือตาม เป้าหมายที่สูงกว่าเป้าหมายอื่น ที่อ้างอิงเป้าหมายนี้ หากต้องการ`select()`ใน Python เวอร์ชันปัจจุบัน คุณสามารถตรวจสอบ เป็น `@rules_python//python:python_version` โปรดดู ที่นี่ เพื่อดูข้อมูลเพิ่มเติม คำเตือนข้อบกพร่อง: แอตทริบิวต์นี้จะกำหนดเวอร์ชันที่ Bazel จะสร้างเป้าหมาย แต่เนื่องจาก #4815 สคริปต์ Stub ที่ได้อาจยังคงเรียกใช้ล่ามเวอร์ชันที่ไม่ถูกต้องขณะรันไทม์ โปรดดู นี่ วิธีแก้ปัญหาชั่วคราว ซึ่งรวมถึงการกำหนดเป้าหมาย `py_runtime` ที่ชี้ไปยัง เวอร์ชัน Python ตามที่จำเป็น และเปิดใช้งาน `py_runtime` นี้โดยการตั้งค่า `--python_top`
`srcs_version`	`String; optional; default is "PY2AND3"` แอตทริบิวต์นี้ประกาศว่า `srcs` ของเป้าหมายที่ใช้ได้กับ Python 2, Python 3 หรือทั้งคู่ หากต้องการตั้งค่าเวอร์ชันรันไทม์ของ Python ให้ใช้ แอตทริบิวต์ `python_version` ของ กฎ Python ที่ดำเนินการได้ (`py_binary` หรือ `py_test`) ค่าที่อนุญาตคือ `"PY2AND3"`, `"PY2"` และ `"PY3"` อนุญาตให้ใช้ค่า `"PY2ONLY"` และ `"PY3ONLY"` กับค่าย้อนหลังได้ด้วย แต่โดยพื้นฐานแล้วจะเหมือนกันกับ `"PY2"` และ `"PY3"` และควรหลีกเลี่ยง โปรดทราบว่ามีเพียงกฎสั่งการ (`py_binary` และ `py_library`) เท่านั้นที่จะยืนยันเวอร์ชัน Python ปัจจุบันเทียบกับค่าของแอตทริบิวต์นี้จริงๆ (นี่เป็นฟีเจอร์ เนื่องจาก `py_library` ไม่ได้เปลี่ยน Python ปัจจุบัน หากทำการยืนยันแล้ว ก็คงเป็นไปไม่ได้ที่จะสร้าง `PY2ONLY` และไลบรารี `PY3ONLY` รายการในการเรียกใช้เดียวกัน) นอกจากนี้ หากมี เวอร์ชันไม่ตรงกัน ระบบจะรายงานข้อผิดพลาดในขั้นตอนการดำเนินการเท่านั้น โดยเฉพาะอย่างยิ่ง ฟิลด์ จะไม่ปรากฏในการเรียกใช้ `bazel build --nobuild`) หากต้องการรับข้อมูลการวินิจฉัยเกี่ยวกับทรัพยากร Dependency ที่ทำให้เกิดข้อกำหนดของเวอร์ชัน คุณสามารถเรียกใช้ลักษณะ `find_requirements` ในเป้าหมายได้ bazel build <your target> \ --aspects=@rules_python//python:defs.bzl%find_requirements \ --output_groups=pyversioninfo การดำเนินการนี้จะสร้างไฟล์ที่มีส่วนต่อท้าย `-pyversioninfo.txt` ที่ให้ข้อมูล เกี่ยวกับเหตุผลที่เป้าหมายของคุณต้องใช้ Python เวอร์ชันใดเวอร์ชันหนึ่ง โปรดทราบว่าวิธีนี้ใช้ได้ผลแม้ สร้างเป้าหมายที่ระบุไม่สำเร็จเนื่องจากความขัดแย้งของเวอร์ชัน
`stamp`	`Integer; optional; default is -1` ระบุว่าจะเข้ารหัสข้อมูลบิลด์ลงในไบนารีหรือไม่ ค่าที่เป็นไปได้มีดังนี้ `stamp = 1`: ประทับตราข้อมูลบิลด์ลงในไบนารีเสมอ แม้ใน `--nostamp` บิลด์ ควรหลีกเลี่ยงการตั้งค่า เนื่องจากอาจทำให้การแคชระยะไกลหยุดทำงาน ไบนารีและการดำเนินการดาวน์สตรีมที่ใช้ `stamp = 0`: แทนที่ข้อมูลบิลด์ด้วยค่าคงที่เสมอ ช่วงเวลานี้ จะให้การแคชผลลัพธ์ของบิลด์ที่ดี `stamp = -1`: การฝังข้อมูลบิลด์ควบคุมโดย Flag `--[no]stamp` ระบบจะไม่สร้างไบนารีที่ประทับตราอีกครั้ง เว้นแต่ทรัพยากร Dependency จะมีการเปลี่ยนแปลง

py_library

py_library(name, deps, srcs, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, imports, licenses, restricted_to, srcs_version, tags, target_compatible_with, testonly, visibility)

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

Attributes
`name`	`Name; required` ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้
`deps`	`List of labels; optional` รายการไลบรารีอื่นๆ ที่จะลิงก์กับเป้าหมายไบนารี ดูความคิดเห็นทั่วไปเกี่ยวกับ `deps` ที่ แอตทริบิวต์ทั่วไปที่กำหนดโดยกฎบิลด์ส่วนใหญ่ โดยทั่วไปแล้ว `py_library`
`srcs`	`List of labels; optional` รายการไฟล์แหล่งที่มา (`.py`) ที่ประมวลผลเพื่อสร้างเป้าหมาย ซึ่งรวมถึงโค้ดเช็คอินทั้งหมดและไฟล์ต้นฉบับที่สร้างขึ้น
`imports`	`List of strings; optional` รายการไดเรกทอรีนำเข้าที่จะเพิ่มใน `PYTHONPATH` ขึ้นอยู่กับการแทนที่ "Makeตัวแปร" การนำเข้าเหล่านี้ ไดเรกทอรีจะถูกเพิ่มสำหรับกฎนี้และกฎทั้งหมดที่เกี่ยวข้อง (หมายเหตุ: ไม่ใช่ ที่กฎนี้ใช้ ระบบจะเพิ่มแต่ละไดเรกทอรีไปยัง `PYTHONPATH` โดย กฎ `py_binary` รายการที่ขึ้นอยู่กับกฎนี้ เส้นทางสัมบูรณ์ (เส้นทางที่เริ่มต้นด้วย `/`) และเส้นทางที่อ้างอิงเส้นทาง เหนือรากการดำเนินการจะไม่ได้รับอนุญาต และจะเกิดข้อผิดพลาด
`srcs_version`	`String; optional; default is "PY2AND3"` แอตทริบิวต์นี้ประกาศว่า `srcs` ของเป้าหมายที่ใช้ได้กับ Python 2, Python 3 หรือทั้งคู่ หากต้องการตั้งค่าเวอร์ชันรันไทม์ของ Python ให้ใช้ แอตทริบิวต์ `python_version` ของ กฎ Python ที่ดำเนินการได้ (`py_binary` หรือ `py_test`) ค่าที่อนุญาตคือ `"PY2AND3"`, `"PY2"` และ `"PY3"` อนุญาตให้ใช้ค่า `"PY2ONLY"` และ `"PY3ONLY"` กับค่าย้อนหลังได้ด้วย แต่โดยพื้นฐานแล้วจะเหมือนกันกับ `"PY2"` และ `"PY3"` และควรหลีกเลี่ยง โปรดทราบว่ามีเพียงกฎสั่งการ (`py_binary` และ `py_library`) เท่านั้นที่จะยืนยันเวอร์ชัน Python ปัจจุบันเทียบกับค่าของแอตทริบิวต์นี้จริงๆ (นี่เป็นฟีเจอร์ เนื่องจาก `py_library` ไม่ได้เปลี่ยน Python ปัจจุบัน หากทำการยืนยันแล้ว ก็คงเป็นไปไม่ได้ที่จะสร้าง `PY2ONLY` และไลบรารี `PY3ONLY` รายการในการเรียกใช้เดียวกัน) นอกจากนี้ หากมี เวอร์ชันไม่ตรงกัน ระบบจะรายงานข้อผิดพลาดในขั้นตอนการดำเนินการเท่านั้น โดยเฉพาะอย่างยิ่ง ฟิลด์ จะไม่ปรากฏในการเรียกใช้ `bazel build --nobuild`) หากต้องการรับข้อมูลการวินิจฉัยเกี่ยวกับทรัพยากร Dependency ที่ทำให้เกิดข้อกำหนดของเวอร์ชัน คุณสามารถเรียกใช้ลักษณะ `find_requirements` ในเป้าหมายได้ bazel build <your target> \ --aspects=@rules_python//python:defs.bzl%find_requirements \ --output_groups=pyversioninfo การดำเนินการนี้จะสร้างไฟล์ที่มีส่วนต่อท้าย `-pyversioninfo.txt` ที่ให้ข้อมูล เกี่ยวกับเหตุผลที่เป้าหมายของคุณต้องใช้ Python เวอร์ชันใดเวอร์ชันหนึ่ง โปรดทราบว่าวิธีนี้ใช้ได้ผลแม้ สร้างเป้าหมายที่ระบุไม่สำเร็จเนื่องจากความขัดแย้งของเวอร์ชัน

py_test

py_test(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, imports, legacy_create_init, licenses, local, main, python_version, restricted_to, shard_count, size, srcs_version, stamp, tags, target_compatible_with, testonly, timeout, toolchains, visibility)

กฎ py_test() จะรวมการทดสอบ การทดสอบคือ Wrapper แบบไบนารี กับโค้ดทดสอบบางอย่าง

ตัวอย่าง

py_test(
    name = "runtest_test",
    srcs = ["runtest_test.py"],
    deps = [
        "//path/to/a/py/library",
    ],
)

นอกจากนี้ยังสามารถระบุโมดูลหลักได้ด้วย ดังนี้

py_test(
    name = "runtest_test",
    srcs = [
        "runtest_main.py",
        "runtest_lib.py",
    ],
    main = "runtest_main.py",
)

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

Attributes
`name`	`Name; required` ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้
`deps`	`List of labels; optional` รายการไลบรารีอื่นๆ ที่จะลิงก์กับเป้าหมายไบนารี ดูความคิดเห็นทั่วไปเกี่ยวกับ `deps` ที่ แอตทริบิวต์ทั่วไปที่กำหนดโดยกฎบิลด์ส่วนใหญ่ โดยทั่วไปแล้ว `py_library`
`srcs`	`List of labels; required` รายการไฟล์แหล่งที่มา (`.py`) ที่ประมวลผลเพื่อสร้างเป้าหมาย ซึ่งรวมถึงโค้ดเช็คอินทั้งหมดและไฟล์ต้นฉบับที่สร้างขึ้น เป้าหมายไลบรารี จะอยู่ใน `deps` แทน ส่วนไฟล์ไบนารีอื่นๆ ที่ต้องใช้ขณะรันไทม์ควรอยู่ใน `data`
`imports`	`List of strings; optional` รายการไดเรกทอรีนำเข้าที่จะเพิ่มใน `PYTHONPATH` ขึ้นอยู่กับการแทนที่ "Makeตัวแปร" การนำเข้าเหล่านี้ ไดเรกทอรีจะถูกเพิ่มสำหรับกฎนี้และกฎทั้งหมดที่เกี่ยวข้อง (หมายเหตุ: ไม่ใช่ ที่กฎนี้ใช้ ระบบจะเพิ่มแต่ละไดเรกทอรีไปยัง `PYTHONPATH` โดย กฎ `py_binary` รายการที่ขึ้นอยู่กับกฎนี้ เส้นทางสัมบูรณ์ (เส้นทางที่เริ่มต้นด้วย `/`) และเส้นทางที่อ้างอิงเส้นทาง เหนือรากการดำเนินการจะไม่ได้รับอนุญาต และจะเกิดข้อผิดพลาด
`legacy_create_init`	`Integer; optional; default is -1` ระบุว่าสร้างไฟล์ __init__.py ที่ว่างเปล่าโดยปริยายในโครงสร้าง Runfiles หรือไม่ รหัสเหล่านี้จะสร้างขึ้นในทุกไดเรกทอรีที่มีซอร์สโค้ด Python หรือ ไลบรารีที่ใช้ร่วมกัน และไดเรกทอรีระดับบนสุดทั้งหมดของไดเรกทอรีเหล่านั้น ยกเว้นรูทของที่เก็บ ไดเรกทอรี ค่าเริ่มต้น อัตโนมัติ หมายถึง "จริง" ยกเว้น ใช้งาน `--incompatible_default_to_explicit_init_py` หากเป็น "เท็จ" ผู้ใช้จะ มีหน้าที่สร้างไฟล์ __init__.py (ซึ่งอาจว่างเปล่า) และเพิ่มไฟล์ดังกล่าวไปยัง `srcs` ของเป้าหมาย Python ตามที่กำหนด
`main`	`Label; optional` ชื่อไฟล์ต้นฉบับซึ่งเป็นจุดแรกเข้าหลักของแอปพลิเคชัน ไฟล์นี้ต้องอยู่ใน `srcs` ด้วย หากไม่ได้ระบุไว้ ระบบจะใช้ `name` แทน (ดูด้านบน) หาก `name` ไม่ทำ ตรงกับชื่อไฟล์ใดก็ได้ใน `srcs` ต้องระบุ `main`
`python_version`	`String; optional; nonconfigurable; default is "_INTERNAL_SENTINEL"` จะสร้างเป้าหมายนี้ (และ `deps` แบบทรานซิชัน) สำหรับ Python 2 หรือ Python หรือไม่ 3. ค่าที่ถูกต้องคือ `"PY2"` และ `"PY3"` (ค่าเริ่มต้น) เวอร์ชัน Python จะรีเซ็ตเสมอ (โดยค่าเริ่มต้น) เป็นเวอร์ชันใดก็ตาม ที่ระบุโดยแอตทริบิวต์นี้ โดยไม่คำนึงถึงเวอร์ชันที่ระบุในบรรทัดคำสั่งหรือตาม เป้าหมายที่สูงกว่าเป้าหมายอื่น ที่อ้างอิงเป้าหมายนี้ หากต้องการ`select()`ใน Python เวอร์ชันปัจจุบัน คุณสามารถตรวจสอบ เป็น `@rules_python//python:python_version` โปรดดู ที่นี่ เพื่อดูข้อมูลเพิ่มเติม คำเตือนข้อบกพร่อง: แอตทริบิวต์นี้จะกำหนดเวอร์ชันที่ Bazel จะสร้างเป้าหมาย แต่เนื่องจาก #4815 สคริปต์ Stub ที่ได้อาจยังคงเรียกใช้ล่ามเวอร์ชันที่ไม่ถูกต้องขณะรันไทม์ โปรดดู นี่ วิธีแก้ปัญหาชั่วคราว ซึ่งรวมถึงการกำหนดเป้าหมาย `py_runtime` ที่ชี้ไปยัง เวอร์ชัน Python ตามที่จำเป็น และเปิดใช้งาน `py_runtime` นี้โดยการตั้งค่า `--python_top`
`srcs_version`	`String; optional; default is "PY2AND3"` แอตทริบิวต์นี้ประกาศว่า `srcs` ของเป้าหมายที่ใช้ได้กับ Python 2, Python 3 หรือทั้งคู่ หากต้องการตั้งค่าเวอร์ชันรันไทม์ของ Python ให้ใช้ แอตทริบิวต์ `python_version` ของ กฎ Python ที่ดำเนินการได้ (`py_binary` หรือ `py_test`) ค่าที่อนุญาตคือ `"PY2AND3"`, `"PY2"` และ `"PY3"` อนุญาตให้ใช้ค่า `"PY2ONLY"` และ `"PY3ONLY"` กับค่าย้อนหลังได้ด้วย แต่โดยพื้นฐานแล้วจะเหมือนกันกับ `"PY2"` และ `"PY3"` และควรหลีกเลี่ยง โปรดทราบว่ามีเพียงกฎสั่งการ (`py_binary` และ `py_library`) เท่านั้นที่จะยืนยันเวอร์ชัน Python ปัจจุบันเทียบกับค่าของแอตทริบิวต์นี้จริงๆ (นี่เป็นฟีเจอร์ เนื่องจาก `py_library` ไม่ได้เปลี่ยน Python ปัจจุบัน หากทำการยืนยันแล้ว ก็คงเป็นไปไม่ได้ที่จะสร้าง `PY2ONLY` และไลบรารี `PY3ONLY` รายการในการเรียกใช้เดียวกัน) นอกจากนี้ หากมี เวอร์ชันไม่ตรงกัน ระบบจะรายงานข้อผิดพลาดในขั้นตอนการดำเนินการเท่านั้น โดยเฉพาะอย่างยิ่ง ฟิลด์ จะไม่ปรากฏในการเรียกใช้ `bazel build --nobuild`) หากต้องการรับข้อมูลการวินิจฉัยเกี่ยวกับทรัพยากร Dependency ที่ทำให้เกิดข้อกำหนดของเวอร์ชัน คุณสามารถเรียกใช้ลักษณะ `find_requirements` ในเป้าหมายได้ bazel build <your target> \ --aspects=@rules_python//python:defs.bzl%find_requirements \ --output_groups=pyversioninfo การดำเนินการนี้จะสร้างไฟล์ที่มีส่วนต่อท้าย `-pyversioninfo.txt` ที่ให้ข้อมูล เกี่ยวกับเหตุผลที่เป้าหมายของคุณต้องใช้ Python เวอร์ชันใดเวอร์ชันหนึ่ง โปรดทราบว่าวิธีนี้ใช้ได้ผลแม้ สร้างเป้าหมายที่ระบุไม่สำเร็จเนื่องจากความขัดแย้งของเวอร์ชัน
`stamp`	`Integer; optional; default is 0` ดูส่วนเกี่ยวกับอาร์กิวเมนต์ py_binary() ยกเว้น อาร์กิวเมนต์ Stamp ตั้งค่าเป็น 0 โดยค่าเริ่มต้นสำหรับการทดสอบ

py_runtime

py_runtime(name, compatible_with, coverage_tool, deprecation, distribs, features, files, interpreter, interpreter_path, licenses, python_version, restricted_to, stub_shebang, tags, target_compatible_with, testonly, visibility)

แสดงรันไทม์ของ Python ที่ใช้เพื่อเรียกใช้โค้ด Python

เป้าหมาย py_runtime สามารถแสดงรันไทม์ของแพลตฟอร์มหรือ รันไทม์ในตัว รันไทม์ของแพลตฟอร์มเข้าถึงอินเทอร์พรีเตอร์ที่ติดตั้งระบบใน ขณะที่รันไทม์ภายในสร้างชี้ไปยังเป้าหมายสั่งการซึ่งทำหน้าที่เป็นล่าม ใน ทั้ง 2 กรณี หมายถึงสคริปต์ไบนารีหรือ Wrapper ที่สั่งการได้ การเรียกใช้สคริปต์ Python ที่ส่งผ่านบรรทัดคำสั่งตามรูปแบบเดียวกับมาตรฐาน ล่าม CPython

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

ตัวอย่าง

py_runtime(
    name = "python-2.7.12",
    files = glob(["python-2.7.12/**"]),
    interpreter = "python-2.7.12/bin/python",
)

py_runtime(
    name = "python-3.6.0",
    interpreter_path = "/opt/pyenv/versions/3.6.0/bin/python",
)

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

Attributes
`name`	`Name; required` ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้
`coverage_tool`	`Label; optional` เป้าหมายนี้ใช้สำหรับรวบรวมข้อมูลความครอบคลุมของโค้ดจาก `py_binary` และ `py_test` เป้าหมาย หากมีการตั้งค่า เป้าหมายต้องสร้างไฟล์เดียวหรือเป็นเป้าหมายที่ดำเนินการได้ เส้นทางไปยังไฟล์เดียวหรือไฟล์ปฏิบัติการหากเป้าหมายเป็นไฟล์ปฏิบัติการ กำหนดจุดแรกเข้าสำหรับเครื่องมือการครอบคลุมของ Python เป้าหมายและ ไฟล์รันไฟล์จะถูกเพิ่มลงในการเรียกใช้ไฟล์เมื่อเปิดใช้การครอบคลุม จุดแรกเข้าของเครื่องมือต้องโหลดได้โดยใช้ล่าม Python (เช่น `.py` หรือ `.pyc`) ต้องยอมรับอาร์กิวเมนต์บรรทัดคำสั่ง coverage.py อย่างน้อยต้องมี คำสั่งย่อย `run` และ `lcov`
`files`	`List of labels; optional` สำหรับรันไทม์ภายในบิลด์ นี่คือชุดไฟล์ที่ประกอบด้วยรันไทม์นี้ ไฟล์เหล่านี้จะ ลงในไฟล์รันไฟล์ของไบนารี Python ที่ใช้รันไทม์นี้ สำหรับรันไทม์แพลตฟอร์ม ต้องไม่ตั้งค่าแอตทริบิวต์นี้
`interpreter`	`Label; optional` สำหรับรันไทม์ระหว่างสร้าง URL นี้เป็นเป้าหมายที่จะเรียกใช้เป็นล่าม สำหรับแพลตฟอร์ม ต้องไม่ตั้งค่าแอตทริบิวต์นี้
`interpreter_path`	`String; optional` สำหรับรันไทม์ของแพลตฟอร์ม นี่คือเส้นทางสัมบูรณ์ของอินเทอร์พรีเตอร์ Python ในเป้าหมาย ที่มีการจัดการครบวงจรได้เลย สำหรับรันไทม์ระหว่างสร้าง ต้องไม่ตั้งค่าแอตทริบิวต์นี้
`python_version`	`String; optional; default is "_INTERNAL_SENTINEL"` รันไทม์นี้มีไว้สำหรับ Python เวอร์ชันหลัก 2 หรือ 3 หรือไม่ ค่าที่ถูกต้องคือ `"PY2"` และ `"PY3"` ค่าเริ่มต้นจะควบคุมด้วยแฟล็ก `--incompatible_py3_is_default` แต่ในอนาคตแอตทริบิวต์นี้จะเป็นแอตทริบิวต์ที่ต้องระบุและไม่มีค่าเริ่มต้น
`stub_shebang`	`String; optional; default is "#!/usr/bin/env python3"` "เชอบัง" ที่มีการแทรกไว้ข้างหน้าสคริปต์ Python Stub ระดับ Bootstrapping ใช้เมื่อดำเนินการเป้าหมาย `py_binary` รายการ ดูปัญหา 8685 สำหรับ แรงจูงใจ แต่ไม่มีผลกับ Windows