forked from dachan/dach
		
	a lot of changes
This commit is contained in:
		
							
								
								
									
										202
									
								
								node_modules/ejs/LICENSE
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										202
									
								
								node_modules/ejs/LICENSE
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,202 @@
 | 
			
		||||
 | 
			
		||||
                                 Apache License
 | 
			
		||||
                           Version 2.0, January 2004
 | 
			
		||||
                        http://www.apache.org/licenses/
 | 
			
		||||
 | 
			
		||||
   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 | 
			
		||||
 | 
			
		||||
   1. Definitions.
 | 
			
		||||
 | 
			
		||||
      "License" shall mean the terms and conditions for use, reproduction,
 | 
			
		||||
      and distribution as defined by Sections 1 through 9 of this document.
 | 
			
		||||
 | 
			
		||||
      "Licensor" shall mean the copyright owner or entity authorized by
 | 
			
		||||
      the copyright owner that is granting the License.
 | 
			
		||||
 | 
			
		||||
      "Legal Entity" shall mean the union of the acting entity and all
 | 
			
		||||
      other entities that control, are controlled by, or are under common
 | 
			
		||||
      control with that entity. For the purposes of this definition,
 | 
			
		||||
      "control" means (i) the power, direct or indirect, to cause the
 | 
			
		||||
      direction or management of such entity, whether by contract or
 | 
			
		||||
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
 | 
			
		||||
      outstanding shares, or (iii) beneficial ownership of such entity.
 | 
			
		||||
 | 
			
		||||
      "You" (or "Your") shall mean an individual or Legal Entity
 | 
			
		||||
      exercising permissions granted by this License.
 | 
			
		||||
 | 
			
		||||
      "Source" form shall mean the preferred form for making modifications,
 | 
			
		||||
      including but not limited to software source code, documentation
 | 
			
		||||
      source, and configuration files.
 | 
			
		||||
 | 
			
		||||
      "Object" form shall mean any form resulting from mechanical
 | 
			
		||||
      transformation or translation of a Source form, including but
 | 
			
		||||
      not limited to compiled object code, generated documentation,
 | 
			
		||||
      and conversions to other media types.
 | 
			
		||||
 | 
			
		||||
      "Work" shall mean the work of authorship, whether in Source or
 | 
			
		||||
      Object form, made available under the License, as indicated by a
 | 
			
		||||
      copyright notice that is included in or attached to the work
 | 
			
		||||
      (an example is provided in the Appendix below).
 | 
			
		||||
 | 
			
		||||
      "Derivative Works" shall mean any work, whether in Source or Object
 | 
			
		||||
      form, that is based on (or derived from) the Work and for which the
 | 
			
		||||
      editorial revisions, annotations, elaborations, or other modifications
 | 
			
		||||
      represent, as a whole, an original work of authorship. For the purposes
 | 
			
		||||
      of this License, Derivative Works shall not include works that remain
 | 
			
		||||
      separable from, or merely link (or bind by name) to the interfaces of,
 | 
			
		||||
      the Work and Derivative Works thereof.
 | 
			
		||||
 | 
			
		||||
      "Contribution" shall mean any work of authorship, including
 | 
			
		||||
      the original version of the Work and any modifications or additions
 | 
			
		||||
      to that Work or Derivative Works thereof, that is intentionally
 | 
			
		||||
      submitted to Licensor for inclusion in the Work by the copyright owner
 | 
			
		||||
      or by an individual or Legal Entity authorized to submit on behalf of
 | 
			
		||||
      the copyright owner. For the purposes of this definition, "submitted"
 | 
			
		||||
      means any form of electronic, verbal, or written communication sent
 | 
			
		||||
      to the Licensor or its representatives, including but not limited to
 | 
			
		||||
      communication on electronic mailing lists, source code control systems,
 | 
			
		||||
      and issue tracking systems that are managed by, or on behalf of, the
 | 
			
		||||
      Licensor for the purpose of discussing and improving the Work, but
 | 
			
		||||
      excluding communication that is conspicuously marked or otherwise
 | 
			
		||||
      designated in writing by the copyright owner as "Not a Contribution."
 | 
			
		||||
 | 
			
		||||
      "Contributor" shall mean Licensor and any individual or Legal Entity
 | 
			
		||||
      on behalf of whom a Contribution has been received by Licensor and
 | 
			
		||||
      subsequently incorporated within the Work.
 | 
			
		||||
 | 
			
		||||
   2. Grant of Copyright License. Subject to the terms and conditions of
 | 
			
		||||
      this License, each Contributor hereby grants to You a perpetual,
 | 
			
		||||
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 | 
			
		||||
      copyright license to reproduce, prepare Derivative Works of,
 | 
			
		||||
      publicly display, publicly perform, sublicense, and distribute the
 | 
			
		||||
      Work and such Derivative Works in Source or Object form.
 | 
			
		||||
 | 
			
		||||
   3. Grant of Patent License. Subject to the terms and conditions of
 | 
			
		||||
      this License, each Contributor hereby grants to You a perpetual,
 | 
			
		||||
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 | 
			
		||||
      (except as stated in this section) patent license to make, have made,
 | 
			
		||||
      use, offer to sell, sell, import, and otherwise transfer the Work,
 | 
			
		||||
      where such license applies only to those patent claims licensable
 | 
			
		||||
      by such Contributor that are necessarily infringed by their
 | 
			
		||||
      Contribution(s) alone or by combination of their Contribution(s)
 | 
			
		||||
      with the Work to which such Contribution(s) was submitted. If You
 | 
			
		||||
      institute patent litigation against any entity (including a
 | 
			
		||||
      cross-claim or counterclaim in a lawsuit) alleging that the Work
 | 
			
		||||
      or a Contribution incorporated within the Work constitutes direct
 | 
			
		||||
      or contributory patent infringement, then any patent licenses
 | 
			
		||||
      granted to You under this License for that Work shall terminate
 | 
			
		||||
      as of the date such litigation is filed.
 | 
			
		||||
 | 
			
		||||
   4. Redistribution. You may reproduce and distribute copies of the
 | 
			
		||||
      Work or Derivative Works thereof in any medium, with or without
 | 
			
		||||
      modifications, and in Source or Object form, provided that You
 | 
			
		||||
      meet the following conditions:
 | 
			
		||||
 | 
			
		||||
      (a) You must give any other recipients of the Work or
 | 
			
		||||
          Derivative Works a copy of this License; and
 | 
			
		||||
 | 
			
		||||
      (b) You must cause any modified files to carry prominent notices
 | 
			
		||||
          stating that You changed the files; and
 | 
			
		||||
 | 
			
		||||
      (c) You must retain, in the Source form of any Derivative Works
 | 
			
		||||
          that You distribute, all copyright, patent, trademark, and
 | 
			
		||||
          attribution notices from the Source form of the Work,
 | 
			
		||||
          excluding those notices that do not pertain to any part of
 | 
			
		||||
          the Derivative Works; and
 | 
			
		||||
 | 
			
		||||
      (d) If the Work includes a "NOTICE" text file as part of its
 | 
			
		||||
          distribution, then any Derivative Works that You distribute must
 | 
			
		||||
          include a readable copy of the attribution notices contained
 | 
			
		||||
          within such NOTICE file, excluding those notices that do not
 | 
			
		||||
          pertain to any part of the Derivative Works, in at least one
 | 
			
		||||
          of the following places: within a NOTICE text file distributed
 | 
			
		||||
          as part of the Derivative Works; within the Source form or
 | 
			
		||||
          documentation, if provided along with the Derivative Works; or,
 | 
			
		||||
          within a display generated by the Derivative Works, if and
 | 
			
		||||
          wherever such third-party notices normally appear. The contents
 | 
			
		||||
          of the NOTICE file are for informational purposes only and
 | 
			
		||||
          do not modify the License. You may add Your own attribution
 | 
			
		||||
          notices within Derivative Works that You distribute, alongside
 | 
			
		||||
          or as an addendum to the NOTICE text from the Work, provided
 | 
			
		||||
          that such additional attribution notices cannot be construed
 | 
			
		||||
          as modifying the License.
 | 
			
		||||
 | 
			
		||||
      You may add Your own copyright statement to Your modifications and
 | 
			
		||||
      may provide additional or different license terms and conditions
 | 
			
		||||
      for use, reproduction, or distribution of Your modifications, or
 | 
			
		||||
      for any such Derivative Works as a whole, provided Your use,
 | 
			
		||||
      reproduction, and distribution of the Work otherwise complies with
 | 
			
		||||
      the conditions stated in this License.
 | 
			
		||||
 | 
			
		||||
   5. Submission of Contributions. Unless You explicitly state otherwise,
 | 
			
		||||
      any Contribution intentionally submitted for inclusion in the Work
 | 
			
		||||
      by You to the Licensor shall be under the terms and conditions of
 | 
			
		||||
      this License, without any additional terms or conditions.
 | 
			
		||||
      Notwithstanding the above, nothing herein shall supersede or modify
 | 
			
		||||
      the terms of any separate license agreement you may have executed
 | 
			
		||||
      with Licensor regarding such Contributions.
 | 
			
		||||
 | 
			
		||||
   6. Trademarks. This License does not grant permission to use the trade
 | 
			
		||||
      names, trademarks, service marks, or product names of the Licensor,
 | 
			
		||||
      except as required for reasonable and customary use in describing the
 | 
			
		||||
      origin of the Work and reproducing the content of the NOTICE file.
 | 
			
		||||
 | 
			
		||||
   7. Disclaimer of Warranty. Unless required by applicable law or
 | 
			
		||||
      agreed to in writing, Licensor provides the Work (and each
 | 
			
		||||
      Contributor provides its Contributions) on an "AS IS" BASIS,
 | 
			
		||||
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
 | 
			
		||||
      implied, including, without limitation, any warranties or conditions
 | 
			
		||||
      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
 | 
			
		||||
      PARTICULAR PURPOSE. You are solely responsible for determining the
 | 
			
		||||
      appropriateness of using or redistributing the Work and assume any
 | 
			
		||||
      risks associated with Your exercise of permissions under this License.
 | 
			
		||||
 | 
			
		||||
   8. Limitation of Liability. In no event and under no legal theory,
 | 
			
		||||
      whether in tort (including negligence), contract, or otherwise,
 | 
			
		||||
      unless required by applicable law (such as deliberate and grossly
 | 
			
		||||
      negligent acts) or agreed to in writing, shall any Contributor be
 | 
			
		||||
      liable to You for damages, including any direct, indirect, special,
 | 
			
		||||
      incidental, or consequential damages of any character arising as a
 | 
			
		||||
      result of this License or out of the use or inability to use the
 | 
			
		||||
      Work (including but not limited to damages for loss of goodwill,
 | 
			
		||||
      work stoppage, computer failure or malfunction, or any and all
 | 
			
		||||
      other commercial damages or losses), even if such Contributor
 | 
			
		||||
      has been advised of the possibility of such damages.
 | 
			
		||||
 | 
			
		||||
   9. Accepting Warranty or Additional Liability. While redistributing
 | 
			
		||||
      the Work or Derivative Works thereof, You may choose to offer,
 | 
			
		||||
      and charge a fee for, acceptance of support, warranty, indemnity,
 | 
			
		||||
      or other liability obligations and/or rights consistent with this
 | 
			
		||||
      License. However, in accepting such obligations, You may act only
 | 
			
		||||
      on Your own behalf and on Your sole responsibility, not on behalf
 | 
			
		||||
      of any other Contributor, and only if You agree to indemnify,
 | 
			
		||||
      defend, and hold each Contributor harmless for any liability
 | 
			
		||||
      incurred by, or claims asserted against, such Contributor by reason
 | 
			
		||||
      of your accepting any such warranty or additional liability.
 | 
			
		||||
 | 
			
		||||
   END OF TERMS AND CONDITIONS
 | 
			
		||||
 | 
			
		||||
   APPENDIX: How to apply the Apache License to your work.
 | 
			
		||||
 | 
			
		||||
      To apply the Apache License to your work, attach the following
 | 
			
		||||
      boilerplate notice, with the fields enclosed by brackets "[]"
 | 
			
		||||
      replaced with your own identifying information. (Don't include
 | 
			
		||||
      the brackets!)  The text should be enclosed in the appropriate
 | 
			
		||||
      comment syntax for the file format. We also recommend that a
 | 
			
		||||
      file or class name and description of purpose be included on the
 | 
			
		||||
      same "printed page" as the copyright notice for easier
 | 
			
		||||
      identification within third-party archives.
 | 
			
		||||
 | 
			
		||||
   Copyright [yyyy] [name of copyright owner]
 | 
			
		||||
 | 
			
		||||
   Licensed under the Apache License, Version 2.0 (the "License");
 | 
			
		||||
   you may not use this file except in compliance with the License.
 | 
			
		||||
   You may obtain a copy of the License at
 | 
			
		||||
 | 
			
		||||
       http://www.apache.org/licenses/LICENSE-2.0
 | 
			
		||||
 | 
			
		||||
   Unless required by applicable law or agreed to in writing, software
 | 
			
		||||
   distributed under the License is distributed on an "AS IS" BASIS,
 | 
			
		||||
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
			
		||||
   See the License for the specific language governing permissions and
 | 
			
		||||
   limitations under the License.
 | 
			
		||||
							
								
								
									
										344
									
								
								node_modules/ejs/README.md
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										344
									
								
								node_modules/ejs/README.md
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,344 @@
 | 
			
		||||
Embedded JavaScript templates<br/>
 | 
			
		||||
[](https://travis-ci.org/mde/ejs)
 | 
			
		||||
[](https://david-dm.org/mde/ejs?type=dev)
 | 
			
		||||
[](https://snyk.io/test/npm/ejs)
 | 
			
		||||
=============================
 | 
			
		||||
 | 
			
		||||
## Installation
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
$ npm install ejs
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Features
 | 
			
		||||
 | 
			
		||||
  * Control flow with `<% %>`
 | 
			
		||||
  * Escaped output with `<%= %>` (escape function configurable)
 | 
			
		||||
  * Unescaped raw output with `<%- %>`
 | 
			
		||||
  * Newline-trim mode ('newline slurping') with `-%>` ending tag
 | 
			
		||||
  * Whitespace-trim mode (slurp all whitespace) for control flow with `<%_ _%>`
 | 
			
		||||
  * Custom delimiters (e.g. `[? ?]` instead of `<% %>`)
 | 
			
		||||
  * Includes
 | 
			
		||||
  * Client-side support
 | 
			
		||||
  * Static caching of intermediate JavaScript
 | 
			
		||||
  * Static caching of templates
 | 
			
		||||
  * Complies with the [Express](http://expressjs.com) view system
 | 
			
		||||
 | 
			
		||||
## Example
 | 
			
		||||
 | 
			
		||||
```ejs
 | 
			
		||||
<% if (user) { %>
 | 
			
		||||
  <h2><%= user.name %></h2>
 | 
			
		||||
<% } %>
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Try EJS online at: https://ionicabizau.github.io/ejs-playground/.
 | 
			
		||||
 | 
			
		||||
## Basic usage
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
let template = ejs.compile(str, options);
 | 
			
		||||
template(data);
 | 
			
		||||
// => Rendered HTML string
 | 
			
		||||
 | 
			
		||||
ejs.render(str, data, options);
 | 
			
		||||
// => Rendered HTML string
 | 
			
		||||
 | 
			
		||||
ejs.renderFile(filename, data, options, function(err, str){
 | 
			
		||||
    // str => Rendered HTML string
 | 
			
		||||
});
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
It is also possible to use `ejs.render(dataAndOptions);` where you pass
 | 
			
		||||
everything in a single object. In that case, you'll end up with local variables
 | 
			
		||||
for all the passed options. However, be aware that your code could break if we
 | 
			
		||||
add an option with the same name as one of your data object's properties.
 | 
			
		||||
Therefore, we do not recommend using this shortcut.
 | 
			
		||||
 | 
			
		||||
### Important
 | 
			
		||||
You should never give end-users unfettered access to the EJS render method, If you do so you are using EJS in an inherently un-secure way. 
 | 
			
		||||
 | 
			
		||||
### Options
 | 
			
		||||
 | 
			
		||||
  - `cache`                 Compiled functions are cached, requires `filename`
 | 
			
		||||
  - `filename`              The name of the file being rendered. Not required if you
 | 
			
		||||
    are using `renderFile()`. Used by `cache` to key caches, and for includes.
 | 
			
		||||
  - `root`                  Set template root(s) for includes with an absolute path (e.g, /file.ejs).
 | 
			
		||||
    Can be array to try to resolve include from multiple directories.
 | 
			
		||||
  - `views`                 An array of paths to use when resolving includes with relative paths.
 | 
			
		||||
  - `context`               Function execution context
 | 
			
		||||
  - `compileDebug`          When `false` no debug instrumentation is compiled
 | 
			
		||||
  - `client`                When `true`, compiles a function that can be rendered
 | 
			
		||||
    in the browser without needing to load the EJS Runtime
 | 
			
		||||
    ([ejs.min.js](https://github.com/mde/ejs/releases/latest)).
 | 
			
		||||
  - `delimiter`             Character to use for inner delimiter, by default '%'
 | 
			
		||||
  - `openDelimiter`         Character to use for opening delimiter, by default '<'
 | 
			
		||||
  - `closeDelimiter`        Character to use for closing delimiter, by default '>'
 | 
			
		||||
  - `debug`                 Outputs generated function body
 | 
			
		||||
  - `strict`                When set to `true`, generated function is in strict mode
 | 
			
		||||
  - `_with`                 Whether or not to use `with() {}` constructs. If `false`
 | 
			
		||||
    then the locals will be stored in the `locals` object. Set to `false` in strict mode.
 | 
			
		||||
  - `destructuredLocals`    An array of local variables that are always destructured from
 | 
			
		||||
    the locals object, available even in strict mode.
 | 
			
		||||
  - `localsName`            Name to use for the object storing local variables when not using
 | 
			
		||||
    `with` Defaults to `locals`
 | 
			
		||||
  - `rmWhitespace`          Remove all safe-to-remove whitespace, including leading
 | 
			
		||||
    and trailing whitespace. It also enables a safer version of `-%>` line
 | 
			
		||||
    slurping for all scriptlet tags (it does not strip new lines of tags in
 | 
			
		||||
    the middle of a line).
 | 
			
		||||
  - `escape`                The escaping function used with `<%=` construct. It is
 | 
			
		||||
    used in rendering and is `.toString()`ed in the generation of client functions.
 | 
			
		||||
    (By default escapes XML).
 | 
			
		||||
  - `outputFunctionName`    Set to a string (e.g., 'echo' or 'print') for a function to print
 | 
			
		||||
    output inside scriptlet tags.
 | 
			
		||||
  - `async`                 When `true`, EJS will use an async function for rendering. (Depends
 | 
			
		||||
    on async/await support in the JS runtime.
 | 
			
		||||
  - `includer`              Custom function to handle EJS includes, receives `(originalPath, parsedPath)`
 | 
			
		||||
    parameters, where `originalPath` is the path in include as-is and `parsedPath` is the
 | 
			
		||||
    previously resolved path. Should return an object `{ filename, template }`,
 | 
			
		||||
    you may return only one of the properties, where `filename` is the final parsed path and `template`
 | 
			
		||||
    is the included content.
 | 
			
		||||
 | 
			
		||||
This project uses [JSDoc](http://usejsdoc.org/). For the full public API
 | 
			
		||||
documentation, clone the repository and run `jake doc`. This will run JSDoc
 | 
			
		||||
with the proper options and output the documentation to `out/`. If you want
 | 
			
		||||
the both the public & private API docs, run `jake devdoc` instead.
 | 
			
		||||
 | 
			
		||||
### Tags
 | 
			
		||||
 | 
			
		||||
  - `<%`              'Scriptlet' tag, for control-flow, no output
 | 
			
		||||
  - `<%_`             'Whitespace Slurping' Scriptlet tag, strips all whitespace before it
 | 
			
		||||
  - `<%=`             Outputs the value into the template (escaped)
 | 
			
		||||
  - `<%-`             Outputs the unescaped value into the template
 | 
			
		||||
  - `<%#`             Comment tag, no execution, no output
 | 
			
		||||
  - `<%%`             Outputs a literal '<%'
 | 
			
		||||
  - `%%>`             Outputs a literal '%>'
 | 
			
		||||
  - `%>`              Plain ending tag
 | 
			
		||||
  - `-%>`             Trim-mode ('newline slurp') tag, trims following newline
 | 
			
		||||
  - `_%>`             'Whitespace Slurping' ending tag, removes all whitespace after it
 | 
			
		||||
 | 
			
		||||
For the full syntax documentation, please see [docs/syntax.md](https://github.com/mde/ejs/blob/master/docs/syntax.md).
 | 
			
		||||
 | 
			
		||||
### Includes
 | 
			
		||||
 | 
			
		||||
Includes either have to be an absolute path, or, if not, are assumed as
 | 
			
		||||
relative to the template with the `include` call. For example if you are
 | 
			
		||||
including `./views/user/show.ejs` from `./views/users.ejs` you would
 | 
			
		||||
use `<%- include('user/show') %>`.
 | 
			
		||||
 | 
			
		||||
You must specify the `filename` option for the template with the `include`
 | 
			
		||||
call unless you are using `renderFile()`.
 | 
			
		||||
 | 
			
		||||
You'll likely want to use the raw output tag (`<%-`) with your include to avoid
 | 
			
		||||
double-escaping the HTML output.
 | 
			
		||||
 | 
			
		||||
```ejs
 | 
			
		||||
<ul>
 | 
			
		||||
  <% users.forEach(function(user){ %>
 | 
			
		||||
    <%- include('user/show', {user: user}) %>
 | 
			
		||||
  <% }); %>
 | 
			
		||||
</ul>
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Includes are inserted at runtime, so you can use variables for the path in the
 | 
			
		||||
`include` call (for example `<%- include(somePath) %>`). Variables in your
 | 
			
		||||
top-level data object are available to all your includes, but local variables
 | 
			
		||||
need to be passed down.
 | 
			
		||||
 | 
			
		||||
NOTE: Include preprocessor directives (`<% include user/show %>`) are
 | 
			
		||||
not supported in v3.0+.
 | 
			
		||||
 | 
			
		||||
## Custom delimiters
 | 
			
		||||
 | 
			
		||||
Custom delimiters can be applied on a per-template basis, or globally:
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
let ejs = require('ejs'),
 | 
			
		||||
    users = ['geddy', 'neil', 'alex'];
 | 
			
		||||
 | 
			
		||||
// Just one template
 | 
			
		||||
ejs.render('<p>[?= users.join(" | "); ?]</p>', {users: users}, {delimiter: '?', openDelimiter: '[', closeDelimiter: ']'});
 | 
			
		||||
// => '<p>geddy | neil | alex</p>'
 | 
			
		||||
 | 
			
		||||
// Or globally
 | 
			
		||||
ejs.delimiter = '?';
 | 
			
		||||
ejs.openDelimiter = '[';
 | 
			
		||||
ejs.closeDelimiter = ']';
 | 
			
		||||
ejs.render('<p>[?= users.join(" | "); ?]</p>', {users: users});
 | 
			
		||||
// => '<p>geddy | neil | alex</p>'
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Caching
 | 
			
		||||
 | 
			
		||||
EJS ships with a basic in-process cache for caching the intermediate JavaScript
 | 
			
		||||
functions used to render templates. It's easy to plug in LRU caching using
 | 
			
		||||
Node's `lru-cache` library:
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
let ejs = require('ejs'),
 | 
			
		||||
    LRU = require('lru-cache');
 | 
			
		||||
ejs.cache = LRU(100); // LRU cache with 100-item limit
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
If you want to clear the EJS cache, call `ejs.clearCache`. If you're using the
 | 
			
		||||
LRU cache and need a different limit, simple reset `ejs.cache` to a new instance
 | 
			
		||||
of the LRU.
 | 
			
		||||
 | 
			
		||||
### Custom file loader
 | 
			
		||||
 | 
			
		||||
The default file loader is `fs.readFileSync`, if you want to customize it, you can set ejs.fileLoader.
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
let ejs = require('ejs');
 | 
			
		||||
let myFileLoad = function (filePath) {
 | 
			
		||||
  return 'myFileLoad: ' + fs.readFileSync(filePath);
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
ejs.fileLoader = myFileLoad;
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
With this feature, you can preprocess the template before reading it.
 | 
			
		||||
 | 
			
		||||
### Layouts
 | 
			
		||||
 | 
			
		||||
EJS does not specifically support blocks, but layouts can be implemented by
 | 
			
		||||
including headers and footers, like so:
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
```ejs
 | 
			
		||||
<%- include('header') -%>
 | 
			
		||||
<h1>
 | 
			
		||||
  Title
 | 
			
		||||
</h1>
 | 
			
		||||
<p>
 | 
			
		||||
  My page
 | 
			
		||||
</p>
 | 
			
		||||
<%- include('footer') -%>
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Client-side support
 | 
			
		||||
 | 
			
		||||
Go to the [Latest Release](https://github.com/mde/ejs/releases/latest), download
 | 
			
		||||
`./ejs.js` or `./ejs.min.js`. Alternately, you can compile it yourself by cloning
 | 
			
		||||
the repository and running `jake build` (or `$(npm bin)/jake build` if jake is
 | 
			
		||||
not installed globally).
 | 
			
		||||
 | 
			
		||||
Include one of these files on your page, and `ejs` should be available globally.
 | 
			
		||||
 | 
			
		||||
### Example
 | 
			
		||||
 | 
			
		||||
```html
 | 
			
		||||
<div id="output"></div>
 | 
			
		||||
<script src="ejs.min.js"></script>
 | 
			
		||||
<script>
 | 
			
		||||
  let people = ['geddy', 'neil', 'alex'],
 | 
			
		||||
      html = ejs.render('<%= people.join(", "); %>', {people: people});
 | 
			
		||||
  // With jQuery:
 | 
			
		||||
  $('#output').html(html);
 | 
			
		||||
  // Vanilla JS:
 | 
			
		||||
  document.getElementById('output').innerHTML = html;
 | 
			
		||||
</script>
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Caveats
 | 
			
		||||
 | 
			
		||||
Most of EJS will work as expected; however, there are a few things to note:
 | 
			
		||||
 | 
			
		||||
1. Obviously, since you do not have access to the filesystem, `ejs.renderFile()` won't work.
 | 
			
		||||
2. For the same reason, `include`s do not work unless you use an `include callback`. Here is an example:
 | 
			
		||||
  ```javascript
 | 
			
		||||
  let str = "Hello <%= include('file', {person: 'John'}); %>",
 | 
			
		||||
      fn = ejs.compile(str, {client: true});
 | 
			
		||||
 | 
			
		||||
  fn(data, null, function(path, d){ // include callback
 | 
			
		||||
    // path -> 'file'
 | 
			
		||||
    // d -> {person: 'John'}
 | 
			
		||||
    // Put your code here
 | 
			
		||||
    // Return the contents of file as a string
 | 
			
		||||
  }); // returns rendered string
 | 
			
		||||
  ```
 | 
			
		||||
 | 
			
		||||
See the [examples folder](https://github.com/mde/ejs/tree/master/examples) for more details.
 | 
			
		||||
 | 
			
		||||
## CLI
 | 
			
		||||
 | 
			
		||||
EJS ships with a full-featured CLI. Options are similar to those used in JavaScript code:
 | 
			
		||||
 | 
			
		||||
  - `-o / --output-file FILE`            Write the rendered output to FILE rather than stdout.
 | 
			
		||||
  - `-f / --data-file FILE`              Must be JSON-formatted. Use parsed input from FILE as data for rendering.
 | 
			
		||||
  - `-i / --data-input STRING`           Must be JSON-formatted and URI-encoded. Use parsed input from STRING as data for rendering.
 | 
			
		||||
  - `-m / --delimiter CHARACTER`         Use CHARACTER with angle brackets for open/close (defaults to %).
 | 
			
		||||
  - `-p / --open-delimiter CHARACTER`    Use CHARACTER instead of left angle bracket to open.
 | 
			
		||||
  - `-c / --close-delimiter CHARACTER`   Use CHARACTER instead of right angle bracket to close.
 | 
			
		||||
  - `-s / --strict`                      When set to `true`, generated function is in strict mode
 | 
			
		||||
  - `-n / --no-with`                     Use 'locals' object for vars rather than using `with` (implies --strict).
 | 
			
		||||
  - `-l / --locals-name`                 Name to use for the object storing local variables when not using `with`.
 | 
			
		||||
  - `-w / --rm-whitespace`               Remove all safe-to-remove whitespace, including leading and trailing whitespace.
 | 
			
		||||
  - `-d / --debug`                       Outputs generated function body
 | 
			
		||||
  - `-h / --help`                        Display this help message.
 | 
			
		||||
  - `-V/v / --version`                   Display the EJS version.
 | 
			
		||||
 | 
			
		||||
Here are some examples of usage:
 | 
			
		||||
 | 
			
		||||
```shell
 | 
			
		||||
$ ejs -p [ -c ] ./template_file.ejs -o ./output.html
 | 
			
		||||
$ ejs ./test/fixtures/user.ejs name=Lerxst
 | 
			
		||||
$ ejs -n -l _ ./some_template.ejs -f ./data_file.json
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Data input
 | 
			
		||||
 | 
			
		||||
There is a variety of ways to pass the CLI data for rendering.
 | 
			
		||||
 | 
			
		||||
Stdin:
 | 
			
		||||
 | 
			
		||||
```shell
 | 
			
		||||
$ ./test/fixtures/user_data.json | ejs ./test/fixtures/user.ejs
 | 
			
		||||
$ ejs ./test/fixtures/user.ejs < test/fixtures/user_data.json
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
A data file:
 | 
			
		||||
 | 
			
		||||
```shell
 | 
			
		||||
$ ejs ./test/fixtures/user.ejs -f ./user_data.json
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
A command-line option (must be URI-encoded):
 | 
			
		||||
 | 
			
		||||
```shell
 | 
			
		||||
./bin/cli.js -i %7B%22name%22%3A%20%22foo%22%7D ./test/fixtures/user.ejs
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Or, passing values directly at the end of the invocation:
 | 
			
		||||
 | 
			
		||||
```shell
 | 
			
		||||
./bin/cli.js -m $ ./test/fixtures/user.ejs name=foo
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Output
 | 
			
		||||
 | 
			
		||||
The CLI by default send output to stdout, but you can use the `-o` or `--output-file`
 | 
			
		||||
flag to specify a target file to send the output to.
 | 
			
		||||
 | 
			
		||||
## IDE Integration with Syntax Highlighting
 | 
			
		||||
 | 
			
		||||
VSCode:Javascript EJS by *DigitalBrainstem*
 | 
			
		||||
 | 
			
		||||
## Related projects
 | 
			
		||||
 | 
			
		||||
There are a number of implementations of EJS:
 | 
			
		||||
 | 
			
		||||
 * TJ's implementation, the v1 of this library: https://github.com/tj/ejs
 | 
			
		||||
 * EJS Embedded JavaScript Framework on Google Code: https://code.google.com/p/embeddedjavascript/
 | 
			
		||||
 * Sam Stephenson's Ruby implementation: https://rubygems.org/gems/ejs
 | 
			
		||||
 * Erubis, an ERB implementation which also runs JavaScript: http://www.kuwata-lab.com/erubis/users-guide.04.html#lang-javascript
 | 
			
		||||
 * DigitalBrainstem EJS Language support: https://github.com/Digitalbrainstem/ejs-grammar
 | 
			
		||||
 | 
			
		||||
## License
 | 
			
		||||
 | 
			
		||||
Licensed under the Apache License, Version 2.0
 | 
			
		||||
(<http://www.apache.org/licenses/LICENSE-2.0>)
 | 
			
		||||
 | 
			
		||||
- - -
 | 
			
		||||
EJS Embedded JavaScript templates copyright 2112
 | 
			
		||||
mde@fleegix.org.
 | 
			
		||||
							
								
								
									
										211
									
								
								node_modules/ejs/bin/cli.js
									
									
									
										generated
									
									
										vendored
									
									
										Executable file
									
								
							
							
						
						
									
										211
									
								
								node_modules/ejs/bin/cli.js
									
									
									
										generated
									
									
										vendored
									
									
										Executable file
									
								
							@@ -0,0 +1,211 @@
 | 
			
		||||
#!/usr/bin/env node
 | 
			
		||||
/*
 | 
			
		||||
 * EJS Embedded JavaScript templates
 | 
			
		||||
 * Copyright 2112 Matthew Eernisse (mde@fleegix.org)
 | 
			
		||||
 *
 | 
			
		||||
 * Licensed under the Apache License, Version 2.0 (the "License");
 | 
			
		||||
 * you may not use this file except in compliance with the License.
 | 
			
		||||
 * You may obtain a copy of the License at
 | 
			
		||||
 *
 | 
			
		||||
 *         http://www.apache.org/licenses/LICENSE-2.0
 | 
			
		||||
 *
 | 
			
		||||
 * Unless required by applicable law or agreed to in writing, software
 | 
			
		||||
 * distributed under the License is distributed on an "AS IS" BASIS,
 | 
			
		||||
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
			
		||||
 * See the License for the specific language governing permissions and
 | 
			
		||||
 * limitations under the License.
 | 
			
		||||
 *
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
let path = require('path');
 | 
			
		||||
 | 
			
		||||
let program = require('jake').program;
 | 
			
		||||
delete global.jake; // NO NOT WANT
 | 
			
		||||
program.setTaskNames = function (n) { this.taskNames = n; };
 | 
			
		||||
 | 
			
		||||
let ejs = require('../lib/ejs');
 | 
			
		||||
let { hyphenToCamel } = require('../lib/utils');
 | 
			
		||||
let fs = require('fs');
 | 
			
		||||
let args = process.argv.slice(2);
 | 
			
		||||
let usage = fs.readFileSync(`${__dirname}/../usage.txt`).toString();
 | 
			
		||||
 | 
			
		||||
const CLI_OPTS = [
 | 
			
		||||
  { full: 'output-file',
 | 
			
		||||
    abbr: 'o',
 | 
			
		||||
    expectValue: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'data-file',
 | 
			
		||||
    abbr: 'f',
 | 
			
		||||
    expectValue: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'data-input',
 | 
			
		||||
    abbr: 'i',
 | 
			
		||||
    expectValue: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'delimiter',
 | 
			
		||||
    abbr: 'm',
 | 
			
		||||
    expectValue: true,
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'open-delimiter',
 | 
			
		||||
    abbr: 'p',
 | 
			
		||||
    expectValue: true,
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'close-delimiter',
 | 
			
		||||
    abbr: 'c',
 | 
			
		||||
    expectValue: true,
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'strict',
 | 
			
		||||
    abbr: 's',
 | 
			
		||||
    expectValue: false,
 | 
			
		||||
    allowValue: false,
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'no-with',
 | 
			
		||||
    abbr: 'n',
 | 
			
		||||
    expectValue: false,
 | 
			
		||||
    allowValue: false,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'locals-name',
 | 
			
		||||
    abbr: 'l',
 | 
			
		||||
    expectValue: true,
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'rm-whitespace',
 | 
			
		||||
    abbr: 'w',
 | 
			
		||||
    expectValue: false,
 | 
			
		||||
    allowValue: false,
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'debug',
 | 
			
		||||
    abbr: 'd',
 | 
			
		||||
    expectValue: false,
 | 
			
		||||
    allowValue: false,
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'help',
 | 
			
		||||
    abbr: 'h',
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  { full: 'version',
 | 
			
		||||
    abbr: 'V',
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
  // Alias lowercase v
 | 
			
		||||
  { full: 'version',
 | 
			
		||||
    abbr: 'v',
 | 
			
		||||
    passThrough: true,
 | 
			
		||||
  },
 | 
			
		||||
];
 | 
			
		||||
 | 
			
		||||
let preempts = {
 | 
			
		||||
  version: function () {
 | 
			
		||||
    program.die(ejs.VERSION);
 | 
			
		||||
  },
 | 
			
		||||
  help: function () {
 | 
			
		||||
    program.die(usage);
 | 
			
		||||
  }
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
let stdin = '';
 | 
			
		||||
process.stdin.setEncoding('utf8');
 | 
			
		||||
process.stdin.on('readable', () => {
 | 
			
		||||
  let chunk;
 | 
			
		||||
  while ((chunk = process.stdin.read()) !== null) {
 | 
			
		||||
    stdin += chunk;
 | 
			
		||||
  }
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
function run() {
 | 
			
		||||
 | 
			
		||||
  program.availableOpts = CLI_OPTS;
 | 
			
		||||
  program.parseArgs(args);
 | 
			
		||||
 | 
			
		||||
  let templatePath = program.taskNames[0];
 | 
			
		||||
  let pVals = program.envVars;
 | 
			
		||||
  let pOpts = {};
 | 
			
		||||
 | 
			
		||||
  for (let p in program.opts) {
 | 
			
		||||
    let name = hyphenToCamel(p);
 | 
			
		||||
    pOpts[name] = program.opts[p];
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  let opts = {};
 | 
			
		||||
  let vals = {};
 | 
			
		||||
 | 
			
		||||
  // Same-named 'passthrough' opts
 | 
			
		||||
  CLI_OPTS.forEach((opt) => {
 | 
			
		||||
    let optName = hyphenToCamel(opt.full);
 | 
			
		||||
    if (opt.passThrough && typeof pOpts[optName] != 'undefined') {
 | 
			
		||||
      opts[optName] = pOpts[optName];
 | 
			
		||||
    }
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  // Bail out for help/version
 | 
			
		||||
  for (let p in opts) {
 | 
			
		||||
    if (preempts[p]) {
 | 
			
		||||
      return preempts[p]();
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  // Ensure there's a template to render
 | 
			
		||||
  if (!templatePath) {
 | 
			
		||||
    throw new Error('Please provide a template path. (Run ejs -h for help)');
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if (opts.strict) {
 | 
			
		||||
    pOpts.noWith = true;
 | 
			
		||||
  }
 | 
			
		||||
  if (pOpts.noWith) {
 | 
			
		||||
    opts._with = false;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  // Grab and parse any input data, in order of precedence:
 | 
			
		||||
  // 1. Stdin
 | 
			
		||||
  // 2. CLI arg via -i
 | 
			
		||||
  // 3. Data file via -f
 | 
			
		||||
  // Any individual vals passed at the end (e.g., foo=bar) will override
 | 
			
		||||
  // any vals previously set
 | 
			
		||||
  let input;
 | 
			
		||||
  let err = new Error('Please do not pass data multiple ways. Pick one of stdin, -f, or -i.');
 | 
			
		||||
  if (stdin) {
 | 
			
		||||
    input = stdin;
 | 
			
		||||
  }
 | 
			
		||||
  else if (pOpts.dataInput) {
 | 
			
		||||
    if (input) {
 | 
			
		||||
      throw err;
 | 
			
		||||
    }
 | 
			
		||||
    input = decodeURIComponent(pOpts.dataInput);
 | 
			
		||||
  }
 | 
			
		||||
  else if (pOpts.dataFile) {
 | 
			
		||||
    if (input) {
 | 
			
		||||
      throw err;
 | 
			
		||||
    }
 | 
			
		||||
    input = fs.readFileSync(pOpts.dataFile).toString();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  if (input) {
 | 
			
		||||
    vals = JSON.parse(input);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  // Override / set any individual values passed from the command line
 | 
			
		||||
  for (let p in pVals) {
 | 
			
		||||
    vals[p] = pVals[p];
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  opts.filename = path.resolve(process.cwd(), templatePath);
 | 
			
		||||
  let template = fs.readFileSync(opts.filename).toString();
 | 
			
		||||
  let output = ejs.render(template, vals, opts);
 | 
			
		||||
  if (pOpts.outputFile) {
 | 
			
		||||
    fs.writeFileSync(pOpts.outputFile, output);
 | 
			
		||||
  }
 | 
			
		||||
  else {
 | 
			
		||||
    process.stdout.write(output);
 | 
			
		||||
  }
 | 
			
		||||
  process.exit();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Defer execution so that stdin can be read if necessary
 | 
			
		||||
setImmediate(run);
 | 
			
		||||
							
								
								
									
										1736
									
								
								node_modules/ejs/ejs.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										1736
									
								
								node_modules/ejs/ejs.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because it is too large
												Load Diff
											
										
									
								
							
							
								
								
									
										1
									
								
								node_modules/ejs/ejs.min.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										1
									
								
								node_modules/ejs/ejs.min.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because one or more lines are too long
											
										
									
								
							
							
								
								
									
										88
									
								
								node_modules/ejs/jakefile.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										88
									
								
								node_modules/ejs/jakefile.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,88 @@
 | 
			
		||||
var fs = require('fs');
 | 
			
		||||
var path = require('path');
 | 
			
		||||
var execSync = require('child_process').execSync;
 | 
			
		||||
var exec = function (cmd) {
 | 
			
		||||
  execSync(cmd, {stdio: 'inherit'});
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/* global jake, task, desc, publishTask */
 | 
			
		||||
 | 
			
		||||
task('build', ['lint', 'clean', 'browserify', 'minify'], function () {
 | 
			
		||||
  console.log('Build completed.');
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
desc('Cleans browerified/minified files and package files');
 | 
			
		||||
task('clean', ['clobber'], function () {
 | 
			
		||||
  jake.rmRf('./ejs.js');
 | 
			
		||||
  jake.rmRf('./ejs.min.js');
 | 
			
		||||
  console.log('Cleaned up compiled files.');
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
desc('Lints the source code');
 | 
			
		||||
task('lint', ['clean'], function () {
 | 
			
		||||
  var epath = path.join('./node_modules/.bin/eslint');
 | 
			
		||||
  exec(epath+' "**/*.js"');
 | 
			
		||||
  console.log('Linting completed.');
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
task('browserify', function () {
 | 
			
		||||
  var epath = path.join('./node_modules/browserify/bin/cmd.js');
 | 
			
		||||
  exec(epath+' --standalone ejs lib/ejs.js > ejs.js');
 | 
			
		||||
  console.log('Browserification completed.');
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
task('minify', function () {
 | 
			
		||||
  var epath = path.join('./node_modules/uglify-js/bin/uglifyjs');
 | 
			
		||||
  exec(epath+' ejs.js > ejs.min.js');
 | 
			
		||||
  console.log('Minification completed.');
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
desc('Generates the EJS API docs for the public API');
 | 
			
		||||
task('doc', function () {
 | 
			
		||||
  jake.rmRf('out');
 | 
			
		||||
  var epath = path.join('./node_modules/.bin/jsdoc');
 | 
			
		||||
  exec(epath+' --verbose -c jsdoc.json lib/* docs/jsdoc/*');
 | 
			
		||||
  console.log('Documentation generated in ./out.');
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
desc('Generates the EJS API docs for the public and private API');
 | 
			
		||||
task('devdoc', function () {
 | 
			
		||||
  jake.rmRf('out');
 | 
			
		||||
  var epath = path.join('./node_modules/.bin/jsdoc');
 | 
			
		||||
  exec(epath+' --verbose -p -c jsdoc.json lib/* docs/jsdoc/*');
 | 
			
		||||
  console.log('Documentation generated in ./out.');
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
desc('Publishes the EJS API docs');
 | 
			
		||||
task('docPublish', ['doc'], function () {
 | 
			
		||||
  fs.writeFileSync('out/CNAME', 'api.ejs.co');
 | 
			
		||||
  console.log('Pushing docs to gh-pages...');
 | 
			
		||||
  var epath = path.join('./node_modules/.bin/git-directory-deploy');
 | 
			
		||||
  exec(epath+' --directory out/');
 | 
			
		||||
  console.log('Docs published to gh-pages.');
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
desc('Runs the EJS test suite');
 | 
			
		||||
task('test', ['lint'], function () {
 | 
			
		||||
  exec(path.join('./node_modules/.bin/mocha'));
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
publishTask('ejs', ['build'], function () {
 | 
			
		||||
  this.packageFiles.include([
 | 
			
		||||
    'jakefile.js',
 | 
			
		||||
    'README.md',
 | 
			
		||||
    'LICENSE',
 | 
			
		||||
    'package.json',
 | 
			
		||||
    'ejs.js',
 | 
			
		||||
    'ejs.min.js',
 | 
			
		||||
    'lib/**',
 | 
			
		||||
    'bin/**',
 | 
			
		||||
    'usage.txt'
 | 
			
		||||
  ]);
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
jake.Task.publish.on('complete', function () {
 | 
			
		||||
  console.log('Updating hosted docs...');
 | 
			
		||||
  console.log('If this fails, run jake docPublish to re-try.');
 | 
			
		||||
  jake.Task.docPublish.invoke();
 | 
			
		||||
});
 | 
			
		||||
							
								
								
									
										951
									
								
								node_modules/ejs/lib/ejs.js
									
									
									
										generated
									
									
										vendored
									
									
										Executable file
									
								
							
							
						
						
									
										951
									
								
								node_modules/ejs/lib/ejs.js
									
									
									
										generated
									
									
										vendored
									
									
										Executable file
									
								
							@@ -0,0 +1,951 @@
 | 
			
		||||
/*
 | 
			
		||||
 * EJS Embedded JavaScript templates
 | 
			
		||||
 * Copyright 2112 Matthew Eernisse (mde@fleegix.org)
 | 
			
		||||
 *
 | 
			
		||||
 * Licensed under the Apache License, Version 2.0 (the "License");
 | 
			
		||||
 * you may not use this file except in compliance with the License.
 | 
			
		||||
 * You may obtain a copy of the License at
 | 
			
		||||
 *
 | 
			
		||||
 *         http://www.apache.org/licenses/LICENSE-2.0
 | 
			
		||||
 *
 | 
			
		||||
 * Unless required by applicable law or agreed to in writing, software
 | 
			
		||||
 * distributed under the License is distributed on an "AS IS" BASIS,
 | 
			
		||||
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
			
		||||
 * See the License for the specific language governing permissions and
 | 
			
		||||
 * limitations under the License.
 | 
			
		||||
 *
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
'use strict';
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * @file Embedded JavaScript templating engine. {@link http://ejs.co}
 | 
			
		||||
 * @author Matthew Eernisse <mde@fleegix.org>
 | 
			
		||||
 * @author Tiancheng "Timothy" Gu <timothygu99@gmail.com>
 | 
			
		||||
 * @project EJS
 | 
			
		||||
 * @license {@link http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0}
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * EJS internal functions.
 | 
			
		||||
 *
 | 
			
		||||
 * Technically this "module" lies in the same file as {@link module:ejs}, for
 | 
			
		||||
 * the sake of organization all the private functions re grouped into this
 | 
			
		||||
 * module.
 | 
			
		||||
 *
 | 
			
		||||
 * @module ejs-internal
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Embedded JavaScript templating engine.
 | 
			
		||||
 *
 | 
			
		||||
 * @module ejs
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
var fs = require('fs');
 | 
			
		||||
var path = require('path');
 | 
			
		||||
var utils = require('./utils');
 | 
			
		||||
 | 
			
		||||
var scopeOptionWarned = false;
 | 
			
		||||
/** @type {string} */
 | 
			
		||||
var _VERSION_STRING = require('../package.json').version;
 | 
			
		||||
var _DEFAULT_OPEN_DELIMITER = '<';
 | 
			
		||||
var _DEFAULT_CLOSE_DELIMITER = '>';
 | 
			
		||||
var _DEFAULT_DELIMITER = '%';
 | 
			
		||||
var _DEFAULT_LOCALS_NAME = 'locals';
 | 
			
		||||
var _NAME = 'ejs';
 | 
			
		||||
var _REGEX_STRING = '(<%%|%%>|<%=|<%-|<%_|<%#|<%|%>|-%>|_%>)';
 | 
			
		||||
var _OPTS_PASSABLE_WITH_DATA = ['delimiter', 'scope', 'context', 'debug', 'compileDebug',
 | 
			
		||||
  'client', '_with', 'rmWhitespace', 'strict', 'filename', 'async'];
 | 
			
		||||
// We don't allow 'cache' option to be passed in the data obj for
 | 
			
		||||
// the normal `render` call, but this is where Express 2 & 3 put it
 | 
			
		||||
// so we make an exception for `renderFile`
 | 
			
		||||
var _OPTS_PASSABLE_WITH_DATA_EXPRESS = _OPTS_PASSABLE_WITH_DATA.concat('cache');
 | 
			
		||||
var _BOM = /^\uFEFF/;
 | 
			
		||||
var _JS_IDENTIFIER = /^[a-zA-Z_$][0-9a-zA-Z_$]*$/;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * EJS template function cache. This can be a LRU object from lru-cache NPM
 | 
			
		||||
 * module. By default, it is {@link module:utils.cache}, a simple in-process
 | 
			
		||||
 * cache that grows continuously.
 | 
			
		||||
 *
 | 
			
		||||
 * @type {Cache}
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.cache = utils.cache;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Custom file loader. Useful for template preprocessing or restricting access
 | 
			
		||||
 * to a certain part of the filesystem.
 | 
			
		||||
 *
 | 
			
		||||
 * @type {fileLoader}
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.fileLoader = fs.readFileSync;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Name of the object containing the locals.
 | 
			
		||||
 *
 | 
			
		||||
 * This variable is overridden by {@link Options}`.localsName` if it is not
 | 
			
		||||
 * `undefined`.
 | 
			
		||||
 *
 | 
			
		||||
 * @type {String}
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.localsName = _DEFAULT_LOCALS_NAME;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Promise implementation -- defaults to the native implementation if available
 | 
			
		||||
 * This is mostly just for testability
 | 
			
		||||
 *
 | 
			
		||||
 * @type {PromiseConstructorLike}
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.promiseImpl = (new Function('return this;'))().Promise;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get the path to the included file from the parent file path and the
 | 
			
		||||
 * specified path.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {String}  name     specified path
 | 
			
		||||
 * @param {String}  filename parent file path
 | 
			
		||||
 * @param {Boolean} [isDir=false] whether the parent file path is a directory
 | 
			
		||||
 * @return {String}
 | 
			
		||||
 */
 | 
			
		||||
exports.resolveInclude = function(name, filename, isDir) {
 | 
			
		||||
  var dirname = path.dirname;
 | 
			
		||||
  var extname = path.extname;
 | 
			
		||||
  var resolve = path.resolve;
 | 
			
		||||
  var includePath = resolve(isDir ? filename : dirname(filename), name);
 | 
			
		||||
  var ext = extname(name);
 | 
			
		||||
  if (!ext) {
 | 
			
		||||
    includePath += '.ejs';
 | 
			
		||||
  }
 | 
			
		||||
  return includePath;
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Try to resolve file path on multiple directories
 | 
			
		||||
 *
 | 
			
		||||
 * @param  {String}        name  specified path
 | 
			
		||||
 * @param  {Array<String>} paths list of possible parent directory paths
 | 
			
		||||
 * @return {String}
 | 
			
		||||
 */
 | 
			
		||||
function resolvePaths(name, paths) {
 | 
			
		||||
  var filePath;
 | 
			
		||||
  if (paths.some(function (v) {
 | 
			
		||||
    filePath = exports.resolveInclude(name, v, true);
 | 
			
		||||
    return fs.existsSync(filePath);
 | 
			
		||||
  })) {
 | 
			
		||||
    return filePath;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get the path to the included file by Options
 | 
			
		||||
 *
 | 
			
		||||
 * @param  {String}  path    specified path
 | 
			
		||||
 * @param  {Options} options compilation options
 | 
			
		||||
 * @return {String}
 | 
			
		||||
 */
 | 
			
		||||
function getIncludePath(path, options) {
 | 
			
		||||
  var includePath;
 | 
			
		||||
  var filePath;
 | 
			
		||||
  var views = options.views;
 | 
			
		||||
  var match = /^[A-Za-z]+:\\|^\//.exec(path);
 | 
			
		||||
 | 
			
		||||
  // Abs path
 | 
			
		||||
  if (match && match.length) {
 | 
			
		||||
    path = path.replace(/^\/*/, '');
 | 
			
		||||
    if (Array.isArray(options.root)) {
 | 
			
		||||
      includePath = resolvePaths(path, options.root);
 | 
			
		||||
    } else {
 | 
			
		||||
      includePath = exports.resolveInclude(path, options.root || '/', true);
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  // Relative paths
 | 
			
		||||
  else {
 | 
			
		||||
    // Look relative to a passed filename first
 | 
			
		||||
    if (options.filename) {
 | 
			
		||||
      filePath = exports.resolveInclude(path, options.filename);
 | 
			
		||||
      if (fs.existsSync(filePath)) {
 | 
			
		||||
        includePath = filePath;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
    // Then look in any views directories
 | 
			
		||||
    if (!includePath && Array.isArray(views)) {
 | 
			
		||||
      includePath = resolvePaths(path, views);
 | 
			
		||||
    }
 | 
			
		||||
    if (!includePath && typeof options.includer !== 'function') {
 | 
			
		||||
      throw new Error('Could not find the include file "' +
 | 
			
		||||
          options.escapeFunction(path) + '"');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  return includePath;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get the template from a string or a file, either compiled on-the-fly or
 | 
			
		||||
 * read from cache (if enabled), and cache the template if needed.
 | 
			
		||||
 *
 | 
			
		||||
 * If `template` is not set, the file specified in `options.filename` will be
 | 
			
		||||
 * read.
 | 
			
		||||
 *
 | 
			
		||||
 * If `options.cache` is true, this function reads the file from
 | 
			
		||||
 * `options.filename` so it must be set prior to calling this function.
 | 
			
		||||
 *
 | 
			
		||||
 * @memberof module:ejs-internal
 | 
			
		||||
 * @param {Options} options   compilation options
 | 
			
		||||
 * @param {String} [template] template source
 | 
			
		||||
 * @return {(TemplateFunction|ClientFunction)}
 | 
			
		||||
 * Depending on the value of `options.client`, either type might be returned.
 | 
			
		||||
 * @static
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
function handleCache(options, template) {
 | 
			
		||||
  var func;
 | 
			
		||||
  var filename = options.filename;
 | 
			
		||||
  var hasTemplate = arguments.length > 1;
 | 
			
		||||
 | 
			
		||||
  if (options.cache) {
 | 
			
		||||
    if (!filename) {
 | 
			
		||||
      throw new Error('cache option requires a filename');
 | 
			
		||||
    }
 | 
			
		||||
    func = exports.cache.get(filename);
 | 
			
		||||
    if (func) {
 | 
			
		||||
      return func;
 | 
			
		||||
    }
 | 
			
		||||
    if (!hasTemplate) {
 | 
			
		||||
      template = fileLoader(filename).toString().replace(_BOM, '');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  else if (!hasTemplate) {
 | 
			
		||||
    // istanbul ignore if: should not happen at all
 | 
			
		||||
    if (!filename) {
 | 
			
		||||
      throw new Error('Internal EJS error: no file name or template '
 | 
			
		||||
                    + 'provided');
 | 
			
		||||
    }
 | 
			
		||||
    template = fileLoader(filename).toString().replace(_BOM, '');
 | 
			
		||||
  }
 | 
			
		||||
  func = exports.compile(template, options);
 | 
			
		||||
  if (options.cache) {
 | 
			
		||||
    exports.cache.set(filename, func);
 | 
			
		||||
  }
 | 
			
		||||
  return func;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Try calling handleCache with the given options and data and call the
 | 
			
		||||
 * callback with the result. If an error occurs, call the callback with
 | 
			
		||||
 * the error. Used by renderFile().
 | 
			
		||||
 *
 | 
			
		||||
 * @memberof module:ejs-internal
 | 
			
		||||
 * @param {Options} options    compilation options
 | 
			
		||||
 * @param {Object} data        template data
 | 
			
		||||
 * @param {RenderFileCallback} cb callback
 | 
			
		||||
 * @static
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
function tryHandleCache(options, data, cb) {
 | 
			
		||||
  var result;
 | 
			
		||||
  if (!cb) {
 | 
			
		||||
    if (typeof exports.promiseImpl == 'function') {
 | 
			
		||||
      return new exports.promiseImpl(function (resolve, reject) {
 | 
			
		||||
        try {
 | 
			
		||||
          result = handleCache(options)(data);
 | 
			
		||||
          resolve(result);
 | 
			
		||||
        }
 | 
			
		||||
        catch (err) {
 | 
			
		||||
          reject(err);
 | 
			
		||||
        }
 | 
			
		||||
      });
 | 
			
		||||
    }
 | 
			
		||||
    else {
 | 
			
		||||
      throw new Error('Please provide a callback function');
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  else {
 | 
			
		||||
    try {
 | 
			
		||||
      result = handleCache(options)(data);
 | 
			
		||||
    }
 | 
			
		||||
    catch (err) {
 | 
			
		||||
      return cb(err);
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    cb(null, result);
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * fileLoader is independent
 | 
			
		||||
 *
 | 
			
		||||
 * @param {String} filePath ejs file path.
 | 
			
		||||
 * @return {String} The contents of the specified file.
 | 
			
		||||
 * @static
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
function fileLoader(filePath){
 | 
			
		||||
  return exports.fileLoader(filePath);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get the template function.
 | 
			
		||||
 *
 | 
			
		||||
 * If `options.cache` is `true`, then the template is cached.
 | 
			
		||||
 *
 | 
			
		||||
 * @memberof module:ejs-internal
 | 
			
		||||
 * @param {String}  path    path for the specified file
 | 
			
		||||
 * @param {Options} options compilation options
 | 
			
		||||
 * @return {(TemplateFunction|ClientFunction)}
 | 
			
		||||
 * Depending on the value of `options.client`, either type might be returned
 | 
			
		||||
 * @static
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
function includeFile(path, options) {
 | 
			
		||||
  var opts = utils.shallowCopy(utils.createNullProtoObjWherePossible(), options);
 | 
			
		||||
  opts.filename = getIncludePath(path, opts);
 | 
			
		||||
  if (typeof options.includer === 'function') {
 | 
			
		||||
    var includerResult = options.includer(path, opts.filename);
 | 
			
		||||
    if (includerResult) {
 | 
			
		||||
      if (includerResult.filename) {
 | 
			
		||||
        opts.filename = includerResult.filename;
 | 
			
		||||
      }
 | 
			
		||||
      if (includerResult.template) {
 | 
			
		||||
        return handleCache(opts, includerResult.template);
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  return handleCache(opts);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Re-throw the given `err` in context to the `str` of ejs, `filename`, and
 | 
			
		||||
 * `lineno`.
 | 
			
		||||
 *
 | 
			
		||||
 * @implements {RethrowCallback}
 | 
			
		||||
 * @memberof module:ejs-internal
 | 
			
		||||
 * @param {Error}  err      Error object
 | 
			
		||||
 * @param {String} str      EJS source
 | 
			
		||||
 * @param {String} flnm     file name of the EJS file
 | 
			
		||||
 * @param {Number} lineno   line number of the error
 | 
			
		||||
 * @param {EscapeCallback} esc
 | 
			
		||||
 * @static
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
function rethrow(err, str, flnm, lineno, esc) {
 | 
			
		||||
  var lines = str.split('\n');
 | 
			
		||||
  var start = Math.max(lineno - 3, 0);
 | 
			
		||||
  var end = Math.min(lines.length, lineno + 3);
 | 
			
		||||
  var filename = esc(flnm);
 | 
			
		||||
  // Error context
 | 
			
		||||
  var context = lines.slice(start, end).map(function (line, i){
 | 
			
		||||
    var curr = i + start + 1;
 | 
			
		||||
    return (curr == lineno ? ' >> ' : '    ')
 | 
			
		||||
      + curr
 | 
			
		||||
      + '| '
 | 
			
		||||
      + line;
 | 
			
		||||
  }).join('\n');
 | 
			
		||||
 | 
			
		||||
  // Alter exception message
 | 
			
		||||
  err.path = filename;
 | 
			
		||||
  err.message = (filename || 'ejs') + ':'
 | 
			
		||||
    + lineno + '\n'
 | 
			
		||||
    + context + '\n\n'
 | 
			
		||||
    + err.message;
 | 
			
		||||
 | 
			
		||||
  throw err;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
function stripSemi(str){
 | 
			
		||||
  return str.replace(/;(\s*$)/, '$1');
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Compile the given `str` of ejs into a template function.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {String}  template EJS template
 | 
			
		||||
 *
 | 
			
		||||
 * @param {Options} [opts] compilation options
 | 
			
		||||
 *
 | 
			
		||||
 * @return {(TemplateFunction|ClientFunction)}
 | 
			
		||||
 * Depending on the value of `opts.client`, either type might be returned.
 | 
			
		||||
 * Note that the return type of the function also depends on the value of `opts.async`.
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.compile = function compile(template, opts) {
 | 
			
		||||
  var templ;
 | 
			
		||||
 | 
			
		||||
  // v1 compat
 | 
			
		||||
  // 'scope' is 'context'
 | 
			
		||||
  // FIXME: Remove this in a future version
 | 
			
		||||
  if (opts && opts.scope) {
 | 
			
		||||
    if (!scopeOptionWarned){
 | 
			
		||||
      console.warn('`scope` option is deprecated and will be removed in EJS 3');
 | 
			
		||||
      scopeOptionWarned = true;
 | 
			
		||||
    }
 | 
			
		||||
    if (!opts.context) {
 | 
			
		||||
      opts.context = opts.scope;
 | 
			
		||||
    }
 | 
			
		||||
    delete opts.scope;
 | 
			
		||||
  }
 | 
			
		||||
  templ = new Template(template, opts);
 | 
			
		||||
  return templ.compile();
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Render the given `template` of ejs.
 | 
			
		||||
 *
 | 
			
		||||
 * If you would like to include options but not data, you need to explicitly
 | 
			
		||||
 * call this function with `data` being an empty object or `null`.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {String}   template EJS template
 | 
			
		||||
 * @param {Object}  [data={}] template data
 | 
			
		||||
 * @param {Options} [opts={}] compilation and rendering options
 | 
			
		||||
 * @return {(String|Promise<String>)}
 | 
			
		||||
 * Return value type depends on `opts.async`.
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.render = function (template, d, o) {
 | 
			
		||||
  var data = d || utils.createNullProtoObjWherePossible();
 | 
			
		||||
  var opts = o || utils.createNullProtoObjWherePossible();
 | 
			
		||||
 | 
			
		||||
  // No options object -- if there are optiony names
 | 
			
		||||
  // in the data, copy them to options
 | 
			
		||||
  if (arguments.length == 2) {
 | 
			
		||||
    utils.shallowCopyFromList(opts, data, _OPTS_PASSABLE_WITH_DATA);
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return handleCache(opts, template)(data);
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Render an EJS file at the given `path` and callback `cb(err, str)`.
 | 
			
		||||
 *
 | 
			
		||||
 * If you would like to include options but not data, you need to explicitly
 | 
			
		||||
 * call this function with `data` being an empty object or `null`.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {String}             path     path to the EJS file
 | 
			
		||||
 * @param {Object}            [data={}] template data
 | 
			
		||||
 * @param {Options}           [opts={}] compilation and rendering options
 | 
			
		||||
 * @param {RenderFileCallback} cb callback
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.renderFile = function () {
 | 
			
		||||
  var args = Array.prototype.slice.call(arguments);
 | 
			
		||||
  var filename = args.shift();
 | 
			
		||||
  var cb;
 | 
			
		||||
  var opts = {filename: filename};
 | 
			
		||||
  var data;
 | 
			
		||||
  var viewOpts;
 | 
			
		||||
 | 
			
		||||
  // Do we have a callback?
 | 
			
		||||
  if (typeof arguments[arguments.length - 1] == 'function') {
 | 
			
		||||
    cb = args.pop();
 | 
			
		||||
  }
 | 
			
		||||
  // Do we have data/opts?
 | 
			
		||||
  if (args.length) {
 | 
			
		||||
    // Should always have data obj
 | 
			
		||||
    data = args.shift();
 | 
			
		||||
    // Normal passed opts (data obj + opts obj)
 | 
			
		||||
    if (args.length) {
 | 
			
		||||
      // Use shallowCopy so we don't pollute passed in opts obj with new vals
 | 
			
		||||
      utils.shallowCopy(opts, args.pop());
 | 
			
		||||
    }
 | 
			
		||||
    // Special casing for Express (settings + opts-in-data)
 | 
			
		||||
    else {
 | 
			
		||||
      // Express 3 and 4
 | 
			
		||||
      if (data.settings) {
 | 
			
		||||
        // Pull a few things from known locations
 | 
			
		||||
        if (data.settings.views) {
 | 
			
		||||
          opts.views = data.settings.views;
 | 
			
		||||
        }
 | 
			
		||||
        if (data.settings['view cache']) {
 | 
			
		||||
          opts.cache = true;
 | 
			
		||||
        }
 | 
			
		||||
        // Undocumented after Express 2, but still usable, esp. for
 | 
			
		||||
        // items that are unsafe to be passed along with data, like `root`
 | 
			
		||||
        viewOpts = data.settings['view options'];
 | 
			
		||||
        if (viewOpts) {
 | 
			
		||||
          utils.shallowCopy(opts, viewOpts);
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
      // Express 2 and lower, values set in app.locals, or people who just
 | 
			
		||||
      // want to pass options in their data. NOTE: These values will override
 | 
			
		||||
      // anything previously set in settings  or settings['view options']
 | 
			
		||||
      utils.shallowCopyFromList(opts, data, _OPTS_PASSABLE_WITH_DATA_EXPRESS);
 | 
			
		||||
    }
 | 
			
		||||
    opts.filename = filename;
 | 
			
		||||
  }
 | 
			
		||||
  else {
 | 
			
		||||
    data = utils.createNullProtoObjWherePossible();
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return tryHandleCache(opts, data, cb);
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Clear intermediate JavaScript cache. Calls {@link Cache#reset}.
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * EJS template class
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
exports.Template = Template;
 | 
			
		||||
 | 
			
		||||
exports.clearCache = function () {
 | 
			
		||||
  exports.cache.reset();
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
function Template(text, opts) {
 | 
			
		||||
  opts = opts || utils.createNullProtoObjWherePossible();
 | 
			
		||||
  var options = utils.createNullProtoObjWherePossible();
 | 
			
		||||
  this.templateText = text;
 | 
			
		||||
  /** @type {string | null} */
 | 
			
		||||
  this.mode = null;
 | 
			
		||||
  this.truncate = false;
 | 
			
		||||
  this.currentLine = 1;
 | 
			
		||||
  this.source = '';
 | 
			
		||||
  options.client = opts.client || false;
 | 
			
		||||
  options.escapeFunction = opts.escape || opts.escapeFunction || utils.escapeXML;
 | 
			
		||||
  options.compileDebug = opts.compileDebug !== false;
 | 
			
		||||
  options.debug = !!opts.debug;
 | 
			
		||||
  options.filename = opts.filename;
 | 
			
		||||
  options.openDelimiter = opts.openDelimiter || exports.openDelimiter || _DEFAULT_OPEN_DELIMITER;
 | 
			
		||||
  options.closeDelimiter = opts.closeDelimiter || exports.closeDelimiter || _DEFAULT_CLOSE_DELIMITER;
 | 
			
		||||
  options.delimiter = opts.delimiter || exports.delimiter || _DEFAULT_DELIMITER;
 | 
			
		||||
  options.strict = opts.strict || false;
 | 
			
		||||
  options.context = opts.context;
 | 
			
		||||
  options.cache = opts.cache || false;
 | 
			
		||||
  options.rmWhitespace = opts.rmWhitespace;
 | 
			
		||||
  options.root = opts.root;
 | 
			
		||||
  options.includer = opts.includer;
 | 
			
		||||
  options.outputFunctionName = opts.outputFunctionName;
 | 
			
		||||
  options.localsName = opts.localsName || exports.localsName || _DEFAULT_LOCALS_NAME;
 | 
			
		||||
  options.views = opts.views;
 | 
			
		||||
  options.async = opts.async;
 | 
			
		||||
  options.destructuredLocals = opts.destructuredLocals;
 | 
			
		||||
  options.legacyInclude = typeof opts.legacyInclude != 'undefined' ? !!opts.legacyInclude : true;
 | 
			
		||||
 | 
			
		||||
  if (options.strict) {
 | 
			
		||||
    options._with = false;
 | 
			
		||||
  }
 | 
			
		||||
  else {
 | 
			
		||||
    options._with = typeof opts._with != 'undefined' ? opts._with : true;
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  this.opts = options;
 | 
			
		||||
 | 
			
		||||
  this.regex = this.createRegex();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
Template.modes = {
 | 
			
		||||
  EVAL: 'eval',
 | 
			
		||||
  ESCAPED: 'escaped',
 | 
			
		||||
  RAW: 'raw',
 | 
			
		||||
  COMMENT: 'comment',
 | 
			
		||||
  LITERAL: 'literal'
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
Template.prototype = {
 | 
			
		||||
  createRegex: function () {
 | 
			
		||||
    var str = _REGEX_STRING;
 | 
			
		||||
    var delim = utils.escapeRegExpChars(this.opts.delimiter);
 | 
			
		||||
    var open = utils.escapeRegExpChars(this.opts.openDelimiter);
 | 
			
		||||
    var close = utils.escapeRegExpChars(this.opts.closeDelimiter);
 | 
			
		||||
    str = str.replace(/%/g, delim)
 | 
			
		||||
      .replace(/</g, open)
 | 
			
		||||
      .replace(/>/g, close);
 | 
			
		||||
    return new RegExp(str);
 | 
			
		||||
  },
 | 
			
		||||
 | 
			
		||||
  compile: function () {
 | 
			
		||||
    /** @type {string} */
 | 
			
		||||
    var src;
 | 
			
		||||
    /** @type {ClientFunction} */
 | 
			
		||||
    var fn;
 | 
			
		||||
    var opts = this.opts;
 | 
			
		||||
    var prepended = '';
 | 
			
		||||
    var appended = '';
 | 
			
		||||
    /** @type {EscapeCallback} */
 | 
			
		||||
    var escapeFn = opts.escapeFunction;
 | 
			
		||||
    /** @type {FunctionConstructor} */
 | 
			
		||||
    var ctor;
 | 
			
		||||
    /** @type {string} */
 | 
			
		||||
    var sanitizedFilename = opts.filename ? JSON.stringify(opts.filename) : 'undefined';
 | 
			
		||||
 | 
			
		||||
    if (!this.source) {
 | 
			
		||||
      this.generateSource();
 | 
			
		||||
      prepended +=
 | 
			
		||||
        '  var __output = "";\n' +
 | 
			
		||||
        '  function __append(s) { if (s !== undefined && s !== null) __output += s }\n';
 | 
			
		||||
      if (opts.outputFunctionName) {
 | 
			
		||||
        if (!_JS_IDENTIFIER.test(opts.outputFunctionName)) {
 | 
			
		||||
          throw new Error('outputFunctionName is not a valid JS identifier.');
 | 
			
		||||
        }
 | 
			
		||||
        prepended += '  var ' + opts.outputFunctionName + ' = __append;' + '\n';
 | 
			
		||||
      }
 | 
			
		||||
      if (opts.localsName && !_JS_IDENTIFIER.test(opts.localsName)) {
 | 
			
		||||
        throw new Error('localsName is not a valid JS identifier.');
 | 
			
		||||
      }
 | 
			
		||||
      if (opts.destructuredLocals && opts.destructuredLocals.length) {
 | 
			
		||||
        var destructuring = '  var __locals = (' + opts.localsName + ' || {}),\n';
 | 
			
		||||
        for (var i = 0; i < opts.destructuredLocals.length; i++) {
 | 
			
		||||
          var name = opts.destructuredLocals[i];
 | 
			
		||||
          if (!_JS_IDENTIFIER.test(name)) {
 | 
			
		||||
            throw new Error('destructuredLocals[' + i + '] is not a valid JS identifier.');
 | 
			
		||||
          }
 | 
			
		||||
          if (i > 0) {
 | 
			
		||||
            destructuring += ',\n  ';
 | 
			
		||||
          }
 | 
			
		||||
          destructuring += name + ' = __locals.' + name;
 | 
			
		||||
        }
 | 
			
		||||
        prepended += destructuring + ';\n';
 | 
			
		||||
      }
 | 
			
		||||
      if (opts._with !== false) {
 | 
			
		||||
        prepended +=  '  with (' + opts.localsName + ' || {}) {' + '\n';
 | 
			
		||||
        appended += '  }' + '\n';
 | 
			
		||||
      }
 | 
			
		||||
      appended += '  return __output;' + '\n';
 | 
			
		||||
      this.source = prepended + this.source + appended;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    if (opts.compileDebug) {
 | 
			
		||||
      src = 'var __line = 1' + '\n'
 | 
			
		||||
        + '  , __lines = ' + JSON.stringify(this.templateText) + '\n'
 | 
			
		||||
        + '  , __filename = ' + sanitizedFilename + ';' + '\n'
 | 
			
		||||
        + 'try {' + '\n'
 | 
			
		||||
        + this.source
 | 
			
		||||
        + '} catch (e) {' + '\n'
 | 
			
		||||
        + '  rethrow(e, __lines, __filename, __line, escapeFn);' + '\n'
 | 
			
		||||
        + '}' + '\n';
 | 
			
		||||
    }
 | 
			
		||||
    else {
 | 
			
		||||
      src = this.source;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    if (opts.client) {
 | 
			
		||||
      src = 'escapeFn = escapeFn || ' + escapeFn.toString() + ';' + '\n' + src;
 | 
			
		||||
      if (opts.compileDebug) {
 | 
			
		||||
        src = 'rethrow = rethrow || ' + rethrow.toString() + ';' + '\n' + src;
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    if (opts.strict) {
 | 
			
		||||
      src = '"use strict";\n' + src;
 | 
			
		||||
    }
 | 
			
		||||
    if (opts.debug) {
 | 
			
		||||
      console.log(src);
 | 
			
		||||
    }
 | 
			
		||||
    if (opts.compileDebug && opts.filename) {
 | 
			
		||||
      src = src + '\n'
 | 
			
		||||
        + '//# sourceURL=' + sanitizedFilename + '\n';
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    try {
 | 
			
		||||
      if (opts.async) {
 | 
			
		||||
        // Have to use generated function for this, since in envs without support,
 | 
			
		||||
        // it breaks in parsing
 | 
			
		||||
        try {
 | 
			
		||||
          ctor = (new Function('return (async function(){}).constructor;'))();
 | 
			
		||||
        }
 | 
			
		||||
        catch(e) {
 | 
			
		||||
          if (e instanceof SyntaxError) {
 | 
			
		||||
            throw new Error('This environment does not support async/await');
 | 
			
		||||
          }
 | 
			
		||||
          else {
 | 
			
		||||
            throw e;
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
      else {
 | 
			
		||||
        ctor = Function;
 | 
			
		||||
      }
 | 
			
		||||
      fn = new ctor(opts.localsName + ', escapeFn, include, rethrow', src);
 | 
			
		||||
    }
 | 
			
		||||
    catch(e) {
 | 
			
		||||
      // istanbul ignore else
 | 
			
		||||
      if (e instanceof SyntaxError) {
 | 
			
		||||
        if (opts.filename) {
 | 
			
		||||
          e.message += ' in ' + opts.filename;
 | 
			
		||||
        }
 | 
			
		||||
        e.message += ' while compiling ejs\n\n';
 | 
			
		||||
        e.message += 'If the above error is not helpful, you may want to try EJS-Lint:\n';
 | 
			
		||||
        e.message += 'https://github.com/RyanZim/EJS-Lint';
 | 
			
		||||
        if (!opts.async) {
 | 
			
		||||
          e.message += '\n';
 | 
			
		||||
          e.message += 'Or, if you meant to create an async function, pass `async: true` as an option.';
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
      throw e;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    // Return a callable function which will execute the function
 | 
			
		||||
    // created by the source-code, with the passed data as locals
 | 
			
		||||
    // Adds a local `include` function which allows full recursive include
 | 
			
		||||
    var returnedFn = opts.client ? fn : function anonymous(data) {
 | 
			
		||||
      var include = function (path, includeData) {
 | 
			
		||||
        var d = utils.shallowCopy(utils.createNullProtoObjWherePossible(), data);
 | 
			
		||||
        if (includeData) {
 | 
			
		||||
          d = utils.shallowCopy(d, includeData);
 | 
			
		||||
        }
 | 
			
		||||
        return includeFile(path, opts)(d);
 | 
			
		||||
      };
 | 
			
		||||
      return fn.apply(opts.context,
 | 
			
		||||
        [data || utils.createNullProtoObjWherePossible(), escapeFn, include, rethrow]);
 | 
			
		||||
    };
 | 
			
		||||
    if (opts.filename && typeof Object.defineProperty === 'function') {
 | 
			
		||||
      var filename = opts.filename;
 | 
			
		||||
      var basename = path.basename(filename, path.extname(filename));
 | 
			
		||||
      try {
 | 
			
		||||
        Object.defineProperty(returnedFn, 'name', {
 | 
			
		||||
          value: basename,
 | 
			
		||||
          writable: false,
 | 
			
		||||
          enumerable: false,
 | 
			
		||||
          configurable: true
 | 
			
		||||
        });
 | 
			
		||||
      } catch (e) {/* ignore */}
 | 
			
		||||
    }
 | 
			
		||||
    return returnedFn;
 | 
			
		||||
  },
 | 
			
		||||
 | 
			
		||||
  generateSource: function () {
 | 
			
		||||
    var opts = this.opts;
 | 
			
		||||
 | 
			
		||||
    if (opts.rmWhitespace) {
 | 
			
		||||
      // Have to use two separate replace here as `^` and `$` operators don't
 | 
			
		||||
      // work well with `\r` and empty lines don't work well with the `m` flag.
 | 
			
		||||
      this.templateText =
 | 
			
		||||
        this.templateText.replace(/[\r\n]+/g, '\n').replace(/^\s+|\s+$/gm, '');
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    // Slurp spaces and tabs before <%_ and after _%>
 | 
			
		||||
    this.templateText =
 | 
			
		||||
      this.templateText.replace(/[ \t]*<%_/gm, '<%_').replace(/_%>[ \t]*/gm, '_%>');
 | 
			
		||||
 | 
			
		||||
    var self = this;
 | 
			
		||||
    var matches = this.parseTemplateText();
 | 
			
		||||
    var d = this.opts.delimiter;
 | 
			
		||||
    var o = this.opts.openDelimiter;
 | 
			
		||||
    var c = this.opts.closeDelimiter;
 | 
			
		||||
 | 
			
		||||
    if (matches && matches.length) {
 | 
			
		||||
      matches.forEach(function (line, index) {
 | 
			
		||||
        var closing;
 | 
			
		||||
        // If this is an opening tag, check for closing tags
 | 
			
		||||
        // FIXME: May end up with some false positives here
 | 
			
		||||
        // Better to store modes as k/v with openDelimiter + delimiter as key
 | 
			
		||||
        // Then this can simply check against the map
 | 
			
		||||
        if ( line.indexOf(o + d) === 0        // If it is a tag
 | 
			
		||||
          && line.indexOf(o + d + d) !== 0) { // and is not escaped
 | 
			
		||||
          closing = matches[index + 2];
 | 
			
		||||
          if (!(closing == d + c || closing == '-' + d + c || closing == '_' + d + c)) {
 | 
			
		||||
            throw new Error('Could not find matching close tag for "' + line + '".');
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
        self.scanLine(line);
 | 
			
		||||
      });
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
  },
 | 
			
		||||
 | 
			
		||||
  parseTemplateText: function () {
 | 
			
		||||
    var str = this.templateText;
 | 
			
		||||
    var pat = this.regex;
 | 
			
		||||
    var result = pat.exec(str);
 | 
			
		||||
    var arr = [];
 | 
			
		||||
    var firstPos;
 | 
			
		||||
 | 
			
		||||
    while (result) {
 | 
			
		||||
      firstPos = result.index;
 | 
			
		||||
 | 
			
		||||
      if (firstPos !== 0) {
 | 
			
		||||
        arr.push(str.substring(0, firstPos));
 | 
			
		||||
        str = str.slice(firstPos);
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      arr.push(result[0]);
 | 
			
		||||
      str = str.slice(result[0].length);
 | 
			
		||||
      result = pat.exec(str);
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    if (str) {
 | 
			
		||||
      arr.push(str);
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    return arr;
 | 
			
		||||
  },
 | 
			
		||||
 | 
			
		||||
  _addOutput: function (line) {
 | 
			
		||||
    if (this.truncate) {
 | 
			
		||||
      // Only replace single leading linebreak in the line after
 | 
			
		||||
      // -%> tag -- this is the single, trailing linebreak
 | 
			
		||||
      // after the tag that the truncation mode replaces
 | 
			
		||||
      // Handle Win / Unix / old Mac linebreaks -- do the \r\n
 | 
			
		||||
      // combo first in the regex-or
 | 
			
		||||
      line = line.replace(/^(?:\r\n|\r|\n)/, '');
 | 
			
		||||
      this.truncate = false;
 | 
			
		||||
    }
 | 
			
		||||
    if (!line) {
 | 
			
		||||
      return line;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    // Preserve literal slashes
 | 
			
		||||
    line = line.replace(/\\/g, '\\\\');
 | 
			
		||||
 | 
			
		||||
    // Convert linebreaks
 | 
			
		||||
    line = line.replace(/\n/g, '\\n');
 | 
			
		||||
    line = line.replace(/\r/g, '\\r');
 | 
			
		||||
 | 
			
		||||
    // Escape double-quotes
 | 
			
		||||
    // - this will be the delimiter during execution
 | 
			
		||||
    line = line.replace(/"/g, '\\"');
 | 
			
		||||
    this.source += '    ; __append("' + line + '")' + '\n';
 | 
			
		||||
  },
 | 
			
		||||
 | 
			
		||||
  scanLine: function (line) {
 | 
			
		||||
    var self = this;
 | 
			
		||||
    var d = this.opts.delimiter;
 | 
			
		||||
    var o = this.opts.openDelimiter;
 | 
			
		||||
    var c = this.opts.closeDelimiter;
 | 
			
		||||
    var newLineCount = 0;
 | 
			
		||||
 | 
			
		||||
    newLineCount = (line.split('\n').length - 1);
 | 
			
		||||
 | 
			
		||||
    switch (line) {
 | 
			
		||||
    case o + d:
 | 
			
		||||
    case o + d + '_':
 | 
			
		||||
      this.mode = Template.modes.EVAL;
 | 
			
		||||
      break;
 | 
			
		||||
    case o + d + '=':
 | 
			
		||||
      this.mode = Template.modes.ESCAPED;
 | 
			
		||||
      break;
 | 
			
		||||
    case o + d + '-':
 | 
			
		||||
      this.mode = Template.modes.RAW;
 | 
			
		||||
      break;
 | 
			
		||||
    case o + d + '#':
 | 
			
		||||
      this.mode = Template.modes.COMMENT;
 | 
			
		||||
      break;
 | 
			
		||||
    case o + d + d:
 | 
			
		||||
      this.mode = Template.modes.LITERAL;
 | 
			
		||||
      this.source += '    ; __append("' + line.replace(o + d + d, o + d) + '")' + '\n';
 | 
			
		||||
      break;
 | 
			
		||||
    case d + d + c:
 | 
			
		||||
      this.mode = Template.modes.LITERAL;
 | 
			
		||||
      this.source += '    ; __append("' + line.replace(d + d + c, d + c) + '")' + '\n';
 | 
			
		||||
      break;
 | 
			
		||||
    case d + c:
 | 
			
		||||
    case '-' + d + c:
 | 
			
		||||
    case '_' + d + c:
 | 
			
		||||
      if (this.mode == Template.modes.LITERAL) {
 | 
			
		||||
        this._addOutput(line);
 | 
			
		||||
      }
 | 
			
		||||
 | 
			
		||||
      this.mode = null;
 | 
			
		||||
      this.truncate = line.indexOf('-') === 0 || line.indexOf('_') === 0;
 | 
			
		||||
      break;
 | 
			
		||||
    default:
 | 
			
		||||
      // In script mode, depends on type of tag
 | 
			
		||||
      if (this.mode) {
 | 
			
		||||
        // If '//' is found without a line break, add a line break.
 | 
			
		||||
        switch (this.mode) {
 | 
			
		||||
        case Template.modes.EVAL:
 | 
			
		||||
        case Template.modes.ESCAPED:
 | 
			
		||||
        case Template.modes.RAW:
 | 
			
		||||
          if (line.lastIndexOf('//') > line.lastIndexOf('\n')) {
 | 
			
		||||
            line += '\n';
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
        switch (this.mode) {
 | 
			
		||||
        // Just executing code
 | 
			
		||||
        case Template.modes.EVAL:
 | 
			
		||||
          this.source += '    ; ' + line + '\n';
 | 
			
		||||
          break;
 | 
			
		||||
          // Exec, esc, and output
 | 
			
		||||
        case Template.modes.ESCAPED:
 | 
			
		||||
          this.source += '    ; __append(escapeFn(' + stripSemi(line) + '))' + '\n';
 | 
			
		||||
          break;
 | 
			
		||||
          // Exec and output
 | 
			
		||||
        case Template.modes.RAW:
 | 
			
		||||
          this.source += '    ; __append(' + stripSemi(line) + ')' + '\n';
 | 
			
		||||
          break;
 | 
			
		||||
        case Template.modes.COMMENT:
 | 
			
		||||
          // Do nothing
 | 
			
		||||
          break;
 | 
			
		||||
          // Literal <%% mode, append as raw output
 | 
			
		||||
        case Template.modes.LITERAL:
 | 
			
		||||
          this._addOutput(line);
 | 
			
		||||
          break;
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
      // In string mode, just add the output
 | 
			
		||||
      else {
 | 
			
		||||
        this._addOutput(line);
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    if (self.opts.compileDebug && newLineCount) {
 | 
			
		||||
      this.currentLine += newLineCount;
 | 
			
		||||
      this.source += '    ; __line = ' + this.currentLine + '\n';
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Escape characters reserved in XML.
 | 
			
		||||
 *
 | 
			
		||||
 * This is simply an export of {@link module:utils.escapeXML}.
 | 
			
		||||
 *
 | 
			
		||||
 * If `markup` is `undefined` or `null`, the empty string is returned.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {String} markup Input string
 | 
			
		||||
 * @return {String} Escaped string
 | 
			
		||||
 * @public
 | 
			
		||||
 * @func
 | 
			
		||||
 * */
 | 
			
		||||
exports.escapeXML = utils.escapeXML;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Express.js support.
 | 
			
		||||
 *
 | 
			
		||||
 * This is an alias for {@link module:ejs.renderFile}, in order to support
 | 
			
		||||
 * Express.js out-of-the-box.
 | 
			
		||||
 *
 | 
			
		||||
 * @func
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.__express = exports.renderFile;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Version of EJS.
 | 
			
		||||
 *
 | 
			
		||||
 * @readonly
 | 
			
		||||
 * @type {String}
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.VERSION = _VERSION_STRING;
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Name for detection of EJS.
 | 
			
		||||
 *
 | 
			
		||||
 * @readonly
 | 
			
		||||
 * @type {String}
 | 
			
		||||
 * @public
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.name = _NAME;
 | 
			
		||||
 | 
			
		||||
/* istanbul ignore if */
 | 
			
		||||
if (typeof window != 'undefined') {
 | 
			
		||||
  window.ejs = exports;
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										241
									
								
								node_modules/ejs/lib/utils.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										241
									
								
								node_modules/ejs/lib/utils.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,241 @@
 | 
			
		||||
/*
 | 
			
		||||
 * EJS Embedded JavaScript templates
 | 
			
		||||
 * Copyright 2112 Matthew Eernisse (mde@fleegix.org)
 | 
			
		||||
 *
 | 
			
		||||
 * Licensed under the Apache License, Version 2.0 (the "License");
 | 
			
		||||
 * you may not use this file except in compliance with the License.
 | 
			
		||||
 * You may obtain a copy of the License at
 | 
			
		||||
 *
 | 
			
		||||
 *         http://www.apache.org/licenses/LICENSE-2.0
 | 
			
		||||
 *
 | 
			
		||||
 * Unless required by applicable law or agreed to in writing, software
 | 
			
		||||
 * distributed under the License is distributed on an "AS IS" BASIS,
 | 
			
		||||
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
			
		||||
 * See the License for the specific language governing permissions and
 | 
			
		||||
 * limitations under the License.
 | 
			
		||||
 *
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Private utility functions
 | 
			
		||||
 * @module utils
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
'use strict';
 | 
			
		||||
 | 
			
		||||
var regExpChars = /[|\\{}()[\]^$+*?.]/g;
 | 
			
		||||
var hasOwnProperty = Object.prototype.hasOwnProperty;
 | 
			
		||||
var hasOwn = function (obj, key) { return hasOwnProperty.apply(obj, [key]); };
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Escape characters reserved in regular expressions.
 | 
			
		||||
 *
 | 
			
		||||
 * If `string` is `undefined` or `null`, the empty string is returned.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {String} string Input string
 | 
			
		||||
 * @return {String} Escaped string
 | 
			
		||||
 * @static
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
exports.escapeRegExpChars = function (string) {
 | 
			
		||||
  // istanbul ignore if
 | 
			
		||||
  if (!string) {
 | 
			
		||||
    return '';
 | 
			
		||||
  }
 | 
			
		||||
  return String(string).replace(regExpChars, '\\$&');
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
var _ENCODE_HTML_RULES = {
 | 
			
		||||
  '&': '&',
 | 
			
		||||
  '<': '<',
 | 
			
		||||
  '>': '>',
 | 
			
		||||
  '"': '"',
 | 
			
		||||
  "'": '''
 | 
			
		||||
};
 | 
			
		||||
var _MATCH_HTML = /[&<>'"]/g;
 | 
			
		||||
 | 
			
		||||
function encode_char(c) {
 | 
			
		||||
  return _ENCODE_HTML_RULES[c] || c;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Stringified version of constants used by {@link module:utils.escapeXML}.
 | 
			
		||||
 *
 | 
			
		||||
 * It is used in the process of generating {@link ClientFunction}s.
 | 
			
		||||
 *
 | 
			
		||||
 * @readonly
 | 
			
		||||
 * @type {String}
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
var escapeFuncStr =
 | 
			
		||||
  'var _ENCODE_HTML_RULES = {\n'
 | 
			
		||||
+ '      "&": "&"\n'
 | 
			
		||||
+ '    , "<": "<"\n'
 | 
			
		||||
+ '    , ">": ">"\n'
 | 
			
		||||
+ '    , \'"\': """\n'
 | 
			
		||||
+ '    , "\'": "'"\n'
 | 
			
		||||
+ '    }\n'
 | 
			
		||||
+ '  , _MATCH_HTML = /[&<>\'"]/g;\n'
 | 
			
		||||
+ 'function encode_char(c) {\n'
 | 
			
		||||
+ '  return _ENCODE_HTML_RULES[c] || c;\n'
 | 
			
		||||
+ '};\n';
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Escape characters reserved in XML.
 | 
			
		||||
 *
 | 
			
		||||
 * If `markup` is `undefined` or `null`, the empty string is returned.
 | 
			
		||||
 *
 | 
			
		||||
 * @implements {EscapeCallback}
 | 
			
		||||
 * @param {String} markup Input string
 | 
			
		||||
 * @return {String} Escaped string
 | 
			
		||||
 * @static
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
exports.escapeXML = function (markup) {
 | 
			
		||||
  return markup == undefined
 | 
			
		||||
    ? ''
 | 
			
		||||
    : String(markup)
 | 
			
		||||
      .replace(_MATCH_HTML, encode_char);
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
function escapeXMLToString() {
 | 
			
		||||
  return Function.prototype.toString.call(this) + ';\n' + escapeFuncStr;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
try {
 | 
			
		||||
  if (typeof Object.defineProperty === 'function') {
 | 
			
		||||
  // If the Function prototype is frozen, the "toString" property is non-writable. This means that any objects which inherit this property
 | 
			
		||||
  // cannot have the property changed using an assignment. If using strict mode, attempting that will cause an error. If not using strict
 | 
			
		||||
  // mode, attempting that will be silently ignored.
 | 
			
		||||
  // However, we can still explicitly shadow the prototype's "toString" property by defining a new "toString" property on this object.
 | 
			
		||||
    Object.defineProperty(exports.escapeXML, 'toString', { value: escapeXMLToString });
 | 
			
		||||
  } else {
 | 
			
		||||
    // If Object.defineProperty() doesn't exist, attempt to shadow this property using the assignment operator.
 | 
			
		||||
    exports.escapeXML.toString = escapeXMLToString;
 | 
			
		||||
  }
 | 
			
		||||
} catch (err) {
 | 
			
		||||
  console.warn('Unable to set escapeXML.toString (is the Function prototype frozen?)');
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Naive copy of properties from one object to another.
 | 
			
		||||
 * Does not recurse into non-scalar properties
 | 
			
		||||
 * Does not check to see if the property has a value before copying
 | 
			
		||||
 *
 | 
			
		||||
 * @param  {Object} to   Destination object
 | 
			
		||||
 * @param  {Object} from Source object
 | 
			
		||||
 * @return {Object}      Destination object
 | 
			
		||||
 * @static
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
exports.shallowCopy = function (to, from) {
 | 
			
		||||
  from = from || {};
 | 
			
		||||
  if ((to !== null) && (to !== undefined)) {
 | 
			
		||||
    for (var p in from) {
 | 
			
		||||
      if (!hasOwn(from, p)) {
 | 
			
		||||
        continue;
 | 
			
		||||
      }
 | 
			
		||||
      if (p === '__proto__' || p === 'constructor') {
 | 
			
		||||
        continue;
 | 
			
		||||
      }
 | 
			
		||||
      to[p] = from[p];
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  return to;
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Naive copy of a list of key names, from one object to another.
 | 
			
		||||
 * Only copies property if it is actually defined
 | 
			
		||||
 * Does not recurse into non-scalar properties
 | 
			
		||||
 *
 | 
			
		||||
 * @param  {Object} to   Destination object
 | 
			
		||||
 * @param  {Object} from Source object
 | 
			
		||||
 * @param  {Array} list List of properties to copy
 | 
			
		||||
 * @return {Object}      Destination object
 | 
			
		||||
 * @static
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
exports.shallowCopyFromList = function (to, from, list) {
 | 
			
		||||
  list = list || [];
 | 
			
		||||
  from = from || {};
 | 
			
		||||
  if ((to !== null) && (to !== undefined)) {
 | 
			
		||||
    for (var i = 0; i < list.length; i++) {
 | 
			
		||||
      var p = list[i];
 | 
			
		||||
      if (typeof from[p] != 'undefined') {
 | 
			
		||||
        if (!hasOwn(from, p)) {
 | 
			
		||||
          continue;
 | 
			
		||||
        }
 | 
			
		||||
        if (p === '__proto__' || p === 'constructor') {
 | 
			
		||||
          continue;
 | 
			
		||||
        }
 | 
			
		||||
        to[p] = from[p];
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  }
 | 
			
		||||
  return to;
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Simple in-process cache implementation. Does not implement limits of any
 | 
			
		||||
 * sort.
 | 
			
		||||
 *
 | 
			
		||||
 * @implements {Cache}
 | 
			
		||||
 * @static
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
exports.cache = {
 | 
			
		||||
  _data: {},
 | 
			
		||||
  set: function (key, val) {
 | 
			
		||||
    this._data[key] = val;
 | 
			
		||||
  },
 | 
			
		||||
  get: function (key) {
 | 
			
		||||
    return this._data[key];
 | 
			
		||||
  },
 | 
			
		||||
  remove: function (key) {
 | 
			
		||||
    delete this._data[key];
 | 
			
		||||
  },
 | 
			
		||||
  reset: function () {
 | 
			
		||||
    this._data = {};
 | 
			
		||||
  }
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Transforms hyphen case variable into camel case.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {String} string Hyphen case string
 | 
			
		||||
 * @return {String} Camel case string
 | 
			
		||||
 * @static
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
exports.hyphenToCamel = function (str) {
 | 
			
		||||
  return str.replace(/-[a-z]/g, function (match) { return match[1].toUpperCase(); });
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Returns a null-prototype object in runtimes that support it
 | 
			
		||||
 *
 | 
			
		||||
 * @return {Object} Object, prototype will be set to null where possible
 | 
			
		||||
 * @static
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
exports.createNullProtoObjWherePossible = (function () {
 | 
			
		||||
  if (typeof Object.create == 'function') {
 | 
			
		||||
    return function () {
 | 
			
		||||
      return Object.create(null);
 | 
			
		||||
    };
 | 
			
		||||
  }
 | 
			
		||||
  if (!({__proto__: null} instanceof Object)) {
 | 
			
		||||
    return function () {
 | 
			
		||||
      return {__proto__: null};
 | 
			
		||||
    };
 | 
			
		||||
  }
 | 
			
		||||
  // Not possible, just pass through
 | 
			
		||||
  return function () {
 | 
			
		||||
    return {};
 | 
			
		||||
  };
 | 
			
		||||
})();
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										42
									
								
								node_modules/ejs/package.json
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										42
									
								
								node_modules/ejs/package.json
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,42 @@
 | 
			
		||||
{
 | 
			
		||||
  "name": "ejs",
 | 
			
		||||
  "description": "Embedded JavaScript templates",
 | 
			
		||||
  "keywords": [
 | 
			
		||||
    "template",
 | 
			
		||||
    "engine",
 | 
			
		||||
    "ejs"
 | 
			
		||||
  ],
 | 
			
		||||
  "version": "3.1.9",
 | 
			
		||||
  "author": "Matthew Eernisse <mde@fleegix.org> (http://fleegix.org)",
 | 
			
		||||
  "license": "Apache-2.0",
 | 
			
		||||
  "bin": {
 | 
			
		||||
    "ejs": "./bin/cli.js"
 | 
			
		||||
  },
 | 
			
		||||
  "main": "./lib/ejs.js",
 | 
			
		||||
  "jsdelivr": "ejs.min.js",
 | 
			
		||||
  "unpkg": "ejs.min.js",
 | 
			
		||||
  "repository": {
 | 
			
		||||
    "type": "git",
 | 
			
		||||
    "url": "git://github.com/mde/ejs.git"
 | 
			
		||||
  },
 | 
			
		||||
  "bugs": "https://github.com/mde/ejs/issues",
 | 
			
		||||
  "homepage": "https://github.com/mde/ejs",
 | 
			
		||||
  "dependencies": {
 | 
			
		||||
    "jake": "^10.8.5"
 | 
			
		||||
  },
 | 
			
		||||
  "devDependencies": {
 | 
			
		||||
    "browserify": "^16.5.1",
 | 
			
		||||
    "eslint": "^6.8.0",
 | 
			
		||||
    "git-directory-deploy": "^1.5.1",
 | 
			
		||||
    "jsdoc": "^4.0.2",
 | 
			
		||||
    "lru-cache": "^4.0.1",
 | 
			
		||||
    "mocha": "^10.2.0",
 | 
			
		||||
    "uglify-js": "^3.3.16"
 | 
			
		||||
  },
 | 
			
		||||
  "engines": {
 | 
			
		||||
    "node": ">=0.10.0"
 | 
			
		||||
  },
 | 
			
		||||
  "scripts": {
 | 
			
		||||
    "test": "mocha -u tdd"
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										24
									
								
								node_modules/ejs/usage.txt
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										24
									
								
								node_modules/ejs/usage.txt
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,24 @@
 | 
			
		||||
EJS Embedded JavaScript templates
 | 
			
		||||
{Usage}: ejs [options ...] template-file [data variables ...]
 | 
			
		||||
 | 
			
		||||
{Options}:
 | 
			
		||||
  -o,     --output-file FILE            Write the rendered output to FILE rather than stdout.
 | 
			
		||||
  -f,     --data-file FILE              Must be JSON-formatted. Use parsed input from FILE as data for rendering.
 | 
			
		||||
  -i,     --data-input STRING           Must be JSON-formatted and URI-encoded. Use parsed input from STRING as data for rendering.
 | 
			
		||||
  -m,     --delimiter CHARACTER         Use CHARACTER with angle brackets for open/close (defaults to %).
 | 
			
		||||
  -p,     --open-delimiter CHARACTER    Use CHARACTER instead of left angle bracket to open.
 | 
			
		||||
  -c,     --close-delimiter CHARACTER   Use CHARACTER instead of right angle bracket to close.
 | 
			
		||||
  -s,     --strict                      When set to `true`, generated function is in strict mode
 | 
			
		||||
  -n      --no-with                     Use 'locals' object for vars rather than using `with` (implies --strict).
 | 
			
		||||
  -l      --locals-name                 Name to use for the object storing local variables when not using `with`.
 | 
			
		||||
  -w      --rm-whitespace               Remove all safe-to-remove whitespace, including leading and trailing whitespace.
 | 
			
		||||
  -d      --debug                       Outputs generated function body
 | 
			
		||||
  -h,     --help                        Display this help message.
 | 
			
		||||
  -V/v,   --version                     Display the EJS version.
 | 
			
		||||
 | 
			
		||||
{Examples}:
 | 
			
		||||
  ejs -m $ ./test/fixtures/user.ejs -f ./user_data.json
 | 
			
		||||
  ejs -m $ ./test/fixtures/user.ejs name=Lerxst
 | 
			
		||||
  ejs -p [ -c ] ./template_file.ejs -o ./output.html
 | 
			
		||||
  ejs -n -l _ ./some_template.ejs -f ./data_file.json
 | 
			
		||||
  ejs -w ./template_with_whitspace.ejs -o ./output_file.html
 | 
			
		||||
		Reference in New Issue
	
	Block a user