Added HandlebarMustache, an extended Mustache class which contains file handling for templates and partials. This will most likely be merged in with the main Mustache class once it's a little more solid.

HandlebarMustache.php

@@ -0,0 +1,111 @@
+<?php
+
+/**
+ * HandlebarMustache class.
+ *
+ * This is an extended Mustache class which contains file handling for templates
+ * and partial templates.
+ *
+ * @extends Mustache
+ */
+class HandlebarMustache extends Mustache {
+
+	/**
+	 * templateBase directory.
+	 *
+	 * If none is specified, this will default to `dirname(__FILE__)`.
+	 *
+	 * @var string
+	 * @access protected
+	 */
+	protected $templateBase;
+
+	/**
+	 * HandlebarMustache class constructor.
+	 *
+	 * @access public
+	 * @param string $template (default: null)
+	 * @param mixed $view (default: null)
+	 * @param array $partials (default: null)
+	 * @return void
+	 */
+	public function __construct($template = null, $view = null, $partials = null) {
+		parent::__construct($template,$view,$partials);
+
+		// default template base is the current directory.
+		if (!isset($this->templateBase)) {
+			$this->setTemplateBase(dirname(__FILE__));
+		}
+	}
+
+	/**
+	 * Override the current templateBase.
+	 *
+	 * @access public
+	 * @param string $dir
+	 * @return void
+	 */
+	public function setTemplateBase($dir) {
+		if (substr($dir, -1) !== '/') {
+			$dir .= '/';
+		}
+		$this->templateBase = $dir;
+	}
+
+	/**
+	 * Load a template file. This file will be relative to $this->templateBase.
+	 * A '.mustache' file extension is assumed if none is provided in $file.
+	 *
+	 * @access public
+	 * @param string $file
+	 * @return void
+	 */
+	public function loadTemplate($file) {
+		if (strpos($file, '.') === false) {
+			$file .= '.mustache';
+		}
+
+		$filename = $this->templateBase . $file;
+		if (file_exists($filename)) {
+			$this->template = file_get_contents($filename);
+		} else {
+			$this->template = null;
+		}
+	}
+
+	/**
+	 * Load a partial, either from $this->partials or from a file in the templateBase
+	 * directory.
+	 *
+	 * @access protected
+	 * @param string $tag_name
+	 * @return string Partial template.
+	 */
+	protected function getPartial($tag_name) {
+		try {
+			if ($result = parent::getPartial($tag_name)) {
+				return $result;
+			}
+		} catch (MustacheException $e) {
+			// Ignore the UNKNOWN_PARTIAL exceptions, we'll just look for a template file.
+			if ($e->getCode() !== MustacheException::UNKNOWN_PARTIAL) {
+				throw $e;
+			}
+		}
+
+		$filename = $this->templateBase . $tag_name . '.mustache';
+		if (file_exists($filename)) {
+			$this->partials[$tag_name] = file_get_contents($filename);
+			return $this->partials[$tag_name];
+		} else {
+			if ($this->throwPartialExceptions) {
+				throw new MustacheException(
+					'Unknown partial: ' . $tag_name,
+					MustacheException::UNKNOWN_PARTIAL
+				);
+			} else {
+				return '';
+			}
+		}
+	}
+}