├── .gitattributes ├── .travis.yml ├── .editorconfig ├── .gitignore ├── index.js ├── LICENSE ├── .verb.md ├── test └── test.js ├── package.json ├── .github └── contributing.md ├── .eslintrc.json └── README.md /.gitattributes: -------------------------------------------------------------------------------- 1 | # Enforce Unix newlines 2 | * text eol=lf 3 | 4 | # binaries 5 | *.ai binary 6 | *.psd binary 7 | *.jpg binary 8 | *.gif binary 9 | *.png binary 10 | *.jpeg binary 11 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | sudo: false 2 | os: 3 | - linux 4 | - osx 5 | language: node_js 6 | node_js: 7 | - node 8 | - '6' 9 | - '4' 10 | matrix: 11 | allow_failures: 12 | - node_js: '4' 13 | - node_js: '0.12' 14 | - node_js: '0.10' 15 | -------------------------------------------------------------------------------- /.editorconfig: -------------------------------------------------------------------------------- 1 | root = true 2 | 3 | [*] 4 | indent_style = space 5 | end_of_line = lf 6 | charset = utf-8 7 | indent_size = 2 8 | trim_trailing_whitespace = true 9 | insert_final_newline = true 10 | 11 | [{**/{actual,fixtures,expected,templates}/**,*.md}] 12 | trim_trailing_whitespace = false 13 | insert_final_newline = false -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # always ignore files 2 | *.DS_Store 3 | *.sublime-* 4 | 5 | # test related, or directories generated by tests 6 | test/actual 7 | actual 8 | coverage 9 | .nyc* 10 | 11 | # npm 12 | node_modules 13 | npm-debug.log 14 | 15 | # yarn 16 | yarn.lock 17 | yarn-error.log 18 | 19 | # misc 20 | _gh_pages 21 | _draft 22 | _drafts 23 | bower_components 24 | vendor 25 | temp 26 | tmp 27 | TODO.md 28 | -------------------------------------------------------------------------------- /index.js: -------------------------------------------------------------------------------- 1 | 'use strict'; 2 | 3 | var isObject = require('isobject'); 4 | var merge = require('mixin-deep'); 5 | var path = require('path'); 6 | 7 | module.exports = function(app, key) { 8 | if (!isObject(app) || typeof app.use !== 'function') { 9 | throw new Error('expected an instance of templates or assemble'); 10 | } 11 | 12 | app.cwd = app.cwd || process.cwd(); 13 | app.options.dest = app.options.dest || app.cwd; 14 | 15 | return function(file, next) { 16 | if (!key) key = 'page'; 17 | 18 | var page = {}; 19 | page.dest = path.resolve(app.cwd, app.options.dest); 20 | page.cwd = file.cwd; 21 | page.base = file.base; 22 | page.path = path.join(page.dest, file.relative); 23 | page.dirname = path.dirname(page.path); 24 | page.relative = file.relative; 25 | page.basename = file.basename; 26 | page.stem = file.stem; 27 | page.extname = file.extname; 28 | 29 | var obj = merge({}, page, file.data); 30 | delete obj[key]; 31 | file.data[key] = obj; 32 | 33 | next(); 34 | }; 35 | }; 36 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | The MIT License (MIT) 2 | 3 | Copyright (c) 2017 Jon Schlinkert 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /.verb.md: -------------------------------------------------------------------------------- 1 | ## Usage 2 | 3 | This middleware will work with [assemble][], [verb][], [generate][], [update][] or any other node.js application based on the [templates][] library. 4 | 5 | ```js 6 | var pageData = require('{%= name %}'); 7 | var assemble = require('assemble'); 8 | var app = assemble(); 9 | 10 | app.onLoad(/\.md$/, pageData(app)); 11 | var page = app.page('home.md', { 12 | contents: new Buffer('---\ntitle: Home\n---\n\nThis is {{page.title}}') 13 | }); 14 | 15 | app.render(page, function(err, view) { 16 | if (err) return console.log(err); 17 | console.log(view.contents.toString()); 18 | //=> 'This is Home' 19 | }); 20 | ``` 21 | 22 | Then, inside templates you can use the variable like this: 23 | 24 | ```handlebars 25 | --- 26 | title: Home 27 | --- 28 | 29 | This is the {{page.title}} page. 30 | ``` 31 | 32 | Which would render to: 33 | 34 | ```html 35 | This is the Home page. 36 | ``` 37 | 38 | ## Custom variable 39 | 40 | Optionally specify a custom property name to use instead of `page`. 41 | 42 | ```js 43 | // you don't need to create a custom collection too, this is just an example 44 | app.create('posts'); 45 | app.onLoad(/\.md$/, pageData(app, 'post')); 46 | 47 | var post = app.post('home.md', { 48 | contents: new Buffer('---\ntitle: Home\n---\n\nThis is {{post.title}}') 49 | }); 50 | 51 | app.render(post, function(err, view) { 52 | if (err) return console.log(err); 53 | console.log(view.contents.toString()); 54 | //=> 'This is Home' 55 | }); 56 | ``` 57 | -------------------------------------------------------------------------------- /test/test.js: -------------------------------------------------------------------------------- 1 | 'use strict'; 2 | 3 | require('mocha'); 4 | var assert = require('assert'); 5 | var pageData = require('..'); 6 | 7 | describe('assemble-middleware-page-variable', function() { 8 | it('should export a function', function() { 9 | assert.equal(typeof pageData, 'function'); 10 | }); 11 | 12 | it('should expose `page` on the context', function(cb) { 13 | var assemble = require('assemble'); 14 | var app = assemble(); 15 | 16 | app.onLoad(/\.md$/, pageData(app)); 17 | var page = app.page('home.md', {content: '---\ntitle: Home\n---\n\nThis is {{page.title}}'}); 18 | app.render(page, function(err, view) { 19 | if (err) return cb(err); 20 | assert.equal(view.content, 'This is Home'); 21 | cb(); 22 | }); 23 | }); 24 | 25 | it('should expose `post` on the context', function(cb) { 26 | var assemble = require('assemble'); 27 | var app = assemble(); 28 | app.create('posts'); 29 | 30 | app.onLoad(/\.md$/, pageData(app, 'post')); 31 | var post = app.post('home.md', {content: '---\ntitle: Home\n---\n\nThis is {{post.title}}'}); 32 | app.render(post, function(err, view) { 33 | if (err) return cb(err); 34 | assert.equal(view.content, 'This is Home'); 35 | cb(); 36 | }); 37 | }); 38 | 39 | it('should throw an error when invalid args are passed', function(cb) { 40 | try { 41 | pageData(); 42 | cb(new Error('expected an error')); 43 | } catch (err) { 44 | assert(err); 45 | assert.equal(err.message, 'expected an instance of templates or assemble'); 46 | cb(); 47 | } 48 | }); 49 | }); 50 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "assemble-middleware-page-variable", 3 | "description": "Assemble middleware for adding a `page` variable to the context, with details about the current item being rendered.", 4 | "version": "0.1.0", 5 | "homepage": "https://github.com/assemble/assemble-middleware-page-variable", 6 | "author": "Jon Schlinkert (https://github.com/jonschlinkert)", 7 | "repository": "assemble/assemble-middleware-page-variable", 8 | "bugs": { 9 | "url": "https://github.com/assemble/assemble-middleware-page-variable/issues" 10 | }, 11 | "license": "MIT", 12 | "files": [ 13 | "index.js" 14 | ], 15 | "main": "index.js", 16 | "engines": { 17 | "node": ">=4" 18 | }, 19 | "scripts": { 20 | "test": "mocha" 21 | }, 22 | "dependencies": { 23 | "isobject": "^3.0.0", 24 | "mixin-deep": "^1.1.3" 25 | }, 26 | "devDependencies": { 27 | "assemble": "^0.17.1", 28 | "gulp-format-md": "^0.1.11", 29 | "mocha": "^3.2.0" 30 | }, 31 | "keywords": [ 32 | "assemble", 33 | "assemblemiddleware", 34 | "assembleplugin", 35 | "middleware", 36 | "page", 37 | "plugin", 38 | "variable" 39 | ], 40 | "verb": { 41 | "toc": false, 42 | "layout": "default", 43 | "tasks": [ 44 | "readme" 45 | ], 46 | "plugins": [ 47 | "gulp-format-md" 48 | ], 49 | "lint": { 50 | "reflinks": true 51 | }, 52 | "related": { 53 | "list": [ 54 | "assemble", 55 | "generate", 56 | "templates", 57 | "update", 58 | "verb" 59 | ] 60 | }, 61 | "reflinks": [ 62 | "assemble", 63 | "generate", 64 | "templates", 65 | "update", 66 | "verb", 67 | "verb-generate-readme" 68 | ] 69 | } 70 | } 71 | -------------------------------------------------------------------------------- /.github/contributing.md: -------------------------------------------------------------------------------- 1 | # Contributing to assemble-middleware-page-variable 2 | 3 | First and foremost, thank you! We appreciate that you want to contribute to assemble-middleware-page-variable, your time is valuable, and your contributions mean a lot to us. 4 | 5 | **What does "contributing" mean?** 6 | 7 | Creating an issue is the simplest form of contributing to a project. But there are many ways to contribute, including the following: 8 | 9 | - Updating or correcting documentation 10 | - Feature requests 11 | - Bug reports 12 | 13 | If you'd like to learn more about contributing in general, the [Guide to Idiomatic Contributing](https://github.com/jonschlinkert/idiomatic-contributing) has a lot of useful information. 14 | 15 | **Showing support for assemble-middleware-page-variable** 16 | 17 | Please keep in mind that open source software is built by people like you, who spend their free time creating things the rest the community can use. 18 | 19 | Don't have time to contribute? No worries, here are some other ways to show your support for assemble-middleware-page-variable: 20 | 21 | - star the [project](https://github.com/jonschlinkert/assemble-middleware-page-variable) 22 | - tweet your support for assemble-middleware-page-variable 23 | 24 | ## Issues 25 | 26 | ### Before creating an issue 27 | 28 | Please try to determine if the issue is caused by an underlying library, and if so, create the issue there. Sometimes this is difficult to know. We only ask that you attempt to give a reasonable attempt to find out. Oftentimes the readme will have advice about where to go to create issues. 29 | 30 | Try to follow these guidelines 31 | 32 | - **Investigate the issue**: 33 | - **Check the readme** - oftentimes you will find notes about creating issues, and where to go depending on the type of issue. 34 | - Create the issue in the appropriate repository. 35 | 36 | ### Creating an issue 37 | 38 | Please be as descriptive as possible when creating an issue. Give us the information we need to successfully answer your question or address your issue by answering the following in your issue: 39 | 40 | - **version**: please note the version of assemble-middleware-page-variable are you using 41 | - **extensions, plugins, helpers, etc** (if applicable): please list any extensions you're using 42 | - **error messages**: please paste any error messages into the issue, or a [gist](https://gist.github.com/) 43 | 44 | ## Above and beyond 45 | 46 | Here are some tips for creating idiomatic issues. Taking just a little bit extra time will make your issue easier to read, easier to resolve, more likely to be found by others who have the same or similar issue in the future. 47 | 48 | - read the [Guide to Idiomatic Contributing](https://github.com/jonschlinkert/idiomatic-contributing) 49 | - take some time to learn basic markdown. This [markdown cheatsheet](https://gist.github.com/jonschlinkert/5854601) is super helpful, as is the GitHub guide to [basic markdown](https://help.github.com/articles/markdown-basics/). 50 | - Learn about [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown/). And if you want to really go above and beyond, read [mastering markdown](https://guides.github.com/features/mastering-markdown/). 51 | - use backticks to wrap code. This ensures that code will retain its format, making it much more readable to others 52 | - use syntax highlighting by adding the correct language name after the first "code fence" 53 | 54 | 55 | [node-glob]: https://github.com/isaacs/node-glob 56 | [micromatch]: https://github.com/jonschlinkert/micromatch 57 | [so]: http://stackoverflow.com/questions/tagged/assemble-middleware-page-variable -------------------------------------------------------------------------------- /.eslintrc.json: -------------------------------------------------------------------------------- 1 | { 2 | "ecmaFeatures": { 3 | "modules": true, 4 | "experimentalObjectRestSpread": true 5 | }, 6 | 7 | "env": { 8 | "browser": false, 9 | "es6": true, 10 | "node": true, 11 | "mocha": true 12 | }, 13 | 14 | "globals": { 15 | "document": false, 16 | "navigator": false, 17 | "window": false 18 | }, 19 | 20 | "rules": { 21 | "accessor-pairs": 2, 22 | "arrow-spacing": [2, { "before": true, "after": true }], 23 | "block-spacing": [2, "always"], 24 | "brace-style": [2, "1tbs", { "allowSingleLine": true }], 25 | "comma-dangle": [2, "never"], 26 | "comma-spacing": [2, { "before": false, "after": true }], 27 | "comma-style": [2, "last"], 28 | "constructor-super": 2, 29 | "curly": [2, "multi-line"], 30 | "dot-location": [2, "property"], 31 | "eol-last": 2, 32 | "eqeqeq": [2, "allow-null"], 33 | "generator-star-spacing": [2, { "before": true, "after": true }], 34 | "handle-callback-err": [2, "^(err|error)$" ], 35 | "indent": [2, 2, { "SwitchCase": 1 }], 36 | "key-spacing": [2, { "beforeColon": false, "afterColon": true }], 37 | "keyword-spacing": [2, { "before": true, "after": true }], 38 | "new-cap": [2, { "newIsCap": true, "capIsNew": false }], 39 | "new-parens": 2, 40 | "no-array-constructor": 2, 41 | "no-caller": 2, 42 | "no-class-assign": 2, 43 | "no-cond-assign": 2, 44 | "no-const-assign": 2, 45 | "no-control-regex": 2, 46 | "no-debugger": 2, 47 | "no-delete-var": 2, 48 | "no-dupe-args": 2, 49 | "no-dupe-class-members": 2, 50 | "no-dupe-keys": 2, 51 | "no-duplicate-case": 2, 52 | "no-empty-character-class": 2, 53 | "no-eval": 2, 54 | "no-ex-assign": 2, 55 | "no-extend-native": 2, 56 | "no-extra-bind": 2, 57 | "no-extra-boolean-cast": 2, 58 | "no-extra-parens": [2, "functions"], 59 | "no-fallthrough": 2, 60 | "no-floating-decimal": 2, 61 | "no-func-assign": 2, 62 | "no-implied-eval": 2, 63 | "no-inner-declarations": [2, "functions"], 64 | "no-invalid-regexp": 2, 65 | "no-irregular-whitespace": 2, 66 | "no-iterator": 2, 67 | "no-label-var": 2, 68 | "no-labels": 2, 69 | "no-lone-blocks": 2, 70 | "no-mixed-spaces-and-tabs": 2, 71 | "no-multi-spaces": 2, 72 | "no-multi-str": 2, 73 | "no-multiple-empty-lines": [2, { "max": 1 }], 74 | "no-native-reassign": 0, 75 | "no-negated-in-lhs": 2, 76 | "no-new": 2, 77 | "no-new-func": 2, 78 | "no-new-object": 2, 79 | "no-new-require": 2, 80 | "no-new-wrappers": 2, 81 | "no-obj-calls": 2, 82 | "no-octal": 2, 83 | "no-octal-escape": 2, 84 | "no-proto": 0, 85 | "no-redeclare": 2, 86 | "no-regex-spaces": 2, 87 | "no-return-assign": 2, 88 | "no-self-compare": 2, 89 | "no-sequences": 2, 90 | "no-shadow-restricted-names": 2, 91 | "no-spaced-func": 2, 92 | "no-sparse-arrays": 2, 93 | "no-this-before-super": 2, 94 | "no-throw-literal": 2, 95 | "no-trailing-spaces": 0, 96 | "no-undef": 2, 97 | "no-undef-init": 2, 98 | "no-unexpected-multiline": 2, 99 | "no-unneeded-ternary": [2, { "defaultAssignment": false }], 100 | "no-unreachable": 2, 101 | "no-unused-vars": [2, { "vars": "all", "args": "none" }], 102 | "no-useless-call": 0, 103 | "no-with": 2, 104 | "one-var": [0, { "initialized": "never" }], 105 | "operator-linebreak": [0, "after", { "overrides": { "?": "before", ":": "before" } }], 106 | "padded-blocks": [0, "never"], 107 | "quotes": [2, "single", "avoid-escape"], 108 | "radix": 2, 109 | "semi": [2, "always"], 110 | "semi-spacing": [2, { "before": false, "after": true }], 111 | "space-before-blocks": [2, "always"], 112 | "space-before-function-paren": [2, "never"], 113 | "space-in-parens": [2, "never"], 114 | "space-infix-ops": 2, 115 | "space-unary-ops": [2, { "words": true, "nonwords": false }], 116 | "spaced-comment": [0, "always", { "markers": ["global", "globals", "eslint", "eslint-disable", "*package", "!", ","] }], 117 | "use-isnan": 2, 118 | "valid-typeof": 2, 119 | "wrap-iife": [2, "any"], 120 | "yoda": [2, "never"] 121 | } 122 | } 123 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # assemble-middleware-page-variable [![NPM version](https://img.shields.io/npm/v/assemble-middleware-page-variable.svg?style=flat)](https://www.npmjs.com/package/assemble-middleware-page-variable) [![NPM monthly downloads](https://img.shields.io/npm/dm/assemble-middleware-page-variable.svg?style=flat)](https://npmjs.org/package/assemble-middleware-page-variable) [![NPM total downloads](https://img.shields.io/npm/dt/assemble-middleware-page-variable.svg?style=flat)](https://npmjs.org/package/assemble-middleware-page-variable) [![Linux Build Status](https://img.shields.io/travis/assemble/assemble-middleware-page-variable.svg?style=flat&label=Travis)](https://travis-ci.org/assemble/assemble-middleware-page-variable) 2 | 3 | > Assemble middleware for adding a `page` variable to the context, with details about the current item being rendered. 4 | 5 | ## Install 6 | 7 | Install with [npm](https://www.npmjs.com/): 8 | 9 | ```sh 10 | $ npm install --save assemble-middleware-page-variable 11 | ``` 12 | 13 | ## Usage 14 | 15 | This middleware will work with [assemble](https://github.com/assemble/assemble), [verb](https://github.com/verbose/verb), [generate](https://github.com/generate/generate), [update](https://github.com/update/update) or any other node.js application based on the [templates](https://github.com/jonschlinkert/templates) library. 16 | 17 | ```js 18 | var pageData = require('assemble-middleware-page-variable'); 19 | var assemble = require('assemble'); 20 | var app = assemble(); 21 | 22 | app.onLoad(/\.md$/, pageData(app)); 23 | var page = app.page('home.md', { 24 | contents: new Buffer('---\ntitle: Home\n---\n\nThis is {{page.title}}') 25 | }); 26 | 27 | app.render(page, function(err, view) { 28 | if (err) return console.log(err); 29 | console.log(view.contents.toString()); 30 | //=> 'This is Home' 31 | }); 32 | ``` 33 | 34 | Then, inside templates you can use the variable like this: 35 | 36 | ```handlebars 37 | --- 38 | title: Home 39 | --- 40 | 41 | This is the {{page.title}} page. 42 | ``` 43 | 44 | Which would render to: 45 | 46 | ```html 47 | This is the Home page. 48 | ``` 49 | 50 | ## Custom variable 51 | 52 | Optionally specify a custom property name to use instead of `page`. 53 | 54 | ```js 55 | // you don't need to create a custom collection too, this is just an example 56 | app.create('posts'); 57 | app.onLoad(/\.md$/, pageData(app, 'post')); 58 | 59 | var post = app.post('home.md', { 60 | contents: new Buffer('---\ntitle: Home\n---\n\nThis is {{post.title}}') 61 | }); 62 | 63 | app.render(post, function(err, view) { 64 | if (err) return console.log(err); 65 | console.log(view.contents.toString()); 66 | //=> 'This is Home' 67 | }); 68 | ``` 69 | 70 | ## About 71 | 72 | ### Related projects 73 | 74 | * [assemble](https://www.npmjs.com/package/assemble): Get the rocks out of your socks! Assemble makes you fast at creating web projects… [more](https://github.com/assemble/assemble) | [homepage](https://github.com/assemble/assemble "Get the rocks out of your socks! Assemble makes you fast at creating web projects. Assemble is used by thousands of projects for rapid prototyping, creating themes, scaffolds, boilerplates, e-books, UI components, API documentation, blogs, building websit") 75 | * [generate](https://www.npmjs.com/package/generate): Command line tool and developer framework for scaffolding out new GitHub projects. Generate offers the… [more](https://github.com/generate/generate) | [homepage](https://github.com/generate/generate "Command line tool and developer framework for scaffolding out new GitHub projects. Generate offers the robustness and configurability of Yeoman, the expressiveness and simplicity of Slush, and more powerful flow control and composability than either.") 76 | * [templates](https://www.npmjs.com/package/templates): System for creating and managing template collections, and rendering templates with any node.js template engine… [more](https://github.com/jonschlinkert/templates) | [homepage](https://github.com/jonschlinkert/templates "System for creating and managing template collections, and rendering templates with any node.js template engine. Can be used as the basis for creating a static site generator or blog framework.") 77 | * [update](https://www.npmjs.com/package/update): Be scalable! Update is a new, open source developer framework and CLI for automating updates… [more](https://github.com/update/update) | [homepage](https://github.com/update/update "Be scalable! Update is a new, open source developer framework and CLI for automating updates of any kind in code projects.") 78 | * [verb](https://www.npmjs.com/package/verb): Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used… [more](https://github.com/verbose/verb) | [homepage](https://github.com/verbose/verb "Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used on hundreds of projects of all sizes to generate everything from API docs to readmes.") 79 | 80 | ### Contributing 81 | 82 | Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new). 83 | 84 | Please read the [contributing guide](.github/contributing.md) for avice on opening issues, pull requests, and coding standards. 85 | 86 | ### Building docs 87 | 88 | _(This document was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme) (a [verb](https://github.com/verbose/verb) generator), please don't edit the readme directly. Any changes to the readme must be made in [.verb.md](.verb.md).)_ 89 | 90 | To generate the readme and API documentation with [verb](https://github.com/verbose/verb): 91 | 92 | ```sh 93 | $ npm install -g verb verb-generate-readme && verb 94 | ``` 95 | 96 | ### Running tests 97 | 98 | Install dev dependencies: 99 | 100 | ```sh 101 | $ npm install -d && npm test 102 | ``` 103 | 104 | ### Author 105 | 106 | **Jon Schlinkert** 107 | 108 | * [github/jonschlinkert](https://github.com/jonschlinkert) 109 | * [twitter/jonschlinkert](http://twitter.com/jonschlinkert) 110 | 111 | ### License 112 | 113 | Copyright © 2017, [Jon Schlinkert](https://github.com/jonschlinkert). 114 | Released under the [MIT license](LICENSE). 115 | 116 | *** 117 | 118 | _This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.2.3, on January 05, 2017._ --------------------------------------------------------------------------------