bem-environ

bem-environ ===========

bem-environ

Install it with npm

› npm install bem-environ --save

If you plan to distribute your module/library as an npm package, add bem-environ to bundledDependencies section (see example) in your package.json. This is due to every BEM library need its own copy of bem-environ, but npm tries to optimise packages installation.

{
    "bundledDependencies": ["bem-environ"]
}

Update your project's make.js to extend common build process provided by bem-tools

// make.js 
 
// Initialize environ with global root path (see API section for more examples) 
var environ = require('bem-environ')(__dirname);
 
function extendMake(registry) {
 
    // Extend common `bem make` build process with `bem-environ`'s nodes (optional) 
    environ.extendMake(registry);
 
    registry.decl('Arch', {
 
      // ... 
 
    });
 
};
 
// For compatibility with bem-tools << 1.0.0 
if (MAKE) extendMake(MAKE);
 
// For compatibility with bem-tools >= 1.0.0 
if (module && module.exports) module.exports = extendMake;

{String|Object} root | opts — Options to declare or path to the environment root

Set environment root and other options.

Set environment root only:

var environ = require('bem-environ')(__dirname);

Set environment root and other options:

var environ = require('bem-environ')({
    root: __dirname,
    libDir: 'components', // override default 'libs' directory 
    confDir: 'conf' // override default 'configs' directory 
});

{BEM.Registry} registry — bem-tools registry object

Extend bem-tools registry object with nodes of bem-environ.

{String} lib — Library name {String} path... — Library internal path

Return absolute path to the library root or its files or directories.

{String} lib — Library name {String} path... — Library internal path

Return relative to the root path to the library root or its files or directories.