psf/black
Black
Este proyecto es un formateador de código determinista e intransigente para Python. Funciona analizando el código fuente en un árbol de sintaxis abstracta y regenerándolo de acuerdo con un conjunto rígido y opinado de reglas de estilo. Al automatizar el proceso de formato, elimina los debates manuales sobre estilo y la sobrecarga de configuración, asegurando que el código permanezca consistente en proyectos completos independientemente de la entrada original.
La herramienta se distingue por su enfoque en la velocidad y la integración fluida en los flujos de trabajo de desarrollo. Utiliza el almacenamiento en caché de archivos basado en contenido y el procesamiento paralelo para mantener un alto rendimiento en grandes bases de código, mientras admite ganchos de control de versiones para aplicar la consistencia de estilo antes de que se confirme el código. Para preservar el historial del proyecto, proporciona mecanismos para ignorar confirmaciones específicas en el seguimiento de autoría del control de versiones, asegurando que los cambios de estilo automatizados no oscurezcan la autoría original.
Más allá de los archivos fuente estándar, el formateador extiende sus capacidades para incluir cuadernos Jupyter, stubs de tipo y ejemplos de código incrustados dentro de la documentación. Ofrece una amplia compatibilidad a través de complementos para los principales editores de texto y entornos de desarrollo integrados, así como soporte para el protocolo de servidor de lenguaje. La configuración se gestiona a través de archivos a nivel de proyecto que se descubren automáticamente dentro de la jerarquía de directorios, lo que permite un comportamiento consistente en diversos entornos de desarrollo.
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.
- Herramientas de calidad de código - Formats Python code automatically.
- Herramientas de desarrollo - 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.
