gina 0.1.9-alpha.2 → 0.1.9-alpha.3

package/.github/workflows/test.yml

@@ -27,7 +27,7 @@ jobs:
       - name: Run tests
         run: |
           node --test \
-            'test/core/*.test.js' \
-            'test/lib/*.test.js' \
-            'test/bin/*.test.js' \
-            'test/integration/helper.test.js'
+            test/core/*.test.js \
+            test/lib/*.test.js \
+            test/bin/*.test.js \
+            test/integration/helper.test.js

package/framework/v0.1.9-alpha.2/package.json

@@ -1,11 +1,5 @@
 {
-  "dependencies": {
-    "colors": "^1.4.0",
-    "engine.io": "^6.6.0",
-    "engine.io-client": "^6.6.2",
-    "requirejs": "2.3.7",
-    "ssl-checker": "^2.0.7",
-    "streamsearch": "^1.1.0",
-    "uuid": "^7.0.3"
-  }
+  "name": "gina-framework",
+  "version": "0.1.9-alpha.2",
+  "dependecies": {}
 }

package/framework/v0.1.9-alpha.3/core/deps/swig-1.4.2/CONTRIBUTING.md

@@ -0,0 +1,107 @@
+Contributing
+============
+
+Go to `gina/framework/${version}/core/deps/swig-1.4.2`, Then :
+
+```tty
+npm install --only=dev --npm-prefix=$(pwd)
+```
+
+Then:
+
+```tty
+gina build
+```
+
+You can stop here for now.
+
+Contributions are awesome! However, Swig is held to very high coding standards, so to ensure that your pull request is easy to understand and will be more successful, please follow this checklist:
+
+
+Checklist
+---------
+
+1. **Setup:** Before you begin, run `make` from your command line to ensure all dependencies are met.
+2. **Test:** Always write new test cases. `make test` and `make test-browser`.
+3. **Lint:** Ensure coding-standards are followed. `make lint`.
+4. **Explain:** In your pull request, very clearly explain the use-case or problem that you are solving.
+
+_Pull requests that fail to add test coverage, break tests, or fail linting standards will not be accepted._
+
+The swig codebase is [highly tested](http://paularmstrong.github.io/swig/coverage.html) and linted, as a way to guarantee functionality and keep all code written in a particular style for readability. No contributions will be accepted that do not pass all tests or throw any linter errors.
+
+Here's an example of a great pull request that followed the above checklist: [Pull Request 273 - Added patch and test case for object prototypal inheritance](https://github.com/paularmstrong/swig/pull/273).
+
+Documentation
+-------------
+
+All documentation for Swig is generated from [JSDoc](http://usejsdoc.org) comments inline and Swig template files within the `./docs` folder. To make changes to any documentation, follow these steps and tips:
+
+```sh
+# Clone the repo
+$ git clone git@github.com:paularmstrong/swig.git
+$ cd swig
+```
+
+```sh
+# Get dependencies
+$ make
+```
+
+```sh
+# Ensure your $NODE_PATH is set
+# Place this in your ~/.bash_profile
+export NODE_PATH=$(npm -g root 2>/dev/null)
+```
+
+```sh
+# Run the documentation test environment
+$ make docs
+```
+
+* Once you have the documentation test environment running, your browser will open showing you the documentation site.
+* If you are making changes to HTML files in `./docs`, reload the page to see them reflected immediately.
+* If you are changing any content from the inline [JSDoc](http://usejsdoc.org) comments, run `make build-docs` to rebuild the JSON data files.
+
+### Important!
+
+Once your documentation pull request is accepted, the person merging your request will be responsible for pushing the changes to the live site. Any attempts to push to or run a pull request to the `gh-pages` branch will not be accepted.
+
+Build Tasks
+-----------
+
+### make
+
+Installs all dependencies and sets up sanity-check git hooks.
+
+### make build
+
+Builds the browser-ified version of Swig to `./dist`.
+
+### make test
+
+Runs all test files matching `./test/*.test.js` within node.js.
+
+### make test-browser
+
+Builds for browser and runs a large subset of tests from the `make test` task within a browser environment using Phantom.js.
+
+### make coverage
+
+Builds a test coverage report.
+
+### make docs
+
+Builds documentation and runs a web-server for viewing a preview of the documentation site.
+
+### make build-docs
+
+Builds documentation for `docs` and `gh-pages` tasks from jsdoc comments in `./lib`.
+
+### make gh-pages
+
+Builds documentation as static HTML files and pushes them to the `gh-pages` git branch.
+
+### make version
+
+Updates the package version number throughout the source files from the `version` key found in `package.json`.

package/framework/v0.1.9-alpha.3/core/deps/swig-1.4.2/Makefile

@@ -0,0 +1,192 @@
+SHA := $(shell git rev-parse HEAD)
+THIS_BRANCH := $(shell git rev-parse --abbrev-ref HEAD)
+VERSION_REGEX = [0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*[^\" ]*
+VERSION := $(shell npm ls | grep "swig@" |  grep -Eo "${VERSION_REGEX}" -m 1)
+
+TMP = 'tmp'
+REMOTE = origin
+BRANCH = gh-pages
+BIN = node_modules/.bin
+PWD = $(shell pwd | sed -e 's/[\/&]/\\&/g')
+
+all:
+	@echo "Installing packages"
+	@npm install --depth=100 --loglevel=error
+	@npm link &>/dev/null
+	@cp scripts/githooks/* .git/hooks/
+	@chmod -R +x .git/hooks/
+
+.INTERMEDIATE version: \
+	browser/comments.js \
+	docs/index.json
+
+version:
+	@sed -i.bak 's/${VERSION_REGEX}/${VERSION}/' lib/swig.js
+	@rm lib/swig.js.bak
+
+browser/comments.js: FORCE
+	@sed -i.bak 's/v${VERSION_REGEX}/v${VERSION}/' $@
+	@rm $@.bak
+
+.SECONDARY dist/swig.js: \
+	browser/comments.js
+
+.SECONDARY dist/swig.min.js: \
+	dist/swig.js
+
+.INTERMEDIATE browser/test/tests.js: \
+	tests/comments.test.js \
+	tests/filters.test.js \
+	tests/tags.test.js \
+	tests/variables.test.js \
+	tests/tags/autoescape.test.js \
+	tests/tags/else.test.js \
+	tests/tags/filter.test.js \
+	tests/tags/for.test.js \
+	tests/tags/if.test.js \
+	tests/tags/macro.test.js \
+	tests/tags/raw.test.js \
+	tests/tags/set.test.js \
+	tests/tags/spaceless.test.js \
+	tests/basic.test.js
+
+clean: FORCE
+	@rm -rf dist
+	@rm -rf ${TMP}
+
+build: clean dist dist/swig.min.js
+	@echo "Built to ./dist/"
+
+dist:
+	@mkdir -p $@
+
+dist/swig.js:
+	@echo "Building $@..."
+	@cat $^ > $@
+	@${BIN}/browserify browser/index.js >> $@
+
+dist/swig.min.js:
+	@echo "Building $@..."
+	@${BIN}/uglifyjs $^ --comments -c warnings=false -m --source-map dist/swig.js.map > $@
+
+browser/test/tests.js:
+	@echo "Building $@..."
+	@cat $^ > tests/browser.js
+	@perl -pi -e 's/\.\.\/\.\.\/lib/\.\.\/lib/g' tests/browser.js
+	@${BIN}/browserify tests/browser.js > $@
+	@rm tests/browser.js
+
+tests := $(shell find ./tests -name '*.test.js' ! -path "*node_modules/*")
+reporter = dot
+opts =
+test:
+	@${BIN}/mocha --check-leaks --reporter ${reporter} ${opts} ${tests}
+
+test-browser: FORCE clean browser/test/tests.js
+	@${BIN}/mocha-phantomjs browser/test/index.html --reporter ${reporter}
+
+files := $(shell find . -name '*.js' ! -path "./node_modules/*" ! -path "./dist/*" ! -path "./browser*" ! -path "./docs*" ! -path "./tmp*")
+lint:
+	@${BIN}/nodelint ${files} --config=scripts/config-lint.js
+
+out = tests/coverage.html
+cov-reporter = html-cov
+coverage:
+ifeq (${cov-reporter}, travis-cov)
+	@${BIN}/mocha ${opts} ${tests} --require blanket -R ${cov-reporter}
+else
+	@${BIN}/mocha ${opts} ${tests} --require blanket -R ${cov-reporter} > ${out}
+	@sed -i .bak -e "s/${PWD}//g" ${out}
+	@rm ${out}.bak
+	@echo
+	@echo "Built Report to ${out}"
+	@echo
+endif
+
+docs/index.json: FORCE
+	@echo "Building $@..."
+	@sed -i.bak 's/v${VERSION_REGEX}/v${VERSION}/' $@
+	@rm $@.bak
+
+docs/docs.json: FORCE
+	@echo "Building $@..."
+	@sed -i.bak 's/v${VERSION_REGEX}/v${VERSION}/' $@
+	@rm $@.bak
+
+docs/coverage.html: FORCE
+	@echo "Building $@..."
+	@make coverage out=$@
+
+docs/docs/api.json: FORCE
+	@echo "Building $@..."
+	@echo '{ "api": ' > $@
+	@${BIN}/jsdoc lib/swig.js -X >> $@
+	@echo '}' >> $@
+
+docs/docs/filters.json: FORCE
+	@echo "Building $@..."
+	@echo '{ "filters": ' > $@
+	@${BIN}/jsdoc lib/filters.js -X >> $@
+	@echo '}' >> $@
+
+docs/docs/tags.json: FORCE
+	@echo "Building $@..."
+	@echo '{ "tags": ' > $@
+	@${BIN}/jsdoc lib/tags/ -X >> $@
+	@echo '}' >> $@
+
+docs/docs/loaders.json: FORCE
+	@echo "Building $@..."
+	@echo '{ "loaders": ' > $@
+	@${BIN}/jsdoc lib/loaders/ -X >> $@
+	@echo '}' >> $@
+
+docs/docs/extending.json: FORCE
+	@echo "Building $@..."
+	@echo '{ "ext": ' > $@
+	@${BIN}/jsdoc lib/parser.js lib/lexer.js -X >> $@
+	@echo '}' >> $@
+
+.SECONDARY build-docs: \
+	docs/index.json \
+	docs/docs.json
+
+.INTERMDIATE build-docs: \
+	docs/docs/api.json \
+	docs/docs/filters.json \
+	docs/docs/tags.json \
+	docs/docs/extending.json \
+	docs/docs/loaders.json
+
+build-docs: FORCE
+	@echo "Documentation built."
+
+gh-pages: clean build build-docs
+	@mkdir -p ${TMP}/js
+	@mkdir -p docs/css
+	@rm -f docs/coverage.html
+	@${BIN}/lessc --yui-compress --include-path=docs/less docs/less/swig.less docs/css/swig.css
+	@${BIN}/still docs -o ${TMP} -i "layout" -i "json" -i "less" -v
+	@make coverage out=${TMP}/coverage.html
+	@cp dist/swig.* ${TMP}/js/
+	@git checkout ${BRANCH}
+	@cp -r ${TMP}/* ./
+	@rm -rf ${TMP}
+ifeq (${THIS_BRANCH}, master)
+	@git add .
+	@git commit -n -am "Automated build from ${SHA}"
+	@git push ${REMOTE} ${BRANCH}
+	@git checkout ${THIS_BRANCH}
+	@git clean -f -d docs/
+endif
+
+port = 3000
+docs: build build-docs
+	@${BIN}/still-server docs/ -p ${port} -o
+
+FORCE:
+
+.PHONY: all version \
+	build build-docs \
+	test test-browser lint coverage \
+	docs gh-pages

package/framework/v0.1.9-alpha.3/core/deps/swig-1.4.2/browser/comments.js

@@ -0,0 +1,2 @@
+/*! Swig v1.4.2 | https://paularmstrong.github.com/swig | @license https://github.com/paularmstrong/swig/blob/master/LICENSE */
+/*! DateZ (c) 2011 Tomo Universalis | @license https://github.com/TomoUniversalis/DateZ/blob/master/LISENCE */

package/framework/v0.1.9-alpha.3/core/deps/swig-1.4.2/browser/index.js

@@ -0,0 +1,9 @@
+var swig = require('../lib/swig');
+
+if (typeof window.define === 'function' && typeof window.define.amd === 'object') {
+  window.define('swig', [], function () {
+    return swig;
+  });
+} else {
+  window.swig = swig;
+}

package/framework/v0.1.9-alpha.3/core/deps/swig-1.4.2/docs/docs/api.html

@@ -0,0 +1,136 @@
+{% extends "./layout.html" %}
+{% import "./includes/macros.html" as docmacro %}
+
+{% block title %}{% parent %} » API{% endblock %}
+
+{% block content %}
+<h1>Swig API</h1>
+
+{% for def in api %}
+{% if def.kind === 'typedef' and def.undocumented !== true %}
+  <section id="{{ def.name }}" class="doc">
+    <h2>Object Type: {{ def.name }}</h2>
+    {{ docmacro.source(def, 1) }}
+
+    {{ docmacro.description(def) }}
+
+    {% if def.properties.length %}
+    <h3>Properties</h3>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+      {% for prop in def.properties %}
+        <tr>
+          <td><var data-language="js">{{ prop.name }}</var></td>
+          <td><code data-language="js">{{ prop.type|join(" or ") }}</code></td>
+          <td>{{ prop.description|raw }}</td>
+        </tr>
+      {% endfor %}
+      </tbody>
+    </table>
+    {% endif %}
+
+    {% if def.examples.length %}
+    <h3>Examples</h3>
+    {% for example in def.examples %}
+    <pre><code data-language="js">{{ example }}</code></pre>
+    {% endfor %}
+    {% endif %}
+  </section>
+{% endif %}
+{% endfor %}
+
+{% for prop in api %}
+{% if prop.kind === 'member' and prop.undocumented !== true %}
+  <section id="{{ prop.name }}" class="doc">
+    <h2>swig.{{ prop.name }}</h2>
+    {{ docmacro.source(prop, 1) }}
+
+    {{ docmacro.description(prop) }}
+
+    {% if prop.examples.length %}
+    <h3>Examples</h3>
+    {% for example in prop.examples %}
+    <pre><code data-language="js">{{ example }}</code></pre>
+    {% endfor %}
+    {% endif %}
+  </section>
+{% endif %}
+{% endfor %}
+
+{% for fn in api %}
+  {% if fn.access !== "private" and fn.kind === 'function' and fn.undocumented !== true %}
+  <section id="{{ fn.name }}" class="doc">
+    <h2>
+      swig.{{ fn.name }}(
+      {%- for p in fn.params -%}
+      {{ p.name }}
+      {%- if not loop.last %}, {% endif -%}
+      {%- endfor -%}
+      )
+    </h2>
+
+    {{ docmacro.source(fn, 1) }}
+
+    {{ docmacro.description(fn) }}
+
+    {% if fn.params.length %}
+    <h3>Parameters</h3>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Optional</th>
+          <th>Default</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+      {% for param in fn.params %}
+        <tr>
+          <td><var data-language="js">{{ param.name }}</var></td>
+          <td><code data-language="js">{{ param.type|join(" or ") }}</code></td>
+          <td>{% if param.optional === true %}✔{% endif %}</td>
+          <td><code data-language="js">{{ param.defaultvalue }}</code></td>
+          <td>{{ param.description|raw }}</td>
+        </tr>
+      {% endfor %}
+      </tbody>
+    </table>
+    {% endif %}
+
+    {% if fn.returns %}
+    <h3>Returns</h3>
+    {% for ret in fn.returns %}
+    <p><samp data-language="js">{{ ret.type.names|join(', ') }}</samp>: {{ ret.description|raw }}</p>
+    {% endfor %}
+    {% endif %}
+
+    {% if fn.examples.length %}
+    <h3>Examples</h3>
+    {% for example in fn.examples %}
+    <pre><code data-language="js">{{ example }}</code></pre>
+    {% endfor %}
+    {% endif %}
+  </section>
+  {% endif %}
+{% endfor %}
+
+{% endblock %}
+
+{% block apisubnav %}
+<ol>
+{% for obj in api %}
+{% if obj.access !== "private" and obj.undocumented !== true and obj.kind !== 'package' %}
+  <li><a href="#{{ obj.name }}">{% if obj.kind === 'typedef' %}Object: {% elif obj.kind === 'function' or obj.kind === 'member' %}swig.{% endif %}{{ obj.name }}</a></li>
+{% endif %}
+{% endfor %}
+</ol>
+{% endblock %}

package/framework/v0.1.9-alpha.3/core/deps/swig-1.4.2/docs/docs/browser.html

@@ -0,0 +1,36 @@
+{% extends "./layout.html" %}
+
+{% block title %}{% parent %} » Browser Usage{% endblock %}
+
+{% block content %}
+<h1>Swig in the Browser</h1>
+
+<p>Most of Swig works in the browser in the same way that Swig works within node.js. The only exception to this is that Swig is unable to look up files by their path name, unless you directly tell Swig what each template's path name is before hand.</p>
+
+<p>In short, Swig cannot resolve the directive <code data-language="swig">{% raw %}{% extends "./myfile.html" %}{% endraw %}</code> and <code data-language="swig">{% raw %}{% include "./myfile.html" %}{% endraw %}</code> without first having already been told about <var>./myfile.html</var>.</p>
+
+<p>The best way to work around this is to first pre-compile your templates using the Swig <a href="{{ baseurl }}/docs/cli/">command-line interface</a>.</p>
+
+<ol>
+  <li>
+    <p>Compile each template into JavaScript files. Assign a method name to the output that will be globally available in your browser.</p>
+    <pre><code data-language="sh">$ swig compile myfile.html --method-name=myfile > myfile.js</code></pre>
+  </li>
+  <li>
+    <p>Include Swig and your <samp>myfile.js</samp> in your web page.</p>
+    <pre><code data-language="html">&lt;script src="swig.min.js"&gt;&lt;/script&gt;
+&lt;script src="myfile.js"&gt;&lt;/script&gt;
+</code></pre>
+  </li>
+  <li>
+    <p>Pre-run the template to prime Swig's cache.</p>
+    <pre><code data-language="js">swig.run(myfile, {}, '/myfile.html');</code></pre>
+  </li>
+  <li>
+    <p>Now, you are ready to render a template in-browser that can extend <samp>myfile.html</samp></p>
+    <pre><code data-language="js">var tpl = '{% raw %}{% extends "./myfile.html" %}{% block content %}{{ stuff }}{% endblock %}{% endraw %}';
+var output = swig.render(tpl, { filename: '/tpl', locals: { stuff: 'awesome' }});
+document.querySelector('#foo').innerHTML = output;</code></pre>
+  </li>
+</ol>
+{% endblock %}

package/framework/v0.1.9-alpha.3/core/deps/swig-1.4.2/docs/docs/cli.html

@@ -0,0 +1,64 @@
+{% extends "./layout.html" %}
+
+{% block title %}{% parent %} » CLI{% endblock %}
+
+{% block content %}
+<h1>Command-Line Interface</h1>
+
+<section id="install" class="doc">
+  <h2>Installation</h2>
+
+  <p>Via NPM:</p>
+  <pre><code data-language="sh">$ npm install swig --global</code></pre>
+</section>
+
+<section id="usage" class="doc">
+  <h2>Usage</h2>
+
+  <pre><code data-language="sh">$ swig compile [file...] [options]
+$ swig render [file...] [options]
+$ swig run [file...] [options]</code></pre>
+
+  <h3>Options</h3>
+  <pre>
+-v, --version  Show the Swig version number.
+-o, --output   Output location. [default: "stdout"]
+-h, --help     Show this help screen.
+-j, --json     Variable context as a JSON file.
+-c, --context  Variable context as a CommonJS-style file. Used only if option `j` is not provided.
+-m, --minify   Minify compiled functions with uglify-js
+--filters      Custom filters as a CommonJS-style file
+--tags         Custom tags as a CommonJS-style file
+--options      Customize Swig's Options from a CommonJS-style file
+--wrap-start   Template wrapper beginning for "compile". [default: "var tpl = "]
+--wrap-end     Template wrapper end for "compile". [default: ";"]
+--method-name  Method name to set template to and run from. [default: "tpl"]</pre>
+</section>
+
+<section id="examples" class="doc">
+  <h2>Examples</h2>
+
+  <p>Render a single file:</p>
+  <pre><code data-language="sh">$ swig render ./index.html</code></pre>
+
+  <p>Compile and cache a template into a renderable function and minify the output with uglify-js:</p>
+  <pre><code data-language="sh">$ swig compile ./index.html -m > ./cache/index.js</code></pre>
+
+  <p>Run and build the previously cached template:</p>
+  <pre><code data-language="sh">$ swig run ./cache/index.js</code></pre>
+
+  <p>Import a JSON file as the variable context for rendering a template:</p>
+  <pre><code data-language="sh">$ swig render ./index.html -j ./index.json</code></pre>
+
+  <p>Make your template an AMD module:</p>
+  <pre><code data-language="sh">$ swig compile ./index.html --wrap-start="define(function () { return " --wrap-end="; });"</code></pre>
+</section>
+{% endblock %}
+
+{% block clisubnav %}
+<ol>
+  <li><a href="#install">Installation</a></li>
+  <li><a href="#usage">Usage</a></li>
+  <li><a href="#examples">Examples</a></li>
+</ol>
+{% endblock %}