psf/black
Black
هذا المشروع عبارة عن منسق كود حتمي لا يساوم لـ Python. يعمل عن طريق تحليل الكود المصدري إلى شجرة بناء جملة مجردة وإعادة إنشائه وفقاً لمجموعة صارمة ومحددة من قواعد الأسلوب. من خلال أتمتة عملية التنسيق، فإنه يلغي نقاشات الأسلوب اليدوية وعبء الإعداد، مما يضمن بقاء الكود متسقاً عبر المشاريع بأكملها بغض النظر عن الإدخال الأصلي.
تتميز الأداة بتركيزها على السرعة والتكامل السلس في سير عمل التطوير. تستخدم التخزين المؤقت للملفات القائم على المحتوى والمعالجة المتوازية للحفاظ على أداء عالٍ في قواعد الكود الكبيرة، مع دعم خطافات التحكم في الإصدار لفرض اتساق الأسلوب قبل الالتزام بالكود. للحفاظ على تاريخ المشروع، توفر آليات لتجاهل التزامات معينة في تتبع اللوم للتحكم في الإصدار، مما يضمن أن تغييرات الأسلوب المؤتمتة لا تحجب التأليف الأصلي.
إلى جانب ملفات المصدر القياسية، توسع الأداة قدراتها لتشمل دفاتر Jupyter، وملفات تعريف النوع، وأمثلة الكود المضمنة داخل التوثيق. توفر توافقاً واسعاً من خلال إضافات لمحررات النصوص الرئيسية وبيئات التطوير المتكاملة، بالإضافة إلى دعم بروتوكول خادم اللغة. تُدار الإعدادات من خلال ملفات على مستوى المشروع يتم اكتشافها تلقائياً داخل هرمية المجلدات، مما يسمح بسلوك متسق عبر بيئات التطوير المتنوعة.
Features
- Code Formatters - Automatically enforces a strict, uniform style across source files.
- Python Development Tools - Provides an uncompromising, deterministic code formatter for the Python ecosystem.
- Automated Formatting Frameworks - Enforces a consistent style across a codebase by automatically applying opinionated rules to source files.
- Python Tooling - Applies opinionated style rules to Python source code, supporting customizable line lengths and target versions.
- VS Code Extensions - Automates code styling within VS Code via extensions.
- Parsers & Lexers - Parses and reconstructs source code according to predefined syntactic rules.
- Code Analysis - Listed in the “Code Analysis” section of the Awesome Python awesome list.
- Code Analysis and Quality - Uncompromising, opinionated code formatter.
- Code Formatters - Uncompromising and opinionated automatic code formatter.
- أدوات جودة الكود - Formats Python code automatically.
- أدوات المطور - Uncompromising Python code formatter.
- Linting And Formatting - Uncompromising Python code formatter.
- Python Packages - Code formatting for Python.
- Notebook Formatting Tools - Applies consistent styling to Jupyter notebook files.
- Development Workflow Integrations - Connects automated styling tools directly into text editors and continuous integration pipelines.
- Language Server Protocols - Connects code editors to formatting tools using standard protocols.
- Git Hooks - Ensures only properly formatted code enters the repository history via pre-commit checks.
- Import Sorters - Aligns import sorting behavior with project style guidelines.
- Project Configuration Discovery - Defines project-specific formatting defaults and exclusion patterns in a configuration file that is automatically discovered.
- Notebook Automation Tools - Integrates notebook file processing into development workflows.
- Notebook Formatters - Applies consistent styling to interactive notebook files to improve readability.
- Build Caches - Stores results on disk to skip unmodified files and speed up workflows.
- Build Caching Systems - Stores hashes of processed files to skip redundant formatting operations and significantly improve performance on large codebases.
- File Exclusion Rules - Allows preventing specific files or directories from being modified.
- Line Wrapping Engines - Wraps long lines of code by applying uniform whitespace rules and bracket-based indentation.
- Version Control Ignore Parsers - Automatically skips files listed in version control ignore files.
- Version Control Utilities - Supports excluding specific commits from history tracking to preserve accurate code authorship during automated formatting.
