fog-rackspace 0.1.0

data/lib/fog/rackspace/requests/storage/get_container.rb

@@ -0,0 +1,69 @@
+module Fog
+  module Storage
+    class Rackspace
+      class Real
+        # Get details for container and total bytes stored
+        #
+        # ==== Parameters
+        # * container<~String> - Name of container to retrieve info for
+        # * options<~String>:
+        #   * 'limit'<~String> - Maximum number of objects to return
+        #   * 'marker'<~String> - Only return objects whose name is greater than marker
+        #   * 'prefix'<~String> - Limits results to those starting with prefix
+        #   * 'path'<~String> - Return objects nested in the pseudo path
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * headers<~Hash>:
+        #     * 'X-Account-Container-Count'<~String> - Count of containers
+        #     * 'X-Account-Bytes-Used'<~String> - Bytes used
+        #   * body<~Array>:
+        #     * 'bytes'<~Integer> - Number of bytes used by container
+        #     * 'count'<~Integer> - Number of items in container
+        #     * 'name'<~String> - Name of container
+        #     * item<~Hash>:
+        #       * 'bytes'<~String> - Size of object
+        #       * 'content_type'<~String> Content-Type of object
+        #       * 'hash'<~String> - Hash of object (etag?)
+        #       * 'last_modified'<~String> - Last modified timestamp
+        #       * 'name'<~String> - Name of object
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        def get_container(container, options = {})
+          options = options.reject {|key, value| value.nil?}
+          request(
+            :expects  => 200,
+            :method   => 'GET',
+            :path     => Fog::Rackspace.escape(container),
+            :query    => {'format' => 'json'}.merge!(options)
+          )
+        end
+      end
+
+      class Mock
+        def get_container(container, options = {})
+          c = mock_container! container
+
+          results = []
+          c.objects.each do |key, mock_file|
+            results << {
+              "hash" => mock_file.hash,
+              "last_modified" => mock_file.last_modified.strftime('%Y-%m-%dT%H:%M:%S.%L'),
+              "bytes" => mock_file.bytes_used,
+              "name" => key,
+              "content_type" => mock_file.content_type
+            }
+          end
+
+          response = Excon::Response.new
+          response.status = 200
+          response.headers = c.to_headers
+          response.body = results
+          response
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+module Fog
+  module Storage
+    class Rackspace
+      class Real
+        # List existing storage containers
+        #
+        # ==== Parameters
+        # * options<~Hash>:
+        #   * 'limit'<~Integer> - Upper limit to number of results returned
+        #   * 'marker'<~String> - Only return objects with name greater than this value
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Array>:
+        #     * container<~Hash>:
+        #       * 'bytes'<~Integer>: - Number of bytes used by container
+        #       * 'count'<~Integer>: - Number of items in container
+        #       * 'name'<~String>: - Name of container
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        def get_containers(options = {})
+          options = options.reject {|key, value| value.nil?}
+          request(
+            :expects  => [200, 204],
+            :method   => 'GET',
+            :path     => '',
+            :query    => {'format' => 'json'}.merge!(options)
+          )
+        end
+      end
+
+      class Mock
+        def get_containers(options = {})
+          results = data.map do |name, container|
+            {
+              "name" => name,
+              "count" => container.objects.size,
+              "bytes" => container.bytes_used
+            }
+          end
+          response = Excon::Response.new
+          response.status = 200
+          response.body = results
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/requests/storage/get_object.rb

@@ -0,0 +1,54 @@
+module Fog
+  module Storage
+    class Rackspace
+      class Real
+        # Get details for object
+        #
+        # ==== Parameters
+        # * container<~String> - Name of container to look in
+        # * object<~String> - Name of object to look for
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        def get_object(container, object, &block)
+          params = {
+            :expects  => 200,
+            :method   => 'GET',
+            :path     => "#{Fog::Rackspace.escape(container)}/#{Fog::Rackspace.escape(object)}"
+          }
+
+          if block_given?
+            params[:response_block] = block
+          end
+
+          request(params, false)
+        end
+      end
+
+      class Mock
+        def get_object(container, object, &block)
+          c = mock_container! container
+          o = c.mock_object! object
+
+          body, size = "", 0
+
+          o.each_part do |part|
+            body << part.body
+            size += part.bytes_used
+          end
+
+          if block_given?
+            # Just send it all in one chunk.
+            block.call(body, 0, size)
+          end
+
+          response = Excon::Response.new
+          response.body = body
+          response.headers = o.to_headers
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/requests/storage/get_object_http_url.rb

@@ -0,0 +1,35 @@
+module Fog
+  module Storage
+    class Rackspace
+      module Common
+        # Get an expiring object http url from Cloud Files
+        #
+        # ==== Parameters
+        # * container<~String> - Name of container containing object
+        # * object<~String> - Name of object to get expiring url for
+        # * expires<~Time> - An expiry time for this url
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~String> - url for object
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        # ==== See Also
+        # http://docs.rackspace.com/files/api/v1/cf-devguide/content/Create_TempURL-d1a444.html
+        def get_object_http_url(container, object, expires, options = {})
+          get_object_https_url(container, object, expires, options.merge(:scheme => 'http'))
+        end
+      end
+
+      class Real
+        include Common
+      end
+
+      class Mock
+        include Common
+      end
+    end
+  end
+end

data/lib/fog/rackspace/requests/storage/get_object_https_url.rb

@@ -0,0 +1,71 @@
+module Fog
+  module Storage
+    class Rackspace
+      module Common
+        # Get an expiring object https url from Cloud Files
+        #
+        # ==== Parameters
+        # * container<~String> - Name of container containing object
+        # * object<~String> - Name of object to get expiring url for
+        # * expires<~Time> - An expiry time for this url
+        # * options<~Hash> - Options to override the method or scheme
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~String> - url for object
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        # ==== See Also
+        # http://docs.rackspace.com/files/api/v1/cf-devguide/content/Create_TempURL-d1a444.html
+        def get_object_https_url(container, object, expires, options = {})
+          if @rackspace_temp_url_key.nil?
+            raise ArgumentError, "Storage must be instantiated with the :rackspace_temp_url_key option"
+          end
+
+          method         = options[:method] || 'GET'
+          expires        = expires.to_i
+          object_path_escaped   = "#{@uri.path}/#{Fog::Rackspace.escape(container)}/#{Fog::Rackspace.escape(object,"/")}"
+          object_path_unescaped = "#{@uri.path}/#{Fog::Rackspace.escape(container)}/#{object}"
+          string_to_sign = "#{method}\n#{expires}\n#{object_path_unescaped}"
+
+          hmac = Fog::HMAC.new('sha1', @rackspace_temp_url_key)
+          sig  = sig_to_hex(hmac.sign(string_to_sign))
+
+          temp_url_query = {
+              :temp_url_sig => sig,
+              :temp_url_expires => expires
+          }
+          temp_url_query.merge!(:inline => true) if options[:inline]
+          temp_url_query.merge!(:filename => options[:filename]) if options[:filename]
+          temp_url_options = {
+              :scheme => options[:scheme] || @uri.scheme,
+              :host => @uri.host,
+              :path => object_path_escaped,
+              :query => temp_url_query.map { |param, val| "#{CGI.escape(param.to_s)}=#{CGI.escape(val.to_s)}" }.join('&')
+          }
+          URI::Generic.build(temp_url_options).to_s
+        end
+
+        private
+
+        def sig_to_hex(str)
+          str.unpack("C*").map { |c|
+            c.to_s(16)
+          }.map { |h|
+            h.size == 1 ? "0#{h}" : h
+          }.join
+        end
+      end
+
+      class Mock
+        include Common
+      end
+
+      class Real
+        include Common
+      end
+    end
+  end
+end

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

@@ -0,0 +1,41 @@
+module Fog
+  module Storage
+    class Rackspace
+      class Real
+        # List number of objects and total bytes stored
+        #
+        # ==== Parameters
+        # * container<~String> - Name of container to retrieve info for
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * headers<~Hash>:
+        #     * 'X-Container-Object-Count'<~String> - Count of containers
+        #     * 'X-Container-Bytes-Used'<~String>   - Bytes used
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        def head_container(container)
+          request(
+            :expects  => 204,
+            :method   => 'HEAD',
+            :path     => Fog::Rackspace.escape(container),
+            :query    => {'format' => 'json'}
+          )
+        end
+      end
+
+      class Mock
+        def head_container(container)
+          c = mock_container! container
+
+          response = Excon::Response.new
+          response.status = 204
+          response.headers = c.to_headers
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/requests/storage/head_containers.rb

@@ -0,0 +1,44 @@
+module Fog
+  module Storage
+    class Rackspace
+      class Real
+        # List number of containers and total bytes stored
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * headers<~Hash>:
+        #     * 'X-Account-Container-Count'<~String> - Count of containers
+        #     * 'X-Account-Bytes-Used'<~String> - Bytes used
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        def head_containers
+          request(
+            :expects  => 204,
+            :method   => 'HEAD',
+            :path     => '',
+            :query    => {'format' => 'json'}
+          )
+        end
+      end
+
+      class Mock
+        def head_containers
+          bytes_used = data.values.map { |c| c.bytes_used }.reduce(0) { |a, b| a + b }
+          container_count = data.size
+          object_count = data.values.map { |c| c.objects.size }.reduce(0) { |a, b| a + b }
+
+          response = Excon::Response.new
+          response.status = 204
+          response.headers = {
+            'X-Account-Bytes-Used' => bytes_used,
+            'X-Account-Container-Count' => container_count,
+            'X-Account-Object-Count' => object_count
+          }.merge(account_meta)
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/requests/storage/head_object.rb

@@ -0,0 +1,48 @@
+module Fog
+  module Storage
+    class Rackspace
+      class Real
+        # Get headers for object
+        #
+        # ==== Parameters
+        # * container<~String> - Name of container to look in
+        # * object<~String> - Name of object to look for
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        def head_object(container, object)
+          request({
+            :expects  => 200,
+            :method   => 'HEAD',
+            :path     => "#{Fog::Rackspace.escape(container)}/#{Fog::Rackspace.escape(object)}"
+          }, false)
+        end
+      end
+
+      class Mock
+        def head_object(container, object)
+          c = mock_container! container
+          o = c.mock_object! object
+
+          headers = o.to_headers
+
+          hashes, length = [], 0
+          o.each_part do |part|
+            hashes << part.hash
+            length += part.bytes_used
+          end
+
+          headers['Etag'] = "\"#{Digest::MD5.hexdigest(hashes.join)}\""
+          headers['Content-Length'] = length.to_s
+          headers['X-Static-Large-Object'] = "True" if o.static_manifest?
+
+          response = Excon::Response.new
+          response.status = 200
+          response.headers = headers
+          response
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/requests/storage/post_set_meta_temp_url_key.rb

@@ -0,0 +1,46 @@
+module Fog
+  module Storage
+    class Rackspace
+      class Real
+        # Set the account wide Temp URL Key. This is a secret key that's
+        # used to generate signed expiring URLs.
+        #
+        # Once the key has been set with this request you should create new
+        # Storage objects with the :rackspace_temp_url_key option then use
+        # the get_object_https_url method to generate expiring URLs.
+        #
+        # *** CAUTION *** changing this secret key will invalidate any expiring
+        # URLS generated with old keys.
+        #
+        # ==== Parameters
+        # * key<~String> - The new Temp URL Key
+        #
+        # ==== Returns
+        # * response<~Excon::Response>
+        # @raise [Fog::Storage::Rackspace::NotFound] - HTTP 404
+        # @raise [Fog::Storage::Rackspace::BadRequest] - HTTP 400
+        # @raise [Fog::Storage::Rackspace::InternalServerError] - HTTP 500
+        # @raise [Fog::Storage::Rackspace::ServiceError]
+        # ==== See Also
+        # http://docs.rackspace.com/files/api/v1/cf-devguide/content/Set_Account_Metadata-d1a4460.html
+        def post_set_meta_temp_url_key(key)
+          request(
+            :expects  => [201, 202, 204],
+            :method   => 'POST',
+            :headers  => {'X-Account-Meta-Temp-Url-Key' => key}
+          )
+        end
+      end
+
+      class Mock
+        def post_set_meta_temp_url_key(key)
+          account_meta['X-Account-Meta-Temp-Url-Key'] = key
+
+          response = Excon::Response.new
+          response.status = 204
+          response
+        end
+      end
+    end
+  end
+end