hhatto/autopep8
Autopep8
autopep8 是一个 Python 静态代码样式器和格式化程序，旨在自动重写源代码以符合 PEP 8 样式指南。它作为一个递归代码清理器，识别并修复整个项目中的缩进、空格和语法不规范之处。
该工具使用抽象语法树（AST）转换执行结构化重构，以执行非空格更改，例如缩短长行和改进身份测试。它包括用于复杂样式违规的激进重构模式，并支持通过内联标记进行选择性格式化，以禁用特定代码块的更改。
功能包括用于定位或忽略特定错误代码的基于规则的修复过滤、行范围格式化，以及生成样式差异报告。该系统可以通过具有递归目录遍历和原地文件修改的命令行界面处理文件，也可以通过 API 以编程方式集成。
格式化偏好和规则集可以通过全局或本地配置文件进行管理。
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.
