शेल रूल

नियम

• sh_binary
• sh_library
• sh_test

sh_binary

sh_binary(name, deps, srcs, data, args, compatible_with, deprecation, env, env_inherit, exec_compatible_with, exec_group_compatible_with, exec_properties, features, output_licenses, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

sh_binary नियम का इस्तेमाल, शैल स्क्रिप्ट को लागू करने के लिए किया जाता है. (sh_binary गलत नाम है: इसके आउटपुट ज़रूरी नहीं कि बाइनरी हों.) इस नियम से यह पक्का होता है कि सभी डिपेंडेंसी बनाई गई हैं और वे runfiles एरिया में दिखती हैं. हमारा सुझाव है कि आप अपने sh_binary() नियमों को स्क्रिप्ट के नाम के बाद नाम दें, जिसमें एक्सटेंशन शामिल न हो (उदाहरण के लिए, .sh); नियम का नाम और फ़ाइल का नाम अलग-अलग होना चाहिए. sh_binary, शेलबंग का इस्तेमाल करता है, ताकि किसी भी उपलब्ध इंटरप्रेटर का इस्तेमाल किया जा सके (उदाहरण के लिए, #!/bin/zsh)

उदाहरण

बिना किसी डिपेंडेंसी और कुछ डेटा फ़ाइलों वाली आसान शेल स्क्रिप्ट के लिए:

sh_binary(
    name = "foo",
    srcs = ["foo.sh"],
    data = glob(["datafiles/*.txt"]),
)

तर्क

sh_library

sh_library(name, deps, srcs, data, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

इस नियम का मुख्य मकसद, एक लॉजिकल "लाइब्रेरी" को एक साथ इकट्ठा करना है. इसमें मिलती-जुलती स्क्रिप्ट होती हैं. ये ऐसे प्रोग्राम होते हैं जिन्हें किसी ऐसी भाषा में लिखा जाता है जिसे समझने के लिए, प्रोग्राम को कंपाइल या लिंक करने की ज़रूरत नहीं होती. जैसे, Bourne shell. साथ ही, इसमें उन प्रोग्राम के लिए ज़रूरी डेटा भी होता है जो रन-टाइम के दौरान इस्तेमाल किए जाते हैं. इसके बाद, एक या एक से ज़्यादा sh_binary नियमों के data एट्रिब्यूट से, ऐसी "लाइब्रेरी" का इस्तेमाल किया जा सकता है.

डेटा फ़ाइलों को इकट्ठा करने के लिए, filegroup नियम का इस्तेमाल किया जा सकता है.

इंटरप्रिटेड प्रोग्रामिंग भाषाओं में, "कोड" और "डेटा" के बीच हमेशा साफ़ तौर पर अंतर नहीं होता: आखिरकार, इंटरप्रिटर के हिसाब से प्रोग्राम सिर्फ़ "डेटा" होता है. इस वजह से, इस नियम में तीन एट्रिब्यूट हैं, जो सभी एक जैसे हैं: srcs, deps, और data. फ़िलहाल, इन सूचियों के एलिमेंट के बीच कोई अंतर नहीं किया जाता. तीनों एट्रिब्यूट में नियम, सोर्स फ़ाइलें, और जनरेट की गई फ़ाइलें शामिल की जा सकती हैं. हालांकि, अन्य नियमों की तरह ही एट्रिब्यूट का इस्तेमाल उनके सामान्य मकसद के लिए करना अच्छा होता है.

उदाहरण

sh_library(
    name = "foo",
    data = [
        ":foo_service_script",  # an sh_binary with srcs
        ":deploy_foo",  # another sh_binary with srcs
    ],
)

तर्क

sh_test

sh_test(name, deps, srcs, data, args, compatible_with, deprecation, env, env_inherit, exec_compatible_with, exec_group_compatible_with, exec_properties, features, flaky, local, package_metadata, restricted_to, shard_count, size, tags, target_compatible_with, testonly, timeout, toolchains, visibility)

sh_binary नियम का इस्तेमाल, शैल स्क्रिप्ट को लागू करने के लिए किया जाता है. (sh_binary गलत नाम है: इसके आउटपुट ज़रूरी नहीं कि बाइनरी हों.) इस नियम से यह पक्का होता है कि सभी डिपेंडेंसी बनाई गई हैं और वे runfiles एरिया में दिखती हैं. हमारा सुझाव है कि आप अपने sh_binary() नियमों को स्क्रिप्ट के नाम के बाद नाम दें, जिसमें एक्सटेंशन शामिल न हो (उदाहरण के लिए, .sh); नियम का नाम और फ़ाइल का नाम अलग-अलग होना चाहिए. sh_binary, शेलबंग का इस्तेमाल करता है, ताकि किसी भी उपलब्ध इंटरप्रेटर का इस्तेमाल किया जा सके (उदाहरण के लिए, #!/bin/zsh)

उदाहरण

बिना किसी डिपेंडेंसी और कुछ डेटा फ़ाइलों वाली आसान शेल स्क्रिप्ट के लिए:

sh_binary(
    name = "foo",
    srcs = ["foo.sh"],
    data = glob(["datafiles/*.txt"]),
)

तर्क