karma-directives-preprocessor

Generate multiple versions of the same file with C-style directives.

Installation

The easiest way is to keep karma-directives-preprocessor as a devDependency in your package.json.

{
  "devDependencies": {
    "karma": "~0.10",
    "karma-directives-preprocessor": "~0.0.1"
  }
}

You can simple do it by:

npm install karma-directives-preprocessor --save-dev

Configuration

Following code shows the default configuration...

// karma.conf.js
module.exports = function(config) {
  config.set({
    files: [
      'src/**/*.js',
      'test/**/*.js'
    ],


    preprocessors: {
      // source files, that you wanna preprocess with directives
      'src/*.js': ['directives']
    },

    directivesPreprocess: {
      flags: {
        'js'  : {development: true, production: false }
      } 
    },

    ...
  });
};

Using this example file, with the configuration above, the code within development flag will be left while the production and test snippets will be removed from the served file.

define([], function () {
  "use strict";

  // @if development
  functionWithDebugOptions();
  // @endif

  // @if production
  superQuickFunction();
  // @endif

  // @ifdef test
  enableThisOtherFunction();
  // @endif

});

Using the include directive you can include an external file like in the example:

body {

  background-color: red;

}
// @include util.css

Supported filetype

Karma-directives is based on preprocess and it does support any filetype.

For each filetype is possible to pass a different set of flags:

directivesPreprocess: {
  flags: {
    'js'  : {flag1: true, flag2: true },
    'html': {flag3: true },
    'css' : {flag4: true }
  } 
},

Contribute

If you want to contribute to the project (e.g. adding new functions, etc..) you're more than welcome. Please add unit tests for any new or changed functionality.

Release history

0.0.5 Added new @include directive
0.0.4 First full documented and tested version.

---

For more information on Karma see the homepage.