# Fixtures

> Reusable test setup with the @fixture decorator.

Reusable test setup with the `@fixture` decorator.

```mermaid
graph LR
    subgraph "Fixture Scopes"
        A[function] --> B[Per test]
        C[class] --> D[Per class]
        E[module] --> F[Per module]
        G[session] --> H[Once per session]
    end
    
    classDef scope fill:#6366F1,stroke:#7C90A0,color:#fff
    classDef desc fill:#10B981,stroke:#7C90A0,color:#fff
    
    class A,C,E,G scope
    class B,D,F,H desc
```

## Basic Fixture

```python
from testagent import fixture

@fixture
def ai_client():
    """Create an AI client for testing."""
    return AIClient()
```

## Fixture with Scope

```python
from testagent import fixture

@fixture(scope="session")
def expensive_resource():
    """Created once per test session."""
    return create_expensive_resource()
```

## Setup and Teardown

Use `yield` for cleanup:

```python
from testagent import fixture

@fixture
def database():
    """Setup and teardown database."""
    db = create_database()
    yield db
    db.cleanup()
```

## Scopes

| Scope | Description |
|-------|-------------|
| `function` | Created for each test (default) |
| `class` | Created once per test class |
| `module` | Created once per module |
| `session` | Created once per test session |

## Example

```python
from testagent import fixture

@fixture
def api_key():
    return "test-api-key"

@fixture(scope="session")
def model():
    return "gpt-4o-mini"

@fixture
def test_client(api_key, model):
    return TestClient(api_key=api_key, model=model)
```

## Fixture Metadata

Fixtures store metadata:

```python
@fixture(scope="module")
def my_fixture():
    return 42

# Access metadata
assert my_fixture._testagent_fixture is True
assert my_fixture._testagent_fixture_scope == "module"
```

## Related pages

- [Advanced Examples](https://testagent.praison.ai/docs/examples/advanced.md)
- [Decorators API Reference](https://testagent.praison.ai/docs/api/decorators.md)
- [Basic Examples](https://testagent.praison.ai/docs/examples/basic.md)
