admixture-macros 0.1.0

Proc macros for declaratively defining test contexts and services
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# admixture

A Rust framework for managing service lifecycles in integration tests. Admixture lets you declaratively define test contexts composed of services (databases, caches, HTTP servers, etc.) with automatic setup and teardown.

## Crates

| Crate | Description |
|-------|-------------|
| [`admixture`](https://crates.io/crates/admixture) | Core traits and macros for defining services and contexts |
| [`admixture-macros`](https://crates.io/crates/admixture-macros) | Proc macros for declaratively defining test contexts |
| [`admixture-docker`](https://crates.io/crates/admixture-docker) | Docker container services via testcontainers |
| [`admixture-docker-macros`](https://crates.io/crates/admixture-docker-macros) | Proc macro for defining Docker container services |
| [`admixture-harness`](https://crates.io/crates/admixture-harness) | Test harness with context reuse and grouped execution |
| [`admixture-harness-macros`](https://crates.io/crates/admixture-harness-macros) | Attribute macro for registering tests with contexts |

## Quick Start

Add `admixture` to your dev-dependencies:

```toml
[dev-dependencies]
admixture = "0.1"
```

Define a test context with services:

```rust
use admixture::context;

context! {
    MyTestContext {
        database: MockDatabaseSetup,
        cache: MockCacheSetup,
    }
}
```

### With Docker containers

Use `admixture-docker` for real database/cache containers in tests:

```toml
[dev-dependencies]
admixture = "0.1"
admixture-docker = { version = "0.1", features = ["sqlx-postgres"] }
```

```rust
use admixture::context;
use admixture_docker::SqlxPostgresServiceSetup;
use testcontainers_modules::postgres::Postgres;

context! {
    PostgresTestContext {
        postgres: SqlxPostgresServiceSetup,
    }
}
```

### With the test harness

Use `admixture-harness` for automatic context lifecycle management and context reuse across tests:

```toml
[dev-dependencies]
admixture = "0.1"
admixture-harness = "0.1"
```

```rust
use admixture::context;
use admixture_harness::prelude::*;

#[admixture_test(context = MyTestContext)]
async fn test_something(ctx: &MyTestContext) -> Result<(), TestError> {
    // Context is automatically started and shared across tests
    Ok(())
}

admixture_harness::test_runner!();
```

The harness starts each context type **once** and reuses it across all tests that share that context, significantly reducing test execution time.

## License

Licensed under the [MIT License](LICENSE).