11 KiB
Express Handlebars Change History
3.0.0 (2016-01-26)
- Upgraded to Handlebars 4.0. ([#142][])
2.0.1 (2015-04-23)
- Guarded against unexpected Handlebars API change that was released in a patch. (#125)
2.0.0 (2015-03-22)
-
[!] Upgraded to Handlebars 3.0 by default, but still works with Handlebars 2.x by using the
handlebars
config option. (#105) -
[!] Removed using prototype properties for default config values. The default values are now embedded in the constructor. (#105)
-
[!] Removed
handlebarsVersion
instance property andgetHandlebarsSemver()
static function on theExpressHandlebars
constructor. (#105) -
[!] Replaced undocumented
compileTemplate()
hook with the protected but supported_compileTemplate()
and_precompileTemplate()
hooks. (#95) -
Fixed layout path resolution on Windows. (#113 @Tineler)
-
Added
compilerOptions
config property which is passed along toHandlebars.compile()
andHandlebars.precompile()
. (#95) -
Exposed Express Handlebars metadata to the data channel during render. This metadata is accessible via
{{@exphbs.*}}
(#89, #101) -
Added new "protected" hooks for AOP-ing template compilation and rendering, all of which can optionally return a Promise: (#105)
_compileTemplate()
_precompileTemplate()
_renderTemplate()
1.2.2 (2015-03-06)
- Upgraded
glob
dependency to v5 which now officially supports symlinks via the newfollow
option. (#98)
1.2.1 (2015-02-17)
- Locked down
glob
dependency to a v4 version range that is known to work with this package and support symlinks. Theglob
version can be updated when isaacs/node-glob#139 is resolved. (#98 @adgad)
1.2.0 (2015-02-17)
- Added support for render-level
partials
to be specified when callingrenderView()
(which is the method Express calls). Theoptions.partials
value matches what Handlebars accepts during template rendering: it should have the shape{partialName: fn}
or be a Promise for such an object. (#82)
1.1.0 (2014-09-14)
-
[!] Upgraded Handlebars to 2.0.0 final, it was beta before.
-
Added support for
partialsDir
to be configured with a collection (or promise for a collection) of templates, via the newtemplates
prop inpartialDir
config objects. This allows developers to hand Express Handlebars the compiled partials templates to use for a specific partials dir. (#81 @joanniclaborde) -
Upgraded Promise dependency.
1.0.3 (2014-09-05)
- Fixed issue with namespaced partials dirs not actually being namespaces. (#76 @inerte)
1.0.2 (2014-09-05)
- Fixed
engines
entry inpackage.json
to Node>=0.10
to reflect this package's requirements. (#78)
1.0.1 (2014-08-08)
- Fixed bug where rendered content was only be returned if a layout template was being used. Now a layout-less render will actually return content. (#73)
1.0.0 (2014-08-07)
-
[!] Renamed to:
express-handlebars
. (#65) -
[!] Rewritten to use Promises instead of
async
for asynchronous code. (#68) This resulted in the following public API changes:loadPartials()
-->getPartials()
, returns a Promise.loadTemplate()
-->getTemplate()
, returns a Promise.loadTemplates()
-->getTemplates()
, returns a Promise.render(file, context, [options])
, returns a Promise.
-
partialsDir
can now be set with an array of objects in the following form to support namespaced partials: (#70 @joanniclaborde){ dir: 'foo/bar/', namespace: 'bar' }
-
Added support for Handlebars'
data
channel viaoptions.data
. (#62) -
Added
compileTemplate()
hook for the pre/post compile process, this also supports returning a Promise. (#39, #41) -
Added
_renderTemplate()
hook that supports returning a Promise. (#39, #41) -
Upgraded all dependencies, including Handlebars to 2.x. (#59)
-
Added
graceful-fs
dependency to support large numbers of files to avoid EMFILE errors. -
Reduced complexity of cache code.
-
Updated examples to each be self-contained and have
package.json
files.
0.5.1 (2014-08-05)
-
[!] Last release before
v1.0
which will have breaking changes. -
Improved
extname
docs in README and added example. (#30 @Crashthatch) -
extname
can now be specified without the leading"."
. (#51 @calvinmetcalf)
0.5.0 (2013-07-25)
-
Added
loadTemplates()
method which will load all the templates in a specified directory. (#21) -
Added support for multiple partials directories. This enables the
partialsDir
configuration property to be specified as an array of directories, and loads all of the templates in each one.This feature allows an app's partials to be split up in multiple directories, which is common if an app has some shared partials which will also be exposed to the client, and some server-side-only partials. (#20)
-
Added runnable code examples in this package's "examples/" directory. (#22)
-
Improved optional argument handling in public methods to treat Express
locals
function objects asoptions
and notcallback
params to the method being invoked. (#27)
0.4.1 (2013-04-06)
- Updated
async
dependency to the latest stable minor version: "~0.2".
0.4.0 (2013-03-24)
-
[!] Removed the following "get" -> "load" aliases which kept in v0.2.0 for back-compat:
getPartials()
->loadPartials()
getTemplate()
->loadTemplate()
This is the future version where these aliases have been removed.
-
[!] Renamed
lib/express3-handlebars.js
->lib/express-handlebars.js
. -
Exposed
getHandlebarsSemver()
function as a static property on theExpressHandlebars
constructor. -
Rearranged module exports by moving the engine factory function to
index.js
, making thelib/express3-handlebars.js
module only responsible for exporting theExpressHandlebars
constructor.
0.3.3 (2013-03-22)
- Updated internal
_resolveLayoutPath()
method to take the fulloptions
/locals objects which the view is rendered with. This makes it easier to override. (#14)
0.3.2 (2013-02-20)
- Transfered ownership and copyright to Yahoo! Inc. This software is still free to use, and is now licensed under the Yahoo! Inc. BSD license.
0.3.1 (2013-02-18)
- Updated README with info about
options.helpers
forrender()
andrenderView()
docs. (#7)
0.3.0 (2013-02-18)
-
Added support for render-level helpers, via
options.helpers
, to therender()
andrenderView()
methods. Handlebars'registerHelper()
function now works as expected and does not have to be called before theExpressHandlebars
instance is created. Helpers are now merged from:handlebars.helpers
(global),helpers
(instance), andoptions.helpers
(render-level) before a template is rendered; this provides flexibility at all levels. (#3, #11) -
Added
handlebarsVersion
property which is the version number ofhandlebars
as a semver. This is used internally to branch on certain operations which differ between Handlebars releases.
0.2.3 (2013-02-13)
- Fixed issue with naming nested partials when using the latest version of Handlebars (1.0.rc.2). Previous versions require a hack to replace "/"s with "."s in partial names, and the latest version of Handlebars fixes that bug. This hack will only be applied to old versions of Handlebars. (#9)
0.2.2 (2013-02-04)
- Updated README with the public method renames which happened v0.2.0.
0.2.1 (2013-02-04)
-
extname
,layoutsDir
, andpartialsDir
property values will now reference the values on the prototype unless anExpressHandlebars
instance is constructed with config values for these properties. -
Improved clarity of method implementations, and exposed more override "hooks" via new private methods:
_getPartialName()
,_renderTemplate()
, and_resolveLayoutPath()
.
0.2.0 (2013-02-01)
-
[!] Renamed methods prefixed with "get" to "load" for clarity:
getPartials()
->loadPartials()
getTemplate()
->loadTemplate()
Aliases for these methods have been created to maintain back-compat, but the old method names are now deprecated will be removed in the future. (#5)
-
All paths are resolved before checking in or adding to caches. (#1)
-
Force
{precompiled: false}
option withinrender()
andrenderView()
methods to prevent trying to render with precompiled templates. (#2)
0.1.2 (2013-01-10)
- Tweaked formatting of README documentation.
0.1.1 (2013-01-10)
- Added README documentation.
0.1.0 (2013-01-07)
- Initial release.