quelltest 0.1.0__tar.gz

quelltest-0.1.0/.claude/settings.local.json

@@ -0,0 +1,26 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv sync *)",
+      "Bash(pip3 --version)",
+      "Bash(pip --version)",
+      "Bash(pip install *)",
+      "Bash(python -m uv --version)",
+      "Bash(python -m uv sync --dev)",
+      "Bash(python -m uv sync --extra dev)",
+      "Bash(python -m uv run pytest tests/ -v)",
+      "Bash(python -m uv venv /tmp/quell-verify --python 3.11)",
+      "Bash(python -m uv venv /tmp/quell-verify)",
+      "Bash(python -m uv pip install --python .venv/Scripts/python.exe -e \".[dev]\")",
+      "Bash(cat /tmp/quell-verify/bvenkzlwk.output 2>/dev/null || true)",
+      "Read(//tmp/quell-verify/**)",
+      "Bash(python -m uv venv /tmp/quell-verify --seed)",
+      "Bash(python -m uv pip install --python /c/Users/binda/AppData/Local/Temp/quell-verify/Scripts/python.exe -e '.[dev]')",
+      "Bash(/c/Users/binda/AppData/Local/Temp/quell-verify/Scripts/python.exe -m pytest tests/ -v --tb=short)",
+      "Bash(python -m uv build)",
+      "Bash(python -m uv publish --token \"pypi-AgEIcHlwaS5vcmcCJDIxMTZiMzk1LTFkYWItNDk3Yy1hOTI5LWYzYTFiNDRjZDc0NwACKlszLCI1MGNiOWNiNy1hOGFiLTRmYjctOTM0YS1jMGUyZWIzNmU2OWYiXQAABiByWgSJydXoe_mWeESQi1vIFCiYJPowsRqv9I_DpOmzsg\")",
+      "Bash(python -m uv pip show quell)",
+      "Bash(python -m pip index versions quell)"
+    ]
+  }
+}

quelltest-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Type check
+        run: uv run mypy quell/
+
+      - name: Test
+        run: uv run pytest tests/ -v --cov=quell --cov-report=xml
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4

quelltest-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,23 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}

quelltest-0.1.0/CLAUDE.md

@@ -0,0 +1,38 @@
+# Quell — AI Assistant Instructions
+
+## What this project is
+Quell auto-generates verified killing tests for survived mutants from mutmut and Stryker.
+It reads mutation testing results, generates pytest assertions using rule-based logic + LLMs,
+verifies each test actually kills the mutant, and injects it into test files via libcst.
+
+## Tech Stack
+- Python 3.11+, Typer CLI, Rich terminal UI, Pydantic v2, libcst, pytest
+
+## Key invariants — NEVER violate these
+1. `verifier.py`: ALWAYS restore source files in a `finally` block
+2. `writer.py`: ALWAYS backup before writing, ALWAYS restore on failure
+3. `writer.py`: ALWAYS validate CST parses correctly before writing to disk
+4. NO code is transmitted to any server except the configured LLM provider
+5. The LLM is ONLY called when rule-based generation is insufficient
+
+## Running tests
+```bash
+uv run pytest tests/ -v
+```
+
+## Adding a new mutation operator
+1. Add the enum value to `MutationOperator` in `core/models.py`
+2. Add classification logic to `_classify_operator` in `core/analyzer.py`
+3. Add generator method `_generate_<operator>_test` in `core/generator.py`
+4. Add route in `generate()` method in `core/generator.py`
+5. Add tests in `tests/unit/test_generator.py`
+
+## Adding a new mutation adapter (e.g., PIT for Java)
+1. Create `adapters/pit_adapter.py` implementing `MutationAdapter` protocol
+2. Add it to `_get_adapter()` in `cli.py`
+3. Add integration tests in `tests/adapters/`
+
+## Code style
+- Run `ruff check . --fix` before committing
+- All public functions must have docstrings
+- Pydantic models for all data structures (no raw dicts crossing module boundaries)

quelltest-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: quelltest
+Version: 0.1.0
+Summary: Auto-generates verified killing tests for survived mutants from mutmut and Stryker
+Project-URL: Homepage, https://github.com/shashank7109/quell
+Project-URL: Documentation, https://quell.dev
+Project-URL: Repository, https://github.com/shashank7109/quell
+Project-URL: Issues, https://github.com/shashank7109/quell/issues
+Author-email: Shashank Bindal <bindalshashank.89@gmail.com>
+License: MIT
+Keywords: mutation-testing,mutmut,pytest,stryker,test-generation,testing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.11
+Requires-Dist: anthropic>=0.28.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: libcst>=1.3.0
+Requires-Dist: openai>=1.30.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Quell
+
+> *Quell your survivors. Strengthen your tests.*
+
+Quell auto-generates verified, killing tests for survived mutants from mutmut and Stryker.
+
+## What it does
+
+Quell reads surviving mutants from mutation testing tools (mutmut for Python, Stryker for JS/TS), analyzes each surviving mutant using Python's AST (via libcst), generates a targeted pytest assertion that would catch the mutation, verifies the generated test actually kills the mutant by applying the mutant and running the test in a subprocess, then writes only verified tests to the test file using libcst (preserving formatting and comments).
+
+- Code never leaves the machine (unless you configure an LLM provider)
+- Every write is auto-restored on failure
+- Full audit log is maintained
+
+## Installation
+
+```bash
+pip install quell
+```
+
+## Quick Start
+
+```bash
+# Step 1: Run your mutation testing tool first
+mutmut run                          # for Python projects
+npx stryker run --reporters=json    # for JS/TS projects
+
+# Step 2: Let quell scan survivors
+quell scan                          # see what survived
+
+# Step 3: Fix interactively
+quell fix                           # review + apply one by one
+
+# Step 4: Or auto-fix everything
+quell auto --dry-run                # preview
+quell auto                          # apply all verified tests
+
+# Config (optional)
+quell init                          # adds [tool.quell] to pyproject.toml
+
+# Use local LLM (privacy-first)
+quell fix --llm ollama              # requires ollama running locally
+```
+
+## Configuration
+
+Add `[tool.quell]` to your `pyproject.toml`:
+
+```toml
+[tool.quell]
+llm_provider = "anthropic"           # "anthropic" | "openai" | "ollama"
+llm_model = "claude-sonnet-4-5"
+max_verification_attempts = 3
+verification_timeout_seconds = 30
+auto_write = false
+```
+
+Set your API key:
+
+```bash
+export ANTHROPIC_API_KEY=sk-...
+# or
+export OPENAI_API_KEY=sk-...
+```
+
+## License
+
+MIT