Bring your node.js modules to life
.("""") (j)(_(_ __(_ ) (n o d e)_ _ _ _ / / / (n) (s)))`)`) ___ )L __ __ / / / n \|/ \|/((,(,' ((_( (( (('(| n \|/ | |
Part of the Node Water collection.
"Bring" follows an inversion of control pattern similar to Java Spring. It helps you easily build applications from modules which you link together using configuration, not code.
At runtime Bring reads your configuration file(s) and instantiates the modules that are specified. It sets options, calls functions on those modules and can pass refences between them or to your main application. Using bring you can have an application bootstrapped, up and running almost entirely by configuration. This is great if you want to "mix" different varients of your application or run your application with different configurations in different environments.
var bring = require'bring-modules';bringautoconfigure;
Your application is now running!
Official releases can be obtained from:
- github.com - the tags section provides links to zip or tar.gz packages.
- npm - use
npm install bring-modules
The lastest developed code may node have not have been released, but can always be found from:
- github.com - the project homepage provides links to all the source code, branches and issue tracking.
Bring configuration is a JSON object in the following format.
At the top level there are three sections, require, construct and templates.
config ="require" : required-modules //required. (see Requiring Modules)"construct" : constructors //required. (see Constucting Modules)"templates" : template-constructors //optional. (see Templates)
required-modules ="<module-name>": module-optionsmodule-options ="depends": "<module-name>""real-name": "<module-real-name>"
Effectively this a wrapper for the
require() function with a few extra options:
required-modules - Object. With 1..* properties:
- <module-name> - Object. Modules are stored for later use to module-names need
to be unique. Unless real-name is also give, module-name is also the string passed to
- <module-name> - Object. Modules are stored for later use to module-names need to be unique. Unless real-name is also give, module-name is also the string passed to require e.g.
module-options - Object. With 2 properties:
- depends - Array. Lists the module-names that should be loaded before this module.
- real-name - String. If you need to give a module your own name use this option.
Make module-name the name you want to use it and real-name is the name you would
normall pass to the
constructors ="< >":
template-constructors ="< >":