|
|
/** * 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; } }
|