tempest-cli 0.1.0__py3-none-any.whl

tempest_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,167 @@
+Metadata-Version: 2.5
+Name: tempest-cli
+Version: 0.1.0
+Summary: Framework-agnostic quality gate for Python projects: ruff + mypy + pytest behind one command, with a typing-strictness dial and a PR-description prompt generator.
+Project-URL: Homepage, https://github.com/mauriciobenjamin700/tempest-cli
+Project-URL: Repository, https://github.com/mauriciobenjamin700/tempest-cli
+Project-URL: Issues, https://github.com/mauriciobenjamin700/tempest-cli/issues
+Project-URL: Documentation, https://mauriciobenjamin700.github.io/tempest-cli/
+Author-email: Mauricio Benjamin <mauricio.benjamin@reloverelations.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,lint,mypy,pytest,quality,ruff,typing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: typer>=0.12.0
+Provides-Extra: tools
+Requires-Dist: mypy>=1.13.0; extra == 'tools'
+Requires-Dist: pytest>=8.3.3; extra == 'tools'
+Requires-Dist: ruff>=0.8.0; extra == 'tools'
+Description-Content-Type: text/markdown
+
+# tempest-cli
+
+[![PyPI](https://img.shields.io/pypi/v/tempest-cli.svg)](https://pypi.org/project/tempest-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/tempest-cli.svg)](https://pypi.org/project/tempest-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**Documentação: [Português (BR)](https://mauriciobenjamin700.github.io/tempest-cli/) · [English (US)](https://mauriciobenjamin700.github.io/tempest-cli/en/)**
+
+One command for the quality gate of any Python project — `ruff` +
+`mypy` + `pytest`, with a typing-strictness dial that lives in your
+`pyproject.toml` instead of in four different Makefile targets.
+
+Framework-agnostic on purpose: Django, Flask, Litestar, FastAPI, a
+library, a script. The only runtime dependency is `typer`.
+
+```bash
+uv add --dev tempest-cli
+
+tempest-cli check          # lint + fmt-check + type + test, in order, stops at the first failure
+tempest-cli fix            # every ruff autofix, then format
+tempest-cli type -s strict # override the configured strictness for one run
+```
+
+## Why it exists
+
+The four commands are always the same, and every project rewrites them
+slightly differently — a Makefile here, a `tox.ini` there, a CI job that
+drifts from what runs locally. `tempest-cli check` is the same gate on
+your machine and in CI, and `--strictness` makes "how much typing do we
+enforce" a value in `pyproject.toml` rather than a flag someone
+remembered to pass.
+
+## Commands
+
+| Command | Runs |
+| --- | --- |
+| `tempest-cli lint` | `ruff check` |
+| `tempest-cli fix` | `ruff check --fix` then `ruff format` (`--unsafe` for the risky autofixes) |
+| `tempest-cli format` | `ruff format` (writes) |
+| `tempest-cli fmt-check` | `ruff format --check` (read-only) |
+| `tempest-cli type` | `mypy` |
+| `tempest-cli test` | `pytest` |
+| `tempest-cli check` | all four, in order, stopping at the first failure |
+| `tempest-cli pr-prompt` | builds the prompt that makes an AI write this branch's PR description |
+
+Every command takes an optional path (`tempest-cli lint src/`) and
+returns the underlying tool's exit code, so CI reads it exactly as it
+would read `ruff` directly.
+
+## Typing strictness
+
+```toml
+[tool.tempest]
+typing_strictness = "strict"   # lenient | standard | strict
+```
+
+The level **adds** flags on top of your own `[tool.ruff]` /
+`[tool.mypy]` — it never relaxes what you already configured:
+
+| Level | ruff (extra `ANN` rules) | mypy |
+| --- | --- | --- |
+| `lenient` | none | none |
+| `standard` | `ANN001`, `ANN201`, `ANN202`, `ANN205`, `ANN206` | `--disallow-untyped-defs --disallow-incomplete-defs` |
+| `strict` | the above plus `ANN204` | `--strict` |
+
+`ANN401` is never enabled at any level: `Any` is a legitimate
+annotation. The levels enforce that things *are* annotated, never that
+they avoid `Any`.
+
+Override per run with `--strictness` / `-s`. Absent config means
+`standard`.
+
+## PR descriptions from the branch itself
+
+```bash
+tempest-cli pr-prompt | claude -p
+tempest-cli pr-prompt develop --lang en --out pr_prompt.txt
+```
+
+The prompt carries the repository's own pull-request template (or a
+bundled PT-BR / EN-US default), the rules that stop a model from handing
+back the template with its placeholders intact, and the branch context:
+commit subjects, changed files, and a bounded excerpt of each patch.
+
+Diffs are read as `base...head` — the merge-base diff the forge shows —
+so commits that landed on the base after the branch started are not
+attributed to it. Whatever the bounds leave out is stated inside the
+prompt, so a partial diff reads as partial.
+
+## Use it as a library
+
+```python
+from tempest_cli import load_tempest_config, run_full_check
+
+config = load_tempest_config()
+exit_code = run_full_check(".", config=config)
+```
+
+And to expose the same gate from your own CLI, without copying command
+bodies:
+
+```python
+import typer
+
+from tempest_cli.main import register_commands
+
+cli: typer.Typer = typer.Typer(name="mytool")
+register_commands(cli)
+```
+
+## Installing the tools
+
+`tempest-cli` shells out to whatever `ruff`, `mypy` and `pytest` it
+finds — it does not pin them, so your project chooses the versions. To
+install them alongside it:
+
+```bash
+uv add --dev "tempest-cli[tools]"
+```
+
+## Relationship with tempest-fastapi-sdk
+
+This package was extracted from
+[`tempest-fastapi-sdk`](https://github.com/mauriciobenjamin700/tempest-fastapi-sdk),
+where the same gate shipped as `tempest check`. Getting it meant
+installing FastAPI, SQLAlchemy, Alembic and Pydantic — 38.7 MB of
+dependencies and roughly 0.5 s of import time per invocation, for four
+commands that never touch any of it.
+
+`tempest check` keeps working: the SDK depends on this package and
+registers the same commands. Both stay in sync because there is now one
+implementation.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

tempest_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+tempest_cli/__init__.py,sha256=LvN9oRwItS9Z68-zjpEuhvIUnUb6AnMqVK-YsjGFqz0,2628
+tempest_cli/config.py,sha256=dIdm4Nh9dx-N1ZjbUVOq05LVWlrmngfLrWb6Cj2_In8,5382
+tempest_cli/lint.py,sha256=uh13CbkInk_6TjQlLono6Vey5DPlPRa1YTjxDmJhU6M,8067
+tempest_cli/main.py,sha256=E-jkqJneheiiBNk5ywe9mAuyUo8kq3ui01B9vZn7aj0,14109
+tempest_cli/pr_prompt.py,sha256=h_yKN0BZUWsCUjgRTG-9b2769vx5G8vPEJidf0NOTC4,26978
+tempest_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tempest_cli/_templates/pull_request_template.en-US.md,sha256=NRUK5FGFhWrUDvRUwgxB7mtZW2wXWCUOX6ma2WiTH_Q,726
+tempest_cli/_templates/pull_request_template.pt-BR.md,sha256=R48eC8UZPBEVdMLMtEWcF_WsKrNtt7brejEg0d-8JyY,819
+tempest_cli-0.1.0.dist-info/METADATA,sha256=9YaPxtRLJNpHY5HKTy2p6wmZxHcpBof5WP-qUhxuJ9A,6276
+tempest_cli-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+tempest_cli-0.1.0.dist-info/entry_points.txt,sha256=DFxenlpcHzP04SdHGnuZD3vkwK4J5DPs6eCNR32cvMc,54
+tempest_cli-0.1.0.dist-info/licenses/LICENSE,sha256=YdgslpwuFZBPleHyVIyQ00pWfprH6kntVr3Oc5c98PA,1074
+tempest_cli-0.1.0.dist-info/RECORD,,

tempest_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

tempest_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tempest-cli = tempest_cli.main:main

tempest_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mauricio Benjamin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.