mae 0.3.6

Opinionated async Rust framework for building Mae-Technologies micro-services — app scaffolding, repo layer, middleware, and test utilities.
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

For development rules, see [DEVELOPMENT.md](DEVELOPMENT.md)

# mae

Opinionated async Rust framework for building [Mae-Technologies](https://github.com/Mae-Technologies) micro-services.

## Features

- **App scaffolding** — `app::build`, `app::configuration`, `app::run`: opinionated Actix-Web server setup with session middleware, tracing, and Redis
- **Repository layer** — `repo`: typed async CRUD helpers over SQLx/Postgres
- **Middleware** — `middleware`: session extraction, service-to-service auth, request context injection
- **Telemetry** — `telemetry`: structured JSON logging via `tracing-bunyan-formatter`
- **Test utilities** (`test-utils` feature) — TestContainer helpers for Postgres, Neo4j, Redis, RabbitMQ; `must::*` assertion helpers; env helpers

## Usage

Add to `Cargo.toml`:

```toml
[dependencies]
mae = "0.1"
```

For test utilities:

```toml
[dev-dependencies]
mae = { version = "0.1", features = ["test-utils"] }
```

## Postgres test helper modes (`test-utils`)

Postgres test helpers support two modes:

- **Container mode** (`MAE_TESTCONTAINERS=1`): starts `ghcr.io/mae-technologies/postgres-mae` via testcontainers (existing behavior).
- **Fallback mode** (default when `MAE_TESTCONTAINERS` is unset/false): connects to an already-running Postgres.

Fallback mode uses safe defaults and allows env overrides:

- `MAE_TEST_PG_HOST` (default `127.0.0.1`)
- `MAE_TEST_PG_PORT` (default `5432`)
- `MAE_TEST_PG_DB` (default `mae_test`)
- `MAE_TEST_PG_USER` (default `app`)
- `MAE_TEST_PG_PASSWORD` (default `secret`)
- `MAE_TEST_PG_MIGRATOR_USER` (default `db_migrator`)
- `MAE_TEST_PG_MIGRATOR_PASSWORD` (default `migrator_secret`)
- `MAE_TEST_PG_SEARCH_PATH` (default `options=-csearch_path%3Dapp`)

`spawn_scoped_schema()` and shared pool setup work in both modes.
For safety, fallback mode refuses database names that do not include `_test`.

## License

MIT

## `test-utils` quickstart

```rust,no_run
use mae::testing::{context::TestContext, must::Must};
use mae_macros::mae_test;

#[mae_test(docker, teardown = mae::testing::containers::teardown_all)]
async fn integration_test_insert_vendor() {
    let ctx = TestContext::<()>::new().await.must();

    // run queries against ctx.pool, namespaced by ctx.schema as needed

    ctx.teardown().await.must();
}
```