প্রকল্প সম্পর্কে

ব্ল্যাক হলো পাইথন সফটওয়্যার ফাউন্ডেশন দ্বারা রক্ষিত একটি পাইথন কোড ফরম্যাটার। এর লক্ষ্য হ'ল হ্যান্ড-ফরম্যাটিং নিয়ে বিতর্ক শেষ করা, একটিমাত্র একই রকম স্টাইল প্রয়োগ করে: ব্যবহারকারীরা ফরম্যাটিং মিনিউটিয়া নিয়ে নিয়ন্ত্রণ ত্যাগ করে গতি, ধ্রুবকতা এবং স্টাইল-চেকারের অভিযোগ থেকে মুক্তির বিনিময় করে। README-তে বর্ণিত প্রধান বৈশিষ্ট্যসমূহ: - পূর্ববর্তী ফরম্যাটিং উপেক্ষা করে পুরো ফাইল পরিবর্তনশীলভাবে পুনরায় ফরম্যাট করে (প্রদত্ত বাস্তবসম্মত ব্যতিক্রম সহ)। - সচেতনভাবে সীমিত কনফিগারেশন বিকল্প; যুক্তিসঙ্গত ডিফল্টকে প্রাধান্য দেওয়া হয়, প্রজেক্টের সেটিংস pyproject.toml থেকে পড়া যায় (যেমন include/exclude প্যাটার্ন)। - ক্ষুদ্রতম সম্ভাব্য ডিফ তৈরি করার লক্ষ্য, যা কোড রিভিউকে দ্রুত করে তোলে বলে দাবি করা হয়। - একটি নিরাপত্তা পরীক্ষা অন্তর্ভুক্ত রয়েছে যা নিশ্চিত করে যে পুনর্ফরম্যাট করা কোড মূলটির সাথে কার্যত সমতুল্য একটি বৈধ AST উত্পন্ন করে; --fast ফ্ল্যাগ এই পরীক্ষা এড়িয়ে চলে। - PEP 8-এর সাথে সঙ্গতিপূর্ণ বলে দাবি করা হয় এবং স্টাইল পরিবর্তন সংক্রান্ত একটি স্থিতিশীলতা নীতি বজায় রাখে। স্থাপন এবং ব্যবহার: - pip install black মাধ্যমে ইনস্টল করুন; Python 3.10 বা তার উচ্চ সংস্করণ প্রয়োজন। - Jupyter Notebook ফরম্যাটিং black[jupyter] এক্সট্রা এর মাধ্যমে উপলব্ধ। - Python ইনস্টলেশনবিহীন ব্যবহারকারীদের জন্য GitHub রিলিজ-এ স্বতন্ত্র PyInstaller-তৈরি এক্সিকিউটেবলগুলো প্রদান করা হয়। - কমান্ড হিসেবে চালান: black {source_file_or_directory} অথবা python -m black {source_file_or_directory}। ইকোসিস্টেম এবং গৃহীত প্রকল্প: README-তে বহু ওপেন সোর্স প্রজেক্টের তালিকা রয়েছে যারা Black ব্যবহার করে, যেমন pytest, tox, Pyramid, Django, Django Channels, Hypothesis, attrs, SQLAlchemy, Poetry, PyPA অ্যাপ্লিকেশন, pandas, Pillow, Twisted, LocalStack, Home Assistant, Zulip এবং Kedro। এছাড়া Dropbox, Lyft, Mozilla, Quora, Duolingo, এবং Tesla-এর মতো সংস্থাগুলোও এর ব্যবহারকারী। প্রকল্পটি MIT লাইসেন্সের অধীনে, ReadTheDocs-এ নথিপত্র সরবরাহ করে, আলাদা ফাইলে পরিবর্তনের ইতিহাস এবং লেখক তালিকা বজায় রাখে, এবং অবদান রাখতে contributing দলিলপত্র এবং Discord চ্যাটের মাধ্যমে আমন্ত্রণ জানায়। এটি Python কমিউনিটি কোড অফ কনডাক্ট-কেও রেফারেন্স করে।