librelist archives

« back to archive

Mustache Specification Release Candidate

Mustache Specification Release Candidate

From:
Pieter V.
Date:
2010-12-26 @ 04:53
Mustache's specification has just been tagged *v1.0.0rc2*.

*What It Is*: The Mustache specification is a set of YAML files containing
test cases for proving implementation conformance.
*
*
*Where It Is:* https://github.com/mustache/spec

*Which Implementations Conform:* The HEAD of the Ruby standard
implementation (https://github.com/defunkt/mustache) currently passes the
entire suite of tests, and the fresh new Milk module (
https://github.com/pvande/Milk) has been written from the ground up in
CoffeeScript targeting the specification.

*Does My Implementation Need To Support This:* No -- this is still a draft
of the specification, and while implementations are encouraged to begin
implementing support, this is not currently a requirement.  When v1.0.0 of
the spec is released, support can be expected from all Mustache
implementations.

*What Do You Still Need:* At this point, the spec has grown to cover many
common inconsistencies between implementations, and tries to demonstrate
cases where certain "optimizations" go awry.  It also tries to specify
behaviors that result in clean output across the board, whether being used
for HTML, JSON, Python or plain text.  *From users*, we most need examples
of issues where the current specification lets you down -- where rendered
output is *non-functional* or *suboptimal*.  *From implementors*, we need to
hear your concerns.  Is there an *edge-case* that we don't cover?  Is there
a *behavior specification* that you disagree with?  Do you have
*questions* about
what a spec tests, or how to pass it?  *Everyone*, please file your examples
and arguments with *the mustache/spec Issues page* (
https://github.com/mustache/spec/issues).

*Wait, rc2?  What About rc1:* Due to various factors, v1.0.0rc1 was never
prominently published or announced.  The current shipping version of the
Mustache gem 
(v0.12.0<https://github.com/defunkt/mustache/commit/287cbf402684b88caec7701c492ffad08e57075e>)
does implement support for it, however.


Merry Christmas to all, and Happy Hacking!