weavejester.ragtime

https://github.com/weavejester/ragtime.git


    git clone 'https://github.com/weavejester/ragtime.git'
      

      

(ql:quickload :weavejester.ragtime)

★446

Ragtime

Ragtime is a Clojure library for migrating structured data in a way that's database independent. It defines a common interface for expressing migrations, much like Ring defines a common interface for expressing web applications.

Installation

Add the following dependency to your project file:

[ragtime "0.8.0"]

Overview

Ragtime needs three pieces of data to work:

A migratable data store
An ordered sequence of migrations
A strategy on how to deal with conflicts

A data store is an implementation of the DataStore protocol, and tells Ragtime how to record which migrations are applied to an arbitrary store of data, such as a database.

Since 0.5.0, migrations are implementations of the Migration protocol, which has three methods:

id - returns a unique ID for the migration
run-up! - applies the migration to a database
run-down! - rolls back the migration in a database

Ragtime comes with a way of loading SQL migrations from files, and applying them to a SQL database.

Documentation

License

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.