Generic template helper for creating an array of vinyl file objects from a glob pattern.
Last updated 3 years ago by jonschlinkert .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install helper-glob-files 
SYNC missed versions from official npm registry.

helper-glob-files NPM version NPM monthly downloads NPM total downloads Linux Build Status

Generic template helper for creating an array of vinyl file objects from a glob pattern.


Install with npm:

$ npm install --save helper-glob-files


This can be used as a helper with handlebars, lodash, assemble, engine or directly as a utility function.

Heads up!

The purpose of this helper is to easily create an array of files to use in templates. This means that the source and dest patterns will need to be known at render time and, as such, this helper expects a dest path to be defined as a string on the helper options or on the context, otherwise an error is thrown.

var glob = require('helper-glob-files');
console.log(glob('*.js', {dest: ''}));
//=> [ <File "example.js">, <File "index.js"> ]

Handlebars usage

var handlebars = require('handlebars');
handlebars.registerHelper('glob', glob);

Then in templates:

{{#each (glob "*") as |file|}}


Get the contents for each file:

var fs = require('fs');
handlebars.registerHelper('read', function(filepath) {
  return fs.readFileSync(filepath, 'utf8');

Then in templates:

<!-- tmpl -->
{{#each (glob "*") as |file|}}
<p>{{read file.path}}</p>


// compile
var fn = handlebars.compile(tmpl);
// render 

Lo-dash usage

var template = require('lodash.template');

Then in templates:

<!-- tmpl -->
<% glob("*", {dest: ""}).map(function(item) { %>
<%= item.stem %>
<% }) %>


// compile
var fn = template(tmpl, {imports: {glob: glob}});
// render 


Related projects


Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Please read the contributing guide for advice on opening issues, pull requests, and coding standards.

Building docs

(This project's is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the readme template.)

To generate the readme, run the following command:

$ npm install -g verbose/verb#dev verb-generate-readme && verb

Running tests

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

$ npm install && npm test


Jon Schlinkert


Copyright © 2017, Jon Schlinkert. MIT

This file was generated by verb-generate-readme, v0.4.2, on February 10, 2017.

Current Tags

  • 0.1.0                                ...           latest (3 years ago)

1 Versions

  • 0.1.0                                ...           3 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (3)
Dev Dependencies (5)
Dependents (0)

Copyright 2014 - 2016 © |