@cherrypulp/dependency-injector

0.0.8 • Public • Published

DependencyInjector

codebeat badge Issues License npm version

A basic and simple dependency injector with no dependencies.

Why use dependency injection?

You might by now be thinking "hey that's pretty cool, but why would I do that?". There's a couple reasons why you might want to use dependency injection in VueJS

Testability

Imagine you're writing an application that makes calls to an API, you're probably using a package for making those HTTP requests. However, when you're running your unit tests you'd probably rather not have those tests run wild and create 200 users in your API. Using dependency injection you could just swap out the binding for your HTTP service with a dummy service (that could for example assert the required calls are made), without having to change a single line of code.

Example

import axios from 'axios';

deps.singleton('$http', axios);

Then for your unit tests

deps.singleton('$http', DummyHttpService);

Explicit dependencies

TODO

Easier refactoring

TODO

Installation

Installing using npm install @cherrypulp/dependency-injector?

WARNING Look at this before building for production.

Quick start

Vanilla

import DependencyInjector from '@cherrypulp/dependency-injector';

const deps = new DependencyInjector();

deps.constant('foo', 'BAR');
deps.register('bar', (key) => key);
deps.singleton('api', ApiService);

// then

deps.resolve('foo'); // return 'BAR'
deps.resolve('bar')('ok'); // return 'ok'
deps.resolve('api'); // return Api service

Resolve parameters

function func(foo, api) {
    /* ... */
}

const params = deps.parameters(func); // return ['BAR', ApiService]

Patch method

WARNING Look at this before building for production.

const func = deps.patch(function (foo, api) {
    // foo === 'BAR'
    // api === ApiService
});

VueJS

import VueDependencyInjector from 'dependency-injector/vue-dependency-injector';

const options = {
    constants: {
        foo: 'BAR',
    },
    factories: {
        bar: (key) => { ... },
    },
    services: {
        api: Api,
    },
};

Vue.use(VueDependencyInjector, options);

// or

new Vue({
    el: '#app',
    ...options,
});

// then

this.$dependency.constant('foo'); // return 'BAR';
this.$dependency.factory('bar')(key); // use bar factory
this.$dependency.service('api'); // return Api service;

TODO

Mangling

When building for production you'll most likely minify your code. Most minifiers employ a technique called "name mangling" which poses a couple problems with this library if you use method injection. You can read more about this here.

In short, you'll need to ensure your minifier won't mangle the parameter names of your services, for UglifyJS (default for webpack) this can be done like this:

new webpack.optimize.UglifyJsPlugin({
    compress: {
        warnings: false
    },
    sourceMap: true,
    mangle: {
        except: ['Service'], // blacklist your services from being mangled
    },
});

Versioning

Versioned using SemVer.

Contribution

Please raise an issue if you find any. Pull requests are welcome!

Author

License

This project is licensed under the MIT License - see the LICENSE file for details.

TODOS

  • [ ] Documentation
  • [ ] VueX integration
  • [ ] Unit tests
  • [x] use Map instead of Object for $$dependencies
  • [x] ability to freeze values
  • [x] ability to cache values

Package Sidebar

Install

npm i @cherrypulp/dependency-injector

Weekly Downloads

0

Version

0.0.8

License

MIT

Unpacked Size

58.5 kB

Total Files

13

Last publish

Collaborators

  • dbennani_cherry
  • danielsum
  • cherrypulpcom
  • monkeymonk
  • anthonypauwels