fog-maestrodev 1.19.0.20140212012611 → 1.20.0.20140305101305

data/lib/fog/rackspace/databases.rb

@@ -1,4 +1,4 @@
-require File.expand_path(File.join(File.dirname(__FILE__), '..', 'rackspace'))
+require 'fog/rackspace/core'
 
 module Fog
   module Rackspace
@@ -143,6 +143,10 @@ module Fog
             regions = @identity_service.service_catalog.display_service_regions(service_name)
             Fog::Logger.deprecation("Please specify region using :rackspace_region rather than :rackspace_endpoint. Valid region for :rackspace_region are #{regions}.")
           end
+
+          unless options[:rackspace_region]
+            Fog::Logger.deprecation("Default region support will be removed in an upcoming release. Please switch to manually setting your endpoint. This requires settng the :rackspace_region option")
+          end
         end
 
         def append_tenant_v1(credentials)

data/lib/fog/rackspace/dns.rb

@@ -1,4 +1,4 @@
-require 'fog/rackspace'
+require 'fog/rackspace/core'
 require 'fog/dns'
 
 module Fog

data/lib/fog/rackspace/docs/compute_v2.md

@@ -250,8 +250,6 @@ This returns a collection of `Fog::Compute::RackspaceV2::Image` models:
         >,
 	…
 
-**Note**: In order to speed up access `service.images` does not retrieve all attribute values. To retrieve additional details you will either need to `reload` each individual image or use the request abstraction.
-
 ## Get Image
 
 To retrieve individual image:
@@ -276,13 +274,11 @@ This returns an `Fog::Compute::RackspaceV2::Image` instance:
       links=[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "rel"=>"bookmark"}, {"href"=>"https://ord.images.api.rackspacecloud.com/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "type"=>"application/vnd.openstack.image", "rel"=>"alternate"}]
     > 
     
-**Note**: This request populates all Image attributes.
-
 ## List Flavors
 
 To retrieve a list of available flavors:
 
-	service.images
+	service.flavors
 	
 This returns a collection of `Fog::Compute::RackspaceV2::Flavor` models:
 
@@ -305,8 +301,6 @@ This returns a collection of `Fog::Compute::RackspaceV2::Flavor` models:
         links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/flavors/3", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/flavors/3", "rel"=>"bookmark"}]
       >,
 	…
-	
-**Note**: In order to speed up access `service.flavors` does not retrieve all attribute values. To retrieve additional details you will either need to `reload` each individual flavor or use the request abstraction.
 
 
 ## Get Flavor
@@ -325,8 +319,6 @@ This returns a `Fog::Compute::RackspaceV2::Flavor` instance:
     vcpus=1,
     links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/flavors/2", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/flavors/2", "rel"=>"bookmark"}]
     >
-    
-**Note**: This request populates all Flavor attributes.
 
 
 ## List Servers
@@ -486,7 +478,7 @@ The `create` method also supports the following key values:
 	</tr>
 	<tr>
 		<td>:personality</td>
-		<td>Array of files to be injected onto the server. Please refer to the Fog <a href="http://rubydoc.info/github/fog/fog/Fog/Compute/RackspaceV2/Servers:bootstrap">bootstrap </a> API documentation for further information.</td>
+		<td>Array of files to be injected onto the server. Please refer to the Fog <a href="http://rubydoc.info/github/fog/fog/Fog/Compute/RackspaceV2/Server:personality">personality </a> API documentation for further information.</td>
 	</tr>
 </table>
 

data/lib/fog/rackspace/errors.rb

@@ -31,4 +31,4 @@ module Fog
       end
     end
   end
-end
+end

data/lib/fog/rackspace/examples/storage/upload_file.rb

@@ -40,6 +40,6 @@ directory = service.directories.create :key => directory_name, :public => true
 upload_file = File.join(File.dirname(__FILE__), "lorem.txt")
 file = directory.files.create :key => 'sample.txt', :body => File.open(upload_file, "r")
 
-puts "You should not be able to view this file via CDN at #{file.public_url}"
+puts "You should be able to view this file via CDN at #{file.public_url}"
 puts "To delete the container and associated file please execute the delete_directory.rb script\n\n"
   

data/lib/fog/rackspace/identity.rb

@@ -1,4 +1,4 @@
-require 'fog/rackspace'
+require 'fog/rackspace/core'
 
 module Fog
   module Rackspace
@@ -34,18 +34,16 @@ module Fog
       request :update_user
       request :delete_user
 
-      class Mock < Fog::Rackspace::Service
-        attr_reader :service_catalog
-        
-        def request
-          Fog::Mock.not_implemented
+      module Common
+        attr_reader :service_catalog, :auth_token
+
+        def authenticate(options={})
+          data = self.create_token(@rackspace_username, @rackspace_api_key).body
+          @service_catalog = ServiceCatalog.from_response(self, data)
+          @auth_token = data['access']['token']['id']
         end
-      end
 
-      class Real < Fog::Rackspace::Service
-        attr_reader :service_catalog, :auth_token
-        
-        def initialize(options={})
+        def apply_options(options)
           @rackspace_username = options[:rackspace_username]
           @rackspace_api_key = options[:rackspace_api_key]
           @rackspace_region = options[:rackspace_region]
@@ -58,15 +56,27 @@ module Fog
           @scheme = @uri.scheme
           @persistent = options[:persistent] || false
           @connection_options = options[:connection_options] || {}
-          @connection = Fog::Connection.new(@uri.to_s, @persistent, @connection_options)
+        end
+      end
+
+      class Mock < Fog::Rackspace::Service
+        include Common
+
+        def initialize(options={})
+          apply_options(options)
 
           authenticate
         end
+      end
+
+      class Real < Fog::Rackspace::Service
+        include Common
         
-        def authenticate(options={})
-          data = self.create_token(@rackspace_username, @rackspace_api_key).body
-          @service_catalog = ServiceCatalog.from_response(self, data)
-          @auth_token = data['access']['token']['id']
+        def initialize(options={})
+          apply_options(options)
+          @connection = Fog::Connection.new(@uri.to_s, @persistent, @connection_options)
+
+          authenticate
         end
       end
     end

data/lib/fog/rackspace/load_balancers.rb

@@ -1,4 +1,4 @@
-require 'fog/rackspace'
+require 'fog/rackspace/core'
 
 module Fog
   module Rackspace
@@ -116,6 +116,8 @@ module Fog
 
           authenticate
 
+          deprecation_warnings(options)
+
           @persistent = options[:persistent] || false
           @connection = Fog::Connection.new(endpoint_uri.to_s, @persistent, @connection_options)
         end
@@ -186,6 +188,10 @@ module Fog
             regions = @identity_service.service_catalog.display_service_regions(service_name)
             Fog::Logger.deprecation("Please specify region using :rackspace_region rather than :rackspace_endpoint. Valid regions for :rackspace_region are #{regions}.")
           end
+
+          unless options[:rackspace_region]
+            Fog::Logger.deprecation("Default region support will be removed in an upcoming release. Please switch to manually setting your endpoint. This requires settng the :rackspace_region option")
+          end
         end
 
         def append_tenant_v1(credentials)

data/lib/fog/rackspace/mock_data.rb

@@ -232,6 +232,23 @@ module Fog
       def self.zulu_time
         Time.now.strftime("%Y-%m-%dT%H:%M:%SZ")
       end
+
+      def self.stringify(message)
+        case message
+        when Symbol
+          message.to_s
+        when Hash
+          result = Hash.new
+          message.each do |key, value|
+            nk = stringify(key)
+            nv = stringify(value)
+            result[nk] = nv
+          end
+          result
+        else
+          message
+        end
+      end
     end
   end
 end

data/lib/fog/rackspace/models/compute/server.rb

@@ -80,8 +80,8 @@ module Fog
         end
 
         def setup(credentials = {})
-          requires :public_ip_address, :identity, :public_key, :username
-          Fog::SSH.new(public_ip_address, username, credentials).run([
+          requires :ssh_ip_address, :identity, :public_key, :username
+          Fog::SSH.new(ssh_ip_address, username, credentials).run([
             %{mkdir .ssh},
             %{echo "#{public_key}" >> ~/.ssh/authorized_keys},
             %{passwd -l #{username}},

data/lib/fog/rackspace/models/compute_v2/key_pair.rb

@@ -33,7 +33,7 @@ module Fog
         # @raise  [Fog::Compute::RackspaceV2::ServiceError]
         def save
           requires :name
-          data = service.create_keypair(name, public_key)
+          data = service.create_keypair(name, attributes)
           merge_attributes(data.body['keypair'])
           data.body['keypair']['name'] == name
         end

data/lib/fog/rackspace/models/compute_v2/server.rb

@@ -137,10 +137,16 @@ module Fog
         # @return [String] The image Id.
         # @see http://docs.rackspace.com/servers/api/v2/cs-devguide/content/List_Images-d1e4435.html
         attribute :image_id, :aliases => 'image', :squash => 'id'
+
         # @!attribute [r] password
         # @return [String] Password for system adminstrator account. 
         # @note This value is ONLY populated on server creation.
-        attr_reader :password 
+        attr_reader :password
+
+        # @!attribute [rw] key_name
+        # @return [String] The name of the key_pair used for server.
+        # @note The key_pair/key_name is used to specify the keypair used for server creation. It is not populated by cloud servers.
+        attribute :key_name
 
 
         def initialize(attributes={})
@@ -170,6 +176,27 @@ module Fog
           metadata.from_hash(hash)
         end
 
+        # Returns the key pair based on the key_name of the server
+        # @return [KeyPair]
+        # @note The key_pair/key_name is used to specify the keypair used for server creation. It is not populated by cloud servers.
+        def key_pair
+          requires :key_name
+
+          service.key_pairs.get(key_name)
+        end
+
+        # Sets the key_pair used by the server.
+        # @param new_keypair [KeyPair] key_pair object for server
+        # @note The key_pair/key_name is used to specify the keypair used for server creation. It is not populated by cloud servers.
+        def key_pair=(new_keypair)
+          if new_keypair.is_a?(String)
+             Fog::Logger.deprecation("#key_pair= should be used to set KeyPair objects. Please use #key_name method instead")
+            self.key_name = new_keypair
+          else
+            self.key_name = new_keypair && new_keypair.name
+          end
+        end
+
         # Saves the server.
         # Creates server if it is new, otherwise it will update server attributes name, accessIPv4, and accessIPv6.
         # @return [Boolean] true if server has started saving
@@ -201,11 +228,16 @@ module Fog
           requires :name, :image_id, :flavor_id
           modified_options = Marshal.load(Marshal.dump(options))
 
+          if attributes[:keypair]
+            Fog::Logger.deprecation(":keypair has been depreciated. Please use :key_name instead.")
+            modified_options[:key_name] = attributes[:keypair]
+          end
+
           modified_options[:networks] ||= attributes[:networks]
           modified_options[:disk_config] = disk_config unless disk_config.nil?
           modified_options[:metadata] = metadata.to_hash unless @metadata.nil?
           modified_options[:personality] = personality unless personality.nil?
-          modified_options[:keypair] ||= attributes[:keypair]
+          modified_options[:key_name] ||= attributes[:key_name]
 
           if modified_options[:networks]
             modified_options[:networks].map! { |id| { :uuid => id } }
@@ -521,15 +553,20 @@ module Fog
         # Setup server for SSH access
         # @see Servers#bootstrap
         def setup(credentials = {})
-          requires :public_ip_address, :identity, :public_key, :username
+          requires :ssh_ip_address, :identity, :public_key, :username
+
           commands = [
             %{mkdir .ssh},
             %{echo "#{public_key}" >> ~/.ssh/authorized_keys},
             password_lock,
             %{echo "#{Fog::JSON.encode(attributes)}" >> ~/attributes.json},
             %{echo "#{Fog::JSON.encode(metadata)}" >> ~/metadata.json}
-          ].compact
-          Fog::SSH.new(public_ip_address, username, credentials).run(commands)
+          ]
+          commands.compact
+
+          @password = nil if password_lock
+
+          Fog::SSH.new(ssh_ip_address, username, credentials).run(commands)
         rescue Errno::ECONNREFUSED
           sleep(1)
           retry

data/lib/fog/rackspace/models/monitoring/entities.rb

@@ -13,7 +13,7 @@ module Fog
 
         def all(options={})
           data = service.list_entities(options).body
-          marker = data['metadata']['next_marker']
+          self.marker = data['metadata']['next_marker']
 
           load(data['values'])
         end

data/lib/fog/rackspace/models/queues/claim.rb

@@ -94,6 +94,14 @@ module Fog
           end
         end
 
+        def initialize(new_attributes = {})
+          # A hack in support of the #messages= hack up above. #messages= requires #collection to
+          # be populated first to succeed, which is always the case in modern Rubies that preserve
+          # Hash ordering, but not in 1.8.7.
+          @collection = new_attributes.delete(:collection)
+          super(new_attributes)
+        end
+
         private
 
         def queue
@@ -109,7 +117,7 @@ module Fog
           response = service.create_claim(queue.identity, ttl, grace, options)
 
           if [200, 201].include? response.status
-            self.identity = response.headers['Location'].split('/').last
+            self.identity = response.get_header('Location').split('/').last
             self.messages = response.body
 
             #Since Claims aren't a server side collection, we need to

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

@@ -166,8 +166,11 @@ module Fog
         def save
           requires :key
           create_or_update_container
-          raise Fog::Storage::Rackspace::Error.new("Directory can not be set as :public without a CDN provided") if public? && !cdn_enabled?
-          @urls = service.cdn.publish_container(self, public?)
+          if cdn_enabled?
+            @urls = service.cdn.publish_container(self, public?)
+          else
+            raise Fog::Storage::Rackspace::Error.new("Directory can not be set as :public without a CDN provided") if public?
+          end
           true
         end
         

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

@@ -47,6 +47,18 @@ module Fog
         # @see http://docs.rackspace.com/files/api/v1/cf-devguide/content/Enabling_File_Compression_with_the_Content-Encoding_Header-d1e2198.html
         attribute :content_encoding, :aliases => 'Content-Encoding'
 
+        # @!attribute [rw] delete_at
+        # A Unix Epoch Timestamp, in integer form, representing the time when this object will be automatically deleted.
+        # @return [Integer] the unix epoch timestamp of when this object will be automatically deleted
+        # @see http://docs.rackspace.com/files/api/v1/cf-devguide/content/Expiring_Objects-e1e3228.html
+        attribute :delete_at, :aliases => ['X-Delete-At']
+
+        # @!attribute [rw] delete_after
+        # A number of seconds representing how long from now this object will be automatically deleted.
+        # @return [Integer] the number of seconds until this object will be automatically deleted
+        # @see http://docs.rackspace.com/files/api/v1/cf-devguide/content/Expiring_Objects-e1e3228.html
+        attribute :delete_after, :aliases => ['X-Delete-After']
+
         # @!attribute [r] directory
         # @return [Fog::Storage::Rackspace::Directory] directory containing file
         attr_accessor :directory
@@ -254,6 +266,8 @@ module Fog
           options['Content-Disposition'] = content_disposition if content_disposition
           options['Etag'] = etag if etag
           options['Content-Encoding'] = content_encoding if content_encoding
+          options['X-Delete-At'] = delete_at if delete_at
+          options['X-Delete-After'] = delete_after if delete_after
           options.merge!(metadata.to_headers)
 
           data = service.put_object(directory.key, key, body, options)

data/lib/fog/rackspace/monitoring.rb

@@ -1,9 +1,8 @@
+require 'fog/rackspace/core'
 # This class originally came from the rackspace-monitoring gem located here:
 # https://github.com/racker/rackspace-monitoring-rb
 # It has been heavily modified for import into Fog master.
 
-require 'fog'
-require 'fog/core'
 
 module Fog
   module Rackspace
@@ -61,6 +60,7 @@ module Fog
 
       request_path 'fog/rackspace/requests/monitoring'
       request      :list_agent_tokens
+      request      :list_agents
       request      :list_alarms
       request      :list_alarm_examples
       request      :list_checks
@@ -72,12 +72,21 @@ module Fog
       request      :list_notification_plans
       request      :list_notifications
 
+      request      :get_agent
       request      :get_agent_token
       request      :get_alarm
       request      :get_alarm_example
       request      :get_check
       request      :get_entity
       request      :get_notification
+      request      :get_cpus_info
+      request      :get_disks_info
+      request      :get_filesystems_info
+      request      :get_memory_info
+      request      :get_network_interfaces_info
+      request      :get_processes_info
+      request      :get_system_info
+      request      :get_logged_in_user_info
 
       request      :create_agent_token
       request      :create_alarm

data/lib/fog/rackspace/queues.rb

@@ -1,4 +1,4 @@
-require File.expand_path(File.join(File.dirname(__FILE__), '..', 'rackspace'))
+require 'fog/rackspace/core'
 
 module Fog
   module Rackspace
@@ -42,23 +42,8 @@ module Fog
       request :update_claim
       request :delete_claim
 
-      class Mock < Fog::Rackspace::Service
-        def request(params)
-          Fog::Mock.not_implemented
-        end
-      end
-
-      class Real < Fog::Rackspace::Service
-
-        def service_name
-          :cloudQueues
-        end
-
-        def region
-          @rackspace_region
-        end
-
-        def initialize(options = {})
+      module Common
+        def apply_options(options)
           @rackspace_api_key = options[:rackspace_api_key]
           @rackspace_username = options[:rackspace_username]
           @rackspace_queues_client_id = options[:rackspace_queues_client_id] || Fog::UUID.uuid
@@ -70,25 +55,14 @@ module Fog
           unless v2_authentication?
             raise Fog::Errors::NotImplemented.new("V2 authentication required for Queues")
           end
+        end
 
-          authenticate
-
-          @persistent = options[:persistent] || false
-          @connection = Fog::Connection.new(endpoint_uri.to_s, @persistent, @connection_options)
+        def service_name
+          :cloudQueues
         end
 
-        def request(params, parse_json = true, &block)
-          super(params, parse_json, &block)
-        rescue Excon::Errors::NotFound => error
-          raise NotFound.slurp(error, self)
-        rescue Excon::Errors::BadRequest => error
-          raise BadRequest.slurp(error, self)
-        rescue Excon::Errors::InternalServerError => error
-          raise InternalServerError.slurp(error, self)
-        rescue Excon::Errors::MethodNotAllowed => error
-          raise MethodNotAllowed.slurp(error, self)
-        rescue Excon::Errors::HTTPStatusError => error
-          raise ServiceError.slurp(error, self)
+        def region
+          @rackspace_region
         end
 
         def endpoint_uri(service_endpoint_url=nil)
@@ -112,6 +86,316 @@ module Fog
           @rackspace_queues_client_id = client_id
         end
       end
+
+      class Mock < Fog::Rackspace::Service
+        include Common
+
+        PATH_BASE = "/v1/queues"
+
+        # An in-memory Queue implementation.
+        class MockQueue
+          attr_accessor :name, :metadata, :messages, :claims
+
+          def initialize(name)
+            @name, @metadata = name, {}
+            @messages, @claims = [], {}
+            @id_counter = Fog::Mock.random_hex(24).to_i(16)
+          end
+
+          # The total number of messages currently on the queue.
+          #
+          # @return [Integer]
+          def total
+            @messages.size
+          end
+
+          # The number of messages currently held by a claim.
+          #
+          # @return [Integer]
+          def claimed
+            @messages.count { |msg| msg.claimed? }
+          end
+
+          # The number of messages not held by any claim.
+          #
+          # @return [Integer]
+          def free
+            @messages.count { |msg| ! msg.claimed? }
+          end
+
+          # The oldest published message on this queue, or `nil`.
+          #
+          # @return [MockMessage|UndefinedObject]
+          def oldest
+            @messages.first
+          end
+
+          # The most recently published message on this queue, or `nil`.
+          #
+          # @return [MockMessage|UndefinedObject]
+          def newest
+            @messages.last
+          end
+
+          # Append a new message to the queue.
+          #
+          # @param client_id [String] UUID for the service object.
+          # @param data [Hash] Message payload.
+          # @param ttl [Integer] Number of seconds that the message should exist.
+          # @return [MockMessage] The message object that was created.
+          def add_message(client_id, data, ttl)
+            id = @id_counter.to_s(16)
+            @id_counter += 1
+            message = MockMessage.new(id, self, client_id, data, ttl)
+            @messages << message
+            message
+          end
+
+          # Create a new MockClaim.
+          #
+          # @param ttl [Integer] Time-to-live for the claim.
+          # @param grace [Integer] Grace period that's added to messages included in this claim.
+          def add_claim(ttl, grace)
+            claim = MockClaim.new(self, ttl, grace)
+            claims[claim.id] = claim
+            claim
+          end
+
+          # Access an existing MockClaim by id.
+          #
+          # @param claim_id [String] An ID of an existing claim.
+          # @raises [Fog::Rackspace::Queues::NotFound] If no MockClaim with this ID exists.
+          # @return [MockClaim] The requested MockClaim.
+          def claim!(claim_id)
+            claims[claim_id] or raise NotFound.new
+          end
+
+          # Remove any messages or claims whose ttls have expired.
+          def ageoff
+            messages.reject! { |m| m.expired? }
+
+            claims.keys.dup.each do |id|
+              claim = claims[id]
+              if claim.expired? || claim.messages.empty?
+                claim.messages.each { |m| m.claim = nil }
+                claims.delete(id)
+              end
+            end
+          end
+        end
+
+        # A single message posted to an in-memory MockQueue.
+        class MockMessage
+          attr_accessor :id, :queue, :data, :ttl, :producer_id
+          attr_accessor :claim, :created
+
+          # Create a new message. Use {MockQueue#add_message} instead.
+          def initialize(id, queue, client_id, data, ttl)
+            @id, @queue, @producer_id = id, queue, client_id
+            @data, @ttl = data, ttl
+            @created = Time.now.to_i
+            @claim = nil
+          end
+
+          # Determine how long ago this message was created, in seconds.
+          #
+          # @return [Integer]
+          def age
+            Time.now.to_i - @created
+          end
+
+          # Generate a URI segment that identifies this message.
+          #
+          # @return [String]
+          def href
+            "#{PATH_BASE}/#{@queue.name}/messages/#{@id}"
+          end
+
+          # Return true if this message has been claimed.
+          #
+          # @return [Boolean]
+          def claimed?
+            ! @claim.nil?
+          end
+
+          # Determine if this message has lived longer than its designated ttl.
+          #
+          # @return [Boolean]
+          def expired?
+            age > ttl
+          end
+
+          # Extend the {#ttl} of this message to include the lifetime of the claim it belongs to,
+          # plus the claim's grace period.
+          def extend_life
+            return unless @claim
+            extended = claim.message_end_of_life - @created
+            @ttl = extended if extended > @ttl
+          end
+
+          # Convert this message to a GET payload.
+          #
+          # @return [Hash]
+          def to_h
+            {
+              "body" => @data,
+              "age" => age,
+              "ttl" => @ttl,
+              "href" => href
+            }
+          end
+        end
+
+        # Reservation indicating that a consumer is in the process of handling a collection of
+        # messages from a queue.
+        class MockClaim
+          attr_accessor :id, :queue, :ttl, :grace
+
+          # Create a new MockClaim. Clients should use {MockQueue#add_claim} instead.
+          #
+          # @param queue [MockQueue] The queue that owns this claim.
+          # @param ttl [Integer] Duration, in seconds, that this queue should last.
+          # @param grace [Integer] Extra life granted to messages within this claim after this
+          #   claim expires, to give another consumer a chance to process it.
+          def initialize(queue, ttl, grace)
+            @queue = queue
+            @id = Fog::Mock.random_hex(24)
+            @ttl, @grace = ttl, grace
+            touch!
+          end
+
+          # Set or reset the creation time of the claim to the present.
+          def touch!
+            @created = Time.now.to_i
+          end
+
+          # Calculate the time at which messages belonging to this claim should expire.
+          #
+          # @return [Integer] Seconds since the epoch.
+          def message_end_of_life
+            @created + @ttl + @grace
+          end
+
+          # Determine how long ago this claim was created, in seconds.
+          #
+          # @return [Integer]
+          def age
+            Time.now.to_i - @created
+          end
+
+          # Determine if this claim has lasted longer than its designated ttl.
+          #
+          # @return [Boolean]
+          def expired?
+            age > ttl
+          end
+
+          # Access the collection of messages owned by this claim.
+          #
+          # @return [Array<Message>]
+          def messages
+            @queue.messages.select { |m| m.claim == self }
+          end
+
+          # Convert this claim into a GET payload.
+          #
+          # @return [Hash]
+          def to_h
+            ms = messages.map { |m| m.to_h }
+
+            {
+              "age" => age,
+              "href" => "#{PATH_BASE}/#{@queue.name}/claims/#{@id}",
+              "ttl" => @ttl,
+              "messages" => ms
+            }
+          end
+        end
+
+        def initialize(options = {})
+          apply_options(options)
+          authenticate
+          endpoint_uri
+        end
+
+        def self.data
+          @data ||= Hash.new do |hash, key|
+            hash[key] = {}
+          end
+        end
+
+        def data
+          self.class.data[@rackspace_username]
+        end
+
+        # Create and remember a MockQueue with a given name. An existing MockQueue with the same
+        # name will be overridden without warning.
+        #
+        # @param [String] Valid queue name.
+        # @return [MockQueue] The MockQueue that was created.
+        def add_queue(queue_name)
+          queue = MockQueue.new(queue_name)
+          data[queue_name] = queue
+          queue
+        end
+
+        # Access a MockQueue with the specified name, or return `nil`.
+        #
+        # @param queue_name [String] Valid queue name.
+        # @return [MockQueue|UndefinedObject] The queue with the specified name, or `nil` if
+        #   it doesn't exist.
+        def mock_queue(queue_name)
+          data[queue_name]
+        end
+
+        # Access a MockQueue with the specified name, raising an exception if it doesn't exist.
+        #
+        # @param queue_name [String] Valid queue name.
+        # @raises [Fog::Rackspace::Queue::NotFound] If there is no queue with the specified name.
+        # @return [MockQueue] The queue with the specified name.
+        def mock_queue!(queue_name)
+          mock_queue(queue_name) or raise NotFound.new
+        end
+
+        # Remove any messages or expire any claims that have exceeded their ttl values. Invoked
+        # before every request.
+        def ageoff
+          data.values.each { |q| q.ageoff }
+        end
+
+        def request(params)
+          ageoff
+          super
+        end
+      end
+
+      class Real < Fog::Rackspace::Service
+        include Common
+
+        def initialize(options = {})
+          apply_options(options)
+
+          authenticate
+
+          @persistent = options[:persistent] || false
+          @connection = Fog::Connection.new(endpoint_uri.to_s, @persistent, @connection_options)
+        end
+
+        def request(params, parse_json = true, &block)
+          super(params, parse_json, &block)
+        rescue Excon::Errors::NotFound => error
+          raise NotFound.slurp(error, self)
+        rescue Excon::Errors::BadRequest => error
+          raise BadRequest.slurp(error, self)
+        rescue Excon::Errors::InternalServerError => error
+          raise InternalServerError.slurp(error, self)
+        rescue Excon::Errors::MethodNotAllowed => error
+          raise MethodNotAllowed.slurp(error, self)
+        rescue Excon::Errors::HTTPStatusError => error
+          raise ServiceError.slurp(error, self)
+        end
+      end
+
     end
   end
 end