Black is the uncompromising Python code formatter. It is a CLI tool that automatically reformats Python source code to a consistent style, with a focus on determinism and minimal configuration. The repository contains the core formatting engine, a HTTP server (blackd) for on-demand formatting, a GitHub Action for CI integration, and a Vim plugin. The architecture is modular: parsing uses a forked lib2to3 parser (blib2to3) for lenient syntax handling, then a visitor-based line generator produces formatted lines, with specialized transformers for strings, brackets, and comments. It supports Jupyter notebooks, line-range formatting, caching, and parallel execution. The codebase is exceptionally well-tested with hundreds of edge-case test files and a comprehensive test suite. It demonstrates high craftsmanship in areas like tree manipulation, concurrency patterns, and string normalization.
pgFormatter is a mature, widely-used SQL formatter specifically designed for PostgreSQL. It operates as a command-line tool, a CGI web service, and a library, providing consistent formatting of SQL statements according to configurable rules (keyword case, indentation, comma placement, line width, etc.). The core formatting logic resides in the self-contained Perl module `lib/pgFormatter/Beautify.pm`, which parses SQL tokens and reformats them based on a comprehensive set of rules. The project includes a vast regression test suite derived from PostgreSQL's own regression tests, ensuring high syntax coverage and correctness across DDL, DML, procedural code, and edge cases. It also offers pre-commit hook integration and Docker deployment for CI/CD pipelines. The codebase is well-structured, actively maintained, and demonstrates strong engineering practices with isolated modules and extensive test coverage.
This repository serves as a pre-commit hook configuration for Ruff, an extremely fast Python linter and formatter. It defines three pre-commit hooks: `ruff-check`, `ruff-format`, and a legacy `ruff` alias. The core operational code is a single Python script (`mirror.py`) that automates version mirroring: it fetches the latest Ruff release from PyPI and updates version strings in `pyproject.toml` and `README.md`. A GitHub Actions workflow runs this script on a schedule (every 4 hours), commits changes, tags releases, and creates GitHub releases. The repository is a minimal, well-structured wrapper that enables installing Ruff via pre-commit hooks. There is no application logic beyond the mirror script; the project's value is in its configuration and automation pipeline for staying in sync with upstream Ruff releases.