diff --git a/Mustache.php b/Mustache.php index ad89f24..414316f 100644 --- a/Mustache.php +++ b/Mustache.php @@ -467,9 +467,10 @@ class Mustache { * @param string $ctag * @return string */ - protected function _prepareTagRegEx($otag, $ctag) { + protected function _prepareTagRegEx($otag, $ctag, $first = false) { return sprintf( - '/(?P(?<=\\n)[ \\t]*)?%s(?P[%s]?)(?P.+?)(?:\\2|})?%s(?:\\s*(?=\\n))?/s', + '/(?P(?:%s\\r?\\n)[ \\t]*)?%s(?P[%s]?)(?P.+?)(?:\\2|})?%s(?P\\s*(?:\\r?\\n|\\Z))?/s', + ($first ? '\\A|' : ''), preg_quote($otag, '/'), self::TAG_TYPES, preg_quote($ctag, '/') @@ -491,7 +492,8 @@ class Mustache { $otag_orig = $this->_otag; $ctag_orig = $this->_ctag; - $this->_tagRegEx = $this->_prepareTagRegEx($this->_otag, $this->_ctag); + $first = true; + $this->_tagRegEx = $this->_prepareTagRegEx($this->_otag, $this->_ctag, true); $html = ''; $matches = array(); @@ -501,10 +503,16 @@ class Mustache { $modifier = $matches['type'][0]; $tag_name = trim($matches['tag_name'][0]); - if (isset($matches['whitespace']) && $matches['whitespace'][1] > -1) { - $whitespace = $matches['whitespace'][0]; + if (isset($matches['leading']) && $matches['leading'][1] > -1) { + $leading = $matches['leading'][0]; } else { - $whitespace = null; + $leading = null; + } + + if (isset($matches['trailing']) && $matches['trailing'][1] > -1) { + $trailing = $matches['trailing'][0]; + } else { + $trailing = null; } $html .= substr($template, 0, $offset); @@ -515,7 +523,12 @@ class Mustache { } $template = substr($template, $next_offset); - $html .= $this->_renderTag($modifier, $tag_name, $whitespace); + $html .= $this->_renderTag($modifier, $tag_name, $leading, $trailing); + + if ($first == true) { + $first = false; + $this->_tagRegEx = $this->_prepareTagRegEx($this->_otag, $this->_ctag); + } } $this->_otag = $otag_orig; @@ -533,20 +546,22 @@ class Mustache { * @access protected * @param string $modifier * @param string $tag_name + * @param string $leading Whitespace + * @param string $trailing Whitespace * @throws MustacheException Unmatched section tag encountered. * @return string */ - protected function _renderTag($modifier, $tag_name, $whitespace) { + protected function _renderTag($modifier, $tag_name, $leading, $trailing) { switch ($modifier) { case '=': - return $this->_changeDelimiter($tag_name); + return $this->_changeDelimiter($tag_name, $leading, $trailing); break; case '!': - return $this->_renderComment($tag_name); + return $this->_renderComment($tag_name, $leading, $trailing); break; case '>': case '<': - return $this->_renderPartial($tag_name, $whitespace); + return $this->_renderPartial($tag_name, $leading, $trailing); break; case '{': // strip the trailing } ... @@ -555,24 +570,41 @@ class Mustache { } case '&': if ($this->_hasPragma(self::PRAGMA_UNESCAPED)) { - return $this->_renderEscaped($tag_name); + return $this->_renderEscaped($tag_name, $leading, $trailing); } else { - return $this->_renderUnescaped($tag_name); + return $this->_renderUnescaped($tag_name, $leading, $trailing); } break; case '#': case '^': case '/': // remove any leftovers from _renderSections - return ''; + return $leading . $trailing; + break; + default: + if ($this->_hasPragma(self::PRAGMA_UNESCAPED)) { + return $this->_renderUnescaped($modifier . $tag_name, $leading, $trailing); + } else { + return $this->_renderEscaped($modifier . $tag_name, $leading, $trailing); + } break; } + } - if ($this->_hasPragma(self::PRAGMA_UNESCAPED)) { - return $this->_renderUnescaped($modifier . $tag_name); - } else { - return $this->_renderEscaped($modifier . $tag_name); + /** + * Returns true if any of its args contains the "\r" character. + * + * @access protected + * @param string $str + * @return boolean + */ + protected function _stringHasR($str) { + foreach (func_get_args() as $arg) { + if (strpos($arg, "\r") !== false) { + return true; + } } + return false; } /** @@ -580,10 +612,12 @@ class Mustache { * * @access protected * @param string $tag_name + * @param string $leading Whitespace + * @param string $trailing Whitespace * @return string */ - protected function _renderEscaped($tag_name) { - return htmlentities($this->_renderUnescaped($tag_name), ENT_COMPAT, $this->_charset); + protected function _renderEscaped($tag_name, $leading, $trailing) { + return $leading . htmlentities($this->_renderUnescaped($tag_name), ENT_COMPAT, $this->_charset) . $trailing; } /** @@ -591,10 +625,18 @@ class Mustache { * * @access protected * @param string $tag_name + * @param string $leading Whitespace + * @param string $trailing Whitespace * @return string */ - protected function _renderComment($tag_name) { - return ''; + protected function _renderComment($tag_name, $leading, $trailing) { + if ($leading !== null && $trailing !== null) { + if (strpos($leading, "\n") === false) { + return ''; + } + return $this->_stringHasR($leading, $trailing) ? "\r\n" : "\n"; + } + return $leading . $trailing; } /** @@ -602,17 +644,19 @@ class Mustache { * * @access protected * @param string $tag_name + * @param string $leading Whitespace + * @param string $trailing Whitespace * @return string */ - protected function _renderUnescaped($tag_name) { + protected function _renderUnescaped($tag_name, $leading, $trailing) { $val = $this->_getVariable($tag_name); if ($this->_varIsCallable($val)) { $key = is_object($val) ? spl_object_hash($val) : serialize($val); - return $this->_renderTemplate(call_user_func($val)); + $val = $this->_renderTemplate(call_user_func($val)); } - return $val; + return $leading . $val . $trailing; } /** @@ -620,14 +664,24 @@ class Mustache { * * @access protected * @param string $tag_name + * @param string $leading Whitespace + * @param string $trailing Whitespace * @return string */ - protected function _renderPartial($tag_name, $whitespace = '') { + protected function _renderPartial($tag_name, $leading, $trailing) { + $partial = $this->_getPartial($tag_name); + if ($leading !== null && $trailing !== null) { + $whitespace = trim($leading, "\r\n"); + $partial = preg_replace('/(\\r?\\n)(?!$)/s', "\\1" . $whitespace, $partial); + } + $view = clone($this); - - $partial = $whitespace . preg_replace('/\n(?!$)/s', "\n" . $whitespace, $this->_getPartial($tag_name)); - - return $view->render($partial); + + if ($leading !== null && $trailing !== null) { + return $leading . $view->render($partial); + } else { + return $leading . $view->render($partial) . $trailing; + } } /** @@ -636,16 +690,24 @@ class Mustache { * * @access protected * @param string $tag_name + * @param string $leading Whitespace + * @param string $trailing Whitespace * @return string */ - protected function _changeDelimiter($tag_name) { + protected function _changeDelimiter($tag_name, $leading, $trailing) { list($otag, $ctag) = explode(' ', $tag_name); $this->_otag = $otag; $this->_ctag = $ctag; $this->_tagRegEx = $this->_prepareTagRegEx($this->_otag, $this->_ctag); - return ''; + if ($leading !== null && $trailing !== null) { + if (strpos($leading, "\n") === false) { + return ''; + } + return $this->_stringHasR($leading, $trailing) ? "\r\n" : "\n"; + } + return $leading . $trailing; } /** diff --git a/README.markdown b/README.markdown index 3662d3c..52ee11f 100644 --- a/README.markdown +++ b/README.markdown @@ -81,12 +81,15 @@ And render it: Known Issues ------------ + * As of v1.1.2, there are a couple of whitespace bugs around section tags. * Things get weird when you change delimiters inside a section -- `delimiters` example currently fails with an "unclosed section" exception. + * The current spec test exposes several whitespace bugs (which are mostly instances of the exact same whitespace + bug) ... Despite these failing tests, this version is actually *closer* to correct than previous releases. See Also -------- * [Readme for the Ruby Mustache implementation](http://github.com/defunkt/mustache/blob/master/README.md). - * [mustache(1)](http://defunkt.github.com/mustache/mustache.1.html) and [mustache(5)](http://defunkt.github.com/mustache/mustache.5.html) man pages. \ No newline at end of file + * [mustache(1)](http://defunkt.github.com/mustache/mustache.1.html) and [mustache(5)](http://defunkt.github.com/mustache/mustache.5.html) man pages. diff --git a/test/MustacheSpecTest.php b/test/MustacheSpecTest.php index 69428f3..d3a3413 100644 --- a/test/MustacheSpecTest.php +++ b/test/MustacheSpecTest.php @@ -25,7 +25,7 @@ class MustacheSpecTest extends PHPUnit_Framework_TestCase { * @group comments * @dataProvider loadCommentSpec */ - public function testCommentSpec($template, $data, $partials, $expected, $desc) { + public function testCommentSpec($desc, $template, $data, $partials, $expected) { $m = new Mustache($template, $data, $partials); $this->assertEquals($expected, $m->render(), $desc); } @@ -34,7 +34,7 @@ class MustacheSpecTest extends PHPUnit_Framework_TestCase { * @group delimiters * @dataProvider loadDelimitersSpec */ - public function testDelimitersSpec($template, $data, $partials, $expected, $desc) { + public function testDelimitersSpec($desc, $template, $data, $partials, $expected) { $m = new Mustache($template, $data, $partials); $this->assertEquals($expected, $m->render(), $desc); } @@ -43,7 +43,7 @@ class MustacheSpecTest extends PHPUnit_Framework_TestCase { * @group interpolation * @dataProvider loadInterpolationSpec */ - public function testInterpolationSpec($template, $data, $partials, $expected, $desc) { + public function testInterpolationSpec($desc, $template, $data, $partials, $expected) { $m = new Mustache($template, $data, $partials); $this->assertEquals($expected, $m->render(), $desc); } @@ -52,7 +52,7 @@ class MustacheSpecTest extends PHPUnit_Framework_TestCase { * @group inverted-sections * @dataProvider loadInvertedSpec */ - public function testInvertedSpec($template, $data, $partials, $expected, $desc) { + public function testInvertedSpec($desc, $template, $data, $partials, $expected) { $m = new Mustache($template, $data, $partials); $this->assertEquals($expected, $m->render(), $desc); } @@ -61,7 +61,7 @@ class MustacheSpecTest extends PHPUnit_Framework_TestCase { * @group lambdas * @dataProvider loadLambdasSpec */ - public function testLambdasSpec($template, $data, $partials, $expected, $desc) { + public function testLambdasSpec($desc, $template, $data, $partials, $expected) { if (!version_compare(PHP_VERSION, '5.3.0', '>=')) { $this->markTestSkipped('Unable to test Lambdas spec with PHP < 5.3.'); } @@ -94,7 +94,7 @@ class MustacheSpecTest extends PHPUnit_Framework_TestCase { * @group partials * @dataProvider loadPartialsSpec */ - public function testPartialsSpec($template, $data, $partials, $expected, $desc) { + public function testPartialsSpec($desc, $template, $data, $partials, $expected) { $m = new Mustache($template, $data, $partials); $this->assertEquals($expected, $m->render(), $desc); } @@ -103,7 +103,7 @@ class MustacheSpecTest extends PHPUnit_Framework_TestCase { * @group sections * @dataProvider loadSectionsSpec */ - public function testSectionsSpec($template, $data, $partials, $expected, $desc) { + public function testSectionsSpec($desc, $template, $data, $partials, $expected) { $m = new Mustache($template, $data, $partials); $this->assertEquals($expected, $m->render(), $desc); } @@ -162,11 +162,11 @@ class MustacheSpecTest extends PHPUnit_Framework_TestCase { $spec = $yaml->parse($file); foreach ($spec['tests'] as $test) { $data[] = array( + $test['name'] . ': ' . $test['desc'], $test['template'], $test['data'], isset($test['partials']) ? $test['partials'] : array(), $test['expected'], - $test['desc'] ); } return $data; diff --git a/test/spec b/test/spec index 3383fa6..bf6288e 160000 --- a/test/spec +++ b/test/spec @@ -1 +1 @@ -Subproject commit 3383fa66e808a07fde1c291aa16a588d0a1a2a6d +Subproject commit bf6288ed6bd0ce8ccea6f1dac070b3d779132c3b