Python नियम

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

नियम

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 चलाना है (उदाहरण के लिए, java_test से कुछ मॉक संसाधन सेट अप करने के लिए, python बाइनरी चलाना), तो सही तरीका यह है कि अन्य बाइनरी या टेस्ट को, उसके डेटा सेक्शन में py_binary पर निर्भर बनाया जाए. इसके बाद, दूसरा बाइनरी, सोर्स डायरेक्ट्री के हिसाब से py_binary का पता लगा सकता है. 

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

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

तर्क

विशेषताएं
name

नाम; ज़रूरी है

इस टारगेट के लिए यूनीक नाम.


अगर main की वैल्यू तय नहीं की गई है, तो यह उस सोर्स फ़ाइल के नाम के बराबर होनी चाहिए जो ऐप्लिकेशन का मुख्य एंट्री पॉइंट है. हालांकि, इसमें एक्सटेंशन शामिल नहीं होना चाहिए. उदाहरण के लिए, अगर आपके एंट्री पॉइंट का नाम main.py है, तो आपका नाम main होना चाहिए.
deps

लेबल की सूची; डिफ़ॉल्ट वैल्यू [] है

बाइनरी टारगेट में लिंक की जाने वाली अन्य लाइब्रेरी की सूची. deps के बारे में सामान्य टिप्पणियां देखें. ये टिप्पणियां ज़्यादातर बिल्ड नियमों के हिसाब से तय किए गए सामान्य एट्रिब्यूट पर की गई हैं. ये आम तौर पर py_library नियम होते हैं.
srcs

लेबल की सूची; ज़रूरी है

टारगेट बनाने के लिए प्रोसेस की गई सोर्स (.py) फ़ाइलों की सूची. इसमें चेक-इन किया गया आपका पूरा कोड और जनरेट की गई सभी सोर्स फ़ाइलें शामिल हैं. लाइब्रेरी टारगेट को deps में रखा जाता है. वहीं, रनटाइम के दौरान ज़रूरी अन्य बाइनरी फ़ाइलों को data में रखा जाता है.
imports

स्ट्रिंग की सूची; डिफ़ॉल्ट वैल्यू [] है

PYTHONPATH में जोड़ी जाने वाली इंपोर्ट डायरेक्ट्री की सूची.

"बदलाव के हिसाब से" विकल्प के तहत बदलाव किया जा सकता है. इस नियम और इस पर निर्भर सभी नियमों के लिए, ये इंपोर्ट डायरेक्ट्री जोड़ी जाएंगी. ध्यान दें: यह नियम जिन नियमों पर निर्भर है उनके लिए नहीं. हर डायरेक्ट्री को PYTHONPATH में जोड़ा जाएगा. इसके लिए, इस नियम पर निर्भर py_binary नियमों का इस्तेमाल किया जाएगा.

ऐब्सलूट पाथ (/ से शुरू होने वाले पाथ) और ऐसे पाथ इस्तेमाल करने की अनुमति नहीं है जो एक्ज़ीक्यूशन रूट से ऊपर के पाथ का रेफ़रंस देते हैं. ऐसा करने पर गड़बड़ी होगी.

legacy_create_init

पूर्णांक; डिफ़ॉल्ट वैल्यू -1 है

यह तय करता है कि रनफ़ाइल ट्री में, __init__.py फ़ाइलें अपने-आप बनेंगी या नहीं. ये फ़ाइलें, Python सोर्स कोड या शेयर की गई लाइब्रेरी वाली हर डायरेक्ट्री में बनाई जाती हैं. साथ ही, इन डायरेक्ट्री की हर पैरंट डायरेक्ट्री में भी बनाई जाती हैं. हालांकि, इन्हें repo root डायरेक्ट्री में नहीं बनाया जाता. डिफ़ॉल्ट रूप से, ऑटो का मतलब सही होता है. हालांकि, --incompatible_default_to_explicit_init_py का इस्तेमाल करने पर ऐसा नहीं होता. अगर यह वैल्यू false पर सेट है, तो उपयोगकर्ता को __init__.py फ़ाइलें बनानी होंगी. ये फ़ाइलें खाली भी हो सकती हैं. साथ ही, इन्हें Python टारगेट के srcs में जोड़ना होगा.
main

लेबल; डिफ़ॉल्ट वैल्यू None है

सोर्स फ़ाइल का नाम, जो ऐप्लिकेशन का मुख्य एंट्री पॉइंट है. यह फ़ाइल, srcs में भी शामिल होनी चाहिए. अगर इसे तय नहीं किया जाता है, तो इसके बजाय name का इस्तेमाल किया जाता है (ऊपर देखें). अगर name, srcs में मौजूद किसी भी फ़ाइल के नाम से मेल नहीं खाता है, तो main को शामिल करना ज़रूरी है.
python_version

स्ट्रिंग; बदला नहीं जा सकता; डिफ़ॉल्ट वैल्यू "_INTERNAL_SENTINEL" है

इस टारगेट (और इसके ट्रांज़िटिव deps) को Python 2 या Python 3 के लिए बनाना है या नहीं. मान्य वैल्यू "PY2" और "PY3" (डिफ़ॉल्ट) हैं.

Python का वर्शन हमेशा इस एट्रिब्यूट में बताए गए वर्शन पर रीसेट हो जाता है. ऐसा डिफ़ॉल्ट रूप से भी हो सकता है. भले ही, कमांड लाइन पर या इस पर निर्भर करने वाले अन्य बड़े टारगेट में कोई और वर्शन बताया गया हो.

अगर आपको Python के मौजूदा वर्शन पर select() करना है, तो @rules_python//python:python_version की वैल्यू देखें. ज़्यादा जानकारी के लिए, यहां देखें.

बग की चेतावनी: यह एट्रिब्यूट उस वर्शन को सेट करता है जिसके लिए Bazel आपके टारगेट को बनाता है. हालांकि, #4815 की वजह से, नतीजे में मिलने वाली स्टब स्क्रिप्ट अब भी रनटाइम के दौरान गलत इंटरप्रेटर वर्शन को लागू कर सकती है. इस वैकल्पिक तरीके को देखें. इसमें एक py_runtime टारगेट तय करना होता है, जो ज़रूरत के हिसाब से Python के किसी भी वर्शन की ओर इशारा करता है. साथ ही, --python_top को सेट करके इस py_runtime को चालू करना होता है.

srcs_version

स्ट्रिंग; डिफ़ॉल्ट वैल्यू "PY2AND3" है

इस एट्रिब्यूट से यह तय किया जाता है कि टारगेट का srcs, Python 2, Python 3 या दोनों के साथ काम करेगा. Python के रनटाइम वर्शन को सेट करने के लिए, Python के एक्ज़ीक्यूटेबल नियम (py_binary या py_test) के python_version एट्रिब्यूट का इस्तेमाल करें.

इन वैल्यू का इस्तेमाल किया जा सकता है: "PY2AND3", "PY2", और "PY3". ऐतिहासिक वजहों से, "PY2ONLY" और "PY3ONLY" वैल्यू का इस्तेमाल करने की भी अनुमति है. हालांकि, ये वैल्यू "PY2" और "PY3" वैल्यू के जैसी ही होती हैं. इसलिए, इनका इस्तेमाल नहीं करना चाहिए.

ध्यान दें कि सिर्फ़ एक्ज़ीक्यूटेबल नियम (py_binary और py_library ), इस एट्रिब्यूट की वैल्यू के हिसाब से Python के मौजूदा वर्शन की पुष्टि करते हैं. (यह एक सुविधा है; py_library, Python के मौजूदा वर्शन में बदलाव नहीं करता. इसलिए, अगर यह पुष्टि करता है, तो एक ही इनवोकेशन में PY2ONLY और PY3ONLY लाइब्रेरी, दोनों को बनाना मुमकिन नहीं होगा.) इसके अलावा, अगर वर्शन मेल नहीं खाते हैं, तो गड़बड़ी की जानकारी सिर्फ़ स्क्रिप्ट चलाने के दौरान मिलती है. खास तौर पर, यह गड़बड़ी bazel build --nobuild इनवॉकेशन में नहीं दिखेगी.)

यह पता लगाने के लिए कि किन डिपेंडेंसी के लिए वर्शन की ज़रूरी शर्तें लागू होती हैं, अपने टारगेट पर find_requirements पहलू चलाएं: 

          bazel build <your target> \
              --aspects=@rules_python//python:defs.bzl%find_requirements \
              --output_groups=pyversioninfo
इससे -pyversioninfo.txt सफ़िक्स वाली एक फ़ाइल बनेगी. इसमें यह जानकारी होगी कि आपके टारगेट को Python के एक वर्शन की ज़रूरत क्यों है. ध्यान दें कि यह तब भी काम करता है, जब वर्शन के टकराव की वजह से दिया गया टारगेट नहीं बन पाता.
stamp

पूर्णांक; डिफ़ॉल्ट वैल्यू -1 है

बिल्ड की जानकारी को बाइनरी में कोड में बदला जाए या नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • stamp = 1: बाइनरी में हमेशा बिल्ड की जानकारी शामिल करें. भले ही, वह --nostamp बिल्ड हो. इस सेटिंग का इस्तेमाल नहीं करना चाहिए, क्योंकि इससे बाइनरी और उस पर निर्भर डाउनस्ट्रीम कार्रवाइयों के लिए रिमोट कैश मेमोरी बंद हो जाती है.
  • stamp = 0: हमेशा बिल्ड की जानकारी को कॉन्स्टेंट वैल्यू से बदलें. इससे, बिल्ड के नतीजों को बेहतर तरीके से कैश मेमोरी में सेव किया जा सकता है.
  • stamp = -1: बिल्ड की जानकारी को एम्बेड करने की सुविधा, --[no]stamp फ़्लैग से कंट्रोल की जाती है.

स्टैंप किए गए बाइनरी को तब तक फिर से नहीं बनाया जाता, जब तक उनकी डिपेंडेंसी में बदलाव न हो.

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)

तर्क

विशेषताएं
name

नाम; ज़रूरी है

इस टारगेट के लिए यूनीक नाम.
deps

लेबल की सूची; डिफ़ॉल्ट वैल्यू [] है

बाइनरी टारगेट में लिंक की जाने वाली अन्य लाइब्रेरी की सूची. deps के बारे में सामान्य टिप्पणियां देखें. ये टिप्पणियां ज़्यादातर बिल्ड नियमों के हिसाब से तय किए गए सामान्य एट्रिब्यूट पर की गई हैं. ये आम तौर पर py_library नियम होते हैं.
srcs

लेबल की सूची; डिफ़ॉल्ट वैल्यू [] है

टारगेट बनाने के लिए प्रोसेस की गई सोर्स (.py) फ़ाइलों की सूची. इसमें चेक-इन किया गया आपका पूरा कोड और जनरेट की गई सभी सोर्स फ़ाइलें शामिल हैं.
imports

स्ट्रिंग की सूची; डिफ़ॉल्ट वैल्यू [] है

PYTHONPATH में जोड़ी जाने वाली इंपोर्ट डायरेक्ट्री की सूची.

"बदलाव के हिसाब से" विकल्प के तहत बदलाव किया जा सकता है. इस नियम और इस पर निर्भर सभी नियमों के लिए, ये इंपोर्ट डायरेक्ट्री जोड़ी जाएंगी. ध्यान दें: यह नियम जिन नियमों पर निर्भर है उनके लिए नहीं. हर डायरेक्ट्री को PYTHONPATH में जोड़ा जाएगा. इसके लिए, इस नियम पर निर्भर py_binary नियमों का इस्तेमाल किया जाएगा.

ऐब्सलूट पाथ (/ से शुरू होने वाले पाथ) और ऐसे पाथ इस्तेमाल करने की अनुमति नहीं है जो एक्ज़ीक्यूशन रूट से ऊपर के पाथ का रेफ़रंस देते हैं. ऐसा करने पर गड़बड़ी होगी.

srcs_version

स्ट्रिंग; डिफ़ॉल्ट वैल्यू "PY2AND3" है

इस एट्रिब्यूट से यह तय किया जाता है कि टारगेट का srcs, Python 2, Python 3 या दोनों के साथ काम करेगा. Python के रनटाइम वर्शन को सेट करने के लिए, Python के एक्ज़ीक्यूटेबल नियम (py_binary या py_test) के python_version एट्रिब्यूट का इस्तेमाल करें.

इन वैल्यू का इस्तेमाल किया जा सकता है: "PY2AND3", "PY2", और "PY3". ऐतिहासिक वजहों से, "PY2ONLY" और "PY3ONLY" वैल्यू का इस्तेमाल करने की भी अनुमति है. हालांकि, ये वैल्यू "PY2" और "PY3" वैल्यू के जैसी ही होती हैं. इसलिए, इनका इस्तेमाल नहीं करना चाहिए.

ध्यान दें कि सिर्फ़ एक्ज़ीक्यूटेबल नियम (py_binary और py_library ), इस एट्रिब्यूट की वैल्यू के हिसाब से Python के मौजूदा वर्शन की पुष्टि करते हैं. (यह एक सुविधा है; py_library, Python के मौजूदा वर्शन में बदलाव नहीं करता. इसलिए, अगर यह पुष्टि करता है, तो एक ही इनवोकेशन में PY2ONLY और PY3ONLY लाइब्रेरी, दोनों को बनाना मुमकिन नहीं होगा.) इसके अलावा, अगर वर्शन मेल नहीं खाते हैं, तो गड़बड़ी की जानकारी सिर्फ़ स्क्रिप्ट चलाने के दौरान मिलती है. खास तौर पर, यह गड़बड़ी bazel build --nobuild इनवॉकेशन में नहीं दिखेगी.)

यह पता लगाने के लिए कि किन डिपेंडेंसी के लिए वर्शन की ज़रूरी शर्तें लागू होती हैं, अपने टारगेट पर 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() नियम, टेस्ट को कंपाइल करता है. टेस्ट, टेस्ट कोड के चारों ओर एक बाइनरी रैपर होता है.

उदाहरण

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",
)

तर्क

विशेषताएं
name

नाम; ज़रूरी है

इस टारगेट के लिए यूनीक नाम.
deps

लेबल की सूची; डिफ़ॉल्ट वैल्यू [] है

बाइनरी टारगेट में लिंक की जाने वाली अन्य लाइब्रेरी की सूची. deps के बारे में सामान्य टिप्पणियां देखें. ये टिप्पणियां ज़्यादातर बिल्ड नियमों के हिसाब से तय किए गए सामान्य एट्रिब्यूट पर की गई हैं. ये आम तौर पर py_library नियम होते हैं.
srcs

लेबल की सूची; ज़रूरी है

टारगेट बनाने के लिए प्रोसेस की गई सोर्स (.py) फ़ाइलों की सूची. इसमें चेक-इन किया गया आपका पूरा कोड और जनरेट की गई सभी सोर्स फ़ाइलें शामिल हैं. लाइब्रेरी टारगेट को deps में रखा जाता है. वहीं, रनटाइम के दौरान ज़रूरी अन्य बाइनरी फ़ाइलों को data में रखा जाता है.
imports

स्ट्रिंग की सूची; डिफ़ॉल्ट वैल्यू [] है

PYTHONPATH में जोड़ी जाने वाली इंपोर्ट डायरेक्ट्री की सूची.

"बदलाव के हिसाब से" विकल्प के तहत बदलाव किया जा सकता है. इस नियम और इस पर निर्भर सभी नियमों के लिए, ये इंपोर्ट डायरेक्ट्री जोड़ी जाएंगी. ध्यान दें: यह नियम जिन नियमों पर निर्भर है उनके लिए नहीं. हर डायरेक्ट्री को PYTHONPATH में जोड़ा जाएगा. इसके लिए, इस नियम पर निर्भर py_binary नियमों का इस्तेमाल किया जाएगा.

ऐब्सलूट पाथ (/ से शुरू होने वाले पाथ) और ऐसे पाथ इस्तेमाल करने की अनुमति नहीं है जो एक्ज़ीक्यूशन रूट से ऊपर के पाथ का रेफ़रंस देते हैं. ऐसा करने पर गड़बड़ी होगी.

legacy_create_init

पूर्णांक; डिफ़ॉल्ट वैल्यू -1 है

यह तय करता है कि रनफ़ाइल ट्री में, __init__.py फ़ाइलें अपने-आप बनेंगी या नहीं. ये फ़ाइलें, Python सोर्स कोड या शेयर की गई लाइब्रेरी वाली हर डायरेक्ट्री में बनाई जाती हैं. साथ ही, इन डायरेक्ट्री की हर पैरंट डायरेक्ट्री में भी बनाई जाती हैं. हालांकि, इन्हें repo root डायरेक्ट्री में नहीं बनाया जाता. डिफ़ॉल्ट रूप से, ऑटो का मतलब सही होता है. हालांकि, --incompatible_default_to_explicit_init_py का इस्तेमाल करने पर ऐसा नहीं होता. अगर यह वैल्यू false पर सेट है, तो उपयोगकर्ता को __init__.py फ़ाइलें बनानी होंगी. ये फ़ाइलें खाली भी हो सकती हैं. साथ ही, इन्हें Python टारगेट के srcs में जोड़ना होगा.
main

लेबल; डिफ़ॉल्ट वैल्यू None है

सोर्स फ़ाइल का नाम, जो ऐप्लिकेशन का मुख्य एंट्री पॉइंट है. यह फ़ाइल, srcs में भी शामिल होनी चाहिए. अगर इसे तय नहीं किया जाता है, तो इसके बजाय name का इस्तेमाल किया जाता है (ऊपर देखें). अगर name, srcs में मौजूद किसी भी फ़ाइल के नाम से मेल नहीं खाता है, तो main को शामिल करना ज़रूरी है.
python_version

स्ट्रिंग; बदला नहीं जा सकता; डिफ़ॉल्ट वैल्यू "_INTERNAL_SENTINEL" है

इस टारगेट (और इसके ट्रांज़िटिव deps) को Python 2 या Python 3 के लिए बनाना है या नहीं. मान्य वैल्यू "PY2" और "PY3" (डिफ़ॉल्ट) हैं.

Python का वर्शन हमेशा इस एट्रिब्यूट में बताए गए वर्शन पर रीसेट हो जाता है. ऐसा डिफ़ॉल्ट रूप से भी हो सकता है. भले ही, कमांड लाइन पर या इस पर निर्भर करने वाले अन्य बड़े टारगेट में कोई और वर्शन बताया गया हो.

अगर आपको Python के मौजूदा वर्शन पर select() करना है, तो @rules_python//python:python_version की वैल्यू देखें. ज़्यादा जानकारी के लिए, यहां देखें.

बग की चेतावनी: यह एट्रिब्यूट उस वर्शन को सेट करता है जिसके लिए Bazel आपके टारगेट को बनाता है. हालांकि, #4815 की वजह से, नतीजे में मिलने वाली स्टब स्क्रिप्ट अब भी रनटाइम के दौरान गलत इंटरप्रेटर वर्शन को लागू कर सकती है. इस वैकल्पिक तरीके को देखें. इसमें एक py_runtime टारगेट तय करना होता है, जो ज़रूरत के हिसाब से Python के किसी भी वर्शन की ओर इशारा करता है. साथ ही, --python_top को सेट करके इस py_runtime को चालू करना होता है.

srcs_version

स्ट्रिंग; डिफ़ॉल्ट वैल्यू "PY2AND3" है

इस एट्रिब्यूट से यह तय किया जाता है कि टारगेट का srcs, Python 2, Python 3 या दोनों के साथ काम करेगा. Python के रनटाइम वर्शन को सेट करने के लिए, Python के एक्ज़ीक्यूटेबल नियम (py_binary या py_test) के python_version एट्रिब्यूट का इस्तेमाल करें.

इन वैल्यू का इस्तेमाल किया जा सकता है: "PY2AND3", "PY2", और "PY3". ऐतिहासिक वजहों से, "PY2ONLY" और "PY3ONLY" वैल्यू का इस्तेमाल करने की भी अनुमति है. हालांकि, ये वैल्यू "PY2" और "PY3" वैल्यू के जैसी ही होती हैं. इसलिए, इनका इस्तेमाल नहीं करना चाहिए.

ध्यान दें कि सिर्फ़ एक्ज़ीक्यूटेबल नियम (py_binary और py_library ), इस एट्रिब्यूट की वैल्यू के हिसाब से Python के मौजूदा वर्शन की पुष्टि करते हैं. (यह एक सुविधा है; py_library, Python के मौजूदा वर्शन में बदलाव नहीं करता. इसलिए, अगर यह पुष्टि करता है, तो एक ही इनवोकेशन में PY2ONLY और PY3ONLY लाइब्रेरी, दोनों को बनाना मुमकिन नहीं होगा.) इसके अलावा, अगर वर्शन मेल नहीं खाते हैं, तो गड़बड़ी की जानकारी सिर्फ़ स्क्रिप्ट चलाने के दौरान मिलती है. खास तौर पर, यह गड़बड़ी bazel build --nobuild इनवॉकेशन में नहीं दिखेगी.)

यह पता लगाने के लिए कि किन डिपेंडेंसी के लिए वर्शन की ज़रूरी शर्तें लागू होती हैं, अपने टारगेट पर find_requirements पहलू चलाएं: 

          bazel build <your target> \
              --aspects=@rules_python//python:defs.bzl%find_requirements \
              --output_groups=pyversioninfo
इससे -pyversioninfo.txt सफ़िक्स वाली एक फ़ाइल बनेगी. इसमें यह जानकारी होगी कि आपके टारगेट को Python के एक वर्शन की ज़रूरत क्यों है. ध्यान दें कि यह तब भी काम करता है, जब वर्शन के टकराव की वजह से दिया गया टारगेट नहीं बन पाता.
stamp

पूर्णांक; डिफ़ॉल्ट वैल्यू 0 है

py_binary() के आर्ग्युमेंट के बारे में सेक्शन देखें. हालांकि, टेस्ट के लिए स्टैंप आर्ग्युमेंट को डिफ़ॉल्ट रूप से 0 पर सेट किया जाता है.

py_runtime

नियम का सोर्स देखें 
py_runtime(name, bootstrap_template, 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 टारगेट, प्लैटफ़ॉर्म रनटाइम या इन-बिल्ड रनटाइम को दिखा सकता है. प्लैटफ़ॉर्म रनटाइम, सिस्टम में इंस्टॉल किए गए इंटरप्रेटर को किसी जाने-पहचाने पाथ पर ऐक्सेस करता है. वहीं, इन-बिल्ड रनटाइम, एक्ज़ीक्यूटेबल टारगेट की ओर इशारा करता है, जो इंटरप्रेटर के तौर पर काम करता है. दोनों ही मामलों में, "इंटरप्रेटर" का मतलब किसी भी ऐसी एक्ज़ीक्यूटेबल बाइनरी या रैपर स्क्रिप्ट से है जो कमांड लाइन पर पास की गई Python स्क्रिप्ट को चला सकती है. इसके लिए, वह स्टैंडर्ड CPython इंटरप्रेटर के नियमों का पालन करती है.

प्लैटफ़ॉर्म रनटाइम, स्वभाव से नॉन-हर्मेटिक होता है. इससे टारगेट प्लैटफ़ॉर्म के लिए, किसी खास पाथ पर इंटरप्रेटर का होना ज़रूरी हो जाता है. पहले से मौजूद रनटाइम हर्मेटिक हो सकता है या नहीं भी हो सकता. यह इस बात पर निर्भर करता है कि वह चेक-इन किए गए इंटरप्रेटर या सिस्टम इंटरप्रेटर को ऐक्सेस करने वाली रैपर स्क्रिप्ट की ओर इशारा करता है या नहीं.

उदाहरण:

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",
)

तर्क

विशेषताएं
name

नाम; ज़रूरी है

इस टारगेट के लिए यूनीक नाम.
bootstrap_template

लेबल; डिफ़ॉल्ट वैल्यू "@bazel_tools//tools/python:python_bootstrap_template.txt" है

इसे पहले "Python स्टब स्क्रिप्ट" कहा जाता था. यह हर Python एक्ज़ीक्यूटेबल टारगेट का एंट्रीपॉइंट होता है.
coverage_tool

लेबल; डिफ़ॉल्ट वैल्यू None है

यह py_binary और py_test टारगेट से कोड कवरेज की जानकारी इकट्ठा करने के लिए इस्तेमाल किया जाने वाला टारगेट है.

अगर टारगेट सेट किया गया है, तो टारगेट को एक फ़ाइल जनरेट करनी चाहिए या वह एक एक्ज़ीक्यूटेबल टारगेट होना चाहिए. सिंगल फ़ाइल का पाथ या एक्ज़ीक्यूटेबल (अगर टारगेट एक्ज़ीक्यूटेबल है), Python कवरेज टूल के लिए एंट्री पॉइंट तय करता है. कवरेज चालू होने पर, टारगेट और उसकी रनफ़ाइलें, रनफ़ाइलों में जोड़ दी जाएंगी.

टूल का एंट्री पॉइंट, Python इंटरप्रेटर से लोड किया जा सकने वाला होना चाहिए. जैसे, .py या .pyc फ़ाइल. इसमें coverage.py के कमांड लाइन आर्ग्युमेंट स्वीकार किए जाने चाहिए. इनमें कम से कम run और lcov सब-कमांड शामिल होनी चाहिए.

files

लेबल की सूची; डिफ़ॉल्ट वैल्यू [] है

इन-बिल्ड रनटाइम के लिए, यह उन फ़ाइलों का सेट होता है जिनमें यह रनटाइम शामिल होता है. ये फ़ाइलें, इस रनटाइम का इस्तेमाल करने वाले Python बाइनरी की रनफ़ाइल में जोड़ दी जाएंगी. किसी प्लैटफ़ॉर्म रनटाइम के लिए, इस एट्रिब्यूट को सेट नहीं किया जाना चाहिए.
interpreter

लेबल; डिफ़ॉल्ट वैल्यू None है

इन-बिल्ट रनटाइम के लिए, यह इंटरप्रेटर के तौर पर शुरू करने का टारगेट होता है. किसी प्लैटफ़ॉर्म रनटाइम के लिए, इस एट्रिब्यूट को सेट नहीं किया जाना चाहिए.
interpreter_path

स्ट्रिंग; डिफ़ॉल्ट वैल्यू "" है

प्लैटफ़ॉर्म के रनटाइम के लिए, यह टारगेट प्लैटफ़ॉर्म पर Python इंटरप्रेटर का ऐब्सलूट पाथ होता है. इन-बिल्ट रनटाइम के लिए, इस एट्रिब्यूट को सेट नहीं किया जाना चाहिए.
python_version

स्ट्रिंग; डिफ़ॉल्ट वैल्यू "_INTERNAL_SENTINEL" है

यह रनटाइम, Python के मेजर वर्शन 2 या 3 के लिए है या नहीं. मान्य वैल्यू "PY2" और "PY3" हैं.

डिफ़ॉल्ट वैल्यू को --incompatible_py3_is_default फ़्लैग से कंट्रोल किया जाता है. हालांकि, आने वाले समय में इस एट्रिब्यूट को शामिल करना ज़रूरी होगा. साथ ही, इसकी कोई डिफ़ॉल्ट वैल्यू नहीं होगी.

stub_shebang

स्ट्रिंग; डिफ़ॉल्ट वैल्यू "#!/usr/bin/env python3" है

बूटस्ट्रैपिंग Python स्क्रिप्ट से पहले जोड़ा गया "Shebang" एक्सप्रेशन py_binary टारगेट को एक्ज़ीक्यूट करते समय इस्तेमाल किया जाता है.

प्रेरणा पाने के लिए, समस्या 8685 देखें.

यह सुविधा Windows पर काम नहीं करती.