Friendly interface to mongodump and mongorestore commands.
mongo-utils provides a friendly interface to MongoDB's mongodump and mongorestore commands, as well as some utility functions.
utilsparseConnectionString connectionString # mongo connection options objectutilsmakeRestoreCommand connectionStringsourceDir # mongorestore ...utilsmakeDumpCommand connectionStringtargetDir # mongodump ...
These functions simply wrap
child_process.exec in a convenient interface. There is absolutely no validation happening. Thus, the absence of an error (as
err argument) does not mean the dump or restore succeeded.
I advise to inspect
stderr yourself if you use this module for any important dumps or restores, or verify the results otherwise.
utilsdumpDatabase connectionStringdirNameutilsdumpHerokuMongoHQDatabase appNamedirNameutilsrestoreDatabase connectionStringdirNameutilsdumpHerokuMongoHQDatabase appNamedirName
The heroku-mongohq functions look up the
MONGOHQ_URL environment variable of your Heroku app, using the heroku module.
mongo-utils logs some messages to allow you to see what's going on behind the scenes, primarily when doing the using the dump or restore commands. To see what's being logged, you may assign a log function which takes a single
message argument to
utils.log. By default,
utils.log is a noop.
utils = require "mongo-utils"= consolelog msg
For the commands to work, you need to have
mongodump in your path.
The Heroku-specific commands require a
HEROKU_API_KEY environment variable to be set.
mongo-utils is released under the MIT License.
Copyright (c) 2013 Meryn Stol