शेल रूल

नियम

• sh_binary
• sh_library
• sh_test

sh_binary

sh_binary(name, deps, srcs, data, args, aspect_hints, 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, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

इस नियम का मुख्य मकसद, एक लॉजिकल "लाइब्रेरी" को एक साथ एग्रीगेट करना है. इसमें मिलती-जुलती स्क्रिप्ट शामिल होती हैं. जैसे, इंटरप्रेट की गई भाषा में प्रोग्राम, जिन्हें कंपाइल या लिंक करने की ज़रूरत नहीं होती. जैसे, बॉर्न शेल. साथ ही, इसमें वे सभी डेटा शामिल होते हैं जिनकी ज़रूरत इन प्रोग्राम को रन-टाइम में होती है. इसके बाद, इन "लाइब्रेरी" का इस्तेमाल एक या एक से ज़्यादा 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, aspect_hints, 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"]),
)

तर्क