Metadata-Version: 2.4
Name: qualitybase
Version: 0.1.1
Summary: Standardized services and tooling for managing code quality, development workflows, and project maintenance in Python projects
Author-email: Octolo <dev@octolo.tech>
License-Expression: MIT
Project-URL: Homepage, https://github.com/octolo/python-qualitybase
Project-URL: Repository, https://github.com/octolo/python-qualitybase
Project-URL: Documentation, https://github.com/octolo/python-qualitybase#readme
Project-URL: Issues, https://github.com/octolo/python-qualitybase/issues
Keywords: code-quality,linting,testing,development-tools,python,ci-cd,code-analysis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
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
Classifier: Topic :: Software Development :: Testing
Requires-Python: <4.0,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: clicommands>=0.0.1
Provides-Extra: lint
Requires-Dist: ruff>=0.5.0; extra == "lint"
Requires-Dist: mypy>=1.0.0; extra == "lint"
Provides-Extra: quality
Requires-Dist: radon>=6.0.0; extra == "quality"
Requires-Dist: vulture>=2.0.0; extra == "quality"
Provides-Extra: security
Requires-Dist: bandit>=1.7.0; extra == "security"
Provides-Extra: security-audit
Requires-Dist: pip-audit>=2.7.0; extra == "security-audit"
Provides-Extra: build
Requires-Dist: build>=1.0.0; extra == "build"
Dynamic: license-file

# python-qualitybase

Python library for code quality, development workflows, and project maintenance.

## Installation

```bash
pip install qualitybase
```

For development:

```bash
pip install -e .
pip install -e ".[dev,lint,quality,security,test]"
```

## Usage

Qualitybase exposes its commands via [clicommands](https://github.com/octolo/python-clicommands):

```bash
qualitybase <command> [args...]
```

### Commands

- **quality** — Quality checks (lint, security, test, complexity, cleanup)
- **build** — Package build
- **clean** — Build artifacts cleanup
- **publish** — Package publishing
- **version** — Show version (from clicommands)
- **copy** — Copy templates (from clicommands)
- **varenv** — Environment variables (from clicommands)

### Examples

```bash
# Quality (default: lint mode)
qualitybase quality
qualitybase quality --mode=security
qualitybase quality lint ruff

# Build and publish
qualitybase build
qualitybase publish

# Help
qualitybase
```

### Environment Variables

- **ENVFILE_PATH** — Path to `.env` file to load automatically

## Documentation

- `docs/purpose.md` — Project purpose and goals
- `docs/structure.md` — Project structure
- `docs/development.md` — Development guidelines
- `docs/AI.md` — AI assistant contract
