psf/black
Black
Dieses Projekt ist ein kompromissloser, deterministischer Code-Formatter für Python. Er funktioniert, indem er Quellcode in einen abstrakten Syntaxbaum parst und ihn gemäß einer starren, meinungsstarken Menge von Stilregeln neu generiert. Durch die Automatisierung des Formatierungsprozesses werden manuelle Stildiskussionen und Konfigurationsaufwand eliminiert, wodurch sichergestellt wird, dass der Code über ganze Projekte hinweg konsistent bleibt, unabhängig von der ursprünglichen Eingabe.
Das Tool zeichnet sich durch seinen Fokus auf Geschwindigkeit und nahtlose Integration in Entwicklungsworkflows aus. Es nutzt inhaltsbasiertes Datei-Caching und parallele Verarbeitung, um eine hohe Leistung bei großen Codebasen aufrechtzuerhalten, während es gleichzeitig Versionskontroll-Hooks unterstützt, um die Stil-Konsistenz vor dem Commit sicherzustellen. Um die Projekthistorie zu bewahren, bietet es Mechanismen, um spezifische Commits in der Versionskontroll-Blame-Verfolgung zu ignorieren, wodurch sichergestellt wird, dass automatisierte Stiländerungen die ursprüngliche Autorenschaft nicht verdecken.
Über Standard-Quelldateien hinaus erweitert der Formatter seine Fähigkeiten auf Jupyter-Notebooks, Typ-Stubs und eingebettete Codebeispiele innerhalb der Dokumentation. Er bietet breite Kompatibilität durch Plugins für gängige Texteditoren und integrierte Entwicklungsumgebungen sowie Unterstützung für das Language Server Protocol. Die Konfiguration wird über projektweite Dateien verwaltet, die automatisch innerhalb der Verzeichnishierarchie entdeckt werden, was ein konsistentes Verhalten über verschiedene Entwicklungsumgebungen hinweg ermöglicht.
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.
- Tools für Codequalität - Formats Python code automatically.
- Developer Tools - 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.
