منصوبے کے بارے میں

Boltons 230 سے زائد BSD لائسنس یافتہ، خالص Python یوٹیلیٹیز کا مجموعہ ہے جو Python کی معیاری لائبریری میں موجود خلا کو پر کرنے کے لیے بنایا گیا ہے۔ یہ پروجیکٹ خود کو "builtins کی طرح، لیکن boltons" قرار دیتا ہے اور اس بات پر زور دیتا ہے کہ یہ معیاری لائبریری کے علاوہ کسی اور چیز پر انحصار نہیں کرتا۔ README میں ذکر کردہ قابل ذکر شامل کردہ تعمیرات میں fileutils کے ذریعے ایٹامک فائل سیونگ، dictutils میں ایک انتہائی بہتر OrderedMultiDict، queueutils میں دو قسم کے PriorityQueue، iterutils میں chunked اور windowed اٹریشن، iterutils.remap کے ذریعے ریکرسیو ڈیٹا اسٹرکچر اٹریشن اور مرجنگ، iterutils.backoff کے ذریعے jitter کے ساتھ exponential backoff، اور tbutils میں اسٹیک ٹریسز کی نمائندگی کے لیے ایک TracebackInfo ٹائپ شامل ہیں۔ انسٹالیشن pip کے ذریعے (`pip install boltons`) اور macOS پر MacPorts کے ذریعے دستیاب ہے۔ چونکہ یہ پروجیکٹ خالص Python ہے اور اس میں کوئی ڈیپنڈنسی نہیں، انفرادی ماڈیولز آزاد ہیں اور اگر مکمل پیکیج بہت بڑا ہو تو انہیں براہ راست کسی پروجیکٹ میں وینڈر یا کاپی کیا جا سکتا ہے۔ دستاویزات میں ایک انٹیگریشن سیکشن شامل ہے جو اس طریقے کو بیان کرتا ہے۔ README نوٹ کرتا ہے کہ زیادہ تر boltons کا مقصد بنیادی استعمال کے کیسز کے لیے "کافی اچھا" ہونا ہے، جبکہ جدید ضروریات کو خصوصی تھرڈ پارٹی لائبریریوں کے لیے چھوڑ دیا گیا ہے۔ یہ قارئین کو ایک آرکیٹیکچر اسٹیٹمنٹ کی طرف بھی رہنمائی کرتا ہے جو ڈیزائن فلسفہ اور ماڈیول تنظیم کا احاطہ کرتا ہے، اور گمشدہ فعالیت کے لیے فیچر ریکویسٹس یا پل ریکویسٹس کی دعوت دیتا ہے۔ ڈیولپمنٹ سیٹ اپ uv استعمال کرتا ہے، جس میں ورچوئل انوائرنمنٹ بنانے، پیکیج کو ایڈیٹیبل موڈ میں انسٹال کرنے، اور tox کے ذریعے ٹیسٹ سوٹ (بشمول doctests) چلانے کے لیے کمانڈز فراہم کی گئی ہیں۔ پروجیکٹ بتاتا ہے کہ اسے Python 3.7 سے 3.14 کے ساتھ ساتھ PyPy3 پر بھی ٹیسٹ کیا جاتا ہے۔ مکمل دستاویزات Read the Docs پر ہوسٹ کی گئی ہیں، اور ریپوزٹری میں ایک changelog برقرار رکھا جاتا ہے۔