carafe
Crazy simple dependency container.
def. a wide-mouthed glass or metal bottle with a lip or spout, for holding and serving dependencies
A little inspiration taken from @travi/ioc.
Usage
Create a Carafe instance, add dependencies to it, and get them back out where needed.
// simple dependency providing // provider.mjs const container = ;container;; // status.mjs; // get happens in the function so it always gets the current valueconst waterStatus = container;; // status.mjs, alternatively using inject; // the function returned always gets the updated dependencyconst waterStatus = container;; // consumer.mjs;console; // fresh and cool
You can also opt in to dependency replacement by passing true as the only argument to Carafe.
// dependency replacement // provider.mjsconst allowReplace = processenvNODE_ENV === 'test'; // optionally enable replacementconst container = allowReplace;container;; // status.mjs does not changeconst waterStatus = container;; // then in your tests...;; container;console; // mock watercontainer; // or to restore all mocks, use restore()console; // fresh and cool
Methods
Carafe instances should be new
ed up, and the instance returned will have the following methods. You can call Carafe() as well, and it will return a new instance for you.
Carafe([enableReplacement])
Creates and returns a new instance of Carafe. If enableReplacement
is true, dependencies can be replaced.
register(name, payload)
Registered a new dependency by name. name
should be a string, and the method will throw if it's not.
get(name)
Returns a registered dependency by name. If there is no matching depdendency, the method will throw.
inject(dependencies[], function)
Takes an array of named depdendencies, passing them in order as arguments to function
. Returns the original function
with the depdendencies partially applied.
replace(name, payload)
Only available if enableReplacement
is true
Used to replace a dependency's value in a recoverable way. replace
can be called multiple times, and the resulting value when get
is used will always be whatever the last value provided was. Use restore
to restore the original dependency's payload.
restore([name])
Only available if enableReplacement
is true
Used to restore a given dependency to its original registered value, undoing any replace
calls. If no name is provided, all dependencies are restored.
License
MIT © w33ble