ballast 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 463cb004e99736cfb55f1584675a52703512152c
-  data.tar.gz: 20a3acc71cb71779579b0dd078888cda80829f76
+  metadata.gz: 72d9e7b1097d75ed1e9fe9e8e056bc54b2d9f29a
+  data.tar.gz: 706a582324c381cd7f9e90b89d6fb38e6ab3a1b0
 SHA512:
-  metadata.gz: 4a5a813ea90cc5ed5b344eeeb75c0cc2574c95295e48969522c737908dee2866bb66db94d2d37109b54d6f6cbda4e560406834a23a29d9f83eab55cf887faf91
-  data.tar.gz: c119cbe42811bb8042975c3088a36816f6e76918669f57247796bb174ddd77a1923960b7f1f11b446916290fe62f02cb797c5019eb60179b010b3fc7d16d53a8
+  metadata.gz: 70620c392ea9e428046389ebf1407cbe5fc0a5b82ab85838173327a950a6efd15b768a6bb605c293c75fe6a0d5326081368ab6f8f32013308660f12ebb42c32c
+  data.tar.gz: a2a106dde8f4bf944dbd53a72c5b830a1ff01c9eecbe84a161d61a46ab5f56a896091039e5ccb3d3a823413b8a931c8ed896e1e6542f38200d7d97a29b0478ee

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+### 1.7.0 / 2014-01-25
+
+* Added `Ballast::Concerns::View::set_layout_params`.
+* Added `Ballast::Concerns::View::layout_params`.
+* Added `Ballast::Concerns::View::layout_param`.
+
 ### 1.6.0 / 2014-01-25
 
 * `Ballast::Concerns::Ajax#allow_cors`'s parameters are now customizable.

data/ballast.gemspec

@@ -26,10 +26,10 @@ Gem::Specification.new do |gem|
 
   gem.add_dependency("actionpack", ">= 4.0.0")
   gem.add_dependency("rack", "~> 1.5.2")
-  gem.add_dependency("oj", "~> 2.5.3")
+  gem.add_dependency("oj", "~> 2.5.4")
   gem.add_dependency("brauser", "~> 3.2.5")
   gem.add_dependency("interactor", "~> 2.1.0")
   gem.add_dependency("addressable", "~> 2.3.5")
   gem.add_dependency("rack-fiber_pool", ">= 0.9.3")
   gem.add_dependency("em-synchrony", "~> 1.0.3")
-end
+end

data/doc/Ballast.html

@@ -121,7 +121,7 @@ Licensed under the MIT license, which can be found at http://www.opensource.org/
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Concerns.html

@@ -118,7 +118,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Concerns/Ajax.html

@@ -895,7 +895,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Concerns/Common.html

@@ -1098,7 +1098,7 @@ and <code>%:Z</code> for the zone name considering also DST.</p>
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Concerns/ErrorsHandling.html

@@ -291,7 +291,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Concerns/View.html

@@ -198,6 +198,31 @@
     <span class="summary_desc"><div class='inline'><p>Outputs the Javascript parameters.</p>
 </div></span>
   
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#layout_params-instance_method" title="#layout_params (instance method)">- (Object|Hash) <strong>layout_params</strong>(key = nil, default_value = nil) </a>
+    
+
+    
+      (also: #layout_param)
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Returns one or all layout parameters.</p>
+</div></span>
+  
 </li>
 
       
@@ -221,6 +246,29 @@
     <span class="summary_desc"><div class='inline'><p>Scopes the CSS of the current page using the controller and action name.</p>
 </div></span>
   
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#set_layout_params-instance_method" title="#set_layout_params (instance method)">- (Object) <strong>set_layout_params</strong>(**args) </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Adds/Replaces layout parameters.</p>
+</div></span>
+  
 </li>
 
       
@@ -309,25 +357,25 @@
       <pre class="lines">
 
 
-47
-48
-49
-50
-51
-52
-53
-54
-55
-56
-57
-58
-59</pre>
+67
+68
+69
+70
+71
+72
+73
+74
+75
+76
+77
+78
+79</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ballast/concerns/view.rb', line 47</span>
+      <pre class="code"><span class="info file"># File 'lib/ballast/concerns/view.rb', line 67</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_add_javascript_params'>add_javascript_params</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_data'>data</span><span class='comma'>,</span> <span class='id identifier rubyid_replace'>replace</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
-  <span class='ivar'>@javascript_params</span> <span class='op'>||=</span> <span class='const'>HashWithIndifferentAccess</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+  <span class='id identifier rubyid_initialize_view_params'>initialize_view_params</span>
 
   <span class='kw'>if</span> <span class='id identifier rubyid_key'>key</span>
     <span class='ivar'>@javascript_params</span><span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='kw'>if</span> <span class='id identifier rubyid_replace'>replace</span>
@@ -561,15 +609,118 @@
       <pre class="lines">
 
 
+57
+58
+59
+60</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ballast/concerns/view.rb', line 57</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_javascript_params'>javascript_params</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_tag'>tag</span> <span class='op'>=</span> <span class='symbol'>:details</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_initialize_view_params'>initialize_view_params</span>
+  <span class='id identifier rubyid_id'>id</span> <span class='op'>?</span> <span class='id identifier rubyid_content_tag'>content_tag</span><span class='lparen'>(</span><span class='id identifier rubyid_tag'>tag</span><span class='comma'>,</span> <span class='ivar'>@javascript_params</span><span class='period'>.</span><span class='id identifier rubyid_to_json'>to_json</span><span class='period'>.</span><span class='id identifier rubyid_html_safe'>html_safe</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>data-jid</span><span class='tstring_end'>&quot;</span></span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span><span class='op'>:</span> <span class='ivar'>@javascript_params</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="layout_params-instance_method">
+  
+    - (<tt>Object|Hash</tt>) <strong>layout_params</strong>(key = nil, default_value = nil) 
+  
+
+  
+    <span class="aliases">Also known as:
+    <span class="names"><span id='layout_param-instance_method'>layout_param</span></span>
+    </span>
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Returns one or all layout parameters.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>key</span>
+      
+      
+        <span class='type'>(<tt>String|Symbol|NilClass</tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+      
+      
+        &mdash;
+        <div class='inline'><p>The parameter to return. If set to <code>nil</code>, all the parameters will be returned as an hash.</p>
+</div>
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>default_value</span>
+      
+      
+        <span class='type'>(<tt>Object</tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+      
+      
+        &mdash;
+        <div class='inline'><p>The default value if the parameter is not present.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Object|Hash</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>The parameter or the entire layout parameters hash.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
 38
 39
-40</pre>
+40
+41</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/ballast/concerns/view.rb', line 38</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_javascript_params'>javascript_params</span><span class='lparen'>(</span><span class='id identifier rubyid_id'>id</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_tag'>tag</span> <span class='op'>=</span> <span class='symbol'>:details</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_id'>id</span> <span class='op'>?</span> <span class='id identifier rubyid_content_tag'>content_tag</span><span class='lparen'>(</span><span class='id identifier rubyid_tag'>tag</span><span class='comma'>,</span> <span class='ivar'>@javascript_params</span><span class='period'>.</span><span class='id identifier rubyid_to_json'>to_json</span><span class='period'>.</span><span class='id identifier rubyid_html_safe'>html_safe</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>data-jid</span><span class='tstring_end'>&quot;</span></span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span><span class='op'>:</span> <span class='ivar'>@javascript_params</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_layout_params'>layout_params</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_default_value'>default_value</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_initialize_view_params'>initialize_view_params</span>
+  <span class='id identifier rubyid_key'>key</span> <span class='op'>?</span> <span class='ivar'>@layout_params</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_default_value'>default_value</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='ivar'>@layout_params</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -631,6 +782,67 @@
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="set_layout_params-instance_method">
+  
+    - (<tt>Object</tt>) <strong>set_layout_params</strong>(**args) 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Adds/Replaces layout parameters.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>args</span>
+      
+      
+        <span class='type'>(<tt>Hash</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>The new parameters to add.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+47
+48
+49
+50</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ballast/concerns/view.rb', line 47</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_set_layout_params'>set_layout_params</span><span class='lparen'>(</span><span class='op'>**</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_initialize_view_params'>initialize_view_params</span>
+  <span class='ivar'>@layout_params</span><span class='period'>.</span><span class='id identifier rubyid_merge!'>merge!</span><span class='lparen'>(</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
   </div>
@@ -638,7 +850,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Configuration.html

@@ -273,7 +273,7 @@ Subfolders are not supported.</p>
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Context.html

@@ -408,7 +408,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Errors.html

@@ -116,7 +116,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Errors/BaseError.html

@@ -317,7 +317,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Errors/InvalidDomain.html

@@ -148,7 +148,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Errors/PerformError.html

@@ -148,7 +148,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Errors/ValidationError.html

@@ -148,7 +148,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Middlewares.html

@@ -116,7 +116,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Middlewares/DefaultHost.html

@@ -345,7 +345,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:01 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Operation.html

@@ -1295,7 +1295,7 @@ as owner will be created.</p>
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/OperationsChain.html

@@ -588,7 +588,7 @@ as owner will be created.</p>
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/RequestDomainMatcher.html

@@ -908,7 +908,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:05 2014 by
+  Generated on Sat Jan 25 13:47:01 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/Ballast/Version.html

@@ -134,7 +134,7 @@
 
 </div>
         </dt>
-        <dd><pre class="code"><span class='int'>6</span></pre></dd>
+        <dd><pre class="code"><span class='int'>7</span></pre></dd>
       
         <dt id="PATCH-constant" class="">PATCH =
           <div class="docstring">
@@ -180,7 +180,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/_index.html

@@ -310,7 +310,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:46:59 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/file.README.html

@@ -106,7 +106,7 @@
 </div></div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/index.html

@@ -106,7 +106,7 @@
 </div></div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/doc/method_list.html

@@ -150,32 +150,32 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ballast/OperationsChain.html#initialize-instance_method" title="Ballast::OperationsChain#initialize (method)">#initialize</a></span>
-    <small>Ballast::OperationsChain</small>
+    <span class='object_link'><a href="Ballast/Configuration.html#initialize-instance_method" title="Ballast::Configuration#initialize (method)">#initialize</a></span>
+    <small>Ballast::Configuration</small>
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ballast/Middlewares/DefaultHost.html#initialize-instance_method" title="Ballast::Middlewares::DefaultHost#initialize (method)">#initialize</a></span>
-    <small>Ballast::Middlewares::DefaultHost</small>
+    <span class='object_link'><a href="Ballast/Errors/BaseError.html#initialize-instance_method" title="Ballast::Errors::BaseError#initialize (method)">#initialize</a></span>
+    <small>Ballast::Errors::BaseError</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ballast/Configuration.html#initialize-instance_method" title="Ballast::Configuration#initialize (method)">#initialize</a></span>
-    <small>Ballast::Configuration</small>
+    <span class='object_link'><a href="Ballast/Middlewares/DefaultHost.html#initialize-instance_method" title="Ballast::Middlewares::DefaultHost#initialize (method)">#initialize</a></span>
+    <small>Ballast::Middlewares::DefaultHost</small>
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ballast/Errors/BaseError.html#initialize-instance_method" title="Ballast::Errors::BaseError#initialize (method)">#initialize</a></span>
-    <small>Ballast::Errors::BaseError</small>
+    <span class='object_link'><a href="Ballast/RequestDomainMatcher.html#initialize-instance_method" title="Ballast::RequestDomainMatcher#initialize (method)">#initialize</a></span>
+    <small>Ballast::RequestDomainMatcher</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ballast/RequestDomainMatcher.html#initialize-instance_method" title="Ballast::RequestDomainMatcher#initialize (method)">#initialize</a></span>
-    <small>Ballast::RequestDomainMatcher</small>
+    <span class='object_link'><a href="Ballast/OperationsChain.html#initialize-instance_method" title="Ballast::OperationsChain#initialize (method)">#initialize</a></span>
+    <small>Ballast::OperationsChain</small>
   </li>
   
 
@@ -204,14 +204,14 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ballast/RequestDomainMatcher.html#matches%3F-instance_method" title="Ballast::RequestDomainMatcher#matches? (method)">#matches?</a></span>
-    <small>Ballast::RequestDomainMatcher</small>
+    <span class='object_link'><a href="Ballast/Concerns/View.html#layout_params-instance_method" title="Ballast::Concerns::View#layout_params (method)">#layout_params</a></span>
+    <small>Ballast::Concerns::View</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ballast/Context.html#method_missing-instance_method" title="Ballast::Context#method_missing (method)">#method_missing</a></span>
-    <small>Ballast::Context</small>
+    <span class='object_link'><a href="Ballast/RequestDomainMatcher.html#matches%3F-instance_method" title="Ballast::RequestDomainMatcher#matches? (method)">#matches?</a></span>
+    <small>Ballast::RequestDomainMatcher</small>
   </li>
   
 
@@ -222,13 +222,13 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ballast/OperationsChain.html#operations-instance_method" title="Ballast::OperationsChain#operations (method)">#operations</a></span>
-    <small>Ballast::OperationsChain</small>
+    <span class='object_link'><a href="Ballast/Context.html#method_missing-instance_method" title="Ballast::Context#method_missing (method)">#method_missing</a></span>
+    <small>Ballast::Context</small>
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ballast/OperationsChain.html#perform-class_method" title="Ballast::OperationsChain.perform (method)">perform</a></span>
+    <span class='object_link'><a href="Ballast/OperationsChain.html#operations-instance_method" title="Ballast::OperationsChain#operations (method)">#operations</a></span>
     <small>Ballast::OperationsChain</small>
   </li>
   
@@ -240,83 +240,95 @@
   
 
   <li class="r1 ">
+    <span class='object_link'><a href="Ballast/OperationsChain.html#perform-class_method" title="Ballast::OperationsChain.perform (method)">perform</a></span>
+    <small>Ballast::OperationsChain</small>
+  </li>
+  
+
+  <li class="r2 ">
     <span class='object_link'><a href="Ballast/Concerns/Common.html#perform_operation-instance_method" title="Ballast::Concerns::Common#perform_operation (method)">#perform_operation</a></span>
     <small>Ballast::Concerns::Common</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="Ballast/Concerns/Common.html#perform_operations_chain-instance_method" title="Ballast::Concerns::Common#perform_operations_chain (method)">#perform_operations_chain</a></span>
     <small>Ballast::Concerns::Common</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="Ballast/Operation.html#perform_with_handling-instance_method" title="Ballast::Operation#perform_with_handling (method)">#perform_with_handling</a></span>
     <small>Ballast::Operation</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="Ballast/Concerns/Ajax.html#prepare_ajax-instance_method" title="Ballast::Concerns::Ajax#prepare_ajax (method)">#prepare_ajax</a></span>
     <small>Ballast::Concerns::Ajax</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="Ballast/Concerns/Ajax.html#prevent_caching-instance_method" title="Ballast::Concerns::Ajax#prevent_caching (method)">#prevent_caching</a></span>
     <small>Ballast::Concerns::Ajax</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="Ballast/RequestDomainMatcher.html#replace_block-instance_method" title="Ballast::RequestDomainMatcher#replace_block (method)">#replace_block</a></span>
     <small>Ballast::RequestDomainMatcher</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="Ballast/RequestDomainMatcher.html#replace_pattern-instance_method" title="Ballast::RequestDomainMatcher#replace_pattern (method)">#replace_pattern</a></span>
     <small>Ballast::RequestDomainMatcher</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="Ballast/RequestDomainMatcher.html#replace_string-instance_method" title="Ballast::RequestDomainMatcher#replace_string (method)">#replace_string</a></span>
     <small>Ballast::RequestDomainMatcher</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="Ballast/Operation.html#resolve_error-instance_method" title="Ballast::Operation#resolve_error (method)">#resolve_error</a></span>
     <small>Ballast::Operation</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="Ballast/Errors/BaseError.html#response-instance_method" title="Ballast::Errors::BaseError#response (method)">#response</a></span>
     <small>Ballast::Errors::BaseError</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="Ballast/Concerns/View.html#scope_css-instance_method" title="Ballast::Concerns::View#scope_css (method)">#scope_css</a></span>
     <small>Ballast::Concerns::View</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="Ballast/Concerns/Ajax.html#send_ajax-instance_method" title="Ballast::Concerns::Ajax#send_ajax (method)">#send_ajax</a></span>
     <small>Ballast::Concerns::Ajax</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="Ballast/Concerns/Common.html#sending_data%3F-instance_method" title="Ballast::Concerns::Common#sending_data? (method)">#sending_data?</a></span>
     <small>Ballast::Concerns::Common</small>
   </li>
   
 
+  <li class="r1 ">
+    <span class='object_link'><a href="Ballast/Concerns/View.html#set_layout_params-instance_method" title="Ballast::Concerns::View#set_layout_params (method)">#set_layout_params</a></span>
+    <small>Ballast::Concerns::View</small>
+  </li>
+  
+
   <li class="r2 ">
     <span class='object_link'><a href="Ballast/Operation.html#setup_response-instance_method" title="Ballast::Operation#setup_response (method)">#setup_response</a></span>
     <small>Ballast::Operation</small>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan 25 11:54:04 2014 by
+  Generated on Sat Jan 25 13:47:00 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.3 (ruby-2.1.0).
 </div>

data/lib/ballast/concerns/view.rb

@@ -30,12 +30,32 @@ module Ballast
         browser.supported?(conf_file)
       end
 
+      # Returns one or all layout parameters.
+      #
+      # @param key [String|Symbol|NilClass] The parameter to return. If set to `nil`, all the parameters will be returned as an hash.
+      # @param default_value [Object] The default value if the parameter is not present.
+      # @return [Object|Hash] The parameter or the entire layout parameters hash.
+      def layout_params(key = nil, default_value = nil)
+        initialize_view_params
+        key ? @layout_params.fetch(key, default_value) : @layout_params
+      end
+      alias_method :layout_param, :layout_params
+
+      # Adds/Replaces layout parameters.
+      #
+      # @param args [Hash] The new parameters to add.
+      def set_layout_params(**args)
+        initialize_view_params
+        @layout_params.merge!(args)
+      end
+
       # Outputs the Javascript parameters.
       #
       # @param id [String|NilClass|FalseClass] The id for the tag. If `nil` or `false`, the parameters will be returned as an hash.
       # @param tag [Symbol] The tag to use for HTML.
       # @return [String|Hash] Javascript parameters as HTML or the hash.
       def javascript_params(id = nil, tag = :details)
+        initialize_view_params
         id ? content_tag(tag, @javascript_params.to_json.html_safe, "data-jid" => id): @javascript_params
       end
 
@@ -45,7 +65,7 @@ module Ballast
       # @param data [Hash] The data to add.
       # @param replace [Boolean] Whether to replace existing data rather than merge.
       def add_javascript_params(key, data, replace = false)
-        @javascript_params ||= HashWithIndifferentAccess.new
+        initialize_view_params
 
         if key
           @javascript_params[key] = nil if replace
@@ -57,6 +77,13 @@ module Ballast
           @javascript_params.merge!(data)
         end
       end
+
+      private
+        # Prepares parameters for views.
+        def initialize_view_params
+          @layout_params ||= HashWithIndifferentAccess.new
+          @javascript_params ||= HashWithIndifferentAccess.new
+        end
     end
   end
 end

data/lib/ballast/version.rb

@@ -13,7 +13,7 @@ module Ballast
     MAJOR = 1
 
     # The minor version.
-    MINOR = 6
+    MINOR = 7
 
     # The patch version.
     PATCH = 0

data/spec/ballast/concerns/view_spec.rb

@@ -55,6 +55,37 @@ describe Ballast::Concerns::View do
     end
   end
 
+  describe "#layout_params" do
+    it "should return a single parameter" do
+      subject.set_layout_params(a: 1)
+      expect(subject.layout_params(:a)).to eq(1)
+    end
+
+    it "should return a default value for a missing parameter" do
+      subject.set_layout_params(a: 1)
+      expect(subject.layout_params(:b, 2)).to eq(2)
+    end
+
+    it "should never raise an error" do
+      expect(subject.layout_params(:a)).to be_nil
+      expect(subject.layout_params(:a, 3)).to eq(3)
+    end
+
+    it "should return the entire hash if no arguments are passed" do
+      expect(subject.layout_params).to eq({})
+      subject.set_layout_params(a: 1)
+      expect(subject.layout_params).to eq({"a" => 1})
+    end
+  end
+
+  describe "#set_layout_params" do
+    it "should merge arguments into the existing parameters" do
+      expect(subject.layout_params).to eq({})
+      subject.set_layout_params(a: 1, b: 2)
+      expect(subject.layout_params).to eq({"a" => 1, "b" => 2})
+    end
+  end
+
   describe "#javascript_params" do
     before(:each) do
       subject.instance_variable_set(:@javascript_params, {a: "1", b: 2})

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ballast
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Shogun
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.5.3
+        version: 2.5.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.5.3
+        version: 2.5.4
 - !ruby/object:Gem::Dependency
   name: brauser
   requirement: !ruby/object:Gem::Requirement