psf/black
Black
该项目是一个不妥协的、确定性的 Python 代码格式化程序。它的工作原理是将源代码解析为抽象语法树，并根据一套严格的、主观的样式规则重新生成它。通过自动化格式化过程，它消除了手动样式争论和配置开销，确保代码在整个项目中保持一致，无论原始输入如何。
该工具通过专注于速度和与开发工作流的无缝集成而脱颖而出。它利用基于内容的文件缓存和并行处理来在大型代码库上保持高性能，同时支持版本控制钩子，以在代码提交前强制执行样式一致性。为了保留项目历史，它提供了在版本控制追溯中忽略特定提交的机制，确保自动化的样式更改不会掩盖原始作者身份。
除了标准源文件外，该格式化程序还将其功能扩展到 Jupyter 笔记本、类型存根以及文档中的嵌入式代码示例。它通过主流文本编辑器和集成开发环境的插件，以及对语言服务器协议的支持，提供了广泛的兼容性。配置通过在目录层次结构中自动发现的项目级文件进行管理，从而允许在不同的开发环境中保持一致的行为。
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.
- 代码质量工具 - Formats Python code automatically.
- 开发者工具 - 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.
