hhatto/autopep8
Autopep8
autopep8 est un styler et formateur de code statique Python conçu pour réécrire automatiquement le code source afin de se conformer au guide de style PEP 8. Il fonctionne comme un nettoyeur de code récursif qui identifie et corrige les irrégularités d'indentation, d'espacement et de syntaxe à travers des projets entiers.
L'outil effectue un refactoring structurel en utilisant des transformations d'arbre de syntaxe abstraite pour exécuter des changements non liés aux espaces, tels que le raccourcissement des lignes longues et l'amélioration des tests d'identité. Il inclut un mode de refactoring agressif pour les violations de style complexes et prend en charge le formatage sélectif via des marqueurs inline pour désactiver les changements pour des blocs de code spécifiques.
Les capacités incluent le filtrage de corrections basé sur des règles pour cibler ou ignorer des codes d'erreur spécifiques, le formatage par plage de lignes et la génération de rapports de différences de style. Le système peut traiter des fichiers via une interface en ligne de commande avec parcours récursif de répertoires et modification de fichiers sur place, ou être intégré par programmation via une API.
Les préférences de formatage et les ensembles de règles peuvent être gérés via des fichiers de configuration globaux ou locaux.
Features
- Python Code Formatters - Automatically reformats Python source code to comply with the PEP 8 style guide.
- Python Source Formatters - Automatically rewrites Python source code to conform to PEP 8 by fixing indentation and whitespace.
- Python Style Checkers - Ensures Python code adheres to the official PEP 8 style guide by fixing common syntax and layout irregularities.
- Automated Lint Fixes - Identifies and automatically fixes style violations across entire directories to maintain a clean codebase.
- AST-Based Refactoring - Performs structural refactoring using abstract syntax tree transformations to execute non-whitespace changes.
- Source Code Formatting - Provides a programmatic API for formatting Python source strings to ensure consistent styling and indentation.
- PEP 8 Rule Detection - Uses a static analysis engine to identify style violations by matching source code against predefined PEP 8 rules.
- Python Static Analyzers - Identifies and fixes indentation, whitespace, and syntax irregularities using static analysis.
- AST-Based Source Transformations - Implements structural code changes, such as identity test improvements, by manipulating the Python abstract syntax tree.
- Automated Code Refactoring - Applies structural changes to Python code, such as improving identity tests, to enhance overall quality.
- In-Place File Mutators - Overwrites original source files directly on disk with formatted content instead of using standard output.
- Style Difference Reports - Generates difference reports showing required style changes without modifying the actual source files.
- Tag-Based Rule Filtering - Targets specific subsets of style errors or ignores particular rules using error codes.
- Recursive Directory Processing - Functions as a recursive code cleaner that processes files across entire project directories.
- Style Compliance Reporting - Produces reports identifying differences between the current code and the PEP 8 style guide.
- Aggressive Refactoring Modes - Includes an aggressive refactoring mode for resolving complex style violations and shortening long lines.
- Recursive Directory Traversers - Walks through folder hierarchies to locate and process all Python source files within a project path.
- Code Formatters - Automatically adjusts code to conform to PEP 8 standards.
