#76 Added ES6+ examples, Updated docs

Author: basedalexander

README.md

@@ -2,7 +2,7 @@
 
 
 ## **container-ioc** 
-is [Dependency Injection](https://en.wikipedia.org/wiki/Dependency_injection) and [IoC container](http://martinfowler.com/articles/injection.html) for Typescript projects (ES6+ API is coming). It manages the dependencies between classes, so that applications stay easy to change and maintain as they grow.
+is [Dependency Injection](https://en.wikipedia.org/wiki/Dependency_injection) and [IoC container](http://martinfowler.com/articles/injection.html) for both **Typescript** and **ES6+** projects. It manages the dependencies between classes, so that applications stay easy to change and maintain as they grow.
 
 [![npm version](https://badge.fury.io/js/container-ioc.svg)](https://badge.fury.io/js/container-ioc)
 [![Build Status](https://travis-ci.org/thohoh/container-ioc.svg?branch=master)](https://travis-ci.org/thohoh/container-ioc)
@@ -11,12 +11,12 @@ is [Dependency Injection](https://en.wikipedia.org/wiki/Dependency_injection) an
 
 ### Features:
 * Well-known Angular4+ DI API.
+* Can be used in ES6+/Typescript projects.
 * No external dependencies.
 * Singleton and Non-Singleton configuration.
 * Hierarchical containers.
 * Pluggable metadata annotator.
-* Can be used both on front-end and back-end.
-* 100% test coverage.
+* 97% test coverage.
 
 #### Installation:
 ```
@@ -25,6 +25,7 @@ npm install --save container-ioc
 
 ### Quick start
 
+##### Typescript:
 ```typescript
 import { Container, Inject, Injectable } from 'container-ioc';
 
@@ -48,6 +49,21 @@ let providers = [
 container.register(providers);
 let app = container.resolve(App);
 ```
+
+### Javascript ES6+:
+##### use alternative syntax for declaring injections shown below and don't use interfaces.
+```javascript
+
+@Injectable(['IService'])
+class Service implements IService {
+    constructor(service) {
+        this.service = service;
+    }
+}
+```
+
+### NOTE: All the examples below are written in Typescript. Check out [examples/javascript](examples/javascript) and [examples/typescript](examples/typescript) for reference.
+
 ### Best Practise: use InjectionToken instances for tokens instead of string/class literals:
 
 ##### Without InjectionToken:

examples/javascript/injection-token.js

@@ -0,0 +1,14 @@
+import { Container, Injectable, InjectionToken } from 'container-ioc';
+
+const TService = new InjectionToken('IService');
+
+@Injectable()
+class Service {}
+
+const container = new Container();
+
+container.register([
+    { token: TService, useClass: Service }
+]);
+
+const service = container.resolve(TService);

examples/persistence-control.ts …amples/javascript/persistence-control.jsexamples/persistence-control.ts renamed to examples/javascript/persistence-control.js examples/persistence-control.ts renamed to examples/javascript/persistence-control.js

@@ -0,0 +1,19 @@
+import { Container, Injectable } from 'container-ioc';
+
+const container = new Container();
+
+interface IService {
+    [key: string]: any;
+}
+
+@Injectable(['IService'])
+class App {
+    constructor(private service: IService) {}
+}
+
+container.register([
+    App,
+    { token: 'IService', useValue: {}}
+]);
+
+const app = container.resolve(App);

examples/use-class-as-a-token-alone.ts …javascript/use-class-as-a-token-alone.jsexamples/use-class-as-a-token-alone.ts renamed to examples/javascript/use-class-as-a-token-alone.js examples/use-class-as-a-token-alone.ts renamed to examples/javascript/use-class-as-a-token-alone.js

@@ -0,0 +1,13 @@
+import { Container, Injectable, LifeTime } from 'container-ioc';
+
+const container = new Container();
+
+@Injectable()
+class A {}
+
+container.register({ token: A, useClass: A, lifeTime: LifeTime.PerRequest });
+
+const instance1 = container.resolve(A);
+const instance2 = container.resolve(A);
+
+// instance1 !== instance2

examples/typescript/alternative-syntax-for-declaring-injections.ts

@@ -0,0 +1,10 @@
+import { Container, Injectable } from 'container-ioc';
+
+// Not recommended
+
+@Injectable() class App {}
+const container = new Container();
+
+container.register(App);
+
+const app = container.resolve(App);

examples/injection-token.ts examples/typescript/injection-token.tsexamples/injection-token.ts renamed to examples/typescript/injection-token.ts

@@ -0,0 +1,29 @@
+import { Container, Injectable, Inject } from 'container-ioc';
+
+const container = new Container();
+
+interface IService {
+    [key: string]: any;
+}
+
+@Injectable()
+class App {
+    constructor(@Inject('IUseFactory') private service: IService) {}
+}
+
+@Injectable()
+class Service {}
+
+container.register([
+    App,
+    { token: 'IService', useClass: Service },
+    {
+        token: 'IUseFactory',
+        useFactory: (service: IService) => {
+            return service;
+        },
+        inject: ['IService']
+    }
+]);
+
+const app = container.resolve(App);

examples/typescript/persistence-control.ts

@@ -0,0 +1,28 @@
+import { Container, Injectable, Inject } from 'container-ioc';
+
+const container = new Container();
+
+interface IService {
+    [key: string]: any;
+}
+
+@Injectable()
+class App {
+    constructor(@Inject('IUseFactory') private service: IService) {}
+}
+
+@Injectable()
+class Service {}
+
+container.register([
+    App,
+    { token: 'IService', useClass: Service },
+    {
+        token: 'IUseFactory',
+        useFactory: () => {
+            return new Service();
+        }
+    }
+]);
+
+const app = container.resolve(App);