v5.5

groue · Oct 20, 2012 · c834a75 · c834a75
1 parent f39e303
commit c834a75
Show file tree

Hide file tree

Showing 38 changed files with 1,026 additions and 67 deletions.
diff --git a/AppledocSettings.plist b/AppledocSettings.plist
@@ -3,9 +3,9 @@
 <plist version="1.0">
 <dict>
 	<key>--project-name</key>
-	<string>GRMustache 5.4</string>
+	<string>GRMustache 5.5</string>
 	<key>--project-version</key>
-	<string>5.4</string>
+	<string>5.5</string>
 	<key>--project-company</key>
 	<string>Gwendal Roué</string>
 	<key>--create-html</key>

diff --git a/README.md b/README.md
@@ -3,7 +3,7 @@ GRMustache
 
 GRMustache is a production-ready implementation of [Mustache](http://mustache.github.com/) templates for MacOS Cocoa and iOS.
 
-**October 11th, 2012: GRMustache 5.4.4 is out.** [Release notes](GRMustache/blob/master/RELEASE_NOTES.md)
+**October 20th, 2012: GRMustache 5.5 is out.** [Release notes](GRMustache/blob/master/RELEASE_NOTES.md)
 
 Don't miss a single release: follow [@GRMustache](http://twitter.com/GRMustache) on Twitter.
 
@@ -17,7 +17,7 @@ How To
 - For MacOS development, add `include/GRMustache.h` and `lib/libGRMustache5-MacOS.a` to your project.
 - For iOS development, add `include/GRMustache.h` and `lib/libGRMustache5-iOS.a` to your project.
 
-Alternatively, you may use [CocoaPods](https://github.com/CocoaPods/CocoaPods): append `pod 'GRMustache', '~> 5.4'` to your Podfile.
+Alternatively, you may use [CocoaPods](https://github.com/CocoaPods/CocoaPods): append `pod 'GRMustache', '~> 5.5'` to your Podfile.
 
 GRMustache targets MacOS down to 10.6 Snow Leopard, iOS down to version 4.3, and only depends on the Foundation framework.
 

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -4,6 +4,19 @@ GRMustache Release Notes
 You can compare the performances of GRMustache versions at https://github.com/groue/GRMustacheBenchmark.
 
 
+## v5.5
+
+### Variadic filters
+
+Filters can now take several arguments: `{{ f(a,b) }}`. Check [Guides/filters.md](Guides/filters.md).
+
+### GRMustacheProxy
+
+Proxies are a tool for the developer who wants to write reusable and robust filters, helpers, and template delegates that extend the abilities of the rendered data. Check [Guides/proxies.md](Guides/proxies.md).
+
+The [array indexes.md](Guides/sample_code/indexes.md) sample code now uses proxies. The visible benefit is that the sample code is shorter. It is also more robust. Before proxies were introduced, we used not to be able to properly render indexes for "special" array items such as NSNull, false booleans, or helpers. Proxies are really all about robustness.
+
+
 ## v5.4.4
 
 - Fix a memory leak in [overridable partials](Guides/partials.md).

diff --git a/Reference/html/Classes/GRMustache.html b/Reference/html/Classes/GRMustache.html
@@ -12,7 +12,7 @@
 	<body>
 		<header id="top_header">
 			<div id="library" class="hideInXcode">
-				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.4 </a></h1>
+				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.5 </a></h1>
 				<a id="developerHome" href="../index.html">Gwendal Roué</a>
 			</div>
 
@@ -306,7 +306,7 @@ <h4 class="method-subtitle">Declared In</h4>
 				<div id="footer">
 					<hr />
 					<div class="footer-copyright">
-						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-09-28)</span><br />
+						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-10-20)</span><br />
 
 						<span class="generator">Generated by <a href="http://appledoc.gentlebytes.com">appledoc 2.0.6 (build 789)</a>.</span></p>
 

diff --git a/Reference/html/Classes/GRMustacheDynamicPartial.html b/Reference/html/Classes/GRMustacheDynamicPartial.html
@@ -12,7 +12,7 @@
 	<body>
 		<header id="top_header">
 			<div id="library" class="hideInXcode">
-				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.4 </a></h1>
+				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.5 </a></h1>
 				<a id="developerHome" href="../index.html">Gwendal Roué</a>
 			</div>
 
@@ -229,7 +229,7 @@ <h4 class="method-subtitle">Declared In</h4>
 				<div id="footer">
 					<hr />
 					<div class="footer-copyright">
-						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-09-28)</span><br />
+						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-10-20)</span><br />
 
 						<span class="generator">Generated by <a href="http://appledoc.gentlebytes.com">appledoc 2.0.6 (build 789)</a>.</span></p>
 

diff --git a/Reference/html/Classes/GRMustacheFilter.html b/Reference/html/Classes/GRMustacheFilter.html
@@ -12,7 +12,7 @@
 	<body>
 		<header id="top_header">
 			<div id="library" class="hideInXcode">
-				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.4 </a></h1>
+				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.5 </a></h1>
 				<a id="developerHome" href="../index.html">Gwendal Roué</a>
 			</div>
 
@@ -44,6 +44,8 @@ <h1 class="hideInXcode">GRMustacheFilter Class Reference</h1>
 
 	<option value="//api/name/filterWithBlock:">&nbsp;&nbsp;&nbsp;&nbsp;+ filterWithBlock:</option>
 
+	<option value="//api/name/variadicFilterWithBlock:">&nbsp;&nbsp;&nbsp;&nbsp;+ variadicFilterWithBlock:</option>
+
 
 
 
@@ -76,6 +78,8 @@ <h1 class="hideInXcode">GRMustacheFilter Class Reference</h1>
 
 	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/filterWithBlock:">filterWithBlock:</a></span></li>
 
+	<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/variadicFilterWithBlock:">variadicFilterWithBlock:</a></span></li>
+
 </ul></li>
 
 
@@ -145,6 +149,14 @@ <h3 class="subsubtitle task-title">Creating Filters</h3>
 	</span>
 
 
+</li><li>
+	<span class="tooltip">
+		<code><a href="#//api/name/variadicFilterWithBlock:">+&nbsp;variadicFilterWithBlock:</a></code>
+		<span class="tooltip"><p>Returns a GRMustacheFilter object that executes the provided block, given an
+array of arguments.</p></span>
+	</span>
+
+
 </li>
 						</ul>
 
@@ -207,6 +219,91 @@ <h4 class="method-subtitle parameter-title">Availability</h4>
 
 
 
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+
+			<li><code><p><a href="#//api/name/variadicFilterWithBlock:">+ variadicFilterWithBlock:</a></p></code></li>
+
+		</ul>
+	</div>
+
+
+
+	<div class="method-subsection declared-in-section">
+		<h4 class="method-subtitle">Declared In</h4>
+		<code class="declared-in-ref">GRMustacheFilter.h</code><br />
+	</div>				
+
+
+</div>
+
+						<div class="section-method">
+	<a name="//api/name/variadicFilterWithBlock:" title="variadicFilterWithBlock:"></a>
+	<h3 class="subsubtitle method-title">variadicFilterWithBlock:</h3>
+
+
+
+	<div class="method-subsection brief-description">
+		<p>Returns a GRMustacheFilter object that executes the provided block, given an
+array of arguments.</p>
+	</div>		
+
+
+
+	<div class="method-subsection method-declaration"><code>+ (id)variadicFilterWithBlock:(id ( ^ ) ( NSArray *arguments ))<em>block</em></code></div>
+
+
+
+	<div class="method-subsection arguments-section parameters">
+		<h4 class="method-subtitle parameter-title">Parameters</h4>
+
+		<dl class="argument-def parameter-def">
+			<dt><em>block</em></dt>
+			<dd><p>The block that transforms its input.</p></dd>
+		</dl>
+
+	</div>
+
+
+
+	<div class="method-subsection return">
+		<h4 class="method-subtitle parameter-title">Return Value</h4>
+		<p>a GRMustacheFilter object.</p>
+	</div>
+
+
+
+	<div class="method-subsection availability">
+		<h4 class="method-subtitle parameter-title">Availability</h4>
+		<p>v5.5</p>
+	</div>
+
+
+
+	<div class="method-subsection discussion-section">
+		<h4 class="method-subtitle">Discussion</h4>
+		<p>Those filters can evaluate expressions like <code>{{ f(a,b) }}</code>.</p>
+
+<p><a href="../Classes/GRMustache.html">GRMustache</a> will invoke the filter regardless of the number of arguments in
+the template: <code>{{ f(a) }}</code>, <code>{{ f(a,b) }}</code> and <code>{{ f(a,b,c) }}</code> will provide
+arrays of 1, 2, and 3 arguments respectively. It is your responsability to
+check that you are provided with as many arguments as you expect.</p>
+	</div>
+
+
+
+
+
+	<div class="method-subsection see-also-section">
+		<h4 class="method-subtitle">See Also</h4>
+		<ul>
+
+			<li><code><p><a href="#//api/name/filterWithBlock:">+ filterWithBlock:</a></p></code></li>
+
+		</ul>
+	</div>
+
 
 
 	<div class="method-subsection declared-in-section">
@@ -232,7 +329,7 @@ <h4 class="method-subtitle">Declared In</h4>
 				<div id="footer">
 					<hr />
 					<div class="footer-copyright">
-						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-09-28)</span><br />
+						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-10-20)</span><br />
 
 						<span class="generator">Generated by <a href="http://appledoc.gentlebytes.com">appledoc 2.0.6 (build 789)</a>.</span></p>
 

diff --git a/Reference/html/Classes/GRMustacheHelper.html b/Reference/html/Classes/GRMustacheHelper.html
@@ -12,7 +12,7 @@
 	<body>
 		<header id="top_header">
 			<div id="library" class="hideInXcode">
-				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.4 </a></h1>
+				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.5 </a></h1>
 				<a id="developerHome" href="../index.html">Gwendal Roué</a>
 			</div>
 
@@ -225,7 +225,7 @@ <h4 class="method-subtitle">Declared In</h4>
 				<div id="footer">
 					<hr />
 					<div class="footer-copyright">
-						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-09-28)</span><br />
+						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-10-20)</span><br />
 
 						<span class="generator">Generated by <a href="http://appledoc.gentlebytes.com">appledoc 2.0.6 (build 789)</a>.</span></p>
 

diff --git a/Reference/html/Classes/GRMustacheInvocation.html b/Reference/html/Classes/GRMustacheInvocation.html
@@ -12,7 +12,7 @@
 	<body>
 		<header id="top_header">
 			<div id="library" class="hideInXcode">
-				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.4 </a></h1>
+				<h1><a id="libraryTitle" href="../index.html">GRMustache 5.5 </a></h1>
 				<a id="developerHome" href="../index.html">Gwendal Roué</a>
 			</div>
 
@@ -307,7 +307,7 @@ <h4 class="method-subtitle">Declared In</h4>
 				<div id="footer">
 					<hr />
 					<div class="footer-copyright">
-						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-09-28)</span><br />
+						<p><span class="copyright">&copy; 2012 Gwendal Roué. All rights reserved. (Last updated: 2012-10-20)</span><br />
 
 						<span class="generator">Generated by <a href="http://appledoc.gentlebytes.com">appledoc 2.0.6 (build 789)</a>.</span></p>