guard-mthaml 0.1.0

data/vendor/mthaml/mthaml/CHANGELOG

@@ -0,0 +1,48 @@
+* 1.6.0 (2014-08-16)
+
+ * Code statements continue on the next line when the current one is terminated by
+   a comma
+ * Ruby-style attributes continue on the next line when braces are not balanced
+   and the current one is terminated by a comma
+ * Attributes defined by attribute methods or expressions are merged with
+   existing .class and #id instead of overriding them (%p.class{attrs()})
+
+* 1.5.0 (2014-07-08)
+
+ * Improved the Twig Loader (hason)
+
+* 1.4.0 (2014-05-23)
+
+ * Now attributes are escaped only if escape is activated (Hassan Amouhzi)
+ * Added an Executor that can easily execute php-based templates
+
+* 1.3.0 (2013-10-04)
+
+ * Made filters modular (hason)
+ * Added filters: coffee, escaped, less, markdown, php, scss, twig (hason)
+ * Spec: Case insensitive doctype id after `!!!`
+ * Spec: `!!! XML` doctype ignored in non xhtml mode
+ * Spec: Do not output `/>` on empty elements in non xhtml mode
+ * Fixed handling of escaped string interpolations (hason)
+ * Improved Object Reference support: object name override (ronan-gloo)
+ * New examples
+
+* 1.2.2 (2013-03-29)
+
+ * Flatten deeply-nested data attributes
+
+* 1.2.0 (2013-02-09)
+
+ * Added support for interpolations in attributes: %form(action="" #{form_enctype(form)})
+ * Added support for object reference syntax: %div[object]
+ * Made the parser more permissive when parsing content of -# comments
+ * Fixed rendering of <?xml tags to not conflict with php short open tags
+ * Added ability to use inline comments in php code
+ * Added attribute expression support in ruby-like attributes: %html{get_attrs()}
+ * Added boolean attribute syntax in html-like attributes: %input(type="checkbox" checked)
+
+* 1.1.0 (2012-09-24)
+
+ * Added handling of special attributes (e.g. id, class, data, and boolean attributes)
+ * Compiled MtHaml templates now need MtHaml at runtime in some cases (and a Twig extension, for Twig templates).
+

data/vendor/mthaml/mthaml/LICENSE

@@ -0,0 +1,44 @@
+Copyright (c) 2006-2011 Arnaud Le Blanc
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Some tests are derived from the original ruby-haml; the following
+copyright notice apply to them:
+
+Copyright (c) 2006-2009 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/vendor/mthaml/mthaml/README.markdown

@@ -0,0 +1,262 @@
+# Multi target HAML
+
+[![Build Status](https://secure.travis-ci.org/arnaud-lb/MtHaml.png)](http://travis-ci.org/arnaud-lb/MtHaml)
+
+MtHaml is a PHP implementation of the [HAML language][1] which can target multiple languages.
+
+Currently supported targets are PHP and [Twig][4], and new ones can be added easily.
+
+Mt-Haml implements the exact same syntax as ruby-haml; the only difference is that any supported language can be used everywhere HAML expects Ruby code:
+
+## HAML/Twig:
+
+``` haml
+%ul#users
+  - for user in users
+    %li.user
+      = user.name
+      Email: #{user.email}
+      %a(href=user.url) Home page
+```
+
+Rendered:
+
+``` jinja
+<ul id="users">
+  {% for user in users %}
+    <li class="user">
+      {{ user.name }}
+      Email: {{ user.email }}
+      <a href="{{ user.url }}">Home page</a>
+    </li>
+  {% endfor %}
+</ul>
+```
+
+## HAML/PHP:
+
+``` haml
+%ul#users
+  - foreach($users as $user)
+    %li.user
+      = $user->getName()
+      Email: #{$user->getEmail()}
+      %a(href=$user->getUrl()) Home page
+```
+
+Rendered:
+
+``` php
+<ul id="users">
+  <?php foreach($users as $user) { ?>
+    <li class="user">
+      <?php echo $user->getName(); ?>
+      Email: <?php echo $user->getEmail(); ?>
+      <a href="<?php echo $user->getUrl(); ?>">Home page</a>
+    </li>
+  <?php } ?>
+</ul>
+```
+
+## Usage
+
+PHP:
+
+``` php
+<?php
+$haml = new MtHaml\Environment('php');
+$executor = new MtHaml\Support\Php\Executor($haml, array(
+    'cache' => sys_get_temp_dir().'/haml',
+));
+
+// Compiles and executes the HAML template, with variables given as second
+// argument
+$executor->display('template.haml', array(
+    'var' => 'value',
+));
+
+```
+
+[Twig][4]:
+
+``` php
+<?php
+$haml = new MtHaml\Environment('twig', array('enable_escaper' => false));
+
+// Use a custom loader, whose responsibility is to convert HAML templates
+// to Twig syntax, before handing them out to Twig:
+$hamlLoader = new MtHaml\Support\Twig\Loader($haml, $twig->getLoader());
+$twig->setLoader($hamlLoader);
+
+// Register the Twig extension before executing a HAML template
+$twig->addExtension(new MtHaml\Support\Twig\Extension());
+
+// Render templates as usual
+$twig->render('template.haml', ...);
+```
+
+See [examples][7] and [MtHaml with Twig](https://github.com/arnaud-lb/MtHaml/wiki/Use-MtHaml-with-Twig)
+
+## Escaping
+
+MtHaml escapes everything by default. Since Twig already supports
+auto escaping it is recommended to enable it in Twig and disable it in MtHaml:
+
+`new MtHaml\Environment('twig', array('enable_escaper' => false));`
+
+HAML/PHP is rendered like this when auto escaping is enabled:
+
+``` haml
+Email #{$user->getEmail()}
+%a(href=$user->getUrl()) Home page
+```
+
+``` php
+Email <?php echo htmlspecialchars($user->getEmail(), ENT_QUOTES, 'UTF-8'); ?>
+<a href="<?php echo htmlspecialchars($user->getUrl(), ENT_QUOTES, 'UTF-8'); ?>">Home page</a>
+```
+
+## Twig
+
+Using [Twig][4] in HAML gives more control over what can be executed, what variables and functions are exposed to the templates, etc. This also allows to use all of Twig's awesome features like template inheritance, macros, blocks, filters, functions, tests, ...
+
+``` haml
+- extends "some-template.haml"
+
+- macro printSomething()
+  %p something
+
+- block body
+  %h1 Title
+  = _self.printSomething()
+```
+
+### Integration in Twig
+
+MtHaml comes with an example Twig_Loader that will automatically convert HAML into Twig at loading time (Twig will then compile the resulting Twig script and cache it). Templates with a `.haml` extension, or whose source starts with `{% haml %}` will be converted, and the others will be left untouched.
+
+The loader acts as a proxy and takes an other loader as parameter:
+
+``` php
+<?php
+
+$haml = new MtHaml\Environment(...);
+
+$twig_loader = new Twig_Loader_Filesystem(...);
+$twig_loader = new MtHaml\Support\Twig\Loader($haml, $twig_loader);
+```
+
+### Runtime support
+
+Compiled MtHaml/Twig templates need support from MtHaml at runtime in some cases. Because of this, a Twig extension must be loaded before executing the templates.
+
+
+``` php
+<?php
+// Register the MtHaml extension before executing the template:
+$twig->addExtension(new MtHaml\Support\Twig\Extension());
+$twig->render("rendered_twig_template.twig");
+```
+
+## Syntax
+
+The syntax is the same as [HAML/Ruby][1]'s syntax, except that PHP or Twig have to be used where Ruby is expected.
+
+See the [tutorial][2] and the [reference][3]
+
+## Performance
+
+MtHaml converts HAML to PHP or Twig code. The resulting code can be cached and executed any number of times, and
+doesn't depend on HAML at runtime.
+
+MtHaml has no runtime overhead.
+
+## Helpers
+
+Helpers in HAML/Ruby are just ruby functions exposed to templates.
+Any function can be made available to HAML templates by the target language
+(the function only have to be available at runtime).
+
+In HAML/Twig you can use all of Twig's functions, filters, and tags. In HAML/PHP, you can use all PHP functions.
+
+## Filters
+
+Filters take plain text input (with support for `#{...}` interpolations) and transform it, or wrap it.
+
+Example with the `javascript` filter:
+
+``` haml
+%p something
+:javascript
+  some.javascript.code("#{var|escape('js')}");
+```
+
+``` jinja
+<p>something</p>
+<script type="text/javascript">
+//<![CDATA[
+  some.javascript.code("{{ var|escape('js') }}");
+//]]>
+</script>
+```
+
+The following filters are available:
+
+ - **css**: wraps with style tags
+ - **cdata**: wraps with CDATA markup
+ - **coffee***: compiles coffeescript to javascript
+ - **escaped**: html escapes
+ - **javascript**: wraps with script tags
+ - **less***: compiles as Lesscss
+ - **markdown***: converts markdown to html
+ - **php**: executes the input as php code
+ - **preseve**: preserves preformatted text
+ - **scss***: converts scss to css
+ - **twig**: executes the input as twig code
+
+Filter marked with `*` have runtime dependencies and are not enabled by default. Such filters need to be provided to MtHaml\Environment explicitly.
+
+Example with the Coffee filter:
+
+``` php
+<?php
+
+$coffeeFilter = new MtHaml\Filter\CoffeeScript(new CoffeeScript\Compiler);
+
+$env = new MtHaml\Environment('twig', array(
+    'enable_escaper' => false,
+), array(
+    'coffee' => $coffeeFilter,
+));
+```
+
+## Sass
+
+[Sass][6] can be used in PHP projects without problem. It only depends on Ruby and does not need to be installed on production servers. So MtHaml will not re-implement Sass.
+
+## Frameworks and CMS support
+ 
+ - CakePHP: https://github.com/TiuTalk/haml
+ - Drupal: https://github.com/antoinelafontaine/oxide
+ - FuelPHP: https://github.com/fuel/parser
+ - Laravel (PHP): https://github.com/BKWLD/laravel-haml
+ - Laravel (Twig): https://github.com/SimonDegraeve/laravel-twigbridge
+ - PHPixie: https://github.com/dracony/PHPixie-HAML
+ - Silex: https://github.com/arnaud-lb/Silex-MtHaml
+ - Sprockets-PHP: https://github.com/Nami-Doc/Sprockets-PHP
+ - Symfony2: https://github.com/arnaud-lb/MtHamlBundle
+ - Zend Framework 1: https://github.com/bonndan/mthaml-zf1
+
+Add yours: https://github.com/arnaud-lb/MtHaml/edit/master/README.markdown
+
+## License
+
+MtHaml is released under the MIT license (same as HAML/Ruby).
+
+[1]: http://haml-lang.com/
+[2]: http://haml-lang.com/tutorial.html
+[3]: http://haml-lang.com/docs/yardoc/file.HAML_REFERENCE.html
+[4]: http://www.twig-project.org/
+[5]: http://haml-lang.com/docs/yardoc/file.HAML_REFERENCE.html#attribute_methods
+[6]: http://sass-lang.com/
+[7]: https://github.com/arnaud-lb/MtHaml/blob/master/examples/README.md

data/vendor/mthaml/mthaml/composer.json

@@ -0,0 +1,45 @@
+{
+    "name": "mthaml/mthaml",
+    "type": "library",
+    "description": "HAML for PHP",
+    "keywords": ["HAML"],
+    "homepage": "https://github.com/arnaud-lb/MtHaml",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Arnaud Le Blanc",
+            "email": "arnaud.lb@gmail.com"
+        }
+    ],
+    "require": {
+        "php": ">=5.3.0"
+    },
+    "require-dev": {
+        "twig/twig": "~1.11",
+        "oyejorge/less.php": "*",
+        "leafo/lessphp": "*",
+        "leafo/scssphp": "*",
+        "coffeescript/coffeescript": "~1",
+        "michelf/php-markdown": "~1.3",
+        "erusev/parsedown": "*"
+    },
+    "suggest": {
+        "twig/twig": "If you want to use Twig templating engine",
+        "oyejorge/less.php": "If you want to use :less filter",
+        "leafo/lessphp": "If you want to use :less filter",
+        "leafo/scssphp": "If you want to use :scss filter",
+        "coffeescript/coffeescript": "If you want to use :coffee or :coffeescript filter",
+        "michelf/php-markdown": "If you want to use :markdown filter",
+        "erusev/parsedown": "If you want to use :markdown filter",
+        "cebe/markdown": "If you want to use :markdown filter",
+        "kzykhys/ciconia": "If you want to use :markdown filter"
+    },
+    "conflict": {
+        "mthaml/mthaml-bundle": "<1.1.0"
+    },
+    "autoload": {
+        "psr-0": {
+            "MtHaml\\": "lib/"
+        }
+    }
+}

data/vendor/mthaml/mthaml/docs/Makefile

@@ -0,0 +1,153 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	-rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/MtHaml.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/MtHaml.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/MtHaml"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/MtHaml"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."