/**
|
|
* Module dependencies.
|
|
*/
|
|
|
|
var debug = require('debug')('express:view');
|
|
var path = require('path');
|
|
var fs = require('fs');
|
|
var utils = require('./utils');
|
|
|
|
/**
|
|
* Module variables.
|
|
* @private
|
|
*/
|
|
|
|
var dirname = path.dirname;
|
|
var basename = path.basename;
|
|
var extname = path.extname;
|
|
var join = path.join;
|
|
var resolve = path.resolve;
|
|
|
|
/**
|
|
* Expose `View`.
|
|
*/
|
|
|
|
module.exports = View;
|
|
|
|
/**
|
|
* Initialize a new `View` with the given `name`.
|
|
*
|
|
* Options:
|
|
*
|
|
* - `defaultEngine` the default template engine name
|
|
* - `engines` template engine require() cache
|
|
* - `root` root path for view lookup
|
|
*
|
|
* @param {String} name
|
|
* @param {Object} options
|
|
* @api private
|
|
*/
|
|
|
|
function View(name, options) {
|
|
options = options || {};
|
|
this.name = name;
|
|
this.root = options.root;
|
|
var engines = options.engines;
|
|
this.defaultEngine = options.defaultEngine;
|
|
var ext = this.ext = extname(name);
|
|
if (!ext && !this.defaultEngine) throw new Error('No default engine was specified and no extension was provided.');
|
|
if (!ext) name += (ext = this.ext = ('.' != this.defaultEngine[0] ? '.' : '') + this.defaultEngine);
|
|
this.engine = engines[ext] || (engines[ext] = require(ext.slice(1)).__express);
|
|
this.path = this.lookup(name);
|
|
}
|
|
|
|
/**
|
|
* Lookup view by the given `name`
|
|
*
|
|
* @param {String} name
|
|
* @return {String}
|
|
* @api private
|
|
*/
|
|
|
|
View.prototype.lookup = function lookup(name) {
|
|
var path;
|
|
var roots = [].concat(this.root);
|
|
|
|
debug('lookup "%s"', name);
|
|
|
|
for (var i = 0; i < roots.length && !path; i++) {
|
|
var root = roots[i];
|
|
|
|
// resolve the path
|
|
var loc = resolve(root, name);
|
|
var dir = dirname(loc);
|
|
var file = basename(loc);
|
|
|
|
// resolve the file
|
|
path = this.resolve(dir, file);
|
|
}
|
|
|
|
return path;
|
|
};
|
|
|
|
/**
|
|
* Render with the given `options` and callback `fn(err, str)`.
|
|
*
|
|
* @param {Object} options
|
|
* @param {Function} fn
|
|
* @api private
|
|
*/
|
|
|
|
View.prototype.render = function render(options, fn) {
|
|
debug('render "%s"', this.path);
|
|
this.engine(this.path, options, fn);
|
|
};
|
|
|
|
/**
|
|
* Resolve the file within the given directory.
|
|
*
|
|
* @param {string} dir
|
|
* @param {string} file
|
|
* @private
|
|
*/
|
|
|
|
View.prototype.resolve = function resolve(dir, file) {
|
|
var ext = this.ext;
|
|
var path;
|
|
var stat;
|
|
|
|
// <path>.<ext>
|
|
path = join(dir, file);
|
|
stat = tryStat(path);
|
|
|
|
if (stat && stat.isFile()) {
|
|
return path;
|
|
}
|
|
|
|
// <path>/index.<ext>
|
|
path = join(dir, basename(file, ext), 'index' + ext);
|
|
stat = tryStat(path);
|
|
|
|
if (stat && stat.isFile()) {
|
|
return path;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Return a stat, maybe.
|
|
*
|
|
* @param {string} path
|
|
* @return {fs.Stats}
|
|
* @private
|
|
*/
|
|
|
|
function tryStat(path) {
|
|
debug('stat "%s"', path);
|
|
|
|
try {
|
|
return fs.statSync(path);
|
|
} catch (e) {
|
|
return undefined;
|
|
}
|
|
}
|