# Add Test

> Add unit and integration tests for Prompture functionality. Uses pytest conventions, shared fixtures from conftest.py, and the integration marker pattern. Use when writing tests for new or existing features. Use when this capability is needed.

- Skill: `tomevault-io/add-test-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/add-test-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/add-test-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/add-test-2

---


# Add Tests

Creates tests in `tests/` following project conventions.

## Infrastructure

- Framework: **pytest**
- Shared fixtures: `tests/conftest.py`
- Default model: `DEFAULT_MODEL` (currently `"ollama/gpt-oss:20b"`)
- Integration marker: `@pytest.mark.integration` (skipped by default)

## Available Fixtures and Helpers

```python
# Fixtures
sample_json_schema       # {"name": str, "age": int, "interests": list}
integration_driver       # Driver from DEFAULT_MODEL (skips if unavailable)

# Assertion helpers
assert_valid_usage_metadata(meta)           # Checks prompt_tokens, completion_tokens, total_tokens, cost, raw_response
assert_jsonify_response_structure(response)  # Checks json_string, json_object, usage
```

## File Naming

- `tests/test_{module}.py` — maps to source module
- `tests/test_{feature}.py` — cross-cutting features

## Test Structure

```python
import pytest
from prompture import extract_with_model


class TestFeatureName:
    """Tests for {feature}."""

    def test_basic_behavior(self):
        """What this test verifies."""
        result = some_function(...)
        assert result["key"] == expected

    def test_error_handling(self):
        """Should raise ValueError on invalid input."""
        with pytest.raises(ValueError, match="expected"):
            some_function(bad_input)


class TestFeatureIntegration:
    """Integration tests requiring live LLM access."""

    @pytest.mark.integration
    def test_live_extraction(self, integration_driver, sample_json_schema):
        result = extract_and_jsonify(
            text="John is 30 years old",
            json_schema=sample_json_schema,
            model_name=DEFAULT_MODEL,
        )
        assert_jsonify_response_structure(result)
        assert_valid_usage_metadata(result["usage"])
```

## Rules

- **Unit tests** (no LLM): no marker, must always pass
- **Integration tests** (live LLM): must have `@pytest.mark.integration`
- Use conftest fixtures — don't redefine them
- One test class per logical group with docstrings
- Test both happy path and error cases
- Mock HTTP layer for driver unit tests

## Running

```bash
pytest tests/ -x -q                          # Unit only
pytest tests/ --run-integration -x -q        # Include integration
pytest tests/test_core.py::TestClass::test_method  # Single test
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/jhd3197) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->