Nondeterministic Postrequisite Metaprotocol


    1.1.4 • Public • Published


    Point a gardener at couchdb and it will install, update, and run node processes that design-docs and couchapps depend on.


    Build Status


    npm install gardener -g
    gardener http://admin:pass@localhost:5984

    This tells the gardener to watch all the databases on your local couch. But what does it do?

    Simple. It looks for node_modules on design docs. Like this:

        "id": "_design/twitter_things",
        "views" : {
            "map" : "by_date" : "function(doc) { emit(, null); }"
        "node_modules" : "twitter-loader,worker-generate-thumbnails@0.4.6"

    In this case, gardener will npm install twitter-loader and worker-generate-thumbnails and run them. Gardener passes them the couch url, and optional username and password. It will look something like this:

    $ gardener http://localhost:5984
    info: [gardener] polling couch for design doc changes.
    info: [gardener] installing twitter-loader-1.0.1.tgz start_immediate=true, module_digest=md5-COu0+gC6Cvk+UPOB3yz6iQ==, module_name=twitter-loader-1.0.1.tgz, package_version=1.0.1, local_name=aHR0cDovL2xvY2FsaG9zdDo1OTg0L3Rlc3QvX2Rlc2lnbi9tdWNreW11Y2s=, ddoc_url=http://localhost:5984/test/_design/myapp, db_url=http://localhost:5984/test
    npm http GET
    npm http 200
    npm WARN package.json twitter-loader@1.0.1 No file found!
    twitter-loader@1.0.1 installed_packages/node_modules/twitter-loader
    info: [gardener] starting package [twitter-loader] in working_dir/aHR0cDovL2xvY2FsaG9zdDo1OTg0L3Rlc3QvX2Rlc2lnbi9tdWNreW11Y2s=
    info: [twitter-loader] Twitter loader is dumping tweets into http://localhost:5984/test

    Yay, twitter loader has been installed, run, and hooked up to the right db.

    How-to Node Program

    Create a directory called 'twitter-loader'. Add server.js to it that looks like:

    // the gardener will set the COUCH_URL variable. Now do what you want!
    var db_url = process.env.COUCH_URL || 'http://localhost:5984/test';
    // do something and save to couch

    Add a package.json file. npm publish.

    (When publishing try to use the couchdb-worker tag so it is easy for others to find and resuse).

    So like, what could I do with it?

    Use some existing workers on npm: tagged couchdb-worker on npm

    Here are just some ideas, you can extrapolate:

    Advanced Usage:

    Usage: gardener <url> [OPTIONS]
    Available OPTIONS:
    --include, -i  Comma seperated db and design docs to include.
    --exclude, -e  Comma seperated db and design docs to exclude.
    --web, -w	   Turn on a local http server and add turn on the /_garden proxy to it from couch ("true" or "false", "true" by default)
    --host, -h	   The host name (or IP address) to bind the http server to. (localhost by default)
    --port, -p	   The port to bind the http server to. (integer, 25984 by default)
    --upnp	Use upnp to open the port on the firewall, and use the public ip ("true" or "false", "false" by default)
    --user	The username given to the node module for connecting to couch
    --pass  The password given to the node module for connecting to couch
    --time, -t	Polling interval (seconds) to check couch for changes to design docs (integer, 30 by default)
    --stdinpass when specified, gardener will read a single line from stdin, which will be used as the password when connecting to couch

    see examples for examples of commandline usage.


    To reduce the footprint of gardener dependencies, not all are listed in the dependencies section. To use some features you will have to do an addition npm install.

    • web, you need to npm install tako
    • upnp, you need to npm install nat-upnp
    • testing (or make or npm test) npm install mocha

    I am probably doing this wrong. Please let me know a better solution.

    About Version Numbers

    gardener follows semver-ftw. Dont think 1.0.0 means production ready yet. There were some breaking changes, so had to move up the major version.


    npm i gardener

    DownloadsWeekly Downloads






    Last publish


    • estellecomment
    • garethbowen
    • mandric