true-formatter 0.1.0

The uncompromising Python formatter.

True — The Uncompromising Python Formatter

True is an opinionated Python source-code formatter inspired by Black. It enforces a consistent style so you never have to think about formatting again.

---

Features

• Normalises string quotes ('hello' → "hello")
• Removes trailing whitespace from every line
• Enforces two blank lines before top-level def / class
• Fixes spacing around = and binary operators
• Guarantees a single trailing newline
• Pluggable rule system — extend or disable any rule
• Zero dependencies (pure stdlib)

---

Installation

pip install true-formatter

Or from source:

git clone https://github.com/yourname/true-formatter
cd true-formatter
pip install -e .[dev]

---

Quick start

As a CLI tool

# Format a file in-place
true my_script.py

# Check without modifying
true --check my_script.py

# Show a unified diff
true --diff my_script.py

# Format an entire directory
true src/

# Read from stdin
echo "x=1" | true -

As a library

import true_formatter

code = "x=1\ny=  'hello'\n"
result = true_formatter.format_str(code, mode=true_formatter.Mode())
print(result)
# x = 1
# y = "hello"

---

Documentation

Document	Description
API Reference	Full public API — format_str, Mode, RuleSet, exceptions
CLI Reference	All command-line flags and examples
Architecture	How the formatter pipeline works internally
Contributing	Writing rules, running tests, sending PRs

---

License

MIT © True Contributors