Installation

# Add this to your shard.yml
dependencies:
  lucky_migrator:
    github: luckyframework/lucky_migrator
    version: ~> 0.6.0

Then run:

shards install

shard.yml

Crystal
0.25.0
License
MIT
Author
Paul Smith
Target
  • gen.migration from src/precompiled_tasks/gen/migration.cr

Dependencies

Runtime Dependencies

  • db*github: crystal-lang/crystal-db
  • pg*github: will/crystal-pg
  • habitat*github: luckyframework/habitat
  • lucky_cli*github: luckyframework/lucky_cli
  • lucky_record*github: luckyframework/lucky_record
  • lucky_inflector*github: luckyframework/lucky_inflector

README

LuckyMigrator

A crystal library that can be used to create/drop/migrate/rollback your database

Installation

Add this to your application's shard.yml:

# Remember to also install the LuckyCli to run the tasks
dependencies:
  lucky_migrator:
    github: luckyframework/lucky_migrator

LuckyMigrator requires installing the LuckyCli so you can run the tasks. See instructions at the LuckyCli repo.

Setup tasks in tasks.cr

# tasks.cr file
require "lucky_cli"

# This will load all the db tasks
require "lucky_migrator"

# Require your migrations. Remember to create the directory too.
require "./db/migrations/*"

LuckyMigrator::Runner.db_name = "my_cool_db"

# This should always be at the bottom or your tasks won't be available in LuckyCli
LuckyCli::Runner.run

Creating, dropping and migrating the database

This library consists of various tasks that can be run with LuckyCli

lucky db.create
lucky db.drop
lucky db.migrate
lucky db.rollback
lucky db.rollback_all

Generating a migration

lucky gen.migration CreateUsers

This will create a timestamped migration in db/migrations

Contributing

  1. Fork it ( https://github.com/luckyframework/lucky_migrator/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Testing

To run the tests:

  • Install Postgres: (macOS/Others)
  • Migrate the database using lucky db.create && lucky db.migrate
  • Run the tests with crystal spec

Contributors