Earnest beginnings.

pom.xml

@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>com.samskivert</groupId>
+  <artifactId>jmustache</artifactId>
+  <packaging>jar</packaging>
+  <version>1.1-SNAPSHOT</version>
+  <name>jmustache</name>
+  <description>A Java implementation of the Mustache templating language.</description>
+  <url>http://code.google.com/p/jmustache/</url>
+  <issueManagement>
+    <url>http://code.google.com/p/jmustache/issues/list</url>
+  </issueManagement>
+
+  <parent>
+    <groupId>org.sonatype.oss</groupId>
+    <artifactId>oss-parent</artifactId>
+    <version>5</version>
+  </parent>
+
+  <licenses>
+    <license>
+      <name>GNU Lesser General Public License (LGPL), Version 2.1</name>
+      <url>http://www.fsf.org/licensing/licenses/lgpl.txt</url>
+      <distribution>repo</distribution>
+    </license>
+  </licenses>
+
+  <developers>
+    <developer>
+      <id>samskivert</id>
+      <name>Michael Bayne</name>
+      <email>mdb@samskivert.com</email>
+    </developer>
+  </developers>
+
+  <scm>
+    <connection>scm:svn:http://jmustache.googlecode.com/svn/trunk/</connection>
+    <developerConnection>scm:svn:https://jmustache.googlecode.com/svn/trunk/</developerConnection>
+    <url>http://jmustache.googlecode.com/svn/trunk/</url>
+  </scm>
+
+  <dependencies>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.8.1</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>2.3.2</version>
+        <configuration>
+          <source>1.5</source>
+          <target>1.5</target>
+          <fork>true</fork>
+          <showDeprecation>true</showDeprecation>
+          <showWarnings>true</showWarnings>
+          <!-- yes, those quoted spaces are a workaround sanctioned by the Maven idiocracy -->
+          <compilerArgument>-Xlint" "-Xlint:-serial" "-Xlint:-path</compilerArgument>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-resources-plugin</artifactId>
+        <version>2.4.3</version>
+        <configuration>
+          <encoding>UTF-8</encoding>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <version>2.6</version>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-javadoc-plugin</artifactId>
+        <version>2.7</version>
+        <configuration>
+          <quiet>true</quiet>
+          <show>public</show>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <version>2.3.1</version>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-install-plugin</artifactId>
+        <version>2.3.1</version>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-deploy-plugin</artifactId>
+        <version>2.5</version>
+      </plugin>
+    </plugins>
+  </build>
+
+  <profiles>
+    <profile>
+      <id>release-sign-artifacts</id>
+      <activation>
+        <property><name>performRelease</name><value>true</value></property>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-gpg-plugin</artifactId>
+            <version>1.1</version>
+            <executions>
+              <execution>
+                <id>sign-artifacts</id>
+                <phase>verify</phase>
+                <goals>
+                  <goal>sign</goal>
+                </goals>
+              </execution>
+            </executions>
+            <configuration>
+              <keyname>mdb@samskivert.com</keyname>
+            </configuration>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+  </profiles>
+</project>

src/main/java/com/samskivert/mustache/Mustache.java

@@ -0,0 +1,110 @@
+//
+// $Id$
+
+package com.samskivert.mustache;
+
+import java.io.Reader;
+import java.io.StringReader;
+import java.io.Writer;
+import java.lang.reflect.Array;
+import java.util.Iterator;
+import java.util.Map;
+
+/**
+ * Provides <a href="http://mustache.github.com/">Mustache</a> templating services.
+ */
+public class Mustache
+{
+    /**
+     * Compiles the supplied template into a repeatedly executable intermediate form.
+     */
+    public static Template compile (String template)
+    {
+        return compile(new StringReader(template));
+    }
+
+    /**
+     * Compiles the supplied template into a repeatedly executable intermediate form.
+     */
+    public static Template compile (Reader template)
+    {
+        return null; // TODO
+    }
+
+    private Mustache () {} // no instantiateski
+
+    /** A simple segment that reproduces a string. */
+    protected static class StringSegment extends Template.Segment {
+        public StringSegment (String text) {
+            _text = text;
+        }
+
+        @Override public void execute (Object ctx, Writer out) {
+            write(out, _text);
+        }
+
+        protected final String _text;
+    }
+
+    /** A segment that substitutes the contents of a variable. */
+    protected static class VariableSegment extends Template.Segment {
+        public VariableSegment (String name) {
+            _name = name;
+        }
+
+        @Override public void execute (Object ctx, Writer out)  {
+            Object value = getValue(ctx, _name);
+            // TODO: configurable behavior on missing values
+            if (value != null) {
+                write(out, String.valueOf(value));
+            }
+        }
+
+        protected final String _name;
+    }
+
+    /** A segment that represents a section. */
+    protected static class SectionSegment extends Template.Segment {
+        public SectionSegment (String name, Template.Segment[] segs) {
+            _name = name;
+            _segs = segs;
+        }
+
+        @Override public void execute (Object ctx, Writer out)  {
+            Object value = getValue(ctx, _name);
+            if (value == null) {
+                return; // TODO: configurable behavior on missing values
+            }
+            if (value instanceof Iterable<?>) {
+                Iterable<?> iable = (Iterable<?>)value;
+                for (Object elem : iable) {
+                    executeSegs(elem, out);
+                }
+            } else if (value instanceof Boolean) {
+                if ((Boolean)value) {
+                    executeSegs(ctx, out);
+                }
+            } else if (value.getClass().isArray()) {
+                for (int ii = 0, ll = Array.getLength(value); ii < ll; ii++) {
+                    executeSegs(Array.get(value, ii), out);
+                }
+            } else if (value instanceof Iterator<?>) {
+                Iterator<?> iter = (Iterator<?>)value;
+                while (iter.hasNext()) {
+                    executeSegs(iter.next(), out);
+                }
+            } else {
+                executeSegs(value, out);
+            }
+        }
+
+        protected void executeSegs (Object ctx, Writer out)  {
+            for (Template.Segment seg : _segs) {
+                seg.execute(ctx, out);
+            }
+        }
+
+        protected String _name;
+        protected Template.Segment[] _segs;
+    }
+}

src/main/java/com/samskivert/mustache/MustacheException.java

@@ -0,0 +1,22 @@
+//
+// $Id$
+
+package com.samskivert.mustache;
+
+/**
+ * An exception thrown when an error occurs parsing or executing a Mustache template.
+ */
+public class MustacheException extends RuntimeException
+{
+    public MustacheException (String message) {
+        super(message);
+    }
+
+    public MustacheException (Throwable cause) {
+        super(cause);
+    }
+
+    public MustacheException (String message, Throwable cause) {
+        super(message, cause);
+    }
+}

src/main/java/com/samskivert/mustache/Template.java

@@ -0,0 +1,87 @@
+//
+// $Id$
+
+package com.samskivert.mustache;
+
+import java.io.IOException;
+import java.io.StringWriter;
+import java.io.Writer;
+import java.util.Deque;
+import java.util.Iterator;
+import java.util.LinkedList;
+import java.util.Map;
+
+/**
+ * Represents a compiled template.
+ */
+public class Template
+{
+    /**
+     * Executes this template with the supplied data, writing the results to the supplied writer.
+     *
+     * <p>The data can be any tree of objects. Given a name <code>foo</code>, the following
+     * mechanisms are supported for resolving its value (and are sought in this order):
+     * <ul>
+     * <li>If the object is a {@link Map}, {@link Map#get} will be called with the string
+     * <code>foo</code> as the key.
+     * <li>A method named <code>foo</code> in the supplied object (with non-void return value).
+     * <li>A method named <code>getFoo</code> in the supplied object (with non-void return value).
+     * <li>A field named <code>foo</code> in the supplied object.
+     * </ul>
+     * </p><p> The field type, method return type, or map value type should correspond to the
+     * desired behavior if the resolved name corresponds to a section. {@link Boolean} is used for
+     * showing or hiding sections without binding a sub-context. Arrays, {@link Iterator} and
+     * {@link Iterable} implementations are used for sections that repeat, with the context bound
+     * to the elements of the array, iterator or iterable. Lambdas are current unsupported, though
+     * they would be easy enough to add if desire exists. See the <a
+     * href="http://mustache.github.com/mustache.5.html">Mustache documentation</a> for more
+     * details on section behavior. </p>
+     *
+     * @throws MustacheException if an error occurs while writing the template.
+     */
+    public void execute (Object data, Writer out) throws MustacheException
+    {
+        for (Segment seg : _segs) {
+            seg.execute(data, out);
+        }
+    }
+
+    /**
+     * Executes this template with the supplied data, returning the results as a string. See {@link
+     * #execute(Object, Writer).
+     *
+     * @throws MustacheException if an error occurs while writing the template.
+     */
+    public String execute (Object data) throws MustacheException
+    {
+        StringWriter out = new StringWriter();
+        execute(data, out);
+        return out.toString();
+    }
+
+    protected Template (Segment[] segs)
+    {
+        _segs = segs;
+    }
+
+    /** A template is broken into segments. */
+    protected static abstract class Segment
+    {
+        abstract void execute (Object ctx, Writer out);
+
+        protected Object getValue (Object ctx, String name) {
+            // TODO: support things other than values
+            return ((Map<?,?>)ctx).get(name);
+        }
+
+        protected static void write (Writer out, String data) {
+            try {
+                out.write(data);
+            } catch (IOException ioe) {
+                throw new MustacheException(ioe);
+            }
+        }
+    }
+
+    protected final Segment[] _segs;
+}