stalin v0.2.2

Stalin

Badass mustache compiler

Why?

• In Soviet Russia template compiles you
• Compiled templates have no dependencies
• Minified and gzipped version is 1KB in size
• Joseph Stalin => stalin.js

Installation

# Global
npm -g install stalin

# Local
npm install stalin

Difference

• Lambdas are not supported (no simple way to get template source from compiled one)
• Partials are functions (templates or helpers at your choise, see below)
• {{{ }}} Not supported, use {{& }} instead to get unescaped output
• Magic RegExp characters can not be used as delimiters (ex: {{=[ ]=}})
• All CRs are converted to LFs before processing
• LFs from lines with standalone tags are not removed

Usage

API

var Stalin = require('stalin');

/* Compile template and save reference */
Stalin('example', '{{#first}}{{example}}{{/first}}');

/* Render compiled template */
console.log(Stalin.example({ first: true, example: 'Hello, world!' }));

Some internal functions available

• Stalin.process - compile template to string and return it
• Stalin.compile - compile, eval and return reference

Partials

Partials can be defined as another template

Stalin('link', '<a href="{{&href}}">{{title}}</a>');

or as custom function

Stalin.link = function (scope, escape) {
	/* Call to scope() does scope lookup and returns unescaped value */
	return '<a href="' + scope('href') + '">' + escape(scope('title')) + '</a>';
};

and used later

Stalin('linkbar', '{{#linkbar.length}}<ul>{{#linkbar}}<li>{{>link}}</li>{{/linkbar}}</ul>{{/linkbar.length}}');

console.log(Stalin.linkbar({
	linkbar: [
		{ href: '/about',    title: 'About' },
		{ href: '/contacts', title: 'Contacts' }
	]
}));

to get result like that

<ul><li><a href="/about">About</a></li><li><a href="/contacts">Contacts</a></li></ul>

Compilation

# Compile all *.mustache files in folder
# and subfolders and save with .js extension
stalin public/templates/

# Compile single file and print it
stalin public/index.mustache

Client

To use compiled templates without Stalin itself you need to define window.Stalin before loading any template. Templates will register themselves on Stalin object when loaded.

<script>var Stalin = {};</script>
<script src="/templates/index.js"></script>
<script>console.log(Stalin.index({ test: true }));</script>

Copyright and License

Copyright 2013 Alexander Nazarov. All rights reserved.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.