stacker_bee 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3dec8ed7bf3c0530da68cb9ba61803e1279f3ff3
-  data.tar.gz: 5532fc2e8188567eb1e7d9590d6249ee0ab60493
+  metadata.gz: 113d9dc3b7034e99f4fa25d03b558de6f6a71c67
+  data.tar.gz: 3ec61352a7c75f6cdf92fbe7bd628fd2d3890d15
 SHA512:
-  metadata.gz: 709fe57d52d12d7a153e5415fb3b947131f4bf0169c19dda3a8440aa58d1601b5ca081449c138be6430e339c19f6e836ddc7fd5efd7c3f5fafa1b49d032287b1
-  data.tar.gz: 7f827708d6c38a505a577cc4c5ae921fc67fe1ddd726e0741cd378bf3da33f25472257a2505921e65ac0c7eb7140295c15b966490a42553fa939fe5c7ccda579
+  metadata.gz: 3583805c59178743eba73e67477b1d7a47e47dbd57e76248e2ab90ba398ebf2c452601c7c7b431039b22d612414d4c7fa874fec74ecea333ca0feceae53e21f0
+  data.tar.gz: e5bd192f9e42c7d9a6facca1fed0ab07339a089e329e41aaf6257516ede551e50f51e79963ede771ba183f8a8951a4b0bfc0919391c9ba5af9a5530905869739

data/.gitignore

@@ -2,6 +2,7 @@
 *.rbc
 config.yml
 .rvmrc
+.ruby-version
 .bundle
 .config
 .yardoc

data/README.md

@@ -3,6 +3,7 @@
 [![Code Climate](https://codeclimate.com/github/promptworks/stacker_bee.png)](https://codeclimate.com/github/promptworks/stacker_bee)
 [![Dependency Status](https://gemnasium.com/promptworks/stacker_bee.png)](https://gemnasium.com/promptworks/stacker_bee)
 [![Build Status](https://travis-ci.org/promptworks/stacker_bee.png?branch=master)](https://travis-ci.org/promptworks/stacker_bee)
+[![Gem Version](https://badge.fury.io/rb/stacker_bee.png)](http://badge.fury.io/rb/stacker_bee)
 
 The unofficial CloudStack client for Ruby.
 
@@ -20,71 +21,66 @@ And execute:
 
     $ bundle install
 
+
 ## Basic Usage
 
-    my_client = StackerBee::Client.new({
+    cloud_stack = StackerBee::Client.new(
       url:        'http://localhost:8080/client/api',
       api_key:    'MY_API_KEY',
       secret_key: 'MY_SECRET_KEY'
-    })
-
-    my_client.list_virtual_machines
-
-    my_client.create_volume name: "MyVolume"
-
-## Basic Configuration
+    )
 
-All configuration parameters set on the Client class are used as defaults for Client instances.
+    cloud_stack.list_virtual_machines state: 'Running'
+    # => [ { id: '48b91ab4...', displayName: '...', ... },
+    #      { id: '59c02bc5...', displayName: '...', ... },
+    #      ... ]
 
-### URL
+    cloud_stack.create_volume name: 'MyVolume'
 
-Your CloudStack URL. E.g. http://localhost:8080/client/api
+## Features
 
-    StackerBee::Client.url = "http://localhost:8080/client/api"
+### Idomatic Ruby formatting for names
 
-Or:
+You can use `list_virtual_machines` instead of `listVirtualMachines` and
+`affinity_group_id` instead of `affinitygroupid` (if you want to).
 
-    my_client = StackerBee::Client.new({
-      url: 'http://localhost:8080/client/api'
-    })
+For example:
 
-### Keys
+    vm = cloud_stack.list_virtual_machines(affinity_group_id: id).first
+    puts vm[:iso_display_text]
 
-Your CloudStack credentials, i.e. API key and secret key.
+### Handling 'map' parameters
 
-    StackerBee::Client.api_key    = "MY_API_KEY"
-    StackerBee::Client.secret_key = "MY_SECRET_KEY"
+For any endpoint requiring a map parameter, simply pass in a hash.
 
-Or:
+    create_tags(tags: { type: 'community'}, resource_type: "Template", resource_ids: id )
 
-    my_client = StackerBee::Client.new({
-      api_key:    'MY_API_KEY',
-      secret_key: 'MY_SECRET_KEY'
-    })
+This will yield a request with the following query string:
 
-### Logger
+    ...&tags[0].key=type&tags[0].name=type&tags[0].value=community
 
-Your logger of choice.
+### Configurable Logger
 
     StackerBee::Client.logger = Rails.logger
 
-Or:
+Or
 
-    my_client = StackerBee::Client.new({
-      logger: Rails.logger
-    })
+    StackerBee::Client.logger = Logger.new
 
-## Configurable API
+### Configurable API Version
 
-    StackerBee::Client.api_path = "/path/to/your/listApis/response.json"
+By default, StackerBee uses the CloudStack 4.2 API, but it doesn't have to.
+Use a different API version by setting the `api_path` configuration option to the path of a JSON file containing the response from your CloudStack instance's `listApis` command.
 
-## CLI
+    StackerBee::Client.api_path = '/path/to/your/listApis/response.json'
+
+### CloudStack REPL
 
 Usage:
 
     $ stacker_bee [OPTIONS]
 
-Examples:
+Example:
 
     $ stacker_bee -u http://localhost:8080/client/api -a MY_API_KEY -s MY_SECRET_KEY
     StackerBee CloudStack REPL
@@ -95,17 +91,110 @@ Examples:
       ...
     >>
 
+## Configuration
+
+Configuring a client:
+
+    cloud_stack = StackerBee::Client.new(
+      url:        'http://localhost:8080/client/api'
+      api_key:    'API_KEY',
+      secret_key: 'SECRET_KEY',
+      logger:     Rails.logger
+    )
+
+All configuration parameters set on the `StackerBee::Client` class are used as defaults for `StackerBee::Client` instances.
+
+    StackerBee::Client.url    = 'http://localhost:8080/client/api'
+    StackerBee::Client.logger = Rails.logger
+
+    user_client = StackerBee::Client.new(
+      api_key:    'USER_API_KEY',
+      secret_key: 'USER_SECRET_KEY'
+    )
+
+    root_client = StackerBee::Client.new(
+      api_key:    'ROOT_API_KEY',
+      secret_key: 'ROOT_SECRET_KEY'
+    )
+
+### URL
+
+The URL of your CloudStack instance's URL.
+
+    StackerBee::Client.url = 'http://localhost:8080/client/api'
+
+Or:
+
+    my_client = StackerBee::Client.new(
+      url: 'http://localhost:8080/client/api'
+    )
+
+### Keys
+
+Your CloudStack credentials, i.e. API key and secret key.
+
+    StackerBee::Client.api_key    = 'MY_API_KEY'
+    StackerBee::Client.secret_key = 'MY_SECRET_KEY'
+
+Or:
+
+    my_client = StackerBee::Client.new(
+      api_key:    'MY_API_KEY',
+      secret_key: 'MY_SECRET_KEY'
+    )
+
+### Logger
+
+StackerBee can be configured with a custom `Logger`.
+
+    StackerBee::Client.logger = Logger.new
+
+Or
+
+    my_client = StackerBee::Client.new(
+      logger: Logger.new
+    )
+
+For Rails apps, it's sometimes convenient to use Rail's logger:
+
+    StackerBee::Client.logger = Rails.logger
+
+### Bulk Configuration
+
+The `StackerBee::Client` class can be configured with multiple options at once.
+
+    StackerBee::Client.default_config = {
+      url:        'http://localhost:8080/client/api',
+      logger:     Rails.logger,
+      api_key:    'API_KEY',
+      secret_key: 'MY_SECRET_KEY'
+    }
+
 ## Contributing
 
+### Testing
+
 Running the tests:
 
-    $ rake
+    $ bundle exec rake
+
+### Testing against CloudStack
 
-To interact with a real CloudStack server:
+To interact with a real CloudStack server, instead of the recorded responses:
 
     $ cp config.default.yml config.yml
 
-And edit `config.yml`, specifying the URL and credentials for your CloudStack server. This file is ignored by git.
+And edit `config.yml`, specifying the URL and credentials for your CloudStack server. This file is used by the test suite if it exists, but is ignored by git.
+
+### Coding Style
+
+This project uses [Rubocop](https://github.com/bbatsov/rubocop) to enforce code style.
+
+    $ bundle exec rubocop
+
+## Thanks to
+
+- [Chip Childers](http://github.com/chipchilders) for a [reference implementation of a CloudStack client in Ruby](http://chipchilders.github.io/cloudstack_ruby_client/)
 
 ## License
 

data/lib/stacker_bee.rb

@@ -1,16 +1,2 @@
-require_stacker_bee = if defined?(require_relative)
-                        lambda do |path|
-                          require_relative path
-                        end
-                      else # for 1.8.7
-                        lambda do |path|
-                          require "stacker_bee/#{path}"
-                        end
-                      end
-
-%w(
-  version
-  client
-).each do |file_name|
-  require_stacker_bee["stacker_bee/#{file_name}"]
-end
+require_relative "stacker_bee/version"
+require_relative "stacker_bee/client"

data/lib/stacker_bee/client.rb

@@ -3,6 +3,7 @@ require "stacker_bee/configuration"
 require "stacker_bee/api"
 require "stacker_bee/connection"
 require "stacker_bee/request"
+require "stacker_bee/dictionary_flattener"
 require "stacker_bee/response"
 
 module StackerBee
@@ -23,7 +24,6 @@ module StackerBee
                    :secret_key=
 
     class << self
-
       def reset!
         @api, @api_path, @default_config = nil
       end
@@ -66,7 +66,7 @@ module StackerBee
     end
 
     def request(endpoint_name, params = {})
-      request      = Request.new(endpoint_for(endpoint_name), api_key, params)
+      request = Request.new(endpoint_for(endpoint_name), api_key, params)
       request.allow_empty_string_params =
         configuration.allow_empty_string_params
       raw_response = connection.get(request)

data/lib/stacker_bee/connection.rb

@@ -2,6 +2,7 @@ require "faraday"
 require "uri"
 require "stacker_bee/middleware/signed_query"
 require "stacker_bee/middleware/logger"
+require "stacker_bee/middleware/detokenizer"
 
 module StackerBee
   class ConnectionError < Exception
@@ -9,15 +10,21 @@ module StackerBee
 
   class Connection
     attr_accessor :configuration
+
     def initialize(configuration)
       @configuration = configuration
       uri      = URI.parse(self.configuration.url)
       @path    = uri.path
       uri.path = ''
       fail ConnectionError, "no protocol specified" unless uri.scheme
+      initialize_faraday(uri)
+    end
+
+    def initialize_faraday(uri)
       @faraday = Faraday.new(url: uri.to_s) do |faraday|
-        faraday.use      Middleware::SignedQuery, self.configuration.secret_key
-        faraday.use      Middleware::Logger, self.configuration.logger
+        faraday.use      Middleware::Detokenizer
+        faraday.use      Middleware::SignedQuery, configuration.secret_key
+        faraday.use      Middleware::Logger, configuration.logger
         faraday.adapter  Faraday.default_adapter  # Net::HTTP
       end
     end

data/lib/stacker_bee/dictionary_flattener.rb

@@ -0,0 +1,41 @@
+module StackerBee
+  class DictionaryFlattener
+    LB = "SBLEFTBRACKET"
+    RB = "SBRIGHTBRACKET"
+
+    attr_accessor :params
+
+    def self.tokenize(key)
+      key.gsub(/\[/, LB).gsub(/\]/, RB)
+    end
+
+    def self.detokenize(key)
+      key.gsub(/#{LB}/, "[").gsub(/#{RB}/, "]")
+    end
+
+    def initialize(params)
+      @params = params.dup
+      flatten_params
+    end
+
+    def flatten_params
+      hashes = params.select { |key, val|  val.respond_to? :keys }
+      flatten_map_values(params, hashes)
+    end
+
+    def flatten_map_values(params, hashes)
+      hashes.each do |outer|
+        remove_empties(outer[1]).each_with_index do |array, index|
+          key = self.class.tokenize("#{outer[0]}[#{index}]")
+          params["#{key}.key"] = params["#{key}.name"] = array[0]
+          params["#{key}.value"] = array[1]
+        end
+        params.delete outer[0]
+      end
+    end
+
+    def remove_empties(hash)
+      hash.reject{ |k, v| v.nil? || v == "" }
+    end
+  end
+end

data/lib/stacker_bee/middleware/detokenizer.rb

@@ -0,0 +1,17 @@
+require "faraday"
+require "base64"
+
+module StackerBee
+  module Middleware
+    class Detokenizer < Faraday::Middleware
+      def call(env)
+        detokenize(env[:url])
+        @app.call(env)
+      end
+
+      def detokenize(uri)
+        uri.query = StackerBee::DictionaryFlattener.detokenize uri.query
+      end
+    end
+  end
+end

data/lib/stacker_bee/middleware/logger.rb

@@ -1,6 +1,6 @@
-require 'forwardable'
-require 'logger'
-require 'pp'
+require "forwardable"
+require "logger"
+require "pp"
 
 module StackerBee
   module Middleware
@@ -42,7 +42,6 @@ module StackerBee
         debug env[:response_headers].pretty_inspect
         debug env[:body]
       end
-
     end
   end
 end

data/lib/stacker_bee/rash.rb

@@ -1,4 +1,4 @@
-require 'forwardable'
+require "forwardable"
 require "stacker_bee/utilities"
 
 module StackerBee

data/lib/stacker_bee/request.rb

@@ -6,21 +6,26 @@ module StackerBee
 
     RESPONSE_TYPE = "json"
 
-    attr_accessor :params
     attr_writer   :allow_empty_string_params
+    attr_accessor :endpoint, :api_key
 
     def initialize(endpoint, api_key, params = {})
-      params[:api_key]  = api_key
-      params[:command]  = endpoint
-      params[:response] = RESPONSE_TYPE
-      self.params = params
+      @params = params
+      self.endpoint = endpoint
+      self.api_key  = api_key
     end
 
     def query_params
-      params
+      flat_params = DictionaryFlattener.new(@params).params
+
+      flat_params[:api_key]  = api_key
+      flat_params[:command]  = endpoint
+      flat_params[:response] = RESPONSE_TYPE
+
+      flat_params
         .reject { |key, val| val.nil? }
         .reject { |key, val| !allow_empty_string_params && val == '' }
-        .sort
+        .sort_by { |key, val| key.to_s }
         .map { |(key, val)| [cloud_stack_key(key), cloud_stack_value(val)] }
     end
 

data/lib/stacker_bee/response.rb

@@ -1,6 +1,6 @@
 require "stacker_bee/body_parser"
 require "stacker_bee/request_error"
-require 'delegate'
+require "delegate"
 
 module StackerBee
   class Response < SimpleDelegator

data/lib/stacker_bee/utilities.rb

@@ -1,7 +1,9 @@
 module StackerBee
   module Utilities
+    REGEX = /\s|-|_/
+
     def uncase(string)
-      string.to_s.downcase.gsub(/\W|_/, '')
+      string.to_s.downcase.gsub(REGEX, '')
     end
 
     def snake_case(string)
@@ -9,7 +11,7 @@ module StackerBee
     end
 
     def camel_case(string, lower = false)
-      string.to_s.split(/\W|_/).each_with_object('') do |word, memo|
+      string.to_s.split(REGEX).each_with_object('') do |word, memo|
         memo << (memo.empty? && lower ? word[0].downcase : word[0].upcase)
         memo << word[1..-1]
       end

data/lib/stacker_bee/version.rb

@@ -1,3 +1,3 @@
 module StackerBee
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_a_Map/can_create_an_object.yml

@@ -0,0 +1,183 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=listZones&response=json&signature=/MnHgTBKGc%2BXx0Z8KwMllvw92vg=
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '403'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: UTF-8
+      string: '{ "listzonesresponse" : { "count":1 ,"zone" : [  {"id":"39e9e31e-925c-4b55-8d33-f99912b73dfc","name":"Sandbox-simulator","dns1":"10.147.28.6","internaldns1":"10.147.28.6","guestcidraddress":"10.1.1.0/24","networktype":"Advanced","securitygroupsenabled":false,"allocationstate":"Enabled","zonetoken":"ea3acbc4-cae8-3b82-b42f-7492ddfede00","dhcpprovider":"VirtualRouter","localstorageenabled":false}
+        ] } }'
+    http_version: 
+  recorded_at: Thu, 19 Dec 2013 17:34:44 GMT
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=listNetworkOfferings&response=json&signature=BAdYatJ5Rjcffi6sU8P%2BZtLhSF8=&supportedServices=sourcenat&type=isolated
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '6006'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: UTF-8
+      string: '{ "listnetworkofferingsresponse" : { "count":4 ,"networkoffering" :
+        [  {"id":"fa126319-f822-4786-9cd3-30bd0c55ca94","name":"DefaultIsolatedNetworkOfferingWithSourceNatService","displaytext":"Offering
+        for Isolated networks with Source Nat service enabled","traffictype":"Guest","isdefault":true,"specifyvlan":false,"conservemode":true,"specifyipranges":false,"availability":"Required","networkrate":200,"state":"Enabled","guestiptype":"Isolated","serviceofferingid":"983410fa-b51b-439c-b8ba-be973804c38f","service":[{"name":"PortForwarding","provider":[{"name":"VirtualRouter"}]},{"name":"StaticNat","provider":[{"name":"VirtualRouter"}],"capability":[{"name":"ElasticIp","value":"false","canchooseservicecapability":false},{"name":"AssociatePublicIP","value":"true","canchooseservicecapability":false}]},{"name":"Dhcp","provider":[{"name":"VirtualRouter"}]},{"name":"Firewall","provider":[{"name":"VirtualRouter"}]},{"name":"Lb","provider":[{"name":"VirtualRouter"}],"capability":[{"name":"SupportedLBIsolation","value":"dedicated","canchooseservicecapability":false},{"name":"ElasticLb","value":"false","canchooseservicecapability":false},{"name":"InlineMode","value":"false","canchooseservicecapability":false}]},{"name":"UserData","provider":[{"name":"VirtualRouter"}]},{"name":"Dns","provider":[{"name":"VirtualRouter"}]},{"name":"SourceNat","provider":[{"name":"VirtualRouter"}],"capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"false","canchooseservicecapability":false}]},{"name":"Vpn","provider":[{"name":"VirtualRouter"}]}],"forvpc":false,"ispersistent":false,"egressdefaultpolicy":false},
+        {"id":"7e70b3b5-5e2c-42cb-9b49-93a87c13a675","name":"DefaultIsolatedNetworkOfferingForVpcNetworks","displaytext":"Offering
+        for Isolated Vpc networks with Source Nat service enabled","traffictype":"Guest","isdefault":true,"specifyvlan":false,"conservemode":false,"specifyipranges":false,"availability":"Optional","networkrate":200,"state":"Enabled","guestiptype":"Isolated","serviceofferingid":"983410fa-b51b-439c-b8ba-be973804c38f","service":[{"name":"PortForwarding","provider":[{"name":"VpcVirtualRouter"}]},{"name":"StaticNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"ElasticIp","value":"false","canchooseservicecapability":false},{"name":"AssociatePublicIP","value":"true","canchooseservicecapability":false}]},{"name":"Dhcp","provider":[{"name":"VpcVirtualRouter"}]},{"name":"NetworkACL","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Lb","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"SupportedLBIsolation","value":"dedicated","canchooseservicecapability":false},{"name":"ElasticLb","value":"false","canchooseservicecapability":false},{"name":"InlineMode","value":"false","canchooseservicecapability":false}]},{"name":"UserData","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Dns","provider":[{"name":"VpcVirtualRouter"}]},{"name":"SourceNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"false","canchooseservicecapability":false}]},{"name":"Vpn","provider":[{"name":"VpcVirtualRouter"}]}],"forvpc":true,"ispersistent":false,"egressdefaultpolicy":false},
+        {"id":"a9d78d52-f306-44c5-bb6d-c121a507db05","name":"DefaultIsolatedNetworkOfferingForVpcNetworksNoLB","displaytext":"Offering
+        for Isolated Vpc networks with Source Nat service enabled and LB service Disabled","traffictype":"Guest","isdefault":true,"specifyvlan":false,"conservemode":false,"specifyipranges":false,"availability":"Optional","networkrate":200,"state":"Enabled","guestiptype":"Isolated","serviceofferingid":"983410fa-b51b-439c-b8ba-be973804c38f","service":[{"name":"PortForwarding","provider":[{"name":"VpcVirtualRouter"}]},{"name":"StaticNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"ElasticIp","value":"false","canchooseservicecapability":false},{"name":"AssociatePublicIP","value":"true","canchooseservicecapability":false}]},{"name":"Dhcp","provider":[{"name":"VpcVirtualRouter"}]},{"name":"NetworkACL","provider":[{"name":"VpcVirtualRouter"}]},{"name":"UserData","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Dns","provider":[{"name":"VpcVirtualRouter"}]},{"name":"SourceNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"false","canchooseservicecapability":false}]},{"name":"Vpn","provider":[{"name":"VpcVirtualRouter"}]}],"forvpc":true,"ispersistent":false,"egressdefaultpolicy":false},
+        {"id":"f9a7b0d0-ce61-4f8d-a360-be1040d67287","name":"DefaultIsolatedNetworkOfferingForVpcNetworksWithInternalLB","displaytext":"Offering
+        for Isolated Vpc networks with Internal LB support","traffictype":"Guest","isdefault":true,"specifyvlan":false,"conservemode":false,"specifyipranges":false,"availability":"Optional","networkrate":200,"state":"Enabled","guestiptype":"Isolated","serviceofferingid":"983410fa-b51b-439c-b8ba-be973804c38f","service":[{"name":"Dhcp","provider":[{"name":"VpcVirtualRouter"}]},{"name":"NetworkACL","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Lb","provider":[{"name":"InternalLbVm"}],"capability":[{"name":"SupportedLBIsolation","value":"dedicated","canchooseservicecapability":false},{"name":"ElasticLb","value":"false","canchooseservicecapability":false},{"name":"InlineMode","value":"false","canchooseservicecapability":false}]},{"name":"UserData","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Dns","provider":[{"name":"VpcVirtualRouter"}]},{"name":"SourceNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"false","canchooseservicecapability":false}]}],"forvpc":true,"ispersistent":false,"egressdefaultpolicy":false}
+        ] } }'
+    http_version: 
+  recorded_at: Thu, 19 Dec 2013 17:34:44 GMT
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=createNetwork&displaytext=John&name=John&networkOfferingId=fa126319-f822-4786-9cd3-30bd0c55ca94&response=json&signature=UDcfFqlzwpHJib/9kLKzR0%2BCbyc=&zoneId=39e9e31e-925c-4b55-8d33-f99912b73dfc
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '4441'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: UTF-8
+      string: '{ "createnetworkresponse" :  { "network" : {"id":"18772181-9674-4a30-81e7-99ebb6a5baed","name":"John","displaytext":"John","broadcastdomaintype":"Vlan","traffictype":"Guest","gateway":"10.1.1.1","netmask":"255.255.255.0","cidr":"10.1.1.0/24","zoneid":"39e9e31e-925c-4b55-8d33-f99912b73dfc","zonename":"Sandbox-simulator","networkofferingid":"fa126319-f822-4786-9cd3-30bd0c55ca94","networkofferingname":"DefaultIsolatedNetworkOfferingWithSourceNatService","networkofferingdisplaytext":"Offering
+        for Isolated networks with Source Nat service enabled","networkofferingconservemode":true,"networkofferingavailability":"Required","issystem":false,"state":"Allocated","related":"18772181-9674-4a30-81e7-99ebb6a5baed","dns1":"10.147.28.6","type":"Isolated","acltype":"Account","account":"admin","domainid":"ce4585b8-41f5-11e3-aaa7-d6558ad1fb9f","domain":"ROOT","service":[{"name":"PortForwarding"},{"name":"StaticNat"},{"name":"Dhcp","capability":[{"name":"DhcpAccrossMultipleSubnets","value":"true","canchooseservicecapability":false}]},{"name":"Firewall","capability":[{"name":"TrafficStatistics","value":"per
+        public ip","canchooseservicecapability":false},{"name":"SupportedTrafficDirection","value":"ingress,
+        egress","canchooseservicecapability":false},{"name":"SupportedEgressProtocols","value":"tcp,udp,icmp,
+        all","canchooseservicecapability":false},{"name":"SupportedProtocols","value":"tcp,udp,icmp","canchooseservicecapability":false},{"name":"MultipleIps","value":"true","canchooseservicecapability":false}]},{"name":"Lb","capability":[{"name":"SupportedLbAlgorithms","value":"roundrobin,leastconn,source","canchooseservicecapability":false},{"name":"SupportedLBIsolation","value":"dedicated","canchooseservicecapability":false},{"name":"SupportedStickinessMethods","value":"[{\"methodname\":\"LbCookie\",\"paramlist\":[{\"paramname\":\"cookie-name\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"mode\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"nocache\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"indirect\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"postonly\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"domain\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"}],\"description\":\"This is loadbalancer cookie based stickiness method.\"},{\"methodname\":\"AppCookie\",\"paramlist\":[{\"paramname\":\"cookie-name\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"length\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"holdtime\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"request-learn\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"prefix\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"mode\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"}],\"description\":\"This is App session based sticky method. Define session
+        stickiness on an existing application cookie. It can be used only for a specific
+        http traffic\"},{\"methodname\":\"SourceBased\",\"paramlist\":[{\"paramname\":\"tablesize\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"expire\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"}],\"description\":\"This is source based Stickiness method, it can be used
+        for any type of protocol.\"}]","canchooseservicecapability":false},{"name":"LbSchemes","value":"Public","canchooseservicecapability":false},{"name":"SupportedProtocols","value":"tcp,
+        udp","canchooseservicecapability":false}]},{"name":"UserData"},{"name":"Dns","capability":[{"name":"AllowDnsSuffixModification","value":"true","canchooseservicecapability":false}]},{"name":"SourceNat","capability":[{"name":"RedundantRouter","value":"true","canchooseservicecapability":false},{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false}]},{"name":"Vpn","capability":[{"name":"SupportedVpnTypes","value":"pptp,l2tp,ipsec","canchooseservicecapability":false},{"name":"VpnTypes","value":"removeaccessvpn","canchooseservicecapability":false}]}],"networkdomain":"cs2sandbox.simulator","physicalnetworkid":"46d08659-81e9-4f31-a589-a15aca972af0","restartrequired":false,"specifyipranges":false,"canusefordeploy":true,"ispersistent":false,"tags":[],"displaynetwork":true}
+        }  }'
+    http_version: 
+  recorded_at: Thu, 19 Dec 2013 17:34:44 GMT
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=createTags&resourceIds=18772181-9674-4a30-81e7-99ebb6a5baed&resourceType=Network&response=json&signature=xFXocwxqx4V1VH1EGVtjwdGZ0Yw=&tags%5B0%5D%5B%7D.key%5D=speed%20%5Blab%5D&tags%5B0%5D%5B%7D.name%5D=speed%20%5Blab%5D&tags%5B0%5D%5B%7D.value%5D=real%20fast!
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 401
+      message: Unauthorized
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '131'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: UTF-8
+      string: '{ "createtagsresponse" : {"uuidList":[],"errorcode":401,"errortext":"unable
+        to verify user credentials and/or request signature"} }'
+    http_version: 
+  recorded_at: Thu, 19 Dec 2013 17:34:44 GMT
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=createTags&resourceIds=18772181-9674-4a30-81e7-99ebb6a5baed&resourceType=Network&response=json&signature=IqPennOpZ2NWFlJIBomJG9Ys9Zg=&tags%5B0%5D%5B.key%5D=speed%20%5Blab%5D&tags%5B0%5D%5B.name%5D=speed%20%5Blab%5D&tags%5B0%5D%5B.value%5D=real%20fast!
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '75'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: UTF-8
+      string: '{ "createtagsresponse" : {"jobid":"7f37bba8-dd8e-4ba2-b5a4-bb97f3cf0cab"}
+        }'
+    http_version: 
+  recorded_at: Thu, 19 Dec 2013 17:42:02 GMT
+recorded_with: VCR 2.8.0

data/spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_a_Map/object.yml

@@ -0,0 +1,153 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=listZones&response=json&signature=/MnHgTBKGc%2BXx0Z8KwMllvw92vg=
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - ! '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '403'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: US-ASCII
+      string: ! '{ "listzonesresponse" : { "count":1 ,"zone" : [  {"id":"39e9e31e-925c-4b55-8d33-f99912b73dfc","name":"Sandbox-simulator","dns1":"10.147.28.6","internaldns1":"10.147.28.6","guestcidraddress":"10.1.1.0/24","networktype":"Advanced","securitygroupsenabled":false,"allocationstate":"Enabled","zonetoken":"ea3acbc4-cae8-3b82-b42f-7492ddfede00","dhcpprovider":"VirtualRouter","localstorageenabled":false}
+        ] } }'
+    http_version: 
+  recorded_at: Wed, 18 Dec 2013 21:25:06 GMT
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=listNetworkOfferings&response=json&signature=BAdYatJ5Rjcffi6sU8P%2BZtLhSF8=&supportedServices=sourcenat&type=isolated
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - ! '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '6006'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: US-ASCII
+      string: ! '{ "listnetworkofferingsresponse" : { "count":4 ,"networkoffering"
+        : [  {"id":"fa126319-f822-4786-9cd3-30bd0c55ca94","name":"DefaultIsolatedNetworkOfferingWithSourceNatService","displaytext":"Offering
+        for Isolated networks with Source Nat service enabled","traffictype":"Guest","isdefault":true,"specifyvlan":false,"conservemode":true,"specifyipranges":false,"availability":"Required","networkrate":200,"state":"Enabled","guestiptype":"Isolated","serviceofferingid":"983410fa-b51b-439c-b8ba-be973804c38f","service":[{"name":"SourceNat","provider":[{"name":"VirtualRouter"}],"capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"false","canchooseservicecapability":false}]},{"name":"Dns","provider":[{"name":"VirtualRouter"}]},{"name":"UserData","provider":[{"name":"VirtualRouter"}]},{"name":"PortForwarding","provider":[{"name":"VirtualRouter"}]},{"name":"Firewall","provider":[{"name":"VirtualRouter"}]},{"name":"Lb","provider":[{"name":"VirtualRouter"}],"capability":[{"name":"SupportedLBIsolation","value":"dedicated","canchooseservicecapability":false},{"name":"ElasticLb","value":"false","canchooseservicecapability":false},{"name":"InlineMode","value":"false","canchooseservicecapability":false}]},{"name":"Dhcp","provider":[{"name":"VirtualRouter"}]},{"name":"Vpn","provider":[{"name":"VirtualRouter"}]},{"name":"StaticNat","provider":[{"name":"VirtualRouter"}],"capability":[{"name":"ElasticIp","value":"false","canchooseservicecapability":false},{"name":"AssociatePublicIP","value":"true","canchooseservicecapability":false}]}],"forvpc":false,"ispersistent":false,"egressdefaultpolicy":false},
+        {"id":"7e70b3b5-5e2c-42cb-9b49-93a87c13a675","name":"DefaultIsolatedNetworkOfferingForVpcNetworks","displaytext":"Offering
+        for Isolated Vpc networks with Source Nat service enabled","traffictype":"Guest","isdefault":true,"specifyvlan":false,"conservemode":false,"specifyipranges":false,"availability":"Optional","networkrate":200,"state":"Enabled","guestiptype":"Isolated","serviceofferingid":"983410fa-b51b-439c-b8ba-be973804c38f","service":[{"name":"SourceNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"false","canchooseservicecapability":false}]},{"name":"Dns","provider":[{"name":"VpcVirtualRouter"}]},{"name":"UserData","provider":[{"name":"VpcVirtualRouter"}]},{"name":"PortForwarding","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Lb","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"SupportedLBIsolation","value":"dedicated","canchooseservicecapability":false},{"name":"ElasticLb","value":"false","canchooseservicecapability":false},{"name":"InlineMode","value":"false","canchooseservicecapability":false}]},{"name":"Dhcp","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Vpn","provider":[{"name":"VpcVirtualRouter"}]},{"name":"StaticNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"ElasticIp","value":"false","canchooseservicecapability":false},{"name":"AssociatePublicIP","value":"true","canchooseservicecapability":false}]},{"name":"NetworkACL","provider":[{"name":"VpcVirtualRouter"}]}],"forvpc":true,"ispersistent":false,"egressdefaultpolicy":false},
+        {"id":"a9d78d52-f306-44c5-bb6d-c121a507db05","name":"DefaultIsolatedNetworkOfferingForVpcNetworksNoLB","displaytext":"Offering
+        for Isolated Vpc networks with Source Nat service enabled and LB service Disabled","traffictype":"Guest","isdefault":true,"specifyvlan":false,"conservemode":false,"specifyipranges":false,"availability":"Optional","networkrate":200,"state":"Enabled","guestiptype":"Isolated","serviceofferingid":"983410fa-b51b-439c-b8ba-be973804c38f","service":[{"name":"SourceNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"false","canchooseservicecapability":false}]},{"name":"Dns","provider":[{"name":"VpcVirtualRouter"}]},{"name":"UserData","provider":[{"name":"VpcVirtualRouter"}]},{"name":"PortForwarding","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Dhcp","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Vpn","provider":[{"name":"VpcVirtualRouter"}]},{"name":"StaticNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"ElasticIp","value":"false","canchooseservicecapability":false},{"name":"AssociatePublicIP","value":"true","canchooseservicecapability":false}]},{"name":"NetworkACL","provider":[{"name":"VpcVirtualRouter"}]}],"forvpc":true,"ispersistent":false,"egressdefaultpolicy":false},
+        {"id":"f9a7b0d0-ce61-4f8d-a360-be1040d67287","name":"DefaultIsolatedNetworkOfferingForVpcNetworksWithInternalLB","displaytext":"Offering
+        for Isolated Vpc networks with Internal LB support","traffictype":"Guest","isdefault":true,"specifyvlan":false,"conservemode":false,"specifyipranges":false,"availability":"Optional","networkrate":200,"state":"Enabled","guestiptype":"Isolated","serviceofferingid":"983410fa-b51b-439c-b8ba-be973804c38f","service":[{"name":"SourceNat","provider":[{"name":"VpcVirtualRouter"}],"capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"false","canchooseservicecapability":false}]},{"name":"Dns","provider":[{"name":"VpcVirtualRouter"}]},{"name":"UserData","provider":[{"name":"VpcVirtualRouter"}]},{"name":"Lb","provider":[{"name":"InternalLbVm"}],"capability":[{"name":"SupportedLBIsolation","value":"dedicated","canchooseservicecapability":false},{"name":"ElasticLb","value":"false","canchooseservicecapability":false},{"name":"InlineMode","value":"false","canchooseservicecapability":false}]},{"name":"Dhcp","provider":[{"name":"VpcVirtualRouter"}]},{"name":"NetworkACL","provider":[{"name":"VpcVirtualRouter"}]}],"forvpc":true,"ispersistent":false,"egressdefaultpolicy":false}
+        ] } }'
+    http_version: 
+  recorded_at: Wed, 18 Dec 2013 21:25:06 GMT
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=createNetwork&displaytext=John&name=John&networkOfferingId=fa126319-f822-4786-9cd3-30bd0c55ca94&response=json&signature=UDcfFqlzwpHJib/9kLKzR0%2BCbyc=&zoneId=39e9e31e-925c-4b55-8d33-f99912b73dfc
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - ! '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '4441'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: US-ASCII
+      string: ! '{ "createnetworkresponse" :  { "network" : {"id":"02e5fd84-e9ea-49f7-ba6a-6d63ea23a27f","name":"John","displaytext":"John","broadcastdomaintype":"Vlan","traffictype":"Guest","gateway":"10.1.1.1","netmask":"255.255.255.0","cidr":"10.1.1.0/24","zoneid":"39e9e31e-925c-4b55-8d33-f99912b73dfc","zonename":"Sandbox-simulator","networkofferingid":"fa126319-f822-4786-9cd3-30bd0c55ca94","networkofferingname":"DefaultIsolatedNetworkOfferingWithSourceNatService","networkofferingdisplaytext":"Offering
+        for Isolated networks with Source Nat service enabled","networkofferingconservemode":true,"networkofferingavailability":"Required","issystem":false,"state":"Allocated","related":"02e5fd84-e9ea-49f7-ba6a-6d63ea23a27f","dns1":"10.147.28.6","type":"Isolated","acltype":"Account","account":"admin","domainid":"ce4585b8-41f5-11e3-aaa7-d6558ad1fb9f","domain":"ROOT","service":[{"name":"SourceNat","capability":[{"name":"SupportedSourceNatTypes","value":"peraccount","canchooseservicecapability":false},{"name":"RedundantRouter","value":"true","canchooseservicecapability":false}]},{"name":"Dns","capability":[{"name":"AllowDnsSuffixModification","value":"true","canchooseservicecapability":false}]},{"name":"UserData"},{"name":"PortForwarding"},{"name":"Firewall","capability":[{"name":"TrafficStatistics","value":"per
+        public ip","canchooseservicecapability":false},{"name":"SupportedTrafficDirection","value":"ingress,
+        egress","canchooseservicecapability":false},{"name":"SupportedProtocols","value":"tcp,udp,icmp","canchooseservicecapability":false},{"name":"MultipleIps","value":"true","canchooseservicecapability":false},{"name":"SupportedEgressProtocols","value":"tcp,udp,icmp,
+        all","canchooseservicecapability":false}]},{"name":"Lb","capability":[{"name":"SupportedLbAlgorithms","value":"roundrobin,leastconn,source","canchooseservicecapability":false},{"name":"LbSchemes","value":"Public","canchooseservicecapability":false},{"name":"SupportedStickinessMethods","value":"[{\"methodname\":\"LbCookie\",\"paramlist\":[{\"paramname\":\"cookie-name\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"mode\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"nocache\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"indirect\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"postonly\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"domain\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"}],\"description\":\"This is loadbalancer cookie based stickiness method.\"},{\"methodname\":\"AppCookie\",\"paramlist\":[{\"paramname\":\"cookie-name\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"length\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"holdtime\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"request-learn\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"prefix\",\"required\":false,\"isflag\":true,\"description\":\"
+        \"},{\"paramname\":\"mode\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"}],\"description\":\"This is App session based sticky method. Define session
+        stickiness on an existing application cookie. It can be used only for a specific
+        http traffic\"},{\"methodname\":\"SourceBased\",\"paramlist\":[{\"paramname\":\"tablesize\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"},{\"paramname\":\"expire\",\"required\":false,\"isflag\":false,\"description\":\"
+        \"}],\"description\":\"This is source based Stickiness method, it can be used
+        for any type of protocol.\"}]","canchooseservicecapability":false},{"name":"SupportedProtocols","value":"tcp,
+        udp","canchooseservicecapability":false},{"name":"SupportedLBIsolation","value":"dedicated","canchooseservicecapability":false}]},{"name":"Dhcp","capability":[{"name":"DhcpAccrossMultipleSubnets","value":"true","canchooseservicecapability":false}]},{"name":"Vpn","capability":[{"name":"SupportedVpnTypes","value":"pptp,l2tp,ipsec","canchooseservicecapability":false},{"name":"VpnTypes","value":"removeaccessvpn","canchooseservicecapability":false}]},{"name":"StaticNat"}],"networkdomain":"cs2sandbox.simulator","physicalnetworkid":"46d08659-81e9-4f31-a589-a15aca972af0","restartrequired":false,"specifyipranges":false,"canusefordeploy":true,"ispersistent":false,"tags":[],"displaynetwork":true}
+        }  }'
+    http_version: 
+  recorded_at: Wed, 18 Dec 2013 21:25:06 GMT
+- request:
+    method: get
+    uri: <CLOUD_STACK_URL>?apiKey=<CLOUD_STACK_API_KEY>&command=createTags&resourceIds=02e5fd84-e9ea-49f7-ba6a-6d63ea23a27f&resourceType=Network&response=json&signature=KnWoymoA3Q34Iz%2BZ9iFEc8R0lEo=&tags%5B0%5D%5B.key%5D=speed&tags%5B0%5D%5B.name%5D=speed&tags%5B0%5D%5B.value%5D=fast
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.8.8
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - ! '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Content-Type:
+      - text/javascript; charset=UTF-8
+      Content-Length:
+      - '75'
+      Server:
+      - Jetty(6.1.26)
+    body:
+      encoding: US-ASCII
+      string: ! '{ "createtagsresponse" : {"jobid":"90bdb3e9-dcd5-4aac-9aa9-1879863082cc"}
+        }'
+    http_version: 
+  recorded_at: Wed, 18 Dec 2013 21:25:07 GMT
+recorded_with: VCR 2.8.0

data/spec/integration/request_spec.rb

@@ -1,5 +1,5 @@
-require 'spec_helper'
-require 'logger'
+require "spec_helper"
+require "logger"
 
 describe "A response to a request sent to the CloudStack API", :vcr do
   let(:io)         { StringIO.new }
@@ -15,9 +15,11 @@ describe "A response to a request sent to the CloudStack API", :vcr do
       apis_path:  File.join(File.dirname(__FILE__), '../fixtures/4.2.json')
     }
   end
+
   let(:client) do
     StackerBee::Client.new(config_hash)
   end
+
   subject { client.list_accounts }
 
   it { should_not be_empty }
@@ -55,10 +57,10 @@ describe "A response to a request sent to the CloudStack API", :vcr do
   end
 
   context "failing to connect" do
-    let(:url) { "http://127.0.0.1:1234/client/api" }
+    let(:url) { "http://127.0.0.1:666/client/api" }
     it "should raise helpful exception" do
       klass = StackerBee::ConnectionError
-      expect(-> { subject }).to raise_error klass, /#{url}/
+      expect{ subject }.to raise_error klass, /#{url}/
     end
   end
 
@@ -113,4 +115,30 @@ describe "A response to a request sent to the CloudStack API", :vcr do
     it { should include "events" }
     it { should_not include "cpuallocated" }
   end
+
+  context "a request parameter with a map" do
+    let(:zone_id) { client.list_zones.first["id"] }
+
+    let(:service_offering_id) do
+      client.list_network_offerings(
+        supported_services: 'sourcenat',
+        type: 'isolated').first["id"]
+    end
+
+    let(:network) do
+      client.create_network(zone_id: zone_id,
+                            network_offering_id: service_offering_id,
+                            name: "John", displaytext: "John")
+    end
+
+    let(:tag) do
+      client.create_tags(resource_type: "Network",
+                         resource_ids: network["id"],
+                         tags: { "speed [lab]" => 'real fast!' })
+    end
+
+    it "can create an object" do
+      tag.should_not be_nil
+    end
+  end
 end

data/spec/units/stacker_bee/dictionary_flattener_spec.rb

@@ -0,0 +1,51 @@
+require 'spec_helper'
+
+describe StackerBee::DictionaryFlattener do
+  let(:lb)               { StackerBee::DictionaryFlattener::LB }
+  let(:rb)               { StackerBee::DictionaryFlattener::RB }
+  let(:string)           { "cool[0].name%21" }
+  let(:tokenized_string) { "cool#{lb}0#{rb}.name%21" }
+
+  describe ".detokenize" do
+    subject { StackerBee::DictionaryFlattener.detokenize(tokenized_string) }
+    it { should eq string  }
+  end
+
+  describe ".tokenize" do
+    subject { StackerBee::DictionaryFlattener.tokenize(string) }
+    it { should eq tokenized_string  }
+  end
+
+  describe ".new" do
+    def prefix(number)
+      StackerBee::DictionaryFlattener.tokenize "rebels[#{number}]"
+    end
+
+    let(:params) do
+      { "time" => "long ago",
+        "rebels" => { "r2" => "d2", "r1" => "", "father" => false } }
+    end
+
+    subject do
+      StackerBee::DictionaryFlattener.new(params).params
+    end
+
+    it "flattens objects in the manner that cloudstack expects" do
+      subject["#{prefix(0)}.name"].should eq "r2"
+      subject["#{prefix(0)}.key"].should eq "r2"
+      subject["#{prefix(0)}.value"].should eq "d2"
+    end
+
+    it "doesnt flatten empty hashes" do
+      subject.should_not have_key "#{prefix(2)}.name"
+    end
+
+    it "handles booleans" do
+      subject["#{prefix(1)}.name"].should eq "father"
+    end
+
+    it "removes original map params" do
+      subject.should_not have_key "rebels"
+    end
+  end
+end

data/spec/units/stacker_bee/request_spec.rb

@@ -8,33 +8,35 @@ describe StackerBee::Request do
       list:     :all,
       nothing:  nil,
       deets:    [:things, :stuff],
+      settings: { cookiename: "Fred", something: "cool" },
       blank:    ''
     }
   end
+
   let(:request)   { StackerBee::Request.new endpoint, api_key, params }
   subject { request }
-  its(:params) do
-    should == {
-      list: :all,
-      api_key: api_key,
-      command: "listStuff",
-      nothing: nil,
-      blank:   '',
-      deets: [:things, :stuff],
-      response: "json"
-    }
-  end
 
   describe "#query_params" do
+    let(:new_params) { params.merge("settings[1].name" => "cool") }
+    let(:flattener)  { double(new: double(params: new_params)) }
+
+    before do
+      stub_const "StackerBee::DictionaryFlattener", flattener
+    end
+
     subject { request.query_params }
+
+    it { should include ["settings[1].name", "cool"] }
     it { should include ["list", :all] }
     it { should include %W(apiKey #{api_key}) }
     it { should include %w(command listStuff) }
     it { should include %w(response json) }
     it { should include %w(deets things,stuff) }
+
     it "removes params with nil values" do
       subject.map(&:first).should_not include "nothing"
     end
+
     it "removes params with blank values" do
       subject.map(&:first).should_not include "blank"
     end

data/spec/units/stacker_bee/utilities_spec.rb

@@ -6,6 +6,7 @@ describe StackerBee::Utilities, "#uncase" do
   it { uncase("foo_bar").should eq "foobar" }
   it { uncase("foo-bar").should eq "foobar" }
   it { uncase("fooBar").should eq "foobar" }
+  it { uncase("foo[0].Bar").should eq "foo[0].bar" }
 
   it { snake_case("Foo Bar").should eq "foo_bar" }
   it { snake_case("foo_bar").should eq "foo_bar" }
@@ -22,4 +23,5 @@ describe StackerBee::Utilities, "#uncase" do
   it { camel_case("foo-bar", true).should eq "fooBar" }
   it { camel_case("fooBar", true).should eq "fooBar" }
   it { camel_case("fooBar", false).should eq "FooBar" }
+  it { camel_case("foo[0].Bar", false).should eq "Foo[0].Bar" }
 end

data/stacker_bee.gemspec

@@ -7,8 +7,8 @@ Gem::Specification.new do |spec|
   spec.name          = "stacker_bee"
   spec.version       = StackerBee::VERSION
   spec.platform      = Gem::Platform::RUBY
-  spec.authors       = ["Greg Sterndale"]
-  spec.email         = ["greg@promptworks.com"]
+  spec.authors       = ["Greg Sterndale", "Mike Nicholaides"]
+  spec.email         = ["team@promptworks.com"]
   spec.summary       = %q{Ruby CloudStack client}
   spec.description   = %q{Ruby CloudStack client and CLI}
   spec.homepage      = "http://github.com/promptworks/stacker_bee"
@@ -27,4 +27,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rspec",    "~> 2.1"
   spec.add_development_dependency "webmock",  "~> 1.15"
   spec.add_development_dependency "vcr",      "~> 2.6"
+  spec.add_development_dependency "rubocop"
 end

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: stacker_bee
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Greg Sterndale
+- Mike Nicholaides
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-01 00:00:00.000000000 Z
+date: 2013-12-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -108,9 +109,23 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Ruby CloudStack client and CLI
 email:
-- greg@promptworks.com
+- team@promptworks.com
 executables:
 - stacker_bee
 extensions: []
@@ -133,6 +148,8 @@ files:
 - lib/stacker_bee/client.rb
 - lib/stacker_bee/configuration.rb
 - lib/stacker_bee/connection.rb
+- lib/stacker_bee/dictionary_flattener.rb
+- lib/stacker_bee/middleware/detokenizer.rb
 - lib/stacker_bee/middleware/logger.rb
 - lib/stacker_bee/middleware/signed_query.rb
 - lib/stacker_bee/rash.rb
@@ -143,6 +160,8 @@ files:
 - lib/stacker_bee/version.rb
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/.yml
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_nil_request_parameter/properly_executes_the_request.yml
+- spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_a_Map/can_create_an_object.yml
+- spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_a_Map/object.yml
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_an_Array/.yml
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_and_empty_string/properly_executes_the_request.yml
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/containing_an_error/.yml
@@ -162,6 +181,7 @@ files:
 - spec/units/stacker_bee/client_spec.rb
 - spec/units/stacker_bee/configuration_spec.rb
 - spec/units/stacker_bee/connection_spec.rb
+- spec/units/stacker_bee/dictionary_flattener_spec.rb
 - spec/units/stacker_bee/middleware/logger_spec.rb
 - spec/units/stacker_bee/rash_spec.rb
 - spec/units/stacker_bee/request_error_spec.rb
@@ -197,6 +217,8 @@ summary: Ruby CloudStack client
 test_files:
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/.yml
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_nil_request_parameter/properly_executes_the_request.yml
+- spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_a_Map/can_create_an_object.yml
+- spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_a_Map/object.yml
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_an_Array/.yml
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/a_request_parameter_with_and_empty_string/properly_executes_the_request.yml
 - spec/cassettes/A_response_to_a_request_sent_to_the_CloudStack_API/containing_an_error/.yml
@@ -216,6 +238,7 @@ test_files:
 - spec/units/stacker_bee/client_spec.rb
 - spec/units/stacker_bee/configuration_spec.rb
 - spec/units/stacker_bee/connection_spec.rb
+- spec/units/stacker_bee/dictionary_flattener_spec.rb
 - spec/units/stacker_bee/middleware/logger_spec.rb
 - spec/units/stacker_bee/rash_spec.rb
 - spec/units/stacker_bee/request_error_spec.rb