var promo = require( 'promo' );

// Take a standard function...
var standard = function ( arg1, arg2, arg3, callback ) {
  // callback is eventually called with two arguments - an error
  // (if applicable) and the result;
};

// ...and create a promise-returning equivalent
var promisified = promo( standard );

// Then, instead of doing this...
standard( a, b, c, function ( err, result ) {
	if ( err ) {
		return handleError( err );
	}

	handleResult( result );
});

// ...do this:
promisified( a, b, c ).then( handleResult, handleError );

var readFile = promo( require( 'fs' ).readFile ),
    writeFile = promo( require( 'fs' ).writeFile ),
    glob = promo( require( 'glob' ) ),
    mkdirp = promo( require( 'mkdirp' ) );

var someModule = {
  someMethod: function ( callback ) {
    // because this method uses `this`, we need to
    // pass in a context
    this.doSomething( callback );
  }
};

var promisified = promo( someModule.someMethod, someModule );

var glob = promo( require( 'glob' ) );
var matches = glob.sync( 'dir/**' ); // still works