fs-utils/utils.js

fs extras and utilities to extend the node.js file system module. Used in Assemble and many other projects.

'use strict';

/**
 * Module dependencies
 */

var utils = require('lazy-cache')(require);

/**
 * Temporarily re-assign `require` to trick browserify and
 * webpack into reconizing lazy dependencies.
 *
 * This tiny bit of ugliness has the huge dual advantage of
 * only loading modules that are actually called at some
 * point in the lifecycle of the application, whilst also
 * allowing browserify and webpack to find modules that
 * are depended on but never actually called.
 */

var fn = require;
require = utils;

/**
 * Lazily required module dependencies
 */

require('async');
require('delete', 'del');
require('js-yaml', 'YAML');
require('extend-shallow', 'extend');
require('is-absolute', 'isAbs');
require('normalize-path', 'normalize');
require('write', 'writeFile');
require('kind-of', 'typeOf');
require('matched', 'glob');
require('read-data');
require('read-yaml');
require('write-json');
require('write-yaml');
require('write-data');
require('relative');

/**
 * Restore `require`
 */

require = fn;

/**
 * Utils
 */

utils.tryStat = function(fp) {
  try {
    return fs.statSync(fp);
  } catch (err) {}
  return null;
};

/**
 * Expose `utils` modules
 */

module.exports = utils;