async-require

![Build Status](https://travis-ci.org/Jhorlin/async-require)
![Coverage Status](https://coveralls.io/r/Jhorlin/async-require)
![Dependency Status](https://david-dm.org/jhorlin/async-require)
![devDependency Status](https://david-dm.org/jhorlin/async-require#info=devDependencies)

async-require

asyncronous module loader

Example
``js //ironically loading async-require using syncronaous require. var asyncRequire = require('async-require');`

* async-require * requireAsync(module) ⇒ Promise.<(module\|Error)> ⏏ * ~load - A promisified function that accepts a moduleId as an argument and returns a promise resolving in an object with a toString method such as a Buffer or a String.()

`$3`


Kind: Exported function  
| Param | Type | Description |
| --- | --- | --- |
| module | string | the path to the module without a .js extension |

Example`js //load script myModule.js asyncRequire('myModule').then(function(module){ //module has been exported });`#### requireAsync~load - A promisified function that accepts a moduleId as an argument and returns a promise resolving in an object with a toString method such as a Buffer or a String.() load is used by async-require to load the script. By default it load a file relative to the calling module similar to how require works when loading module not installed through npm. Since this function is public you can set a new load method.

Kind: inner method of requireAsync Access: public Example load a script with request`js var asyncRequire = require('async-require'), request = require('request'), Promise = require('promise'), //load must return a promise get = Promise.promisify(request.get); //overwrite the default load asyncRequire.load = function(url){ //get the script return get(url).spread(function(res, body){ //returrn only the body of the script return body; }) }``

async-require

Example
``

js
//ironically loading async-require using syncronaous require.
var asyncRequire = require('async-require');

$3

Kind: Exported function

| Param | Type | Description |
| --- | --- | --- |
| module | string | the path to the module without a .js extension |

Example

js
//load script myModule.js
asyncRequire('myModule').then(function(module){
  //module has been exported
});



#### requireAsync~load - A promisified function that accepts a moduleId as an argument and returns a promise resolving in an object with a toString method such as a Buffer or a String.()
load is used by async-require to load the script. By default it load a file relative to the calling module
similar to how require works when loading module not installed through npm. Since this function is public you can
set a new load method.

Kind: inner method of requireAsync  
Access: public  
Example  
load a script with request

js
var asyncRequire = require('async-require'),
    request = require('request'),
    Promise = require('promise'),
    //load must return a promise
    get = Promise.promisify(request.get);

    //overwrite the default load
    asyncRequire.load = function(url){
         //get the script
         return get(url).spread(function(res, body){
             //returrn only the body of the script
             return body;
         })
    }