Metadata-Version: 2.4
Name: drace
Version: 2.3.0
Summary: A pragmatic, resilient Python linter and formatter
Author: Caleb M. Sibanda
Author-email: darkian.dev@gmail.com
License: MIT
Project-URL: Homepage, https://github.com/2kDarki/drace
Project-URL: Documentation, https://github.com/2kDarki/drace#readme
Project-URL: Repository, https://github.com/2kDarki/drace
Project-URL: Issues, https://github.com/2kDarki/drace/issues
Keywords: linter,formatter,python,cli,ast,code-quality,pragmatic,resilient
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cnat
Requires-Dist: tuikit>=0.1.3
Dynamic: author
Dynamic: author-email
Dynamic: license-file

# Drace

Drace is a pragmatic Python linter and formatter focused on readability,
maintainability, and practical code quality signals.

## Highlights

- Lint + format + score workflows in one CLI
- Syntax-tolerant analysis so broken files still receive useful feedback
- Rule-driven autofix with multi-pass formatting
- Strict CI mode via `--strict-fix`
- Configurable defaults through `drace config`

## Installation

```bash
pip install drace
```

## Quick Start

```bash
drace lint src/
drace format src/
drace format src/ --diff
drace format src/ --strict-fix
drace score src/
```

## Configuration

```bash
drace config list
drace config line_len 100
drace config ignored_rules + Z221
drace config reset all
```

Flexible separators are supported:

```bash
drace config line_len = 100
drace config color :: on
```

## Documentation

- `docs/README.md`
- `docs/engine.md`
- `docs/autofix.md`
- `docs/config.md`
- `docs/rules/README.md`

## Philosophy

Drace emphasizes structure over cosmetic compliance. It flags maintainability
pressure early so teams can keep code easy to understand and safe to change.

## Limitations

- Python-focused tooling
- Deeper analysis may be slower than style-only linters
- Opinionated defaults may differ from strict PEP8-only setups

## License

MIT. See `LICENSE`.

## Contributing

See `CONTRIBUTING.md`.
