Awesome
soyer
Soyer is small lib for serverside use of Google Closure Templates with node.js.
Thanks to Daniel Pupius for soynode. I used this module as template and added the language support and removed the compile features.
Install
npm install soyer
Initialize module:
var Soyer = require("soyer");
var mySoyer = new Soyer( config );
mySoyer.load( function( err, success ){
if( err ){
throw err
} else {
console.log( "templates sucessfully loaded" );
}
});
####config object description
- path : (
String
required )
absolute path to the directory where the module can find compiled soy files. - soyFileExt : (
String
optional: default = ".soy.js" )
soy file extension to select only the compiled soy files. - languagesupport : (
Boolean
optional: default = false )
enable the language support. If true the following options are relevant. - defaultlang : (
String
optional: default = "en-us" )
the default language code if the passed code will not fit. - availibleLangs : (
Array
optional: default = "[ "en-us", "de-de" ]" )
a list of valid language codes - extractLang : (
Function
optional )
a method to extract the language-code out of the filename. The filename will be passed to the method and should return a valid language code.
Example
var Soyer = require( "soyer" );
var mySoyer = new Soyer({
path: path.resolve( __dirname, "../path/to/templates/" )
});
mySoyer.load( function( err, success ){
if( err ){
throw err
}
var rendered = mySoyer.render( "myNamespace.myTemplate", { param1: "abc" } );
console.log( rendered );
});
Advanced example
// files in folder: template.soy, template.en.js, template.fr.js, template.de.js
var Soyer = require( "soyer" );
var mySoyer = new Soyer({
path: path.resolve( __dirname, "../path/to/templates/" ) ,
soyFileExt: ".js",
languagesupport: true,
defaultlang: "de",
availibleLangs: [ "en", "de", "fr" ],
extractLang: function( file ){
var _lang = file.split( "." )[1]
return _lang
}
});
mySoyer.load( function( err, success ){
if( err ){
throw err
}
var renderedDE = mySoyer.render( "myNamespace.myTemplate", "de" { param1: "deutsch" } );
console.log( renderedDE );
var renderedEN = mySoyer.render( "myNamespace.myTemplate", "en" { param1: "english" } );
console.log( renderedEN );
var renderedFR = mySoyer.render( "myNamespace.myTemplate", "fr" { param1: "français" } );
console.log( renderedFR );
});
get a template method ( GET )
Get's a method to render a template.
mySoyer.get( name, [ lang ] )
Arguments :
- name: (
String
required )
soy path of the template. - lang: (
String
required )
the language to render iflanguagesupport
is activated.
Example
var fnTemplate = mySoyer.get( "myNamespace.path.to.template" );
console.log( fnTemplate( { param1: "hello world" } ) );
render a template ( RENDER )
render a template immediately
mySoyer.get( name, [ lang ] )
Arguments :
- name: (
String
required )
soy path of the template. - lang: (
String
optional )
the language to render iflanguagesupport
is activated. - data: (
String
optional: default = {} )
template data.
Example
var rendered = mySoyer.render( "myNamespace.path.to.template", { param1: "hello world" } );
console.log( rendered );
routing helper
usually you will use soyer within a routing framework like express.
In this case the server has to finish the loading of the templates before the first .render()
is called.
So you can use the method routingWait
to add a middleware and make sure the templates has been loaded until the first rendering starts.
To use it you just have to add and call the method [ your soyer instance ].routingWait()
as middleware.
Buff
This is designed to fit to express. But you can use it in other tools, too. You just have to make sure the last argument of your routing framework is the next method ( e.g. in express it's ( request, response, next )
).
Example
Soyer = require("soyer");
var express = require("express");
var app = express.createServer();
var mySoyer = new Soyer( config );
mySoyer.load( function( err ){
if( err ){
throw err
}
});
app.get( "/myroute/:id", mySoyer.routingWait(), function( req, res ){
// do your stuff
});
app.listen()
###General info
To define a locale my best practice is a combination of language-code ISO 639
and country-code ISO 3166
.
But you can define your own logic with this module.
Release History
Version | Date | Description |
---|---|---|
v0.3.5 | 2015-04-14 | Dropped node 0.6 and 0.8 travis tests, because the dependencies to build the modules are not compatible. But i think the compiled version from npm should already work |
v0.3.4 | 2015-04-14 | Added try catch during vm context create; changed to a more modern development env with grunt; Switched to lodash |
v0.3.3 | 2014-10-30 | Fixed bug in routingWait method |
v0.3.1 | 2013-12-04 | Fixed bug to ignore hidden files ( prefixed with a . ) |
v0.3.0 | 2013-03-04 | Updated soyutils to version Dez. 2012 |
Other projects
Name | Description |
---|---|
rsmq | A really simple message queue based on Redis |
rsmq-worker | RSMQ helper to simply implement a worker around the message queue |
redis-notifications | A redis based notification engine. It implements the rsmq-worker to safely create notifications and recurring reports. |
node-cache | Simple and fast NodeJS internal caching. Node internal in memory cache like memcached. |
redis-sessions | An advanced session store for NodeJS and Redis |
obj-schema | Simple module to validate an object by a predefined schema |
connect-redis-sessions | A connect or express middleware to simply use the redis sessions. With redis sessions you can handle multiple sessions per user_id. |
systemhealth | Node module to run simple custom checks for your machine or it's connections. It will use redis-heartbeat to send the current state to redis. |
task-queue-worker | A powerful tool for background processing of tasks that are run by making standard http requests. |
grunt-soy-compile | Compile Goggle Closure Templates ( SOY ) templates inclding the handling of XLIFF language files. |
backlunr | A solution to bring Backbone Collections together with the browser fulltext search engine Lunr.js |
License
(The MIT License)
Copyright (c) 2013 M. Peter
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.