Ability to set nested scopes

Author: kevintraver

lib/rspec_api_documentation/dsl/endpoint.rb

@@ -150,9 +150,13 @@ def set_param(hash, param)
       key = param[:name]
       return hash if !respond_to?(key) || in_path?(key)
 
-      if param[:scope]
-        hash[param[:scope].to_s] ||= {}
-        hash[param[:scope].to_s][key] = send(key)
+      if scope = param[:scope]
+        if scope.is_a?(Array)
+          hash.merge!(scope.reverse.inject({key => send(key)}) { |a,n| { n.to_s => a }})
+        else
+          hash[scope.to_s] ||= {}
+          hash[scope.to_s][key] = send(key)
+        end
       else
         hash[key] = send(key)
       end

spec/dsl_spec.rb

@@ -364,6 +364,7 @@
       parameter :order_type, "Type of order"
       parameter :amount, "Amount of order", scope: :order
       parameter :name, "Name of order", scope: :order
+      parameter :street, "order location country", scope: [:order,:location,:address]
 
 
       context "no extra params" do
@@ -396,6 +397,16 @@
 
         example_request "should deep merge the optional parameter hash", {:order_type => 'big', :order => {:name => 'Friday Order'}}
       end
+
+      context "extra options for do_request with nested scope" do
+        before do
+          expect(client).to receive(:post).with("/orders", {"order" => {"location" => {"address" => {"street" => "123 Main St"}}}}, nil)
+        end
+
+        let(:street) { '123 Main St' }
+
+        example_request "should deep merge the optional parameter hash with nested scope"
+      end
     end
   end