aws 1.11.9 → 1.11.36

data/lib/sdb/right_sdb_interface.rb

@@ -30,9 +30,10 @@ module RightAws
     include RightAwsBaseInterface
 
     DEFAULT_HOST      = 'sdb.amazonaws.com'
-    DEFAULT_PORT      = 80
-    DEFAULT_PROTOCOL  = 'http'
-    API_VERSION       = '2007-11-07'
+    DEFAULT_PORT      = 443
+    DEFAULT_PROTOCOL  = 'https'
+    DEFAULT_SERVICE  = '/'
+    API_VERSION       = '2009-04-15'
     DEFAULT_NIL_REPRESENTATION = 'nil'
 
     @@bench = AwsBenchmarkingBlock.new
@@ -45,16 +46,22 @@ module RightAws
     #
     # Params:
     #    { :server       => 'sdb.amazonaws.com'  # Amazon service host: 'sdb.amazonaws.com'(default)
-    #      :port         => 443                  # Amazon service port: 80 or 443(default)
-    #      :protocol     => 'https'              # Amazon service protocol: 'http' or 'https'(default)
-    #      :signature_version => '0'             # The signature version : '0' or '1'(default)
-    #      :multi_thread => true|false           # Multi-threaded (connection per each thread): true or false(default)
+    #      :port         => 443                  # Amazon service port: 80(default) or 443
+    #      :protocol     => 'https'              # Amazon service protocol: 'http'(default) or 'https'
+    #      :signature_version => '2'             # The signature version : '0', '1' or '2' (default)
+    #      DEPRECATED :multi_thread => true|false           # Multi-threaded (connection per each thread): true or false(default)
+    #      :connection_mode  => :default         # options are :default (will use best known option, may change in the future)
+    #                                                  :per_request (opens and closes a connection on every request to SDB)
+    #                                                  :single - one connection shared across app (same as old multi_thread=>false)
+    #                                                  :per_thread - one connection per ruby thread (same as old multi_thread=>true)
+    #                                                  :pool (uses a connection pool with a maximum number of connections - NOT IMPLEMENTED YET)
     #      :logger       => Logger Object        # Logger instance: logs to STDOUT if omitted
     #      :nil_representation => 'mynil'}       # interpret Ruby nil as this string value; i.e. use this string in SDB to represent Ruby nils (default is the string 'nil')
+    #      :service      => '/'	                 # Set this to /mdb/request.mgwsi for usage with M/DB #
     #
     # Example:
     #
-    #  sdb = RightAws::SdbInterface.new('1E3GDYEOGFJPIT7XXXXXX','hgTHt68JY07JKUY08ftHYtERkjgtfERn57XXXXXX', {:multi_thread => true, :logger => Logger.new('/tmp/x.log')}) #=> #<RightSdb:0xa6b8c27c>
+    #  sdb = RightAws::SdbInterface.new('1E3GDYEOGFJPIT7XXXXXX','hgTHt68JY07JKUY08ftHYtERkjgtfERn57XXXXXX', {:connection_mode => :per_request, :logger => Logger.new('/tmp/x.log')}) #=> #<RightSdb:0xa6b8c27c>
     #
     # see: http://docs.amazonwebservices.com/AmazonSimpleDB/2007-11-07/DeveloperGuide/
     #
@@ -64,7 +71,9 @@ module RightAws
       init({ :name             => 'SDB',
              :default_host     => ENV['SDB_URL'] ? URI.parse(ENV['SDB_URL']).host   : DEFAULT_HOST,
              :default_port     => ENV['SDB_URL'] ? URI.parse(ENV['SDB_URL']).port   : DEFAULT_PORT,
-             :default_protocol => ENV['SDB_URL'] ? URI.parse(ENV['SDB_URL']).scheme : DEFAULT_PROTOCOL },
+             :default_protocol => ENV['SDB_URL'] ? URI.parse(ENV['SDB_URL']).scheme : DEFAULT_PROTOCOL,
+             :default_service  => ENV['SDB_URL'] ? URI.parse(ENV['SDB_URL']).path   : DEFAULT_SERVICE },
+#             :service_endpoint => ENV['SDB_URL'] ? URI.parse(ENV['SDB_URL']).path   : DEFAULT_ENDPOINT },
            aws_access_key_id     || ENV['AWS_ACCESS_KEY_ID'],
            aws_secret_access_key || ENV['AWS_SECRET_ACCESS_KEY'],
            params)
@@ -78,12 +87,13 @@ module RightAws
       params.delete_if {|key,value| value.nil? }
       #params_string  = params.to_a.collect{|key,val| key + "=#{CGI::escape(val.to_s)}" }.join("&")
       # prepare service data
-      service = '/'
+        service = @params[:service]
+#      puts 'service=' + service.to_s
       service_hash = {"Action"         => action,
                       "AWSAccessKeyId" => @aws_access_key_id,
                       "Version"        => API_VERSION }
       service_hash.update(params)
-      service_params = signed_service_params(@aws_secret_access_key, service_hash, :get, @params[:server], service)
+      service_params = signed_service_params(@aws_secret_access_key, service_hash, :get, @params[:server], @params[:service])
       #
       # use POST method if the length of the query string is too large
       # see http://docs.amazonwebservices.com/AmazonSimpleDB/2007-11-07/DeveloperGuide/MakingRESTRequests.html
@@ -201,12 +211,15 @@ module RightAws
     #
     def query_expression_from_array(params) #:nodoc:
       return '' if params.blank?
-      query = params.shift.to_s
+      query = params[0].to_s
+      i = 1
       query.gsub(/(\\)?(\?)/) do
         if $1 # if escaped '\?' is found - replace it by '?' without backslash
           "?"
         else  # well, if no backslash precedes '?' then replace it by next param from the list
-          escape(params.shift)
+          ret = escape(params[i])
+            i+=1
+            ret
         end
       end
     end
@@ -265,6 +278,41 @@ module RightAws
       on_exception
     end
 
+     # Retrieve a list of SDB domains from Amazon.
+    #
+    # Returns a hash:
+    #   { :domains     => [domain1, ..., domainN],
+    #     :next_token => string || nil,
+    #     :box_usage   => string,
+    #     :request_id  => string }
+    #
+    # Example:
+    #
+    #  sdb = RightAws::SdbInterface.new
+    #  sdb.list_domains  #=> { :box_usage  => "0.0000071759",
+    #                          :request_id => "976709f9-0111-2345-92cb-9ce90acd0982",
+    #                          :domains    => ["toys", "dolls"]}
+    #
+    # If a block is given, this method yields to it.  If the block returns true, list_domains will continue looping the request.  If the block returns false,
+    # list_domains will end.
+    #
+    #   sdb.list_domains(10) do |result|   # list by 10 domains per iteration
+    #     puts result.inspect
+    #     true
+    #   end
+    #
+    # see: http://docs.amazonwebservices.com/AmazonSimpleDB/2007-11-07/DeveloperGuide/SDB_API_ListDomains.html
+    #
+    def domain_metadata(domain_name)
+     link   = generate_request("DomainMetadata", 'DomainName' => domain_name)
+     result = request_info(link, QSdbDomainMetadataParser.new)
+     return result
+   rescue Exception
+     on_exception
+    end
+
+
+
     # Create new SDB domain at Amazon.
     #
     # Returns a hash: { :box_usage, :request_id } on success or an exception on error.
@@ -646,22 +694,41 @@ module RightAws
       end
       def tagend(name)
         case name
-        when 'NextToken'  then @result[:next_token] =  @text
-        when 'DomainName' then @result[:domains]    << @text
-        when 'BoxUsage'   then @result[:box_usage]  =  @text
-        when 'RequestId'  then @result[:request_id] =  @text
+            when 'NextToken'  then @result[:next_token] =  @text
+            when 'DomainName' then @result[:domains]    << @text
+            when 'BoxUsage'   then @result[:box_usage]  =  @text
+            when 'RequestId'  then @result[:request_id] =  @text
         end
       end
     end
 
+     class QSdbDomainMetadataParser < RightAWSParser #:nodoc:
+      def reset
+        @result = {}
+      end
+      def tagend(name)
+        case name
+            when 'Timestamp'  then @result[:timestamp] = @text
+            when 'ItemCount' then @result[:item_count] = @text.to_i
+            when 'AttributeValueCount'   then @result[:attribute_value_count]  =  @text.to_i
+            when 'AttributeNameCount'  then @result[:attribute_name_acount] =  @text.to_i
+            when 'ItemNamesSizeBytes'  then @result[:item_names_size_bytes] =  @text.to_i
+            when 'AttributeValuesSizeBytes'  then @result[:attributes_values_size_bytes] =  @text.to_i
+            when 'AttributeNamesSizeBytes'  then @result[:attributes_names_size_bytes] =  @text.to_i
+
+        end
+      end
+    end
+
+
     class QSdbSimpleParser < RightAWSParser #:nodoc:
       def reset
         @result = {}
       end
       def tagend(name)
         case name
-        when 'BoxUsage'  then @result[:box_usage]  =  @text
-        when 'RequestId' then @result[:request_id] =  @text
+            when 'BoxUsage'  then @result[:box_usage]  =  @text
+            when 'RequestId' then @result[:request_id] =  @text
         end
       end
     end
@@ -673,10 +740,10 @@ module RightAws
       end
       def tagend(name)
         case name
-        when 'Name'      then @last_attribute_name = @text
-        when 'Value'     then (@result[:attributes][@last_attribute_name] ||= []) << @text
-        when 'BoxUsage'  then @result[:box_usage]  =  @text
-        when 'RequestId' then @result[:request_id] =  @text
+            when 'Name'      then @last_attribute_name = @text
+            when 'Value'     then (@result[:attributes][@last_attribute_name] ||= []) << @text
+            when 'BoxUsage'  then @result[:box_usage]  =  @text
+            when 'RequestId' then @result[:request_id] =  @text
         end
       end
     end
@@ -687,10 +754,10 @@ module RightAws
       end
       def tagend(name)
         case name
-        when 'ItemName'  then @result[:items]      << @text
-        when 'BoxUsage'  then @result[:box_usage]  =  @text
-        when 'RequestId' then @result[:request_id] =  @text
-        when 'NextToken' then @result[:next_token] =  @text
+            when 'ItemName'  then @result[:items]      << @text
+            when 'BoxUsage'  then @result[:box_usage]  =  @text
+            when 'RequestId' then @result[:request_id] =  @text
+            when 'NextToken' then @result[:next_token] =  @text
         end
       end
     end

data/lib/sqs/right_sqs.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2007-2008 RightScale Inc
+# Copyright (c) 2008 RightScale Inc
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -24,13 +24,18 @@
 module RightAws
 
     #
-    # = RightAws::Sqs -- RightScale's Amazon SQS interface
-    # The RightAws::Sqs class provides a complete interface to Amazon's Simple
+    # RightAws::Sqs -- RightScale's Amazon SQS interface, API version
+    # 2008-01-01 and later.
+    # The RightAws::Sqs class provides a complete interface to the second generation of Amazon's Simple
     # Queue Service.
     # For explanations of the semantics
     # of each call, please refer to Amazon's documentation at
     # http://developer.amazonwebservices.com/connect/kbcategory.jspa?categoryID=31
     #
+    #
+    # RightAws::Sqs is built atop RightAws::SqsInterface, a lower-level
+    # procedural API that may be appropriate for certain programs.
+    #
     # Error handling: all operations raise an RightAws::AwsError in case
     # of problems. Note that transient errors are automatically retried.
     #
@@ -48,13 +53,9 @@ module RightAws
     #  queue2.send_message('Ola-la!')
     #  message2 = queue2.pop
     #   ...
-    #  grantee1 = RightAws::Sqs::Grantee.create(queue2,'one_cool_guy@email.address')
-    #  grantee1.grant('FULLCONTROL')
-    #  grantee1.drop
-    #   ...
-    #  grantee2 = queue.grantees('another_cool_guy@email.address')
-    #  grantee2.revoke('SENDMESSAGE')
-    #       
+    #
+    # NB: Second-generation SQS has eliminated the entire access grant mechanism present in Gen 1.
+    #
     # Params is a hash:
     #
     #    {:server       => 'queue.amazonaws.com' # Amazon service host: 'queue.amazonaws.com' (default)
@@ -62,15 +63,14 @@ module RightAws
     #     :multi_thread => true|false            # Multi-threaded (connection per each thread): true or false (default)
     #     :signature_version => '0'              # The signature version : '0' or '1'(default)
     #     :logger       => Logger Object}        # Logger instance: logs to STDOUT if omitted }
-    #
   class Sqs
     attr_reader :interface
-    
+
     def initialize(aws_access_key_id=nil, aws_secret_access_key=nil, params={})
       @interface = SqsInterface.new(aws_access_key_id, aws_secret_access_key, params)
     end
-    
-      # Retrieves a list of queues. 
+
+      # Retrieves a list of queues.
       # Returns an +array+ of +Queue+ instances.
       #
       #  RightAws::Sqs.queues #=> array of queues
@@ -80,8 +80,8 @@ module RightAws
         Queue.new(self, url)
       end
     end
-    
-      # Returns Queue instance by queue name. 
+
+      # Returns Queue instance by queue name.
       # If the queue does not exist at Amazon SQS and +create+ is true, the method creates it.
       #
       #  RightAws::Sqs.queue('my_awesome_queue') #=> #<RightAws::Sqs::Queue:0xb7b626e4 ... >
@@ -91,12 +91,12 @@ module RightAws
       url = (create ? @interface.create_queue(queue_name, visibility) : nil) unless url
       url ? Queue.new(self, url) : nil
     end
-  
-  
+
+
     class Queue
       attr_reader :name, :url, :sqs
-      
-        # Returns Queue instance by queue name. 
+
+        # Returns Queue instance by queue name.
         # If the queue does not exist at Amazon SQS and +create+ is true, the method creates it.
         #
         #  RightAws::Sqs::Queue.create(sqs, 'my_awesome_queue') #=> #<RightAws::Sqs::Queue:0xb7b626e4 ... >
@@ -104,8 +104,8 @@ module RightAws
       def self.create(sqs, url_or_name, create=true, visibility=nil)
         sqs.queue(url_or_name, create, visibility)
       end
-      
-        # Creates new Queue instance. 
+
+        # Creates new Queue instance.
         # Does not create a queue at Amazon.
         #
         #  queue = RightAws::Sqs::Queue.new(sqs, 'my_awesome_queue')
@@ -115,7 +115,7 @@ module RightAws
         @url  = @sqs.interface.queue_url_by_name(url_or_name)
         @name = @sqs.interface.queue_name_by_url(@url)
       end
-      
+
         # Retrieves queue size.
         #
         #  queue.size #=> 1
@@ -123,64 +123,62 @@ module RightAws
       def size
         @sqs.interface.get_queue_length(@url)
       end
-      
-        # Clears queue. 
-        # Deletes only the visible messages unless +force+ is +true+.
-        #
-        #  queue.clear(true) #=> true
+
+        # Clears queue, deleting only the visible messages.  Any message within its visibility
+        # timeout will not be deleted, and will re-appear in the queue in the
+        # future when the timeout expires.
         #
-        # P.S. when <tt>force==true</tt> the queue deletes then creates again. This is 
-        # the quickest method to clear a big queue or a queue with 'locked' messages. All queue
-        # attributes are restored. But there is no way to restore grantees' permissions to 
-        # this queue. If you have no grantees except 'root' then you have no problems.
-        # Otherwise, it's better to use <tt>queue.clear(false)</tt>.
+        # To delete all messages in a queue and eliminate the chance of any
+        # messages re-appearing in the future, it's best to delete the queue and
+        # re-create it as a new queue.  Note that doing this will take at least 60
+        # s since SQS does not allow re-creation of a queue within this interval.
         #
-        # PS This function is no longer supported.  Amazon has changed the SQS semantics to require at least 60 seconds between 
-        # queue deletion and creation. Hence this method will fail with an exception.
+        #  queue.clear() #=> true
         #
-      def clear(force=false)
-##        if force
-##          @sqs.interface.force_clear_queue(@url)
-##        else
+      def clear()
           @sqs.interface.clear_queue(@url)
-##        end
       end
-      
-        # Deletes queue. 
-        # Queue must be empty or +force+ must be set to +true+. 
-        # Returns +true+. 
+
+        # Deletes queue.  Any messages in the queue will be permanently lost.
+        # Returns +true+.
         #
-        #  queue.delete(true) #=> true
+        # NB: Use with caution; severe data loss is possible!
+        #
+        # queue.delete(true) #=> true
         #
       def delete(force=false)
-        @sqs.interface.delete_queue(@url, force)
+        @sqs.interface.delete_queue(@url)
       end
 
-        # Sends new message to queue. 
+        # Sends new message to queue.
         # Returns new Message instance that has been sent to queue.
       def send_message(message)
         message = message.to_s
-        msg     = Message.new(self, @sqs.interface.send_message(@url, message), message)
+        res = @sqs.interface.send_message(@url, message)
+        msg = Message.new(self, res['MessageId'], nil, message)
+        msg.send_checksum = res['MD5OfMessageBody']
         msg.sent_at = Time.now
         msg
       end
       alias_method :push, :send_message
 
-        # Retrieves several messages from queue. 
-        # Returns an array of Message instances. 
+        # Retrieves several messages from queue.
+        # Returns an array of Message instances.
         #
         #  queue.receive_messages(2,10) #=> array of messages
         #
       def receive_messages(number_of_messages=1, visibility=nil)
-        list = @sqs.interface.receive_messages(@url, number_of_messages, visibility)
+        list = @sqs.interface.receive_message(@url, number_of_messages, visibility)
         list.map! do |entry|
-          msg             = Message.new(self, entry[:id], entry[:body], visibility)
-          msg.received_at = Time.now 
+          msg = Message.new(self, entry['MessageId'], entry['ReceiptHandle'],
+                            entry['Body'], visibility)
+          msg.received_at = Time.now
+          msg.receive_checksum = entry['MD5OfBody']
           msg
         end
       end
-      
-        # Retrieves first accessible message from queue. 
+
+        # Retrieves first accessible message from queue.
         # Returns Message instance or +nil+ it the queue is empty.
         #
         #  queue.receive #=> #<RightAws::Sqs::Message:0xb7bf0884 ... >
@@ -190,52 +188,49 @@ module RightAws
         list.empty? ? nil : list[0]
       end
 
-        # Peeks message body.
-        #
-        #  queue.peek #=> #<RightAws::Sqs::Message:0xb7bf0884 ... >
-        #
-      def peek(message_id)
-        entry = @sqs.interface.peek_message(@url, message_id)
-        msg   = Message.new(self, entry[:id], entry[:body])
-        msg.received_at = Time.now 
-        msg
-      end
-
-        # Pops (and deletes) first accessible message from queue. 
-        # Returns Message instance or +nil+ it the queue is empty.
+        # Pops (and deletes) first accessible message from queue.
+        # Returns Message instance or +nil+ if the queue is empty.
         #
         #  queue.pop #=> #<RightAws::Sqs::Message:0xb7bf0884 ... >
         #
       def pop
-        msg = receive
-        msg.delete if msg
+        list = @sqs.interface.pop_messages(@url, 1)
+        return nil if list.empty?
+        entry = list[0]
+        msg = Message.new(self, entry['MessageId'], entry['ReceiptHandle'],
+                            entry['Body'], visibility)
+        msg.received_at = Time.now
+        msg.receive_checksum = entry['MD5OfBody']
         msg
       end
 
-        # Retrieves +VisibilityTimeout+ value for the queue. 
+        # Retrieves +VisibilityTimeout+ value for the queue.
         # Returns new timeout value.
         #
         #  queue.visibility #=> 30
         #
       def visibility
-        @sqs.interface.get_visibility_timeout(@url)
+        @sqs.interface.get_queue_attributes(@url, 'VisibilityTimeout')['VisibilityTimeout']
       end
-        
-        # Sets new +VisibilityTimeout+ for the queue. 
-        # Returns new timeout value. 
+
+        # Sets new +VisibilityTimeout+ for the queue.
+        # Returns new timeout value.
         #
         #  queue.visibility #=> 30
         #  queue.visibility = 33
         #  queue.visibility #=> 33
         #
       def visibility=(visibility_timeout)
-        @sqs.interface.set_visibility_timeout(@url, visibility_timeout)
+        @sqs.interface.set_queue_attributes(@url, 'VisibilityTimeout', visibility_timeout)
         visibility_timeout
       end
-        
-        # Sets new queue attribute value. 
-        # Not all attributes may be changed: +ApproximateNumberOfMessages+ (for example) is a read only attribute. 
-        # Returns a value to be assigned to attribute. 
+
+        # Sets new queue attribute value.
+        # Not all attributes may be changed: +ApproximateNumberOfMessages+ (for example) is a read only attribute.
+        # Returns a value to be assigned to attribute.
+        # Currently, 'VisibilityTimeout' is the only settable queue attribute.
+        # Attempting to set non-existent attributes generates an indignant
+        # exception.
         #
         # queue.set_attribute('VisibilityTimeout', '100')  #=> '100'
         # queue.get_attribute('VisibilityTimeout')         #=> '100'
@@ -244,145 +239,48 @@ module RightAws
         @sqs.interface.set_queue_attributes(@url, attribute, value)
         value
       end
-        
-        # Retrieves queue attributes. 
-        # At this moment Amazon supports +VisibilityTimeout+ and +ApproximateNumberOfMessages+ only. 
+
+        # Retrieves queue attributes.
+        # At this moment Amazon supports +VisibilityTimeout+ and +ApproximateNumberOfMessages+ only.
         # If the name of attribute is set, returns its value. Otherwise, returns a hash of attributes.
         #
-        # queue.get_attribute('VisibilityTimeout')  #=> '100'
+        # queue.get_attribute('VisibilityTimeout')  #=> {"VisibilityTimeout"=>"45"}
         #
       def get_attribute(attribute='All')
         attributes = @sqs.interface.get_queue_attributes(@url, attribute)
         attribute=='All' ? attributes : attributes[attribute]
       end
-        
-        # Retrieves a list of grantees. 
-        # Returns an +array+ of Grantee instances if the +grantee_email_address+ is unset. 
-        # Otherwise returns a Grantee instance that points to +grantee_email_address+ or +nil+.
-        #
-        #  grantees = queue.grantees #=> [#<RightAws::Sqs::Grantee:0xb7bf0888 ... >, ...]
-        #   ...
-        #  grantee  = queue.grantees('cool_guy@email.address') #=> nil | #<RightAws::Sqs::Grantee:0xb7bf0888 ... >
-        #
-      def grantees(grantee_email_address=nil, permission = nil)
-        hash = @sqs.interface.list_grants(@url, grantee_email_address, permission)
-        grantees = []
-        hash.each do |key, value|
-          grantees << Grantee.new(self, grantee_email_address, key, value[:name], value[:perms])
-        end
-        if grantee_email_address
-          grantees.blank? ? nil : grantees.shift
-        else
-          grantees
-        end
-      end
     end
-    
-    
+
     class Message
-      attr_reader   :queue, :id, :body, :visibility
-      attr_accessor :sent_at, :received_at
-      
-      def initialize(queue, id=nil, body=nil, visibility=nil)
+      attr_reader   :queue, :id, :body, :visibility, :receipt_handle
+      attr_accessor :sent_at, :received_at, :send_checksum, :receive_checksum
+
+      def initialize(queue, id=nil, rh = nil, body=nil, visibility=nil)
         @queue       = queue
         @id          = id
+        @receipt_handle = rh
         @body        = body
         @visibility  = visibility
         @sent_at     = nil
         @received_at = nil
+        @send_checksum = nil
+        @receive_checksum = nil
       end
-      
+
         # Returns +Message+ instance body.
       def to_s
         @body
       end
-      
-        # Changes +VisibilityTimeout+ for current message. 
-        # Returns new +VisibilityTimeout+ value.
-      def visibility=(visibility_timeout)
-        @queue.sqs.interface.change_message_visibility(@queue.url, @id, visibility_timeout)
-        @visibility = visibility_timeout
-      end
-      
-        # Removes message from queue. 
+
+        # Removes message from queue.
         # Returns +true+.
       def delete
-        @queue.sqs.interface.delete_message(@queue.url, @id)
+        @queue.sqs.interface.delete_message(@queue.url, @receipt_handle) if @receipt_handle
       end
-    end
 
-
-    class Grantee
-      attr_accessor :queue, :id, :name, :perms, :email
-      
-        # Creates new Grantee instance. 
-        # To create new grantee for queue use:
-        #
-        #   grantee = Grantee.new(queue, grantee@email.address)
-        #   grantee.grant('FULLCONTROL')
-        #
-      def initialize(queue, email=nil, id=nil, name=nil, perms=[])
-        @queue = queue
-        @id    = id
-        @name  = name
-        @perms = perms
-        @email = email
-        retrieve unless id
-      end
-
-        # Retrieves security information for grantee identified by email. 
-        # Returns +nil+ if the named user has no privileges on this queue, or 
-        # +true+ if perms updated successfully. 
-      def retrieve # :nodoc:
-        @id    = nil
-        @name  = nil
-        @perms = []
-        
-        hash = @queue.sqs.interface.list_grants(@queue.url, @email)
-        return nil if hash.empty?
-        
-        grantee = hash.shift
-        @id     = grantee[0]
-        @name   = grantee[1][:name]
-        @perms  = grantee[1][:perms]
-        true
-      end
-        
-        # Adds permissions for grantee. 
-        # Permission: 'FULLCONTROL' | 'RECEIVEMESSAGE' | 'SENDMESSAGE'. 
-        # The caller must have set the email instance variable. 
-      def grant(permission=nil)
-        raise "You can't grant permission without defining a grantee email address!" unless @email
-        @queue.sqs.interface.add_grant(@queue.url, @email, permission)
-        retrieve
-      end
-      
-        # Revokes permissions for grantee. 
-        # Permission: 'FULLCONTROL' | 'RECEIVEMESSAGE' | 'SENDMESSAGE'. 
-        # Default value is 'FULLCONTROL'. 
-        # User must have +@email+ or +@id+ set. 
-        # Returns +true+.
-      def revoke(permission='FULLCONTROL')
-        @queue.sqs.interface.remove_grant(@queue.url, @email || @id, permission)
-        unless @email   # if email is unknown - just remove permission from local perms list...
-          @perms.delete(permission)
-        else            # ... else retrieve updated information from Amazon
-          retrieve
-        end
-        true
-      end
-      
-        # Revokes all permissions for this grantee.
-        # Returns +true+
-      def drop
-        @perms.each do |permission|
-          @queue.sqs.interface.remove_grant(@queue.url, @email || @id, permission)
-        end
-        retrieve
-        true
-      end
-      
     end
 
+
   end
 end