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

بلیک ایک رائے دان پایتھون کوڈ فارمیٹر ہے جو پایتھون سافٹ ویئر فاؤنڈیشن کے ذریعے برقرار رکھا جاتا ہے۔ اس کا کہیں مقصد ہینڈ فارمیٹنگ کے بارے میں بحثوں کو ختم کرنا ہے اور ایک ہی مربوط انداز لاگو کرنا ہے: صارفین فارمیٹنگ کی باریکیوں پر کنٹرول سونپ دیتے ہیں تاکہ رفتار، حتمیت اور اسٹائل چیکر کی شکایات سے آزادی حاصل کریں۔ ریڈ مے میں بیان کردہ اہم خصوصیات: - پوری فائلوں کو مقامی طور پر دوبارہ فارمیٹ کرتا ہے، پچھلے فارمیٹنگ کو نظر انداز کرتے ہوئے (مستند عملی استثنیات کے ساتھ)۔ - جان بوجھ کر محدود کنفیگریشن آپشنز؛ مناسب ڈیفالٹس پر زور دیا گیا ہے، جس میں پروجیکٹ سیٹنگز pyproject.toml سے پڑھی جا سکتی ہیں (مثلاً شامل/خرج نمونے)۔ - ممکنہ حد تک چھوٹے diffs پیدا کرنے کا مقصد، جسے پروجیکٹ کہتا ہے کہ یہ کوڈ ریویو کو تیز تر بناتا ہے۔ - ایک حفاظتی چیک شامل ہے جو یہ یقینی بناتی ہے کہ دوبارہ فارمیٹ کردہ کوڈ اب بھی اصل کے مؤثر طور پر مساوی AST پیدا کرتا ہے؛ ایک --fast فلگ اس چیک کو چھوڑ دیتا ہے۔ - PEP 8 مطابقت اور اسٹائل تبدیلیوں کو کنٹرول کرنے والی استحکام پالیسی کا دعویٰ کرتا ہے۔ تنصیب اور استعمال: - pip install black کے ذریعے انسٹال کریں؛ اس کے لیے پایتھون 3.10 یا اس سے نیا درکار ہے۔ - جیوپایٹر نوٹ بک فارمیٹنگ black[jupyter] ایکسٹرا کے ذریعے دستیاب ہے۔ - پایتھون انسٹالیشن بغیر صارفین کے لیے GitHub ریلیزز میں اسٹینڈالون PyInstaller بنائے گئے ایگزیکٹیبلز فراہم کیے گئے ہیں۔ - black {source_file_or_directory} یا python -m black {source_file_or_directory} کے طور پر چلائیں۔ اکوسیستم اور اپنانا: ریڈ مے میں کئی اوپن سورس پروجیکٹس کی فہرست ہے جن میں Black استعمال کرتے ہیں، جن میں pytest، tox، Pyramid، Django، Django Channels، Hypothesis، attrs، SQLAlchemy، Poetry، PyPA applications، pandas، Pillow، Twisted، LocalStack، Home Assistant، Zulip، اور Kedro شامل ہیں۔ یہ Dropbox، Lyft، Mozilla，Quora, DuoLingo، اور Tesla جیسے تنظیموں کو بھی استعمال کنندگان کے طور پر نامزد کرتا ہے۔ Mike Bayer, Hynek Schlawack, Kenneth Reitz، اور Carl Meyer سمیت ڈویلپرز سے اقتباسات نقل کیے گئے ہیں۔ پروجیکٹ MIT لائسنس کے تحت ہے، ReadTheDocs پر دستاویزات فراہم کرتا ہے، الگ فائلوں میں تبدیلیوں کا ریکارڈ اور مصنفین کی فہرست برقرار رکھتا ہے، اور اپنے کنٹریبیوٹنگ دستاویزات اور Discord چیٹ کے ذریعے شراکت کی دعوت دیتا ہے۔ یہ پایتھون کمیونٹی کوڈ آف کانڈکٹ کا بھی حوالہ دیتا ہے۔