ballast 1.5.3 → 1.6.0

data/doc/Ballast/Concerns/ErrorsHandling.html

@@ -291,7 +291,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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

@@ -638,7 +638,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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

@@ -260,7 +260,7 @@ Subfolders are not supported.</p>
     <span class='kw'>self</span><span class='lbracket'>[</span><span class='id identifier rubyid_section'>section</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_content'>content</span><span class='lbracket'>[</span><span class='id identifier rubyid_environment'>environment</span><span class='rbracket'>]</span>
   <span class='kw'>end</span>
 
-  <span class='id identifier rubyid_enable_dotted_access'>enable_dotted_access</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span>
+  <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_enable_dotted_access'>enable_dotted_access</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -273,7 +273,7 @@ Subfolders are not supported.</p>
 </div>
 
     <div id="footer">
-  Generated on Sat Jan  4 16:26:01 2014 by
+  Generated on Sat Jan 25 11:54:05 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:05 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:05 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:05 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:05 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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  4 16:26:01 2014 by
+  Generated on Sat Jan 25 11:54:05 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  4 16:26:01 2014 by
+  Generated on Sat Jan 25 11:54:05 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

@@ -302,8 +302,7 @@
 32
 33
 34
-35
-36</pre>
+35</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/ballast/operations_chain.rb', line 32</span>
@@ -311,7 +310,6 @@
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='id identifier rubyid_operations'>operations</span><span class='comma'>,</span> <span class='id identifier rubyid_context'>context</span><span class='rparen'>)</span>
   <span class='ivar'>@context</span> <span class='op'>=</span> <span class='id identifier rubyid_context'>context</span>
   <span class='ivar'>@operations</span> <span class='op'>=</span> <span class='id identifier rubyid_operations'>operations</span><span class='period'>.</span><span class='id identifier rubyid_ensure_array'>ensure_array</span>
-  <span class='id identifier rubyid_setup'>setup</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -403,7 +401,14 @@
 34
 35
 36
-37</pre>
+37
+38
+39
+40
+41
+42
+43
+44</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/ballast/operations_chain.rb', line 11</span>
@@ -432,8 +437,15 @@
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='id identifier rubyid_operations'>operations</span><span class='comma'>,</span> <span class='id identifier rubyid_context'>context</span><span class='rparen'>)</span>
     <span class='ivar'>@context</span> <span class='op'>=</span> <span class='id identifier rubyid_context'>context</span>
     <span class='ivar'>@operations</span> <span class='op'>=</span> <span class='id identifier rubyid_operations'>operations</span><span class='period'>.</span><span class='id identifier rubyid_ensure_array'>ensure_array</span>
-    <span class='id identifier rubyid_setup'>setup</span>
   <span class='kw'>end</span>
+
+  <span class='id identifier rubyid_private'>private</span>
+    <span class='comment'># Returns the operations to perform.
+</span>    <span class='comment'>#
+</span>    <span class='comment'># @return [Array] An array of operations to perform.
+</span>    <span class='kw'>def</span> <span class='id identifier rubyid_interactors'>interactors</span>
+      <span class='ivar'>@operations</span>
+    <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -576,7 +588,7 @@ as owner will be created.</p>
 </div>
 
     <div id="footer">
-  Generated on Sat Jan  4 16:26:01 2014 by
+  Generated on Sat Jan 25 11:54:05 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  4 16:26:01 2014 by
+  Generated on Sat Jan 25 11:54:05 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'>5</span></pre></dd>
+        <dd><pre class="code"><span class='int'>6</span></pre></dd>
       
         <dt id="PATCH-constant" class="">PATCH =
           <div class="docstring">
@@ -149,7 +149,7 @@
 
 </div>
         </dt>
-        <dd><pre class="code"><span class='int'>3</span></pre></dd>
+        <dd><pre class="code"><span class='int'>0</span></pre></dd>
       
         <dt id="STRING-constant" class="">STRING =
           <div class="docstring">
@@ -180,7 +180,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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

@@ -228,14 +228,14 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ballast/Operation.html#perform-class_method" title="Ballast::Operation.perform (method)">perform</a></span>
-    <small>Ballast::Operation</small>
+    <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/OperationsChain.html#perform-class_method" title="Ballast::OperationsChain.perform (method)">perform</a></span>
-    <small>Ballast::OperationsChain</small>
+    <span class='object_link'><a href="Ballast/Operation.html#perform-class_method" title="Ballast::Operation.perform (method)">perform</a></span>
+    <small>Ballast::Operation</small>
   </li>
   
 
@@ -246,78 +246,84 @@
   
 
   <li class="r2 ">
+    <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 ">
     <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="r1 ">
+  <li class="r2 ">
     <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="r2 ">
+  <li class="r1 ">
     <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="r1 ">
+  <li class="r2 ">
     <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="r2 ">
+  <li class="r1 ">
     <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="r1 ">
+  <li class="r2 ">
     <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="r2 ">
+  <li class="r1 ">
     <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="r1 ">
+  <li class="r2 ">
     <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="r2 ">
+  <li class="r1 ">
     <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="r1 ">
+  <li class="r2 ">
     <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="r2 ">
+  <li class="r1 ">
     <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 ">
+  <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>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="Ballast/Concerns/Ajax.html#update_ajax-instance_method" title="Ballast::Concerns::Ajax#update_ajax (method)">#update_ajax</a></span>
     <small>Ballast::Concerns::Ajax</small>
   </li>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat Jan  4 16:26:00 2014 by
+  Generated on Sat Jan 25 11:54:04 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/ajax.rb

@@ -73,13 +73,21 @@ module Ballast
       end
 
       # Allows HTTP Cross-Origin Resource Sharing.
-      def allow_cors
+      #
+      # @param allow_origin [String] The value for the `Access-Control-Allow-Origin` header.
+      # @param allow_methods [Array] A list of methods for the `Access-Control-Allow-Methods` header.
+      # @param allow_headers [String] The value for the `Access-Control-Allow-Headers` header.
+      # @param max_age [Float|Fixnum] The value for the `Access-Control-Max-Age` header.
+      # @param allow_credentials [Boolean] The value for the `Access-Control-Allow-Credentials` header.
+      def allow_cors(allow_origin: "*", allow_methods: [:post, :get, :options], allow_headers: "*", max_age: 1.year, allow_credentials: false)
         headers.merge!({
-          "Access-Control-Allow-Origin" => "*",
-          "Access-Control-Allow-Methods" => "POST, GET, OPTIONS",
-          "Access-Control-Allow-Headers" => "*",
-          "Access-Control-Max-Age" => 1.year.to_i.to_s
+          "Access-Control-Allow-Origin" => allow_origin,
+          "Access-Control-Allow-Methods" => allow_methods.collect {|m| m.to_s.upcase }.join(", "),
+          "Access-Control-Allow-Headers" => allow_headers,
+          "Access-Control-Max-Age" => max_age.to_i.to_s
         })
+
+        headers["Access-Control-Allow-Credentials"] = "true" if allow_credentials
       end
 
       # Disallows web robots.

data/lib/ballast/concerns/common.rb

@@ -26,11 +26,21 @@ module Ballast
       # @param klass [Class] The operation to perform.
       # @param owner [Object] The owner to use. By default it uses itself.
       # @param kwargs [Hash] The arguments for performing.
-      # @return [Operation] The performed operation
+      # @return [Operation] The performed operation.
       def perform_operation(klass, owner = nil, **kwargs)
         @operation = klass.perform(owner || self, **kwargs)
       end
 
+      # Performs an operations chain, using itself as owner by default.
+      #
+      # @param klasses [Array] The operations to perform.
+      # @param owner [Object] The owner to use. By default it uses itself.
+      # @param kwargs [Hash] The arguments for performing.
+      # @return [OperationChain] The performed operation chain.
+      def perform_operations_chain(klasses, owner = nil, **kwargs)
+        @operation = Ballast::OperationsChain.perform(owner || self, klasses, **kwargs)
+      end
+
       # Formats a relative date using abbreviation or short formats.
       #
       # @param date [DateTime] The date to format.

data/lib/ballast/configuration.rb

@@ -23,20 +23,7 @@ module Ballast
         self[section] = content[environment]
       end
 
-      enable_dotted_access(self)
+      self.enable_dotted_access
     end
-
-    private
-      # Enables dotted access on a root object and its nested hashes.
-      #
-      # @param root [Hash] The hash to manage.
-      def enable_dotted_access(root)
-        root.extend(Hashie::Extensions::MethodReader)
-        root.extend(Hashie::Extensions::MethodQuery)
-
-        root.each do |_, node|
-          enable_dotted_access(node) if node.is_a?(Hash)
-        end
-      end
   end
 end