psf/black
Black
Ce projet est un formateur de code déterministe et sans compromis pour Python. Il fonctionne en analysant le code source dans un arbre de syntaxe abstraite et en le régénérant selon un ensemble rigide et opinionné de règles de style. En automatisant le processus de formatage, il élimine les débats manuels sur le style et la surcharge de configuration, garantissant que le code reste cohérent sur l'ensemble des projets, indépendamment de l'entrée originale.
L'outil se distingue par son accent sur la vitesse et l'intégration transparente dans les flux de travail de développement. Il utilise la mise en cache de fichiers basée sur le contenu et le traitement parallèle pour maintenir des performances élevées sur de grandes bases de code, tout en prenant en charge les hooks de contrôle de version pour appliquer la cohérence du style avant que le code ne soit validé. Pour préserver l'historique du projet, il fournit des mécanismes pour ignorer des commits spécifiques dans le suivi des auteurs du contrôle de version, garantissant que les changements de style automatisés n'obscurcissent pas la paternité originale.
Au-delà des fichiers sources standard, le formateur étend ses capacités pour inclure les notebooks Jupyter, les stubs de type et les exemples de code intégrés dans la documentation. Il offre une large compatibilité via des plugins pour les principaux éditeurs de texte et environnements de développement intégrés, ainsi qu'un support pour le protocole de serveur de langage. La configuration est gérée via des fichiers au niveau du projet qui sont automatiquement découverts dans la hiérarchie des répertoires, permettant un comportement cohérent sur divers environnements de développement.
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.
- Outils de qualité de code - Formats Python code automatically.
- Outils de développement - 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.
