इस प्रोजेक्ट के बारे में

Black एक opinionated Python कोड फॉर्मैटर है जो Python Software Foundation द्वारा बनाया गया है। इसका उद्देश्य hand-formatting के बारे में बहसों को समाप्त करना है, एक एकल, सुसंगत शैली लागू करके: users formatting minutiae पर नियंत्रण को गति, determinism और style-checker शिकायतों से मुक्ति के बदले में छोड़ देते हैं। README में वर्णित प्रमुख विशेषताएं: - पिछली formatting को नजरअंदाज करते हुए पूरी फ़ाइलों को एक जगह reformat करता है (दस्तावेजीकृत व्यावहारिक अपवादों के साथ)। - जानबूझकर सीमित configuration विकल्प; sensible defaults पर जोर, जिसमें pyproject.toml से project settings पढ़ी जा सकती हैं (उदाहरण के लिए include/exclude patterns)。 - सबसे छोटे संभव diffs बनाने का प्रयास, जिससे code review तेज़ होती है। - एक safety check शामिल है जो reformatted कोड को मूल के बराबर वैध AST उत्पादित करने की पुष्टि करती है; --fast flag इस check को छोड़ देता है。 - PEP 8 compliance और style changes को नियंत्रित करने वाली stability policy का दावा करता है। Installation और usage: - pip install black द्वारा install करें; Python 3.10 या नएतर का आवश्यक है। - Jupyter Notebook formatting के लिए black[jupyter] extra उपलब्ध है。 - PyInstaller से बने standalone executables GitHub releases में उपलब्ध हैं उन users के लिए जिनके पास Python installation नहीं है。 - black {source_file_or_directory} या python -m black {source_file_or_directory} के रूप में चलाएं。 Ecosystem और adoption: README कई open-source projects की सूची देता है जो 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 जैसे organizations का भी नाम देता है। Mike Bayer, Hynek Schlawack, Kenneth Reitz, और Carl Meyer जैसे developers से testimonials लिए गए हैं। यह project MIT licensed है, ReadTheDocs पर documentation प्रदान करता है, changelog और author list को अलग files में रखता है, और contributing documentation और Discord chat के माध्यम से contributions को आमंत्रित करता है। यह Python Community Code of Conduct का भी हवाला देता है।