Skip to content
mongodb adapter for "east"
JavaScript
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
.gitignore
.npmignore
LICENSE.txt
README.md
package.json

README.md

east mongo

mongodb adapter for east (node.js database migration tool) which uses mongodb native driver

All executed migrations names will be stored at _migrations collection in the current database. Object with following properties will be passed to migrate and rollback functions:

  • db - instance of mongodb native db
  • dropIndexIfExists function(collection, index, callback) - helper function which can be used for dropping index in safe way (contrasting to collection.dropIndex which throws an error if index doesn't exist).

Installation

npm install east east-mongo -g

alternatively you could install it locally

Usage

go to project dir and run

east init

create .eastrc file at current directory

{
    "adapter": "east-mongo",
    "url": "mongodb://localhost:27017/test"
}

where url is url of database which you want to migrate (in mongodb native url connection format)

now we can create some migrations

east create apples
east create bananas

created files will looks like this one

exports.migrate = function(client, done) {
    var db = client.db;
    done();
};

exports.rollback = function(client, done) {
    var db = client.db;
    done();
};

edit created files and insert

to 1_apples

exports.migrate = function(client, done) {
    var db = client.db;
    db.collection('things').insert({_id: 1, name: 'apple', color: 'red'}, function(err) {
        if (err) done(err);
        db.collection('things').insert({_id: 2, name: 'apple', color: 'green'}, done);
    });
};

exports.rollback = function(client, done) {
    var db = client.db;
    db.collection('things').remove({_id: {$in: [1, 2]}}, done);
};

to 2_bananas

exports.migrate = function(client, done) {
    var db = client.db;
    db.collection('things').insert({_id: 3, name: 'banana', color: 'yellow'}, done);
};

exports.rollback = function(client, done) {
    var db = client.db;
    db.collection('things').remove({_id: 3}, done);
};

now we can execute our migrations

east migrate

output

target migrations:
    1_apples
    2_bananas
migrate `1_apples`
migration done
migrate `2_bananas`
migration done

and roll them back

east rollback

output

target migrations:
    2_bananas
    1_apples
rollback `2_bananas`
migration successfully rolled back
rollback `1_apples`
migration successfully rolled back

you can specify one or several particular migrations for migrate/rollback e.g.

east migrate 1_apples

or

east migrate 1_apples 2_bananas

Run east -h to see all commands, east <command> -h to see detail command help, see also east page for command examples.

Running test

run east tests with this adapter

License

MIT

Something went wrong with that request. Please try again.