Merge branch 'release/0.2.0'
This commit is contained in:
+242
-76
@@ -14,22 +14,50 @@
|
||||
*/
|
||||
class Mustache {
|
||||
|
||||
public $otag = '{{';
|
||||
public $ctag = '}}';
|
||||
public $_otag = '{{';
|
||||
public $_ctag = '}}';
|
||||
|
||||
// Should this Mustache throw exceptions when it finds unexpected tags?
|
||||
protected $throwSectionExceptions = true;
|
||||
protected $throwPartialExceptions = false;
|
||||
protected $throwVariableExceptions = false;
|
||||
/**
|
||||
* Should this Mustache throw exceptions when it finds unexpected tags?
|
||||
*
|
||||
* @see self::_throwsException()
|
||||
*/
|
||||
protected $_throwsExceptions = array(
|
||||
MustacheException::UNKNOWN_VARIABLE => false,
|
||||
MustacheException::UNCLOSED_SECTION => true,
|
||||
MustacheException::UNEXPECTED_CLOSE_SECTION => true,
|
||||
MustacheException::UNKNOWN_PARTIAL => false,
|
||||
MustacheException::UNKNOWN_PRAGMA => true,
|
||||
);
|
||||
|
||||
// Override charset passed to htmlentities() and htmlspecialchars(). Defaults to UTF-8.
|
||||
protected $charset = 'UTF-8';
|
||||
protected $_charset = 'UTF-8';
|
||||
|
||||
protected $tagRegEx;
|
||||
const PRAGMA_DOT_NOTATION = 'DOT-NOTATION';
|
||||
|
||||
protected $template = '';
|
||||
protected $context = array();
|
||||
protected $partials = array();
|
||||
/**
|
||||
* The {{%UNESCAPED}} pragma swaps the meaning of the {{normal}} and {{{unescaped}}}
|
||||
* Mustache tags. That is, once this pragma is activated the {{normal}} tag will not be
|
||||
* escaped while the {{{unescaped}}} tag will be escaped.
|
||||
*
|
||||
* Pragmas apply only to the current template. Partials, even those included after the
|
||||
* {{%UNESCAPED}} call, will need their own pragma declaration.
|
||||
*
|
||||
* his may be useful in non-HTML Mustache situations.
|
||||
*/
|
||||
const PRAGMA_UNESCAPED = 'UNESCAPED';
|
||||
|
||||
protected $_tagRegEx;
|
||||
|
||||
protected $_template = '';
|
||||
protected $_context = array();
|
||||
protected $_partials = array();
|
||||
protected $_pragmas = array();
|
||||
|
||||
protected $_pragmasImplemented = array(
|
||||
self::PRAGMA_DOT_NOTATION,
|
||||
self::PRAGMA_UNESCAPED
|
||||
);
|
||||
|
||||
/**
|
||||
* Mustache class constructor.
|
||||
@@ -44,9 +72,9 @@ class Mustache {
|
||||
* @return void
|
||||
*/
|
||||
public function __construct($template = null, $view = null, $partials = null) {
|
||||
if ($template !== null) $this->template = $template;
|
||||
if ($partials !== null) $this->partials = $partials;
|
||||
if ($view !== null) $this->context = array($view);
|
||||
if ($template !== null) $this->_template = $template;
|
||||
if ($partials !== null) $this->_partials = $partials;
|
||||
if ($view !== null) $this->_context = array($view);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -62,16 +90,16 @@ class Mustache {
|
||||
* @return string Rendered Mustache template.
|
||||
*/
|
||||
public function render($template = null, $view = null, $partials = null) {
|
||||
if ($template === null) $template = $this->template;
|
||||
if ($partials !== null) $this->partials = $partials;
|
||||
if ($template === null) $template = $this->_template;
|
||||
if ($partials !== null) $this->_partials = $partials;
|
||||
|
||||
if ($view) {
|
||||
$this->context = array($view);
|
||||
} else if (empty($this->context)) {
|
||||
$this->context = array($this);
|
||||
$this->_context = array($view);
|
||||
} else if (empty($this->_context)) {
|
||||
$this->_context = array($this);
|
||||
}
|
||||
|
||||
return $this->_render($template, $this->context);
|
||||
return $this->_renderTemplate($template, $this->_context);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -91,7 +119,6 @@ class Mustache {
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Internal render function, used for recursive calls.
|
||||
*
|
||||
@@ -100,9 +127,10 @@ class Mustache {
|
||||
* @param array &$context
|
||||
* @return string Rendered Mustache template.
|
||||
*/
|
||||
protected function _render($template, &$context) {
|
||||
$template = $this->renderSection($template, $context);
|
||||
return $this->renderTags($template, $context);
|
||||
protected function _renderTemplate($template, &$context) {
|
||||
$template = $this->_renderPragmas($template, $context);
|
||||
$template = $this->_renderSection($template, $context);
|
||||
return $this->_renderTags($template, $context);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -113,13 +141,9 @@ class Mustache {
|
||||
* @param array $context
|
||||
* @return string
|
||||
*/
|
||||
protected function renderSection($template, &$context) {
|
||||
if (strpos($template, $this->otag . '#') === false) {
|
||||
return $template;
|
||||
}
|
||||
|
||||
$otag = $this->prepareRegEx($this->otag);
|
||||
$ctag = $this->prepareRegEx($this->ctag);
|
||||
protected function _renderSection($template, &$context) {
|
||||
$otag = $this->_prepareRegEx($this->_otag);
|
||||
$ctag = $this->_prepareRegEx($this->_ctag);
|
||||
$regex = '/' . $otag . '(\\^|\\#)(.+?)' . $ctag . '\\s*([\\s\\S]+?)' . $otag . '\\/\\2' . $ctag . '\\s*/m';
|
||||
|
||||
$matches = array();
|
||||
@@ -131,7 +155,7 @@ class Mustache {
|
||||
$content = $matches[3][0];
|
||||
|
||||
$replace = '';
|
||||
$val = $this->getVariable($tag_name, $context);
|
||||
$val = $this->_getVariable($tag_name, $context);
|
||||
switch($type) {
|
||||
// inverted section
|
||||
case '^':
|
||||
@@ -142,14 +166,15 @@ class Mustache {
|
||||
|
||||
// regular section
|
||||
case '#':
|
||||
if ($this->varIsIterable($val)) {
|
||||
if ($this->_varIsIterable($val)) {
|
||||
foreach ($val as $local_context) {
|
||||
$c = $this->getContext($context, $local_context);
|
||||
$replace .= $this->_render($content, $c);
|
||||
$c = $this->_getContext($context, $local_context);
|
||||
$replace .= $this->_renderTemplate($content, $c);
|
||||
}
|
||||
} else if ($val) {
|
||||
if (is_array($val) || is_object($val)) {
|
||||
$replace .= $this->_render($content, $this->getContext($context, $val));
|
||||
$c = $this->_getContext($context, $val);
|
||||
$replace .= $this->_renderTemplate($content, $c);
|
||||
} else {
|
||||
$replace .= $content;
|
||||
}
|
||||
@@ -163,6 +188,105 @@ class Mustache {
|
||||
return $template;
|
||||
}
|
||||
|
||||
/**
|
||||
* Initialize pragmas and remove all pragma tags.
|
||||
*
|
||||
* @access protected
|
||||
* @param string $template
|
||||
* @param array &$context
|
||||
* @return string
|
||||
*/
|
||||
protected function _renderPragmas($template, &$context) {
|
||||
// no pragmas
|
||||
if (strpos($template, $this->_otag . '%') === false) {
|
||||
return $template;
|
||||
}
|
||||
|
||||
$otag = $this->_prepareRegEx($this->_otag);
|
||||
$ctag = $this->_prepareRegEx($this->_ctag);
|
||||
$regex = '/' . $otag . '%\\s*([\\w_-]+)((?: [\\w]+=[\\w]+)*)\\s*' . $ctag . '\\n?/';
|
||||
return preg_replace_callback($regex, array($this, '_renderPragma'), $template);
|
||||
}
|
||||
|
||||
/**
|
||||
* A preg_replace helper to remove {{%PRAGMA}} tags and enable requested pragma.
|
||||
*
|
||||
* @access protected
|
||||
* @param mixed $matches
|
||||
* @return void
|
||||
* @throws MustacheException unknown pragma
|
||||
*/
|
||||
protected function _renderPragma($matches) {
|
||||
$pragma = $matches[0];
|
||||
$pragma_name = $matches[1];
|
||||
$options_string = $matches[2];
|
||||
|
||||
if (!in_array($pragma_name, $this->_pragmasImplemented)) {
|
||||
throw new MustacheException('Unknown pragma: ' . $pragma_name, MustacheException::UNKNOWN_PRAGMA);
|
||||
}
|
||||
|
||||
$options = array();
|
||||
foreach (explode(' ', trim($options_string)) as $o) {
|
||||
if ($p = trim($o)) {
|
||||
$p = explode('=', trim($p));
|
||||
$options[$p[0]] = $p[1];
|
||||
}
|
||||
}
|
||||
|
||||
if (empty($options)) {
|
||||
$this->_pragmas[$pragma_name] = true;
|
||||
} else {
|
||||
$this->_pragmas[$pragma_name] = $options;
|
||||
}
|
||||
|
||||
return '';
|
||||
}
|
||||
|
||||
/**
|
||||
* Check whether this Mustache has a specific pragma.
|
||||
*
|
||||
* @access protected
|
||||
* @param string $pragma_name
|
||||
* @return bool
|
||||
*/
|
||||
protected function _hasPragma($pragma_name) {
|
||||
if (array_key_exists($pragma_name, $this->_pragmas) && $this->_pragmas[$pragma_name]) {
|
||||
return true;
|
||||
} else {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Return pragma options, if any.
|
||||
*
|
||||
* @access protected
|
||||
* @param string $pragma_name
|
||||
* @return mixed
|
||||
* @throws MustacheException Unknown pragma
|
||||
*/
|
||||
protected function _getPragmaOptions($pragma_name) {
|
||||
if (!$this->_hasPragma()) {
|
||||
throw new MustacheException('Unknown pragma: ' . $pragma_name, MustacheException::UNKNOWN_PRAGMA);
|
||||
}
|
||||
|
||||
return $this->_pragmas[$pragma_name];
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Check whether this Mustache instance throws a given exception.
|
||||
*
|
||||
* Expects exceptions to be MustacheException error codes (i.e. class constants).
|
||||
*
|
||||
* @access protected
|
||||
* @param mixed $exception
|
||||
* @return void
|
||||
*/
|
||||
protected function _throwsException($exception) {
|
||||
return (isset($this->_throwsExceptions[$exception]) && $this->_throwsExceptions[$exception]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Loop through and render individual Mustache tags.
|
||||
*
|
||||
@@ -171,24 +295,26 @@ class Mustache {
|
||||
* @param array $context
|
||||
* @return void
|
||||
*/
|
||||
protected function renderTags($template, &$context) {
|
||||
if (strpos($template, $this->otag) === false) {
|
||||
protected function _renderTags($template, &$context) {
|
||||
if (strpos($template, $this->_otag) === false) {
|
||||
return $template;
|
||||
}
|
||||
|
||||
$otag = $this->prepareRegEx($this->otag);
|
||||
$ctag = $this->prepareRegEx($this->ctag);
|
||||
$this->tagRegEx = '/' . $otag . "(#|\/|=|!|>|\\{|&)?([^\/#]+?)\\1?" . $ctag . "+/";
|
||||
$otag = $this->_prepareRegEx($this->_otag);
|
||||
$ctag = $this->_prepareRegEx($this->_ctag);
|
||||
|
||||
$this->_tagRegEx = '/' . $otag . "([#\^\/=!>\\{&])?(.+?)\\1?" . $ctag . "+/";
|
||||
|
||||
$html = '';
|
||||
$matches = array();
|
||||
while (preg_match($this->tagRegEx, $template, $matches, PREG_OFFSET_CAPTURE)) {
|
||||
while (preg_match($this->_tagRegEx, $template, $matches, PREG_OFFSET_CAPTURE)) {
|
||||
$tag = $matches[0][0];
|
||||
$offset = $matches[0][1];
|
||||
$modifier = $matches[1][0];
|
||||
$tag_name = trim($matches[2][0]);
|
||||
|
||||
$html .= substr($template, 0, $offset);
|
||||
$html .= $this->renderTag($modifier, $tag_name, $context);
|
||||
$html .= $this->_renderTag($modifier, $tag_name, $context);
|
||||
$template = substr($template, $offset + strlen($tag));
|
||||
}
|
||||
|
||||
@@ -208,38 +334,47 @@ class Mustache {
|
||||
* @throws MustacheException Unmatched section tag encountered.
|
||||
* @return string
|
||||
*/
|
||||
protected function renderTag($modifier, $tag_name, &$context) {
|
||||
protected function _renderTag($modifier, $tag_name, &$context) {
|
||||
switch ($modifier) {
|
||||
case '#':
|
||||
if ($this->throwSectionExceptions) {
|
||||
case '^':
|
||||
if ($this->_throwsException(MustacheException::UNCLOSED_SECTION)) {
|
||||
throw new MustacheException('Unclosed section: ' . $tag_name, MustacheException::UNCLOSED_SECTION);
|
||||
} else {
|
||||
return '';
|
||||
}
|
||||
break;
|
||||
case '/':
|
||||
if ($this->throwSectionExceptions) {
|
||||
if ($this->_throwsException(MustacheException::UNEXPECTED_CLOSE_SECTION)) {
|
||||
throw new MustacheException('Unexpected close section: ' . $tag_name, MustacheException::UNEXPECTED_CLOSE_SECTION);
|
||||
} else {
|
||||
return '';
|
||||
}
|
||||
break;
|
||||
case '=':
|
||||
return $this->changeDelimiter($tag_name, $context);
|
||||
return $this->_changeDelimiter($tag_name, $context);
|
||||
break;
|
||||
case '!':
|
||||
return $this->renderComment($tag_name, $context);
|
||||
return $this->_renderComment($tag_name, $context);
|
||||
break;
|
||||
case '>':
|
||||
return $this->renderPartial($tag_name, $context);
|
||||
return $this->_renderPartial($tag_name, $context);
|
||||
break;
|
||||
case '{':
|
||||
case '&':
|
||||
return $this->renderUnescaped($tag_name, $context);
|
||||
if ($this->_hasPragma(self::PRAGMA_UNESCAPED)) {
|
||||
return $this->_renderEscaped($tag_name, $context);
|
||||
} else {
|
||||
return $this->_renderUnescaped($tag_name, $context);
|
||||
}
|
||||
break;
|
||||
case '':
|
||||
default:
|
||||
return $this->renderEscaped($tag_name, $context);
|
||||
if ($this->_hasPragma(self::PRAGMA_UNESCAPED)) {
|
||||
return $this->_renderUnescaped($tag_name, $context);
|
||||
} else {
|
||||
return $this->_renderEscaped($tag_name, $context);
|
||||
}
|
||||
break;
|
||||
}
|
||||
}
|
||||
@@ -252,8 +387,8 @@ class Mustache {
|
||||
* @param array $context
|
||||
* @return string
|
||||
*/
|
||||
protected function renderEscaped($tag_name, &$context) {
|
||||
return htmlentities($this->getVariable($tag_name, $context), null, $this->charset);
|
||||
protected function _renderEscaped($tag_name, &$context) {
|
||||
return htmlentities($this->_getVariable($tag_name, $context), null, $this->_charset);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -264,7 +399,7 @@ class Mustache {
|
||||
* @param array $context
|
||||
* @return string
|
||||
*/
|
||||
protected function renderComment($tag_name, &$context) {
|
||||
protected function _renderComment($tag_name, &$context) {
|
||||
return '';
|
||||
}
|
||||
|
||||
@@ -276,8 +411,8 @@ class Mustache {
|
||||
* @param array $context
|
||||
* @return string
|
||||
*/
|
||||
protected function renderUnescaped($tag_name, &$context) {
|
||||
return $this->getVariable($tag_name, $context);
|
||||
protected function _renderUnescaped($tag_name, &$context) {
|
||||
return $this->_getVariable($tag_name, $context);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -288,10 +423,10 @@ class Mustache {
|
||||
* @param array $context
|
||||
* @return string
|
||||
*/
|
||||
protected function renderPartial($tag_name, &$context) {
|
||||
$view = new self($this->getPartial($tag_name), $context, $this->partials);
|
||||
$view->otag = $this->otag;
|
||||
$view->ctag = $this->ctag;
|
||||
protected function _renderPartial($tag_name, &$context) {
|
||||
$view = new self($this->_getPartial($tag_name), $context, $this->_partials);
|
||||
$view->_otag = $this->_otag;
|
||||
$view->_ctag = $this->_ctag;
|
||||
return $view->render();
|
||||
}
|
||||
|
||||
@@ -304,14 +439,14 @@ class Mustache {
|
||||
* @param array $context
|
||||
* @return string
|
||||
*/
|
||||
protected function changeDelimiter($tag_name, &$context) {
|
||||
protected function _changeDelimiter($tag_name, &$context) {
|
||||
$tags = explode(' ', $tag_name);
|
||||
$this->otag = $tags[0];
|
||||
$this->ctag = $tags[1];
|
||||
$this->_otag = $tags[0];
|
||||
$this->_ctag = $tags[1];
|
||||
|
||||
$otag = $this->prepareRegEx($this->otag);
|
||||
$ctag = $this->prepareRegEx($this->ctag);
|
||||
$this->tagRegEx = '/' . $otag . "(#|\/|=|!|>|\\{|&)?([^\/#\^]+?)\\1?" . $ctag . "+/";
|
||||
$otag = $this->_prepareRegEx($this->_otag);
|
||||
$ctag = $this->_prepareRegEx($this->_ctag);
|
||||
$this->_tagRegEx = '/' . $otag . "([#\^\/=!>\\{&])?(.+?)\\1?" . $ctag . "+/";
|
||||
return '';
|
||||
}
|
||||
|
||||
@@ -326,7 +461,7 @@ class Mustache {
|
||||
* @param mixed $local_context
|
||||
* @return void
|
||||
*/
|
||||
protected function getContext(&$context, &$local_context) {
|
||||
protected function _getContext(&$context, &$local_context) {
|
||||
$ret = array();
|
||||
$ret[] =& $local_context;
|
||||
foreach ($context as $view) {
|
||||
@@ -350,7 +485,34 @@ class Mustache {
|
||||
* @throws MustacheException Unknown variable name.
|
||||
* @return string
|
||||
*/
|
||||
protected function getVariable($tag_name, &$context) {
|
||||
protected function _getVariable($tag_name, &$context) {
|
||||
if ($this->_hasPragma(self::PRAGMA_DOT_NOTATION)) {
|
||||
$chunks = explode('.', $tag_name);
|
||||
$first = array_shift($chunks);
|
||||
|
||||
$ret = $this->_findVariableInContext($first, $context);
|
||||
while ($next = array_shift($chunks)) {
|
||||
// Slice off a chunk of context for dot notation traversal.
|
||||
$c = array($ret);
|
||||
$ret = $this->_findVariableInContext($next, $c);
|
||||
}
|
||||
return $ret;
|
||||
} else {
|
||||
return $this->_findVariableInContext($tag_name, $context);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get a variable from the context array. Internal helper used by getVariable() to abstract
|
||||
* variable traversal for dot notation.
|
||||
*
|
||||
* @access protected
|
||||
* @param string $tag_name
|
||||
* @param array &$context
|
||||
* @throws MustacheException Unknown variable name.
|
||||
* @return string
|
||||
*/
|
||||
protected function _findVariableInContext($tag_name, &$context) {
|
||||
foreach ($context as $view) {
|
||||
if (is_object($view)) {
|
||||
if (isset($view->$tag_name)) {
|
||||
@@ -363,7 +525,7 @@ class Mustache {
|
||||
}
|
||||
}
|
||||
|
||||
if ($this->throwVariableExceptions) {
|
||||
if ($this->_throwsException(MustacheException::UNKNOWN_VARIABLE)) {
|
||||
throw new MustacheException("Unknown variable: " . $tag_name, MustacheException::UNKNOWN_VARIABLE);
|
||||
} else {
|
||||
return '';
|
||||
@@ -380,12 +542,12 @@ class Mustache {
|
||||
* @throws MustacheException Unknown partial name.
|
||||
* @return string
|
||||
*/
|
||||
protected function getPartial($tag_name) {
|
||||
if (is_array($this->partials) && isset($this->partials[$tag_name])) {
|
||||
return $this->partials[$tag_name];
|
||||
protected function _getPartial($tag_name) {
|
||||
if (is_array($this->_partials) && isset($this->_partials[$tag_name])) {
|
||||
return $this->_partials[$tag_name];
|
||||
}
|
||||
|
||||
if ($this->throwPartialExceptions) {
|
||||
if ($this->_throwsException(MustacheException::UNKNOWN_PARTIAL)) {
|
||||
throw new MustacheException('Unknown partial: ' . $tag_name, MustacheException::UNKNOWN_PARTIAL);
|
||||
} else {
|
||||
return '';
|
||||
@@ -399,7 +561,7 @@ class Mustache {
|
||||
* @param mixed $var
|
||||
* @return bool
|
||||
*/
|
||||
protected function varIsIterable($var) {
|
||||
protected function _varIsIterable($var) {
|
||||
return is_object($var) || (is_array($var) && !array_diff_key($var, array_keys(array_keys($var))));
|
||||
}
|
||||
|
||||
@@ -410,7 +572,7 @@ class Mustache {
|
||||
* @param string $str
|
||||
* @return string
|
||||
*/
|
||||
protected function prepareRegEx($str) {
|
||||
protected function _prepareRegEx($str) {
|
||||
$replace = array(
|
||||
'\\' => '\\\\', '^' => '\^', '.' => '\.', '$' => '\$', '|' => '\|', '(' => '\(',
|
||||
')' => '\)', '[' => '\[', ']' => '\]', '*' => '\*', '+' => '\+', '?' => '\?',
|
||||
@@ -436,11 +598,15 @@ class MustacheException extends Exception {
|
||||
const UNCLOSED_SECTION = 1;
|
||||
|
||||
// An UNEXPECTED_CLOSE_SECTION exception is thrown when {{/section}} appears
|
||||
// without a corresponding {{#section}}.
|
||||
// without a corresponding {{#section}} or {{^section}}.
|
||||
const UNEXPECTED_CLOSE_SECTION = 2;
|
||||
|
||||
// An UNKNOWN_PARTIAL exception is thrown whenever a {{>partial}} tag appears
|
||||
// with no associated partial.
|
||||
const UNKNOWN_PARTIAL = 3;
|
||||
|
||||
// An UNKNOWN_PRAGMA exception is thrown whenever a {{%PRAGMA}} tag appears
|
||||
// which can't be handled by this Mustache instance.
|
||||
const UNKNOWN_PRAGMA = 4;
|
||||
|
||||
}
|
||||
@@ -81,6 +81,8 @@ And render it:
|
||||
Known Issues
|
||||
------------
|
||||
|
||||
* Pragmas don't un-apply... Instead of applying only to a specific template, pragmas are applied
|
||||
to all subsequent templates and partials rendered by this Mustache instance.
|
||||
* Sections don't respect delimiter changes -- `delimiters` example currently fails with an
|
||||
"unclosed section" exception.
|
||||
* Test coverage is incomplete.
|
||||
|
||||
@@ -1 +1 @@
|
||||
<h1>{{title}}{{! just something interesting... or not... }}</h1>
|
||||
<h1>{{title}}{{! just something interesting... #or ^not... }}</h1>
|
||||
@@ -0,0 +1,19 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* DotNotation example class. Uses DOT_NOTATION pragma.
|
||||
*
|
||||
* @extends Mustache
|
||||
*/
|
||||
class DotNotation extends Mustache {
|
||||
public $person = array(
|
||||
'name' => array('first' => 'Chris', 'last' => 'Firescythe'),
|
||||
'age' => 24,
|
||||
'hometown' => array(
|
||||
'city' => 'Cincinnati',
|
||||
'state' => 'OH',
|
||||
)
|
||||
);
|
||||
|
||||
public $normal = 'Normal';
|
||||
}
|
||||
@@ -0,0 +1,5 @@
|
||||
{{%DOT-NOTATION}}
|
||||
* {{person.name.first}} {{person.name.last}}
|
||||
* {{person.age}}
|
||||
* {{person.hometown.city}}, {{person.hometown.state}}
|
||||
* {{normal}}
|
||||
@@ -0,0 +1,4 @@
|
||||
* Chris Firescythe
|
||||
* 24
|
||||
* Cincinnati, OH
|
||||
* Normal
|
||||
@@ -0,0 +1,6 @@
|
||||
<?php
|
||||
|
||||
class InvertedDoubleSection extends Mustache {
|
||||
public $t = false;
|
||||
public $two = 'second';
|
||||
}
|
||||
@@ -0,0 +1,7 @@
|
||||
{{^t}}
|
||||
* first
|
||||
{{/t}}
|
||||
* {{two}}
|
||||
{{^t}}
|
||||
* third
|
||||
{{/t}}
|
||||
@@ -0,0 +1,3 @@
|
||||
* first
|
||||
* second
|
||||
* third
|
||||
@@ -0,0 +1,5 @@
|
||||
<?php
|
||||
|
||||
class PragmaUnescaped extends Mustache {
|
||||
protected $vs = 'Bear > Shark';
|
||||
}
|
||||
@@ -0,0 +1,3 @@
|
||||
{{%UNESCAPED}}
|
||||
{{vs}}
|
||||
{{{vs}}}
|
||||
@@ -0,0 +1,2 @@
|
||||
Bear > Shark
|
||||
Bear > Shark
|
||||
@@ -0,0 +1,34 @@
|
||||
<?php
|
||||
|
||||
require_once '../Mustache.php';
|
||||
require_once 'PHPUnit/Framework.php';
|
||||
|
||||
class MustachePragmaDotNotationTest extends PHPUnit_Framework_TestCase {
|
||||
|
||||
public function testDotTraversal() {
|
||||
$m = new Mustache('', array('foo' => array('bar' => 'this worked')));
|
||||
|
||||
$this->assertEquals($m->render('{{foo.bar}}'), '',
|
||||
'Dot notation not enabled, variable should have been replaced with nothing');
|
||||
$this->assertEquals($m->render('{{%DOT-NOTATION}}{{foo.bar}}'), 'this worked',
|
||||
'Dot notation enabled, variable should have been replaced by "this worked"');
|
||||
}
|
||||
|
||||
public function testDeepTraversal() {
|
||||
$data = array(
|
||||
'foo' => array('bar' => array('baz' => array('qux' => array('quux' => 'WIN!')))),
|
||||
'a' => array('b' => array('c' => array('d' => array('e' => 'abcs')))),
|
||||
'one' => array(
|
||||
'one' => 'one-one',
|
||||
'two' => 'one-two',
|
||||
'three' => 'one-three',
|
||||
),
|
||||
);
|
||||
|
||||
$m = new Mustache('', $data);
|
||||
$this->assertEquals($m->render('{{%DOT-NOTATION}}{{foo.bar.baz.qux.quux}}'), 'WIN!');
|
||||
$this->assertEquals($m->render('{{%DOT-NOTATION}}{{a.b.c.d.e}}'), 'abcs');
|
||||
$this->assertEquals($m->render('{{%DOT-NOTATION}}{{one.one}}|{{one.two}}|{{one.three}}'), 'one-one|one-two|one-three');
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,42 @@
|
||||
<?php
|
||||
|
||||
require_once '../Mustache.php';
|
||||
require_once 'PHPUnit/Framework.php';
|
||||
|
||||
class MustachePragmaTest extends PHPUnit_Framework_TestCase {
|
||||
|
||||
public function testUnknownPragmaException() {
|
||||
$m = new Mustache();
|
||||
|
||||
try {
|
||||
$m->render('{{%I-HAVE-THE-GREATEST-MUSTACHE}}');
|
||||
} catch (MustacheException $e) {
|
||||
$this->assertEquals(MustacheException::UNKNOWN_PRAGMA, $e->getCode(), 'Caught exception code was not MustacheException::UNKNOWN_PRAGMA');
|
||||
return;
|
||||
}
|
||||
|
||||
$this->fail('Mustache should have thrown an unknown pragma exception');
|
||||
}
|
||||
|
||||
public function testPragmaReplace() {
|
||||
$m = new Mustache();
|
||||
$this->assertEquals('', $m->render('{{%DOT-NOTATION}}'), 'Pragma tag not removed');
|
||||
}
|
||||
|
||||
public function testPragmaReplaceMultiple() {
|
||||
$m = new Mustache();
|
||||
|
||||
$this->assertEquals('', $m->render('{{% DOT-NOTATION }}'), 'Pragmas should allow whitespace');
|
||||
$this->assertEquals('', $m->render('{{% DOT-NOTATION foo=bar }}'), 'Pragmas should allow whitespace');
|
||||
$this->assertEquals('', $m->render("{{%DOT-NOTATION}}\n{{%DOT-NOTATION}}"), 'Multiple pragma tags not removed');
|
||||
$this->assertEquals(' ', $m->render('{{%DOT-NOTATION}} {{%DOT-NOTATION}}'), 'Multiple pragma tags not removed');
|
||||
}
|
||||
|
||||
public function testPragmaReplaceNewline() {
|
||||
$m = new Mustache();
|
||||
$this->assertEquals('', $m->render("{{%DOT-NOTATION}}\n"), 'Trailing newline after pragma tag not removed');
|
||||
$this->assertEquals("\n", $m->render("\n{{%DOT-NOTATION}}\n"), 'Too many newlines removed with pragma tag');
|
||||
$this->assertEquals("1\n23", $m->render("1\n2{{%DOT-NOTATION}}\n3"), 'Wrong newline removed with pragma tag');
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,15 @@
|
||||
<?php
|
||||
|
||||
require_once '../Mustache.php';
|
||||
require_once 'PHPUnit/Framework.php';
|
||||
|
||||
class MustachePragmaUnescapedTest extends PHPUnit_Framework_TestCase {
|
||||
|
||||
public function testPragmaUnescaped() {
|
||||
$m = new Mustache(null, array('title' => 'Bear > Shark'));
|
||||
|
||||
$this->assertEquals('Bear > Shark', $m->render('{{%UNESCAPED}}{{title}}'));
|
||||
$this->assertEquals('Bear > Shark', $m->render('{{%UNESCAPED}}{{{title}}}'));
|
||||
}
|
||||
|
||||
}
|
||||
+103
-1
@@ -34,6 +34,109 @@ require_once 'PHPUnit/Framework.php';
|
||||
*/
|
||||
class MustacheTest extends PHPUnit_Framework_TestCase {
|
||||
|
||||
const TEST_CLASS = 'Mustache';
|
||||
|
||||
/**
|
||||
* Test Mustache constructor.
|
||||
*
|
||||
* @access public
|
||||
* @return void
|
||||
*/
|
||||
public function test__construct() {
|
||||
$template = '{{#mustaches}}{{#last}}and {{/last}}{{type}}{{^last}}, {{/last}}{{/mustaches}}';
|
||||
$data = array(
|
||||
'mustaches' => array(
|
||||
array('type' => 'Natural'),
|
||||
array('type' => 'Hungarian'),
|
||||
array('type' => 'Dali'),
|
||||
array('type' => 'English'),
|
||||
array('type' => 'Imperial'),
|
||||
array('type' => 'Freestyle', 'last' => 'true'),
|
||||
)
|
||||
);
|
||||
$output = 'Natural, Hungarian, Dali, English, Imperial, and Freestyle';
|
||||
|
||||
$m1 = new Mustache();
|
||||
$this->assertEquals($output, $m1->render($template, $data));
|
||||
|
||||
$m2 = new Mustache($template);
|
||||
$this->assertEquals($output, $m2->render(null, $data));
|
||||
|
||||
$m3 = new Mustache($template, $data);
|
||||
$this->assertEquals($output, $m3->render());
|
||||
|
||||
$m4 = new Mustache(null, $data);
|
||||
$this->assertEquals($output, $m4->render($template));
|
||||
}
|
||||
|
||||
/**
|
||||
* Test __toString() function.
|
||||
*
|
||||
* @access public
|
||||
* @return void
|
||||
*/
|
||||
public function test__toString() {
|
||||
$m = new Mustache('{{first_name}} {{last_name}}', array('first_name' => 'Karl', 'last_name' => 'Marx'));
|
||||
|
||||
$this->assertEquals('Karl Marx', $m->__toString());
|
||||
$this->assertEquals('Karl Marx', (string) $m);
|
||||
|
||||
$m2 = $this->getMock(self::TEST_CLASS, array('render'), array());
|
||||
$m2->expects($this->once())
|
||||
->method('render')
|
||||
->will($this->returnValue('foo'));
|
||||
|
||||
$this->assertEquals('foo', $m2->render());
|
||||
}
|
||||
|
||||
public function test__toStringException() {
|
||||
$m = $this->getMock(self::TEST_CLASS, array('render'), array());
|
||||
$m->expects($this->once())
|
||||
->method('render')
|
||||
->will($this->throwException(new Exception));
|
||||
|
||||
try {
|
||||
$out = (string) $m;
|
||||
} catch (Exception $e) {
|
||||
$this->fail('__toString should catch all exceptions');
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Test render().
|
||||
*
|
||||
* @access public
|
||||
* @return void
|
||||
*/
|
||||
public function testRender() {
|
||||
$m = new Mustache();
|
||||
|
||||
$this->assertEquals('', $m->render(''));
|
||||
$this->assertEquals('foo', $m->render('foo'));
|
||||
$this->assertEquals('', $m->render(null));
|
||||
|
||||
$m2 = new Mustache('foo');
|
||||
$this->assertEquals('foo', $m2->render());
|
||||
|
||||
$m3 = new Mustache('');
|
||||
$this->assertEquals('', $m3->render());
|
||||
|
||||
$m3 = new Mustache();
|
||||
$this->assertEquals('', $m3->render(null));
|
||||
}
|
||||
|
||||
/**
|
||||
* Test render() with data.
|
||||
*
|
||||
* @access public
|
||||
* @return void
|
||||
*/
|
||||
public function testRenderWithData() {
|
||||
$m = new Mustache('{{first_name}} {{last_name}}');
|
||||
$this->assertEquals('Charlie Chaplin', $m->render(null, array('first_name' => 'Charlie', 'last_name' => 'Chaplin')));
|
||||
$this->assertEquals('Zappa, Frank', $m->render('{{last_name}}, {{first_name}}', array('first_name' => 'Frank', 'last_name' => 'Zappa')));
|
||||
}
|
||||
|
||||
/**
|
||||
* Test everything in the `examples` directory.
|
||||
*
|
||||
@@ -49,7 +152,6 @@ class MustacheTest extends PHPUnit_Framework_TestCase {
|
||||
$this->assertEquals($output, $m->render($template));
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Data provider for testExamples method.
|
||||
*
|
||||
|
||||
Reference in New Issue
Block a user