resolute-cli 0.2.0

CLI for resolute: offline query cache and database migrations.
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

# resolute-cli

Command-line companion for the `resolute` query macros and a
lightweight migration runner. Ships one binary: `resolute-cli`.

## What it does

- **`prepare`**: scans the crate for `query!` / `query_as!` / etc
  invocations, connects to the live database, and caches the column
  and parameter metadata in `.resolute/` so subsequent builds don't need
  a database. Check this directory into source control if you want
  offline / reproducible builds.
- **`check`**: re-runs `prepare` in verify mode, flagging any queries
  whose schema has drifted from the cache.
- **`migrate`**: `create`, `run`, `revert`, `status`, `info`,
  `validate`, `seed`. Plain SQL files up / down, tracking table
  named `_resolute_migrations`.
- **`database`**: `create` / `drop` lifecycle helpers for dev and CI
  test scaffolding.

## Install

```
cargo install --path resolute-cli
# or from the workspace:
cargo run -p resolute-cli -- --help
```

## Usage sketch

```
export DATABASE_URL=postgres://user:pass@localhost:5432/mydb

resolute-cli prepare               # populate .resolute/
resolute-cli migrate create add_users
resolute-cli migrate run
resolute-cli migrate status
```

## License

Dual licensed under [Apache 2.0](https://github.com/joshburgess/resolute/blob/main/LICENSE-APACHE) or [MIT](https://github.com/joshburgess/resolute/blob/main/LICENSE-MIT). See the [workspace root](https://github.com/joshburgess/resolute#readme) for the broader project.