Suweal Generator

Package Version Hex Docs

An (experimental) code generation library for .surql files.

[dev_dependencies]
suweal_gen = ">= 0.7.1 and < 1.0.0"

Running the generator

The generator has two commands, gen and clear. Both take an optional path argument (the source directory, defaults to ./src).

gen

Finds every .surql file under path (recursively) and generates the matching .gleam modules next to it.

gleam run -m suweal_gen -- gen [path] [flags]
FlagDescription
--offstageEnable the offstage integration
--serviceEnable the suweal_service integration
--versioningEnable versioning (see below)
--forceForce generation, ignoring any checks

No integration:

gleam run -m suweal_gen -- gen

offstage integration:

gleam run -m suweal_gen -- gen --offstage

Versioning

With --versioning, each generation is stored as a numbered version. The generator records a hash of every .surql file in versions.json and, when the schema changed since the previous version, writes the field changes as a migration in migrations/. Generated versions live in versions/.

If no .surql file changed since the last version, generation is skipped. Use --force to generate anyway.

clear

Removes everything the generator produced under path: the generated .gleam files, versions/, versions.json and migrations/.

gleam run -m suweal_gen -- clear [path]
✨ Search Document