इस पेज पर, Starlark के बारे में खास जानकारी दी गई है. इसे पहले Skylark कहा जाता था. यह Bazel में इस्तेमाल की जाने वाली भाषा है. फ़ंक्शन और टाइप की पूरी सूची के लिए, Bazel API का रेफ़रंस देखें.
भाषा के बारे में ज़्यादा जानने के लिए, Starlark का GitHub repo देखें.
Starlark सिंटैक्स और व्यवहार के बारे में आधिकारिक जानकारी के लिए, Starlark भाषा के बारे में स्पेसिफ़िकेशन देखें.
सिंटैक्स
Starlark का सिंटैक्स, Python3 से प्रेरित है. Starlark में यह सिंटैक्स मान्य है:
def fizz_buzz(n):
"""Print Fizz Buzz numbers from 1 to n."""
for i in range(1, n + 1):
s = ""
if i % 3 == 0:
s += "Fizz"
if i % 5 == 0:
s += "Buzz"
print(s if s else i)
fizz_buzz(20)
Starlark के सेमेटिक्स, Python से अलग हो सकते हैं. हालांकि, काम करने के तरीके में अंतर कम ही होता है. ऐसा सिर्फ़ उन मामलों में होता है जहां Starlark कोई गड़बड़ी दिखाता है. Python के ये टाइप इस्तेमाल किए जा सकते हैं:
टाइप किए गए एनोटेशन
एक्सपेरिमेंटल. टाइप एनोटेशन, एक्सपेरिमेंट के तौर पर उपलब्ध सुविधा है. इसमें किसी भी समय बदलाव हो सकता है. इस पर भरोसा न करें. इसे --experimental_starlark_types फ़्लैग का इस्तेमाल करके, Bazel में HEAD पर चालू किया जा सकता है.
Bazel के HEAD में Starlark, टाइप एनोटेशन के लिए धीरे-धीरे सहायता जोड़ रहा है. इसके लिए, PEP 484 से प्रेरित सिंटैक्स का इस्तेमाल किया जा रहा है.
- Starlark टाइप के एनोटेशन पर काम जारी है. इस प्रोग्रेस को issue#22935 पर ट्रैक किया जा रहा है.
- स्पेसिफ़िकेशन को धीरे-धीरे बढ़ाया जाता है: starlark-with-types/spec.md
- शुरुआती प्रस्ताव: SEP-001 Starlark टाइप को बूटस्ट्रैप करना
म्यूटेबिलिटी
Starlark, बदले न जा सकने वाले वैरिएबल का इस्तेमाल करता है. डेटा में बदलाव करने की सुविधा वाले दो स्ट्रक्चर उपलब्ध हैं: सूची और डिकशनरी. बदलाव किए जा सकने वाले डेटा-स्ट्रक्चर में किए गए बदलाव, सिर्फ़ मौजूदा संदर्भ में बनाए गए ऑब्जेक्ट के लिए मान्य होते हैं. जैसे, किसी सूची में वैल्यू जोड़ना या किसी डिक्शनरी में मौजूद एंट्री मिटाना. कोई कॉन्टेक्स्ट खत्म होने के बाद, उसकी वैल्यू में बदलाव नहीं किया जा सकता.
ऐसा इसलिए होता है, क्योंकि Bazel बिल्ड, पैरलल तरीके से प्रोसेस किए जाते हैं. बिल्ड के दौरान, हर .bzl
फ़ाइल और हर BUILD फ़ाइल को अपना एक एक्सीक्यूशन कॉन्टेक्स्ट मिलता है. हर नियम का विश्लेषण, उसके संदर्भ में भी किया जाता है.
आइए, foo.bzl फ़ाइल के साथ एक उदाहरण देखें:
# `foo.bzl`
var = [] # declare a list
def fct(): # declare a function
var.append(5) # append a value to the list
fct() # execute the fct function
foo.bzl लोड होने पर, Bazel var बनाता है. इसलिए, var, foo.bzl के कॉन्टेक्स्ट का हिस्सा है. fct(), foo.bzl के कॉन्टेक्स्ट में चलता है. foo.bzl के लिए आकलन पूरा होने के बाद, एनवायरमेंट में var नाम की एक ऐसी एंट्री मौजूद होती है जिसे बदला नहीं जा सकता. इसकी वैल्यू [5] होती है.
जब कोई दूसरा bar.bzl, foo.bzl से सिंबल लोड करता है, तो लोड की गई वैल्यू में बदलाव नहीं होता. इस वजह से, bar.bzl में यह कोड गैर-कानूनी है:
# `bar.bzl`
load(":foo.bzl", "var", "fct") # loads `var`, and `fct` from `./foo.bzl`
var.append(6) # runtime error, the list stored in var is frozen
fct() # runtime error, fct() attempts to modify a frozen list
bzl फ़ाइलों में तय किए गए ग्लोबल वैरिएबल, उन bzl फ़ाइलों के बाहर नहीं बदले जा सकते जिनमें उन्हें तय किया गया है. bzl फ़ाइलों का इस्तेमाल करने वाले ऊपर दिए गए उदाहरण की तरह ही,
नियमों से मिली वैल्यू में बदलाव नहीं किया जा सकता.
BUILD और .bzl फ़ाइलों के बीच अंतर
BUILD फ़ाइलें, नियमों को कॉल करके टारगेट रजिस्टर करती हैं. .bzl फ़ाइलें, कॉन्सटेंट, नियमों, मैक्रो, और फ़ंक्शन के लिए परिभाषाएं उपलब्ध कराती हैं.
नेटिव फ़ंक्शन और नेटिव नियम, BUILD फ़ाइलों में ग्लोबल सिंबल होते हैं. bzl फ़ाइलों को native मॉड्यूल का इस्तेमाल करके लोड करना होगा.
BUILD फ़ाइलों में सिंटैक्स से जुड़ी दो पाबंदियां हैं: 1) फ़ंक्शन का एलान करना गैर-कानूनी है और 2) *args और **kwargs आर्ग्युमेंट की अनुमति नहीं है.
Python से अंतर
ग्लोबल वैरिएबल में बदलाव नहीं किया जा सकता.
टॉप-लेवल पर
forस्टेटमेंट इस्तेमाल करने की अनुमति नहीं है. इसके बजाय, फ़ंक्शन में उनका इस्तेमाल करें.BUILDफ़ाइलों में, सूची के कॉम्प्रेहेंशन का इस्तेमाल किया जा सकता है.टॉप-लेवल पर
ifस्टेटमेंट इस्तेमाल करने की अनुमति नहीं है. हालांकि,ifएक्सप्रेशन का इस्तेमाल इनके लिए किया जा सकता है:first = data[0] if len(data) > 0 else None.डिक्शनरी में मौजूद आइटम को क्रम से देखने के लिए, तय किया गया क्रम.
बार-बार इस्तेमाल करने की अनुमति नहीं है.
Int टाइप, सिर्फ़ 32-बिट के साइन किए गए पूर्णांक तक सीमित है. ओवरफ़्लो होने पर गड़बड़ी का मैसेज दिखेगा.
किसी कलेक्शन में, दोहराए जाने वाले फ़ंक्शन के दौरान बदलाव करना गड़बड़ी है.
बराबरी की जांच के अलावा, तुलना करने वाले ऑपरेटर
<,<=,>=,>वगैरह, सभी तरह की वैल्यू के लिए तय नहीं किए जाते. कम शब्दों में:5 < 'foo'गड़बड़ी दिखाएगा और5 == "5"गलत दिखाएगा.ट्यूपल में, आखिर में कॉमा सिर्फ़ तब मान्य होता है, जब ट्यूपल ब्रैकेट के बीच में हो — जब
1,के बजाय(1,)लिखा जाता है.डिक्शनरी लिटरल में डुप्लीकेट की नहीं हो सकतीं. उदाहरण के लिए, यह एक गलती है:
{"a": 4, "b": 7, "a": 1}.स्ट्रिंग को डबल कोट के साथ दिखाया जाता है. जैसे, repr को कॉल करने पर.
स्ट्रिंग को दोहराया नहीं जा सकता.
Python की ये सुविधाएं काम नहीं करतीं:
- स्ट्रिंग को जोड़ने की प्रोसेस अपने-आप होती है (
+ऑपरेटर का इस्तेमाल करें). - चेन की गई तुलनाएं (जैसे कि
1 < x < 5). class(structफ़ंक्शन देखें).import(loadस्टेटमेंट देखें).while,yield.- फ़्लोट और सेट टाइप.
- जनरेटर और जनरेटर एक्सप्रेशन.
is(इसके बजाय==का इस्तेमाल करें).try,raise,except,finally(गंभीर गड़बड़ियों के लिएfailदेखें).global,nonlocal.- ज़्यादातर बिल्ट-इन फ़ंक्शन, ज़्यादातर तरीके.