Templating madness!


$ npm install tarima

Tarima is a pipeline library for templating based on the filename extensions.

Define a template named tpl.js.jade and explicitly call render() or compile():

var tarima = require('tarima');
var template = 'h1 It works!';
var view = tarima.parse('tpl.js.jade', template);
console.log(view.render()); // <h1>It works!</h1> 
console.log(view.compile()); // function template(locals) ... 

Now rename your template into tpl.html.jade and the output will be the same.

If a filename called tpl.x.y have two extensions, each extension will invoke a particular engine from right to left respectively.

When a extension has no registered engine, the pipeline will stop and return the current chain params.

  • params.next will be passed with the name of the next file-extension
  • params.client will be true if was invoked with compile()
  • params.source is used if the engine returns nothing

Currently tarima supports:

Some engines can compile to .js but most will render() only.

Register a custom extension and callback.

tarima.add('foo', function(params) {
  if (params.next === 'baz') {
    return 'bazzinga';

The params object looks like:

  next: undefined,
  client: false,
  filepath: '',
  filename: 'foo.js.coffee',
  parts: [ 'js', 'coffee' ],
  name: 'foo',
  ext: 'js',
  options: { locals: {} },
  source: '-> "string"',
  keypath: 'foo'

Using params.source the callback must build the string to render or compile it.

If params.client is true it must return a compiled function to render on the client:

var tpl = new TemplateEngine(params.source, params.options);
if (params.client) {
  return tpl.compileClient();
return tpl.compile();

Note that in the browser a runtime is required for some engines.

Generate a partial view from the given source and filepath.

var view = tarima.parse('foo.js.jade', 'h1 It works');

Same as parse but reading from filesystem instead.

var view = tarima.load('/path/to/foo.js.jade');

Will bundle the array of templates into a stringified JST variable.

var code = tarima.bundle([tarima.parse('bar.js.ejs', '<%= value %>')]);

Return all the registered extensions.

console.log(tarima.engines()); // ['coffee', 'ejs', ...] 
  • cwd — Set relative keys on bundle()
  • locals — Local variables on bundle()
  • filter — Execute this callback after parse()
  • wrapper — Execute this callback after bundle()
  • marker — Custom marker for extracting front-matter
  • exports — If true prepends module.exports on fn-views
  • globals — Object map for injecting static globals within scripts

If you want to override certain options for any engine:

var view = tarima.load('/path/to/view.js.coffee', {
  // custom settings for coffee-engine 
  coffee: { bare: true }

Once you've parsed or loaded a template you can get its output or data, or both.

Return the pre-compiled version if possible, otherwise return the same source.

var js = tarima.parse('tpl.js.jade', 'h1 ok').compile();
console.log(js); // function template(locals) ... 

Render and return as string, most template-engines do this.

var html = tarima.parse('tpl.html.jade', 'h1 ok').render();
console.log(html); // <h1>ok</h1> ... 

Will render() and return the resulting view-params as is.

  • If raw is true compile() will be called instead
  • If locals is boolean it will be used as raw and locals will be empty
var tpl = tarima.parse('tpl.js.jade', 'h1 ok');
console.log(tpl.data().source); // <h1>ok</h1> ... 
console.log(tpl.data(true).source); // function template(locals) ... 

All parsed files can use a front-matter block for local data.

  title: Untitled
  _render: other/layout.hbs
  extended: !include ../path/to.yml
h1= title

Since 0.8.0 tarima introduced the _render keyword which is used to yield the rendered view through more templates, e.g.

{{!-- other/layout.hbs --}}
<div>{{{ yield }}}</div>



Since 0.8.1 you can merge additional files using !include within any front-matter block.

Since 0.7.8 tarima exposes some internal utilities:

  • tarima.util
    • isView(filename)
    • isScript(filename)
    • isTemplate(sourcecode)

You're welcome to open a ticket or submit a PR. ;-)