google/yapf
Yapf
YAPF es un formateador de código de Python y una herramienta de cumplimiento de estilo. Opera como un reformateador basado en AST que utiliza árboles de sintaxis concretos para garantizar la consistencia estructural y una presentación visual uniforme en todos los archivos fuente.
El motor utiliza un optimizador de diseño basado en penalizaciones para determinar los mejores saltos de línea calculando costos numéricos para diferentes opciones de formato. Emplea un procesador de código multiproceso para distribuir el formato de múltiples archivos a través de varios núcleos de CPU.
La herramienta cubre el reformateo del código fuente a través de modificaciones de archivos in-place, análisis de diferencias y el procesamiento de fragmentos de código parciales. Incluye un sistema de configuración basado en reglas para gestionar preajustes de estilo, reglas de diseño y configuraciones a nivel de proyecto.
Las capacidades de integración incluyen la verificación del cumplimiento de estilo para pipelines de integración continua, automatización de git hooks y funcionalidad de formato al guardar basada en el editor.
Features
- Python Code Formatters - Reformats Python source code to adhere to defined style guides for consistent visual presentation.
- Penalty-Based Layout Optimizers - Implements a penalty-based layout optimizer to determine the most aesthetically pleasing line breaks based on numerical costs.
- Formatting Processors - Employs a recursive descent pattern to traverse the code tree and determine the optimal layout of nested elements.
- AST-Based Formatters - Uses concrete syntax tree analysis to restructure code layout while preserving functional logic.
- Style Rule Configurations - Provides a rule-based configuration system for defining how specific Python constructs should be formatted.
- Python Development Tools - Provides productivity utilities for the Python ecosystem, including automatic code reformatting.
- Layout Rule Definitions - Defines specific layout rules for indentation and line length to ensure visual consistency.
- Source Code Formatters - Automatically reformats Python source code to adhere to a standardized style guide for consistent presentation.
- Style Compliance Checkers - Includes a check-only mode to verify style compliance without modifying files, suitable for continuous integration pipelines.
- Project Configuration Management - Manages formatting and ignore configurations at the project level to ensure consistency across teams.
- Concrete Syntax Tree Transformations - Reconstructs source code by modifying concrete syntax tree representations while preserving the original structural integrity.
- Formatting Behavior Adjustments - Adjusts the layout behavior for Python expressions, lists, and dictionaries using style flags and penalties.
- Git Style Verifiers - Verifies style compliance within git diffs and automates formatting during commit events.
- In-Place File Mutators - Supports updating source files directly on disk with the reformatted version.
- Large-Scale Style Maintenance - Maintains consistent formatting and style across extremely large software repositories using parallel processing.
- Concrete Syntax Tree Generators - Uses concrete syntax trees to maintain high fidelity to the original source code structure during the formatting process.
- Continuous Integration Checks - Executes formatting checks within automated pipelines to identify style violations during pull requests.
- Formatting Exclusion Markers - Provides inline markers that allow developers to exclude specific blocks of code from being reformatted.
- Multi-Process Parallelism - Utilizes multi-process parallelism to distribute the formatting workload across multiple CPU cores for faster execution on large projects.
- Partial Fragment Formatting - Processes specific line ranges or fragments of code to support targeted formatting updates.
- Parallel Processing - Improves performance by distributing the formatting of multiple Python files across several CPU cores.
- Style Presets - Provides named style presets and configuration files to control code indentation and spacing.
- Textual Difference Analysis - Identifies textual differences between the current source and the proposed formatted version without applying changes.
- Code Formatters - Configurable formatter that reformats code to follow best practices.
