Black Formatter

The tool formats Python code according to the Black style, resolving inconsistent formatting across editors. It targets developers, data scientists, and educators who require predictable formatting without installing tools locally. Typical use cases include preparing code for reviews, CI checks, tutorials, or demos where consistent style is essential.

Core Logic & Features: It applies Black-inspired rules to indentation, spacing, and quote usage while preserving semantics. Required: code_text input. Optional: line_length (default 88) and python_version. Advanced: API access and project-wide configuration to align with team standards.

Inputs & Outputs: Inputs: code_text (string, required), line_length (int, optional, chars, default 88), python_version (string, optional). Outputs: formatted_code (string), status (string), diagnostics (string, optional). Validation ensures non-empty code_text and reasonable line_length.

Algorithms & Calculations: Uses AST-based normalization to produce a canonical representation and serialize back to text using Black conventions. Line breaks are chosen to respect line_length; changes are deterministic and idempotent.