fog 1.9.0 → 1.10.0

data/lib/fog/rackspace/models/storage/metadata.rb

@@ -0,0 +1,129 @@
+require 'fog/rackspace/models/storage/directory'
+require 'fog/rackspace/models/storage/file'
+require 'fog/rackspace/models/storage/directories'
+require 'fog/rackspace/models/storage/files'
+
+module Fog
+  module Storage
+    class Rackspace
+      
+      class Metadata
+        
+        OBJECT_META_PREFIX = "X-Object-Meta-"
+        OBJECT_REMOVE_META_PREFIX = "X-Remove-Object-Meta-"
+        CONTAINER_META_PREFIX = "X-Container-Meta-"
+        CONTAINER_REMOVE_META_PREFIX = "X-Remove-Container-Meta-"
+        
+        # Cloud Files will ignore headers without a value
+        DUMMY_VALUE = 1
+        
+        CONTAINER_KEY_REGEX = /^#{CONTAINER_META_PREFIX}(.*)/
+        OBJECT_KEY_REGEX = /^#{OBJECT_META_PREFIX}(.*)/
+        
+        
+        attr_reader :data, :parent
+        
+        def initialize(parent, hash={})
+          @data = hash || {}
+          @deleted_hash = {}
+          @parent = parent
+        end
+                
+        def delete(key)
+          data.delete(key)
+          @deleted_hash[key] = nil
+        end
+                
+        def to_headers
+          headers = {}          
+          h = data.merge(@deleted_hash) 
+          h.each_pair do |k,v|
+            key = to_header_key(k,v)
+            headers[key] = v || DUMMY_VALUE 
+          end
+          
+          headers
+        end
+        
+        def self.from_headers(parent, headers)
+          metadata = Metadata.new(parent)
+          headers.each_pair do |k, v|
+            key = metadata.send(:to_key, k)
+            next unless key
+            metadata.data[key] = v
+          end
+          metadata
+        end   
+        
+        def respond_to?(method_sym, include_private = false)
+          super(method_sym, include_private) || data.respond_to?(method_sym, include_private)
+        end
+                
+        def method_missing(method, *args, &block)
+          data.send(method, *args, &block)
+        end                             
+        
+        private
+        
+        def directory?
+          [Fog::Storage::Rackspace::Directory, Fog::Storage::Rackspace::Directories].include? parent_class
+        end
+        
+        def file?
+          [Fog::Storage::Rackspace::File, Fog::Storage::Rackspace::Files].include? parent_class
+        end
+        
+        def parent_class
+          parent.is_a?(Class) ? parent : parent.class
+        end
+        
+        def meta_prefix
+          if directory?
+            CONTAINER_META_PREFIX
+          elsif file?
+            OBJECT_META_PREFIX
+          else
+            raise "Metadata prefix is unknown for #{parent_class}"
+          end
+        end
+
+        def remove_meta_prefix
+          if directory?
+            CONTAINER_REMOVE_META_PREFIX
+          elsif file?
+            OBJECT_REMOVE_META_PREFIX
+          else
+            raise "Remove Metadata prefix is unknown for #{parent_class}"
+          end
+        end
+
+        def meta_prefix_regex
+          if directory?
+            CONTAINER_KEY_REGEX
+          elsif file?
+            OBJECT_KEY_REGEX
+          else
+            raise "Metadata prefix is unknown for #{parent_class}"
+          end
+        end
+        
+        def to_key(key)
+           m = key.match meta_prefix_regex
+           return nil unless m && m[1]
+           
+           a = m[1].split('-')
+           a.collect!(&:downcase)
+           str = a.join('_')
+           str.to_sym
+         end
+                 
+        def to_header_key(key, value)
+          prefix = value.nil? ?  remove_meta_prefix : meta_prefix
+          prefix + key.to_s.split(/[-_]/).collect(&:capitalize).join('-')
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/fog/rackspace/requests/cdn/delete_object.rb

@@ -0,0 +1,37 @@
+module Fog
+  module CDN
+    class Rackspace
+      class Real
+
+        # Delete an existing object
+        #
+        # ==== Parameters
+        # * container<~String> - Name of container to delete
+        # * object<~String> - Name of object to delete
+        #
+        def delete_object(container, object)
+          request(
+            :expects  => 204,
+            :method   => 'DELETE',
+            :path     => "#{Fog::Rackspace.escape(container)}/#{Fog::Rackspace.escape(object)}"
+          )
+        end
+      end
+      
+      class Mock
+        
+        def delete_object(container, object)        
+          response = Excon::Response.new
+          response.status = 204
+          response.headers = {
+            "Content-Length"=>"0", 
+            "Date"=>"Fri, 01 Feb 2013 21:34:33 GMT", 
+            "X-Trans-Id"=>"tx860f26bd76284a849384c0a467767b57"
+          } 
+          response.body = ""
+          response
+        end        
+      end
+    end
+  end
+end

data/lib/fog/rackspace/requests/cdn/get_containers.rb

@@ -26,6 +26,40 @@ module Fog
         end
 
       end
+      
+      class Mock
+        
+        def get_containers(options = {})
+          response = Excon::Response.new
+          response.status = 200
+          response.headers = { 
+            "Content-Length"=>"4402", 
+            "Date"=>"Fri, 01 Feb 2013 21:16:54 GMT", 
+            "Content-Type"=>"application/json", 
+            "X-Trans-Id"=>"tx6c79ea47300941c49f2291b4d47d4ef5"
+          } 
+          response.body = [
+            { "log_retention"=>false, 
+              "cdn_ios_uri"=>"http://a590286a323fec6aed22-d1e9259b2132e81da48ed3e1e802ef22.iosr.cf1.rackcdn.com", 
+              "ttl"=>3600, 
+              "cdn_enabled"=>true, 
+              "cdn_streaming_uri"=>"http://168e307d41afe64f1a62-d1e9259b2132e81da48ed3e1e802ef22.r2.stream.cf1.rackcdn.com", 
+              "name"=>"brown", "cdn_uri"=>"http://6e8f4bf5125c9c2e4e3a-d1e9259b2132e81da48ed3e1e802ef22.r2.cf1.rackcdn.com", 
+              "cdn_ssl_uri"=>"https://f83cb7d39e0b9ff9581b-d1e9259b2132e81da48ed3e1e802ef22.ssl.cf1.rackcdn.com"
+            }, 
+            { "log_retention"=>false, 
+              "cdn_ios_uri"=>"http://b141f80caedd02158f10-cf33674d895dc8b8e6e5207fdbd5cae4.iosr.cf1.rackcdn.com", 
+              "ttl"=>5000, 
+              "cdn_enabled"=>false, 
+              "cdn_streaming_uri"=>"http://ea5feee96b8087a3d5e5-cf33674d895dc8b8e6e5207fdbd5cae4.r72.stream.cf1.rackcdn.com", 
+              "name"=>"fogcontainertests", "cdn_uri"=>"http://0115a9de56617a5d5473-cf33674d895dc8b8e6e5207fdbd5cae4.r72.cf1.rackcdn.com", 
+              "cdn_ssl_uri"=>"https://a5df8bd8a418ca88061e-cf33674d895dc8b8e6e5207fdbd5cae4.ssl.cf1.rackcdn.com"
+            }
+          ] 
+          response
+        end        
+      end
+
     end
   end
 end

data/lib/fog/rackspace/requests/cdn/head_container.rb

@@ -28,6 +28,30 @@ module Fog
         end
 
       end
+      
+      class Mock
+        
+        def head_container(container)
+          raise Fog::Storage::Rackspace::NotFound.new "#{container} not found" unless container == 'fogcontainertests'
+          response = Excon::Response.new
+          response.status = 204
+          response.headers = { 
+            "X-Cdn-Uri"=>"http://e4bbc22477d80eaf22bd-ca4e4e61e477bbd430e1f5b9dc9a19f5.r53.cf1.rackcdn.com", 
+            "X-Cdn-Ios-Uri"=>"http://3c10ef49037f74416445-ca4e4e61e477bbd430e1f5b9dc9a19f5.iosr.cf1.rackcdn.com", 
+            "X-Cdn-Ssl-Uri"=>"https://b722b8ee248259c37901-ca4e4e61e477bbd430e1f5b9dc9a19f5.ssl.cf1.rackcdn.com", 
+            "X-Log-Retention"=>"False", 
+            "X-Cdn-Enabled"=>"True", 
+            "Content-Length"=>"0", 
+            "Date"=>"Fri, 01 Feb 2013 21:25:57 GMT", 
+            "X-Cdn-Streaming-Uri"=>"http://b82027c64cb4dd03670a-ca4e4e61e477bbd430e1f5b9dc9a19f5.r53.stream.cf1.rackcdn.com", 
+            "X-Ttl"=>"259200", 
+            "X-Trans-Id"=>"txca40ffd0412943608bb3e9656c8b81ef"
+          }             
+          response.body = "" 
+          response
+        end        
+      end
+      
     end
   end
 end

data/lib/fog/rackspace/requests/cdn/post_container.rb

@@ -25,6 +25,27 @@ module Fog
         end
 
       end
+      
+      class Mock
+        
+        def post_container(name, options = {})
+          raise Fog::Storage::Rackspace::NotFound.new "#{name} not found" unless name == 'fogcontainertests'
+          response = Excon::Response.new
+          response.status = 202
+          response.headers = { 
+            "X-Cdn-Uri"=>"http://e4bbc22477d80eaf22bd-ca4e4e61e477bbd430e1f5b9dc9a19f5.r53.cf1.rackcdn.com", 
+            "X-Cdn-Ios-Uri"=>"http://3c10ef49037f74416445-ca4e4e61e477bbd430e1f5b9dc9a19f5.iosr.cf1.rackcdn.com", 
+            "X-Cdn-Ssl-Uri"=>"https://b722b8ee248259c37901-ca4e4e61e477bbd430e1f5b9dc9a19f5.ssl.cf1.rackcdn.com", 
+            "Content-Length"=>"58", "Date"=>"Fri, 01 Feb 2013 21:31:30 GMT", 
+            "Content-Type"=>"text/plain; charset=UTF-8", 
+            "X-Cdn-Streaming-Uri"=>"http://b82027c64cb4dd03670a-ca4e4e61e477bbd430e1f5b9dc9a19f5.r53.stream.cf1.rackcdn.com", 
+            "X-Trans-Id"=>"tx4a3206e63dfc446bb5b60e34a62f749d"
+          } 
+          response.body = "202 Accepted\n\nThe request is accepted for processing.\n\n   " 
+          response
+        end        
+      end
+      
     end
   end
 end

data/lib/fog/rackspace/requests/cdn/put_container.rb

@@ -25,6 +25,27 @@ module Fog
         end
 
       end
+      
+      class Mock
+        
+        def put_container(name, options = {})
+          response = Excon::Response.new
+          response.status = 201
+          response.headers = { 
+            "X-Cdn-Uri"=>"http://e4bbc22477d80eaf22bd-ca4e4e61e477bbd430e1f5b9dc9a19f5.r53.cf1.rackcdn.com", 
+            "X-Cdn-Ios-Uri"=>"http://3c10ef49037f74416445-ca4e4e61e477bbd430e1f5b9dc9a19f5.iosr.cf1.rackcdn.com", 
+            "X-Cdn-Ssl-Uri"=>"https://b722b8ee248259c37901-ca4e4e61e477bbd430e1f5b9dc9a19f5.ssl.cf1.rackcdn.com", 
+            "Content-Length"=>"18", 
+            "Date"=>"Fri, 01 Feb 2013 21:21:45 GMT", 
+            "Content-Type"=>"text/plain; charset=UTF-8", 
+            "X-Cdn-Streaming-Uri"=>"http://b82027c64cb4dd03670a-ca4e4e61e477bbd430e1f5b9dc9a19f5.r53.stream.cf1.rackcdn.com", 
+            "X-Trans-Id"=>"tx1b41ec63189f4862baa65e0c08711772"
+          } 
+          response.body = "201 Created\n\n\n\n   " 
+          response
+        end        
+      end
+      
     end
   end
 end

data/lib/fog/rackspace/requests/compute_v2/attach_volume.rb

@@ -2,6 +2,19 @@ module Fog
   module Compute
     class RackspaceV2
       class Real
+        
+        # This operation attaches a volume to the specified server.
+        # @param [String] server_id
+        # @param [String] volume_id
+        # @param [String] device name of the device /dev/xvd[a-p]  (optional)
+        # @return [Excon::Response] response:
+        #   * body [Hash]:
+        #     * volumeAttachment [Hash]:
+        #       * device [String] - The name of the device, such as /dev/xvdb. Specify auto for auto-assignment.
+        #       * serverId [String] - The id of the server that attached the volume
+        #       * id [String] - The id of the attachment
+        #       * volumeId [String] - The id of the volume that was attached
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Attach_Volume_to_Server.html
         def attach_volume(server_id, volume_id, device)
           data = {
             'volumeAttachment' => {

data/lib/fog/rackspace/requests/compute_v2/change_server_password.rb

@@ -2,6 +2,13 @@ module Fog
   module Compute
     class RackspaceV2
       class Real
+        
+        # Changes server admin password
+        # @param [String] server_id 
+        # @param [String] password
+        # @return [Excon::Response] response
+        # @note Though Rackspace does not enforce complexity requirements for the password, the operating system might. If the password is not complex enough, the server might enter an ERROR state.
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Change_Password-d1e3234.html        
         def change_server_password(server_id, password)
           data = {
             'changePassword' => {

data/lib/fog/rackspace/requests/compute_v2/confirm_resize_server.rb

@@ -2,6 +2,15 @@ module Fog
   module Compute
     class RackspaceV2
       class Real
+        
+        # Confirm server resize operation
+        # @param [String] server_id The id of the server to revert
+        # @note All resizes are automatically confirmed after 24 hours if you do not explicitly confirm or revert the resize.
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Revert_Resized_Server-d1e4024.html
+        #
+        # * Status Transition:
+        #   * VERIFY_RESIZE -> ACTIVE
+        #   * VERIFY_RESIZE -> ERROR (on error)        
         def confirm_resize_server(server_id)
           data = {
             'confirmResize' => nil

data/lib/fog/rackspace/requests/compute_v2/create_image.rb

@@ -5,11 +5,15 @@ module Fog
 
         # Create an image from a running server
         #
-        # ==== Parameters
-        # * server_id<~Integer> - Id of server to create image from
-        # * name - Name of image
-        # * options<~Hash> - Name
-
+        # @param [String] server_id Id of server to create image from
+        # @param [String] name name for created image
+        # @param [Hash] options
+        # @option options [Hash ]:metadata - key value pairs of image metadata
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Create_Image-d1e4655.html
+        #
+        #   * State Transition:
+        #     * SAVING -> ACTIVE
+        #     * SAVING  -> ERROR (on error)        
         def create_image(server_id, name, options = {})
           data = {
             'createImage' => {

data/lib/fog/rackspace/requests/compute_v2/create_network.rb

@@ -0,0 +1,36 @@
+module Fog
+  module Compute
+    class RackspaceV2
+      class Real
+        def create_network(label, cidr)
+          data = {
+            'network' => {
+              'label' => label,
+              'cidr' => cidr
+            }
+          }
+
+          request(
+            :method => 'POST',
+            :body => Fog::JSON.encode(data),
+            :path => "os-networksv2",
+            :expects => 200
+          )
+        end
+      end
+
+      class Mock
+        def create_network(label, cidr)
+          network_id = Fog::Rackspace::MockData.uuid
+
+          self.data[:networks][network_id] = {
+            'id' => network_id,
+            'label' => label,
+            'cidr' => cidr
+          }
+          response(:body => { 'network' => self.data[:networks][network_id] })
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/requests/compute_v2/create_server.rb

@@ -2,6 +2,40 @@ module Fog
   module Compute
     class RackspaceV2
       class Real
+        # Create server
+        # @param [String] name name of server
+        # @param [String] image_id id of the image used to create server
+        # @param [String] flavor_id id of the flavor of the image
+        # @param [String] min_count
+        # @param [String] max_count
+        # @param [Hash] options
+        # @option options [Hash] metadata key value pairs of server metadata
+        # @option options [String] OS-DCF:diskConfig The disk configuration value. (AUTO or MANUAL)
+        # @option options [Hash] personality Hash containing data to inject into the file system of the cloud server instance during server creation.
+        # @return [Excon::Response] response:
+        #   * body [Hash]:        
+        #     * server [Hash]:
+        #       * name [String] - name of server
+        #       * imageRef [String] - id of image used to create server
+        #       * flavorRef [String] - id of flavor used to create server        
+        #       * OS-DCF:diskConfig [String] - The disk configuration value.
+        #       * name [String] - name of server
+        #       * metadata [Hash] - Metadata key and value pairs.
+        #       * personality [Array]: 
+        #           * [Hash]:
+        #             * path - path of the file created
+        #             * contents - Base 64 encoded file contents
+        #       * networks [Array]: 
+        #         * [Hash]: 
+        #           * uuid [String] - uuid of attached network        
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/CreateServers.html
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Server_Metadata-d1e2529.html
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Server_Personality-d1e2543.html
+        # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/ch_extensions.html#diskconfig_attribute
+        #
+        # * State Transitions
+        #   * BUILD -> ACTIVE
+        #   * BUILD -> ERROR (on error)
         def create_server(name, image_id, flavor_id, min_count, max_count, options = {})
           data = {
             'server' => {
@@ -17,6 +51,10 @@ module Fog
           data['server']['OS-DCF:diskConfig'] = options[:disk_config] unless options[:disk_config].nil?
           data['server']['metadata'] = options[:metadata] unless options[:metadata].nil?
           data['server']['personality'] = options[:personality] unless options[:personality].nil?
+          data['server']['networks'] = options[:networks] || [
+            { :uuid => '00000000-0000-0000-0000-000000000000' },
+            { :uuid => '11111111-1111-1111-1111-111111111111' }
+          ]
 
           request(
             :body => Fog::JSON.encode(data),