inverted

Inverted is an Inversion of Control container. It uses a separate configuration file to express how classes are instantiated and how they interact. Once these defaults and relationships have been defined, an application context can be created, and instances of the classes can be used.

npm install inverted
7 downloads in the last week
29 downloads in the last month

Inverted: Javascript IOC Container

See philmander.github.com/inverted for complete end user documentation.

Quickstart

Runs in the browser and Node.js

Download source

Minified (~9.4kb/~3.2kb gzipped)

Uncompressed

or

npm install inverted

In the browser, Inverted depends on a module loader being present. Out of the box it will work with RequireJS or Curl. Inverted uses a module loader to load modules and should be loaded with an AMD module loader itself. For example:


<script src="require.js"></script>
<script>
requirejs.config({
  baseUrl: "/src",
  paths: {
      inverted : "/lib/inverted-min"
  }
});

require(["inverted", "app-config"], function(inverted, appConfig) {

  var appContext = inverted.create(appConfig);
  appContext.getProto(["protoId"], function(obj){
    obj.doStuff();
  });
});
</script>

Issues and discussion

Please use the Github issue tracker for this project to raise bugs, feature requests or just ask a question.

Project organization

/src

Core source code is here, split into two sub directories:

  • package Files added to the core source code to create a working build
  • inverted The main Inverted JS modules, AppContext and ProtoFactory and various support modules

/lib

Final builds are placed here

/test

Inverted's unit tests written in QUnit (with support from Q2Junit) are here

/support

Additional libraries in Javascript and Java for build and testing

How to build

Inverted is built using Apache Ant. The build performs the following steps:

  1. Lints the source code using JSHint.
  2. Runs the unit tests in Phantom JS
  3. Concatenates the source files to create an unminified build
  4. Compresses the unminified build using Google Closure compiler

To perform a build first install Apache Ant on your path and, in the project root directory, run:

ant

or to run a build that includes a version number in the build's source

ant -Dversion=[version]

NB. To run on a system other than Windows you will currently need to update the ant test runner config to point to a platform specific version of Phantom JS

Versions

The master branch should be considered as a snapshot of the latest code.

Official releases can be found as tags.

Changelog

v0.2.*

  • BREAKING CHANGE AppContext#getProto interface has changed. More than one proto id must be now specified as an array of strings in the first argument. A single proto id may remain as a string
  • Added support for mixin dependecies (issue #6)
  • Added support for interfaces (issue #3)
  • AppContext#getProto now returns a promise with success and failure callbacks (issue #4)
  • Improved error handling
  • App config now has the option to inject the app context into a proto (#2)
  • Now supports circular dependencies
npm loves you