angular-provide

This module provides a way to separate component definitions with component registrations for AngularJS.

The concept which is using in this module are influenced by angular2 Provider.

sample source code here

Features

• Separating component definition with component registrations.
• Execution order management.

Usage

Install

$ npm install angular-provide --save

Define providers

Config

import provide from 'angular-provide';
 
// Configuration will be registered.
let provider = provide.config(function ($someProvider) {
  // ...
});

Provider

import provide from 'angular-provide';
 
// Provider will be registered as `foo`.
let provider = provide.provider('foo', function () {
  // ...
});

Service

import provide from 'angular-provide';
 
import { ServiceClass } from './service';
 
// ServiceClass will be registered as `foo`.
let provider = provide.service('foo', ServiceClass);

Factory

import provide from 'angular-provide';
 
// Factory will be registered as `foo`.
let provider = provide.factory('foo', function () {
  // ...
});

Directive

import provide from 'angular-provide';
 
// Directive will be registered as `foo`.
let provider = provide.directive('foo', function () {
  // ...
});

Component

import provide from 'angular-provide';
 
// Directive will be registered as `foo`.
let provider = provide.component('foo', {
  // ...
});

Run

import provide from 'angular-provide';
 
// Initialization function will be registered.
let provider = provide.run(function () {
  // ...
});

Working with Providers

Aggregate providers

import provide from 'angular-provide';
 
const FOO_PROVIDERS = [
  provide.service('bar', ...),
  provide.factory('baz', ...),
  provide.config(...),
];
 
// export providers
export FOO_PROVIDERS;

Apply providers to a module

import * as angular from 'angular';
import provide from 'angular-provide';
 
import { MY_DIRECTIVE_PROVIDERS } from './directives';
import { MY_SERVICE_PROVIDERS } from './services';
 
// create module
let module = angular.module('myApp', []);
 
// apply providers to the module
provide(module,
  ...MY_DIRECTIVE_PROVIDERS,
  ...MY_SERVICE_PROVIDERS,
);

Provider priority

Provider could have a priority which can specify execution ordering. It helps defining the process which depends on some other process.

e.g. http request/response interceptors

Providers will be apply to module in high priority order. (default priority is 0)

import provide from 'angular-provide';
 
 // will execute this configuration early than others.
let provider = provide
  .config($httpProvider => {
    $httpProvider.interceptors.push(function () {...})
  })
  .priority(1000)