@retailmenot/roux-handlebars-tools

This module provides tools for working with Roux ingredients that provide a Handlebars entry point.

Installation

npm install @retailmenot/roux-handlebars-tools

API

resolvePartialName

Get a path to the file referenced by the partialName

• partialName - the name of the partial to locate
• config - optional configuration object
  • config.extensions - optional array of extensions to try when looking for partials; defaults to ['hbs', 'handlebars']
  • config.pantries - an optional cache of Pantry instances
  • config.pantrySearchPaths - optional array of paths to search for pantries in if not found in the cache; defaults to ['$CWD/node_modules']
  • `config.partials - an optional map of partial names to Handlebars source code; the partials will be processed if transitively depended on, but will not appear in the result
  • config.partialSearchPaths - optional array of paths to search for partials in the filesystem; defaults to ['$CWD']

getPartialDependencies

This method returns a promise of a map from the names of all partials a template transitively depends on to their absolute path in the filesystem.

It accepts an optional map of partials as config.partials. These will be explored if transitively depended on, but members of config.partials will not be included in the result.

• template - the source code of a Handlebars template
• config - optional configuration object
  • config.extensions - optional array of extensions to try when looking for partials; defaults to ['hbs', 'handlebars']
  • config.pantries - an optional cache of Pantry instances
  • config.pantrySearchPaths - optional array of paths to search for pantries in if not found in the cache; defaults to ['$CWD/node_modules']
  • `config.partials - an optional map of partial names to Handlebars source code; the partials will be processed if transitively depended on, but will not appear in the result
  • config.partialSearchPaths - optional array of paths to search for partials in the filesystem; defaults to ['$CWD']

Name resolution

This method will first attempt to resolve a prefix of the partial name as a Roux ingredient. If able to do so, the partial name is assumed to refer to a template in that ingredient. It will then attempt to get its absolute path, failing if the file doesn't exist.

If unable to resolve a prefix as a Roux ingredient, the method attempts to find the partial name relative to the paths in config.partialSearchPaths.