Template cache for angular apps

Translates Angular html template files to a unique compressed javascript file that uses $templateCache directive.

Install

npm i templatecache --save

Use it

With a callback function:

templatecache({
    angularRoot: 'path/to/angular/app',
}, function (err, templatejs) {
    // err contains errors if any, null otherwise
    // templatejs contains the generated javascript file
});

Or as a promise:

templatecache({
    angularRoot: 'path/to/angular/app',
})
    .then(function (templatejs) {
        // templatejs contains the generated javascript file
    })
    .catch(function (err) {
        // called if there has been any error
    });

Options

Default options are the following ones:

var options = {
    angularRoot: 'path/to/angular/app',
    moduleName: 'templates',
    isStandalone: false,
    isNgAnnotate: false,
    isCreateOutput: false,
    templatesFilePath: 'path/to/templates.js',
    progress: function (p) {
        return true;
    },
    contentModifier: function (content, filePath) {
        return content;
    },
};

templatecache(options, function (err, templatejs) {

});

angularRoot (string, required)

The location of your Angular app. templatecache will search all .html files inside this directory, skipping the root path/to/angular/app/index.html.

moduleName (string, optional)

The name of the module that will be created.

Defaults: templates

isStandalone (boolean, optional)

When true, the module will be created as standalone, otherwise, as a dependency of moduleName. In example, if modulename is myTemplates:

• isStandalone === false will create angular.module("myTemplates")
• isStandalone === true will create angular.module("myTemplates",[])

Defaults: false

isNgAnnotate (boolean, optional)

When true, $templateCache variable will be annotated, otherwise it won't be:

• isNgAnnotate === false will create angular.module("myTemplates").run(function($templateCache){ ... })
• isNgAnnotate === true will create angular.module("myTemplates").run(["$templateCache",function($templateCache){ ... }])

Defaults: false

isCreateOutput (boolean, optional)

When true, the output file will be created. If templatesFilePath is specified then the file will be created in the specified value, otherwise in the default location (path.resolve(path.join(angularRoot, 'templates.js'));).

Defaults: false

templatesFilePath (string, optional)

The path to the templates file (in case a file will be generated). If the path does not exist, this module will create the needed subdirectories. If the file already exists, it will be replaced. This script is the one that should be included in your index.html.

<script src="path/to/templates.js"></script>

If this value starts with a slash ('/templates.js') it will be considered as an absolute path and it will be resolved as it is. If this value starts with a dot-slash ('./templates.js') it will be considered as a relative path from where this module is being invoked. Otherwise it will be resolved relative to angularRoot.

Defaults: 'templates.js'

progress (function, optional)

Called each time a template is processed. It has the following signature:

function progress(filePath) {
    return true;
}

When it returns true, the file specified in filePath will be processed, otherwise it will be skipped.

Defaults: function (p) { return true; }

contentModifier

Called each time a template has been read. It allows to modify the content of the template. It has the following signature:

function contentModifier(content, filePath, callback) {
    return content;
}

It allows to return an string with same/new content, a Promise that resolves to the same/new content or rejects (will fail whole process) or it can be resolved with callback(err, newContent) (if err is specified it will fail the whole process). If an error is thrown it will fail the whole process.

Defaults: function (content) { return content; }

License: MIT

The MIT License (MIT)

Copyright (c) 2016 AppFeel

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Made in Barcelona with <3 and Code