Sanders
A simple Inversion of Control container for node.js.
What does it do?
Sanders builds object graphs that have dependencies, while hopefully staying out of your way as much as possible.
Why would I want that?
Maybe you don't. If you are happy using require
with file paths, feel free to keep doing that.
In working test-first on a socket application written in coffeescript for node, I have found that I prefer to invert the dependencies, so that each class takes everything it needs in its constructor, like so:
: : : : :
This makes it easy to test each component in isolation, by passing in test doubles (fakes/mocks/spies) where necessary.
Using a container makes it easy to:
- construct this graph of objects at runtime
- plug in different implementations for different environments
For example, we probably only want to send actual email in production, so we would plug in a fake emailer that logs sent emails someplace so we could verify them.
The database configuration also would likely change depending on the environment.
This is how you might configure the above system in Sanders:
Sanders = require 'sanders' container = # you can register constructors # by convention, the names of the argumentis to the constructor # are used to determine the object to pass containerregisterDatabasecontainerregisterUserRegistrycontainerregisterUserSocket # you can register by name. # these will be matched with constructor arguments with the same name # (case-insensitive) containerregister'logger'ConsoleLoggercontainerregister'websocketconnection'DebugWebSocketConnection # Perhaps you don't want to rely on the argument names, # For example, you want to use a different connection for reports: replicatedDatabaseConnection = server : 'some-other-server' # register the databse with a name containerregister'replicatedDatabase'replicatedDatabaseConnection # override the default, just for the user report containerregisterUserReport'replicatedDatabase' # can also register objects directly containerregister'databaseConfig'server: 'FOO'user: 'BAR'password : 'BAZ'containerregister'emailConfig'server: 'localhost'fromEmail: 'bar@example.com' # now you can get the things you need, with the dependencies you have configured userSocket = containergetUserSocketuserReport = containergetUserReport
OK, I come from (Java/.NET) so I know what an IOC container is, how does Sanders compare to $OTHERCONTAINER?
Sanders builds only a single instance of each object. (There is no "lifetime" concept). Each instance is cached for the lifetime of the container.