Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/violetbuse/storch

A db schema migration library for gleam + sqlight
https://github.com/violetbuse/storch

gleam migrations sqlight sqlite

Last synced: about 1 month ago
JSON representation

A db schema migration library for gleam + sqlight

Awesome Lists containing this project

README

        

# storch

[![Package Version](https://img.shields.io/hexpm/v/storch)](https://hex.pm/packages/storch)
[![Hex Docs](https://img.shields.io/badge/hex-docs-ffaff3)](https://hexdocs.pm/storch/)

**This package is superceded by the [feather](https://hex.pm/packages/feather) package, which offers a superset of storch's functionality**

```sh
gleam add storch
```

Add the following fields to your gleam.toml file:

```toml
# this can of course be anything you like
migrations_dir = "./priv/migrations"
schemafile = "./schema.sql"
```

Then run the command `gleam run -m storch -- new "Initial schema migration"` and make any changes you like.

Running the command `gleam run -m storch -- schema` will create the file ./schema.sql, (or whatever you set in your gleam.toml) with the schema of your database after all migrations have been applied.

```gleam
import storch
import gleam/result
import gleam/erlang
import sqlight

pub fn main() {
let assert Ok(priv_dir) = erlang.priv_directory("my_module_name")
use migrations <- result.try(storch.get_migrations(priv_dir <> "/migrations"))
use connection <- sqlight.with_connection(":memory:")
storch.migrate(migrations, on: connection)
}
```

Further documentation can be found at .

## Development

```sh
gleam run # Run the project
gleam test # Run the tests
gleam shell # Run an Erlang shell
```