aws 1.11.38 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21,13 +21,13 @@
21
21
  # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22
22
  #
23
23
 
24
- module RightAws
24
+ module Aws
25
25
 
26
- class S3Interface < RightAwsBase
26
+ class S3Interface < AwsBase
27
27
 
28
28
  USE_100_CONTINUE_PUT_SIZE = 1_000_000
29
29
 
30
- include RightAwsBaseInterface
30
+ include AwsBaseInterface
31
31
 
32
32
  DEFAULT_HOST = 's3.amazonaws.com'
33
33
  DEFAULT_PORT = 80
@@ -50,7 +50,7 @@ module RightAws
50
50
 
51
51
  # Creates new RightS3 instance.
52
52
  #
53
- # s3 = RightAws::S3Interface.new('1E3GDYEOGFJPIT7XXXXXX','hgTHt68JY07JKUY08ftHYtERkjgtfERn57XXXXXX', {:multi_thread => true, :logger => Logger.new('/tmp/x.log')}) #=> #<RightAws::S3Interface:0xb7b3c27c>
53
+ # s3 = Aws::S3Interface.new('1E3GDYEOGFJPIT7XXXXXX','hgTHt68JY07JKUY08ftHYtERkjgtfERn57XXXXXX', {:multi_thread => true, :logger => Logger.new('/tmp/x.log')}) #=> #<Aws::S3Interface:0xb7b3c27c>
54
54
  #
55
55
  # Params is a hash:
56
56
  #
@@ -165,7 +165,7 @@ module RightAws
165
165
  # Raises AwsError if any banana happened.
166
166
  def request_info(request, parser, &block) # :nodoc:
167
167
  thread = @params[:multi_thread] ? Thread.current : Thread.main
168
- thread[:s3_connection] ||= Rightscale::HttpConnection.new(:exception => RightAws::AwsError, :logger => @logger)
168
+ thread[:s3_connection] ||= Rightscale::HttpConnection.new(:exception => Aws::AwsError, :logger => @logger)
169
169
  request_info_impl(thread[:s3_connection], @@bench, request, parser, &block)
170
170
  end
171
171
 
@@ -201,7 +201,7 @@ module RightAws
201
201
  request_info(req_hash, RightHttp2xxParser.new)
202
202
  rescue Exception => e
203
203
  # if the bucket exists AWS returns an error for the location constraint interface. Drop it
204
- e.is_a?(RightAws::AwsError) && e.message.include?('BucketAlreadyOwnedByYou') ? true : on_exception
204
+ e.is_a?(Aws::AwsError) && e.message.include?('BucketAlreadyOwnedByYou') ? true : on_exception
205
205
  end
206
206
 
207
207
  # Retrieve bucket location
@@ -407,7 +407,7 @@ module RightAws
407
407
 
408
408
 
409
409
 
410
- # New experimental API for uploading objects, introduced in RightAws 1.8.1.
410
+ # New experimental API for uploading objects, introduced in Aws 1.8.1.
411
411
  # store_object is similar in function to the older function put, but returns the full response metadata. It also allows for optional verification
412
412
  # of object md5 checksums on upload. Parameters are passed as hash entries and are checked for completeness as well as for spurious arguments.
413
413
  # The hash of the response headers contains useful information like the Amazon request ID and the object ETag (MD5 checksum).
@@ -472,7 +472,7 @@ module RightAws
472
472
  # "content-length"=>"0"}
473
473
  #
474
474
  # s3.store_object_and_verify(:bucket => "foobucket", :key => "foo", :md5 => "a507841b1bc8115094b00bbe8c1b2953", :data => "polemonium" )
475
- # RightAws::AwsError: Uploaded object failed MD5 checksum verification: {"x-amz-id-2"=>"HTxVtd2bf7UHHDn+WzEH43MkEjFZ26xuYvUzbstkV6nrWvECRWQWFSx91z/bl03n",
475
+ # Aws::AwsError: Uploaded object failed MD5 checksum verification: {"x-amz-id-2"=>"HTxVtd2bf7UHHDn+WzEH43MkEjFZ26xuYvUzbstkV6nrWvECRWQWFSx91z/bl03n",
476
476
  # "etag"=>"\"a507841b1bc8115094b00bbe8c1b2954\"",
477
477
  # "date"=>"Mon, 29 Sep 2008 18:38:41 GMT",
478
478
  # :verified_md5=>false,
@@ -519,7 +519,7 @@ module RightAws
519
519
  on_exception
520
520
  end
521
521
 
522
- # New experimental API for retrieving objects, introduced in RightAws 1.8.1.
522
+ # New experimental API for retrieving objects, introduced in Aws 1.8.1.
523
523
  # retrieve_object is similar in function to the older function get. It allows for optional verification
524
524
  # of object md5 checksums on retrieval. Parameters are passed as hash entries and are checked for completeness as well as for spurious arguments.
525
525
  #
@@ -724,7 +724,7 @@ module RightAws
724
724
  else
725
725
  result[:grantees][key] =
726
726
  { :display_name => grantee[:display_name] || grantee[:uri].to_s[/[^\/]*$/],
727
- :permissions => grantee[:permissions].to_a,
727
+ :permissions => grantee[:permissions].lines.to_a,
728
728
  :attributes => grantee[:attributes] }
729
729
  end
730
730
  end
@@ -968,7 +968,7 @@ module RightAws
968
968
  # PARSERS:
969
969
  #-----------------------------------------------------------------
970
970
 
971
- class S3ListAllMyBucketsParser < RightAWSParser # :nodoc:
971
+ class S3ListAllMyBucketsParser < AwsParser # :nodoc:
972
972
  def reset
973
973
  @result = []
974
974
  @owner = {}
@@ -987,7 +987,7 @@ module RightAws
987
987
  end
988
988
  end
989
989
 
990
- class S3ListBucketParser < RightAWSParser # :nodoc:
990
+ class S3ListBucketParser < AwsParser # :nodoc:
991
991
  def reset
992
992
  @result = []
993
993
  @service = {}
@@ -1018,7 +1018,7 @@ module RightAws
1018
1018
  end
1019
1019
  end
1020
1020
 
1021
- class S3ImprovedListBucketParser < RightAWSParser # :nodoc:
1021
+ class S3ImprovedListBucketParser < AwsParser # :nodoc:
1022
1022
  def reset
1023
1023
  @result = {}
1024
1024
  @result[:contents] = []
@@ -1060,7 +1060,7 @@ module RightAws
1060
1060
  end
1061
1061
  end
1062
1062
 
1063
- class S3BucketLocationParser < RightAWSParser # :nodoc:
1063
+ class S3BucketLocationParser < AwsParser # :nodoc:
1064
1064
  def reset
1065
1065
  @result = ''
1066
1066
  end
@@ -1069,7 +1069,7 @@ module RightAws
1069
1069
  end
1070
1070
  end
1071
1071
 
1072
- class S3AclParser < RightAWSParser # :nodoc:
1072
+ class S3AclParser < AwsParser # :nodoc:
1073
1073
  def reset
1074
1074
  @result = {:grantees=>[], :owner=>{}}
1075
1075
  @current_grantee = {}
@@ -1102,7 +1102,7 @@ module RightAws
1102
1102
  end
1103
1103
  end
1104
1104
 
1105
- class S3LoggingParser < RightAWSParser # :nodoc:
1105
+ class S3LoggingParser < AwsParser # :nodoc:
1106
1106
  def reset
1107
1107
  @result = {:enabled => false, :targetbucket => '', :targetprefix => ''}
1108
1108
  @current_grantee = {}
@@ -1124,7 +1124,7 @@ module RightAws
1124
1124
  end
1125
1125
  end
1126
1126
 
1127
- class S3CopyParser < RightAWSParser # :nodoc:
1127
+ class S3CopyParser < AwsParser # :nodoc:
1128
1128
  def reset
1129
1129
  @result = {}
1130
1130
  end
@@ -1148,7 +1148,7 @@ module RightAws
1148
1148
  def headers_to_string(headers)
1149
1149
  result = {}
1150
1150
  headers.each do |key, value|
1151
- value = value.to_s if value.is_a?(Array) && value.size<2
1151
+ value = value[0] if value.is_a?(Array) && value.size<2
1152
1152
  result[key] = value
1153
1153
  end
1154
1154
  result
@@ -28,27 +28,27 @@ rescue LoadError => e
28
28
  exit
29
29
  end
30
30
 
31
- module RightAws
31
+ module Aws
32
32
 
33
- # = RightAws::ActiveSdb -- RightScale SDB interface (alpha release)
34
- # The RightAws::ActiveSdb class provides a complete interface to Amazon's Simple
33
+ # = Aws::ActiveSdb -- RightScale SDB interface (alpha release)
34
+ # The Aws::ActiveSdb class provides a complete interface to Amazon's Simple
35
35
  # Database Service.
36
36
  #
37
- # ActiveSdb is in alpha and does not load by default with the rest of RightAws. You must use an additional require statement to load the ActiveSdb class. For example:
37
+ # ActiveSdb is in alpha and does not load by default with the rest of Aws. You must use an additional require statement to load the ActiveSdb class. For example:
38
38
  #
39
39
  # require 'right_aws'
40
40
  # require 'sdb/active_sdb'
41
41
  #
42
- # Additionally, the ActiveSdb class requires the 'uuidtools' gem; this gem is not normally required by RightAws and is not installed as a
43
- # dependency of RightAws.
42
+ # Additionally, the ActiveSdb class requires the 'uuidtools' gem; this gem is not normally required by Aws and is not installed as a
43
+ # dependency of Aws.
44
44
  #
45
45
  # Simple ActiveSdb usage example:
46
46
  #
47
- # class Client < RightAws::ActiveSdb::Base
47
+ # class Client < Aws::ActiveSdb::Base
48
48
  # end
49
49
  #
50
50
  # # connect to SDB
51
- # RightAws::ActiveSdb.establish_connection
51
+ # Aws::ActiveSdb.establish_connection
52
52
  #
53
53
  # # create domain
54
54
  # Client.create_domain
@@ -101,7 +101,7 @@ module RightAws
101
101
 
102
102
  # Create a new handle to an Sdb account. All handles share the same per process or per thread
103
103
  # HTTP connection to Amazon Sdb. Each handle is for a specific account.
104
- # The +params+ are passed through as-is to RightAws::SdbInterface.new
104
+ # The +params+ are passed through as-is to Aws::SdbInterface.new
105
105
  # Params:
106
106
  # { :server => 'sdb.amazonaws.com' # Amazon service host: 'sdb.amazonaws.com'(default)
107
107
  # :port => 443 # Amazon service port: 80 or 443(default)
@@ -118,7 +118,7 @@ module RightAws
118
118
  # :service_endpoint => '/' # Set this to /mdb/request.mgwsi for usage with M/DB
119
119
 
120
120
  def establish_connection(aws_access_key_id=nil, aws_secret_access_key=nil, params={})
121
- @connection = RightAws::SdbInterface.new(aws_access_key_id, aws_secret_access_key, params)
121
+ @connection = Aws::SdbInterface.new(aws_access_key_id, aws_secret_access_key, params)
122
122
  end
123
123
 
124
124
  def close_connection
@@ -134,7 +134,7 @@ module RightAws
134
134
 
135
135
  # Retreive a list of domains.
136
136
  #
137
- # put RightAws::ActiveSdb.domains #=> ['co-workers','family','friends','clients']
137
+ # put Aws::ActiveSdb.domains #=> ['co-workers','family','friends','clients']
138
138
  #
139
139
  def domains
140
140
  connection.list_domains[:domains]
@@ -143,7 +143,7 @@ module RightAws
143
143
  # Create new domain.
144
144
  # Raises no errors if the domain already exists.
145
145
  #
146
- # RightAws::ActiveSdb.create_domain('alpha') #=> {:request_id=>"6fc652a0-0000-41d5-91f4-3ed390a3d3b2", :box_usage=>"0.0055590278"}
146
+ # Aws::ActiveSdb.create_domain('alpha') #=> {:request_id=>"6fc652a0-0000-41d5-91f4-3ed390a3d3b2", :box_usage=>"0.0055590278"}
147
147
  #
148
148
  def create_domain(domain_name)
149
149
  connection.create_domain(domain_name)
@@ -152,7 +152,7 @@ module RightAws
152
152
  # Remove domain from SDB.
153
153
  # Raises no errors if the domain does not exist.
154
154
  #
155
- # RightAws::ActiveSdb.create_domain('alpha') #=> {:request_id=>"6fc652a0-0000-41c6-91f4-3ed390a3d3b2", :box_usage=>"0.0055590001"}
155
+ # Aws::ActiveSdb.create_domain('alpha') #=> {:request_id=>"6fc652a0-0000-41c6-91f4-3ed390a3d3b2", :box_usage=>"0.0055590001"}
156
156
  #
157
157
  def delete_domain(domain_name)
158
158
  connection.delete_domain(domain_name)
@@ -167,25 +167,25 @@ module RightAws
167
167
  # next_token value returned by last find: is useful to continue finding
168
168
  attr_accessor :next_token
169
169
 
170
- # Returns a RightAws::SdbInterface object
170
+ # Returns a Aws::SdbInterface object
171
171
  #
172
- # class A < RightAws::ActiveSdb::Base
172
+ # class A < Aws::ActiveSdb::Base
173
173
  # end
174
174
  #
175
- # class B < RightAws::ActiveSdb::Base
175
+ # class B < Aws::ActiveSdb::Base
176
176
  # end
177
177
  #
178
- # class C < RightAws::ActiveSdb::Base
178
+ # class C < Aws::ActiveSdb::Base
179
179
  # end
180
180
  #
181
- # RightAws::ActiveSdb.establish_connection 'key_id_1', 'secret_key_1'
181
+ # Aws::ActiveSdb.establish_connection 'key_id_1', 'secret_key_1'
182
182
  #
183
183
  # C.establish_connection 'key_id_2', 'secret_key_2'
184
184
  #
185
185
  # # A and B uses the default connection, C - uses its own
186
- # puts A.connection #=> #<RightAws::SdbInterface:0xb76d6d7c>
187
- # puts B.connection #=> #<RightAws::SdbInterface:0xb76d6d7c>
188
- # puts C.connection #=> #<RightAws::SdbInterface:0xb76d6ca0>
186
+ # puts A.connection #=> #<Aws::SdbInterface:0xb76d6d7c>
187
+ # puts B.connection #=> #<Aws::SdbInterface:0xb76d6d7c>
188
+ # puts C.connection #=> #<Aws::SdbInterface:0xb76d6ca0>
189
189
  #
190
190
  def connection
191
191
  @connection || ActiveSdb::connection
@@ -196,18 +196,18 @@ module RightAws
196
196
  # Current domain name.
197
197
  #
198
198
  # # if 'ActiveSupport' is not loaded then class name converted to downcase
199
- # class Client < RightAws::ActiveSdb::Base
199
+ # class Client < Aws::ActiveSdb::Base
200
200
  # end
201
201
  # puts Client.domain #=> 'client'
202
202
  #
203
203
  # # if 'ActiveSupport' is loaded then class name being tableized
204
204
  # require 'activesupport'
205
- # class Client < RightAws::ActiveSdb::Base
205
+ # class Client < Aws::ActiveSdb::Base
206
206
  # end
207
207
  # puts Client.domain #=> 'clients'
208
208
  #
209
209
  # # Explicit domain name definition
210
- # class Client < RightAws::ActiveSdb::Base
210
+ # class Client < Aws::ActiveSdb::Base
211
211
  # set_domain_name :foreign_clients
212
212
  # end
213
213
  # puts Client.domain #=> 'foreign_clients'
@@ -225,7 +225,7 @@ module RightAws
225
225
 
226
226
  # Change the default domain name to user defined.
227
227
  #
228
- # class Client < RightAws::ActiveSdb::Base
228
+ # class Client < Aws::ActiveSdb::Base
229
229
  # set_domain_name :foreign_clients
230
230
  # end
231
231
  #
@@ -236,7 +236,7 @@ module RightAws
236
236
  # Create domain at SDB.
237
237
  # Raises no errors if the domain already exists.
238
238
  #
239
- # class Client < RightAws::ActiveSdb::Base
239
+ # class Client < Aws::ActiveSdb::Base
240
240
  # end
241
241
  # Client.create_domain #=> {:request_id=>"6fc652a0-0000-41d5-91f4-3ed390a3d3b2", :box_usage=>"0.0055590278"}
242
242
  #
@@ -247,7 +247,7 @@ module RightAws
247
247
  # Remove domain from SDB.
248
248
  # Raises no errors if the domain does not exist.
249
249
  #
250
- # class Client < RightAws::ActiveSdb::Base
250
+ # class Client < Aws::ActiveSdb::Base
251
251
  # end
252
252
  # Client.delete_domain #=> {:request_id=>"e14d90d3-0000-4898-9995-0de28cdda270", :box_usage=>"0.0055590278"}
253
253
  #
@@ -297,7 +297,7 @@ module RightAws
297
297
  # Client.select('1234987b4583475347523948')
298
298
  # Client.select('1','2','3','4', :conditions=> ["toys=?", "beer"])
299
299
  #
300
- # Find helpers: RightAws::ActiveSdb::Base.select_by_... and RightAws::ActiveSdb::Base.select_all_by_...
300
+ # Find helpers: Aws::ActiveSdb::Base.select_by_... and Aws::ActiveSdb::Base.select_all_by_...
301
301
  #
302
302
  # Client.select_by_name('Matias Rust')
303
303
  # Client.select_by_name_and_city('Putin','Moscow')
@@ -21,13 +21,13 @@
21
21
  # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22
22
  #
23
23
 
24
- require "right_aws"
24
+ require "aws"
25
25
 
26
- module RightAws
26
+ module Aws
27
27
 
28
- class SdbInterface < RightAwsBase
28
+ class SdbInterface < AwsBase
29
29
 
30
- include RightAwsBaseInterface
30
+ include AwsBaseInterface
31
31
 
32
32
  DEFAULT_HOST = 'sdb.amazonaws.com'
33
33
  DEFAULT_PORT = 443
@@ -61,7 +61,7 @@ module RightAws
61
61
  #
62
62
  # Example:
63
63
  #
64
- # sdb = RightAws::SdbInterface.new('1E3GDYEOGFJPIT7XXXXXX','hgTHt68JY07JKUY08ftHYtERkjgtfERn57XXXXXX', {:connection_mode => :per_request, :logger => Logger.new('/tmp/x.log')}) #=> #<RightSdb:0xa6b8c27c>
64
+ # sdb = Aws::SdbInterface.new('1E3GDYEOGFJPIT7XXXXXX','hgTHt68JY07JKUY08ftHYtERkjgtfERn57XXXXXX', {:connection_mode => :per_request, :logger => Logger.new('/tmp/x.log')}) #=> #<RightSdb:0xa6b8c27c>
65
65
  #
66
66
  # see: http://docs.amazonwebservices.com/AmazonSimpleDB/2007-11-07/DeveloperGuide/
67
67
  #
@@ -243,7 +243,7 @@ module RightAws
243
243
  #
244
244
  # Example:
245
245
  #
246
- # sdb = RightAws::SdbInterface.new
246
+ # sdb = Aws::SdbInterface.new
247
247
  # sdb.list_domains #=> { :box_usage => "0.0000071759",
248
248
  # :request_id => "976709f9-0111-2345-92cb-9ce90acd0982",
249
249
  # :domains => ["toys", "dolls"]}
@@ -288,7 +288,7 @@ module RightAws
288
288
  #
289
289
  # Example:
290
290
  #
291
- # sdb = RightAws::SdbInterface.new
291
+ # sdb = Aws::SdbInterface.new
292
292
  # sdb.list_domains #=> { :box_usage => "0.0000071759",
293
293
  # :request_id => "976709f9-0111-2345-92cb-9ce90acd0982",
294
294
  # :domains => ["toys", "dolls"]}
@@ -320,7 +320,7 @@ module RightAws
320
320
  #
321
321
  # Example:
322
322
  #
323
- # sdb = RightAws::SdbInterface.new
323
+ # sdb = Aws::SdbInterface.new
324
324
  # sdb.create_domain('toys') # => { :box_usage => "0.0000071759",
325
325
  # :request_id => "976709f9-0111-2345-92cb-9ce90acd0982" }
326
326
  #
@@ -340,7 +340,7 @@ module RightAws
340
340
  #
341
341
  # Example:
342
342
  #
343
- # sdb = RightAws::SdbInterface.new
343
+ # sdb = Aws::SdbInterface.new
344
344
  # sdb.delete_domain('toys') # => { :box_usage => "0.0000071759",
345
345
  # :request_id => "976709f9-0111-2345-92cb-9ce90acd0982" }
346
346
  #
@@ -371,7 +371,7 @@ module RightAws
371
371
  #
372
372
  # Example:
373
373
  #
374
- # sdb = RightAws::SdbInterface.new
374
+ # sdb = Aws::SdbInterface.new
375
375
  # sdb.create_domain 'family'
376
376
  #
377
377
  # attributes = {}
@@ -405,7 +405,7 @@ module RightAws
405
405
  end
406
406
 
407
407
  #
408
- # items is an array of RightAws::SdbInterface::Item.new(o.id, o.attributes, true)
408
+ # items is an array of Aws::SdbInterface::Item.new(o.id, o.attributes, true)
409
409
  def batch_put_attributes(domain_name, items)
410
410
  params = { 'DomainName' => domain_name }
411
411
  i = 0
@@ -688,7 +688,7 @@ module RightAws
688
688
  #-----------------------------------------------------------------
689
689
  # PARSERS:
690
690
  #-----------------------------------------------------------------
691
- class QSdbListDomainParser < RightAWSParser #:nodoc:
691
+ class QSdbListDomainParser < AwsParser #:nodoc:
692
692
  def reset
693
693
  @result = { :domains => [] }
694
694
  end
@@ -702,7 +702,7 @@ module RightAws
702
702
  end
703
703
  end
704
704
 
705
- class QSdbDomainMetadataParser < RightAWSParser #:nodoc:
705
+ class QSdbDomainMetadataParser < AwsParser #:nodoc:
706
706
  def reset
707
707
  @result = {}
708
708
  end
@@ -721,7 +721,7 @@ module RightAws
721
721
  end
722
722
 
723
723
 
724
- class QSdbSimpleParser < RightAWSParser #:nodoc:
724
+ class QSdbSimpleParser < AwsParser #:nodoc:
725
725
  def reset
726
726
  @result = {}
727
727
  end
@@ -733,7 +733,7 @@ module RightAws
733
733
  end
734
734
  end
735
735
 
736
- class QSdbGetAttributesParser < RightAWSParser #:nodoc:
736
+ class QSdbGetAttributesParser < AwsParser #:nodoc:
737
737
  def reset
738
738
  @last_attribute_name = nil
739
739
  @result = { :attributes => {} }
@@ -748,7 +748,7 @@ module RightAws
748
748
  end
749
749
  end
750
750
 
751
- class QSdbQueryParser < RightAWSParser #:nodoc:
751
+ class QSdbQueryParser < AwsParser #:nodoc:
752
752
  def reset
753
753
  @result = { :items => [] }
754
754
  end
@@ -762,7 +762,7 @@ module RightAws
762
762
  end
763
763
  end
764
764
 
765
- class QSdbQueryWithAttributesParser < RightAWSParser #:nodoc:
765
+ class QSdbQueryWithAttributesParser < AwsParser #:nodoc:
766
766
  def reset
767
767
  @result = { :items => [] }
768
768
  end
@@ -785,7 +785,7 @@ module RightAws
785
785
  end
786
786
  end
787
787
 
788
- class QSdbSelectParser < RightAWSParser #:nodoc:
788
+ class QSdbSelectParser < AwsParser #:nodoc:
789
789
  def reset
790
790
  @result = { :items => [] }
791
791
  end
@@ -21,28 +21,28 @@
21
21
  # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22
22
  #
23
23
 
24
- module RightAws
24
+ module Aws
25
25
 
26
26
  #
27
- # RightAws::Sqs -- RightScale's Amazon SQS interface, API version
27
+ # Aws::Sqs -- RightScale's Amazon SQS interface, API version
28
28
  # 2008-01-01 and later.
29
- # The RightAws::Sqs class provides a complete interface to the second generation of Amazon's Simple
29
+ # The Aws::Sqs class provides a complete interface to the second generation of Amazon's Simple
30
30
  # Queue Service.
31
31
  # For explanations of the semantics
32
32
  # of each call, please refer to Amazon's documentation at
33
33
  # http://developer.amazonwebservices.com/connect/kbcategory.jspa?categoryID=31
34
34
  #
35
35
  #
36
- # RightAws::Sqs is built atop RightAws::SqsInterface, a lower-level
36
+ # Aws::Sqs is built atop Aws::SqsInterface, a lower-level
37
37
  # procedural API that may be appropriate for certain programs.
38
38
  #
39
- # Error handling: all operations raise an RightAws::AwsError in case
39
+ # Error handling: all operations raise an Aws::AwsError in case
40
40
  # of problems. Note that transient errors are automatically retried.
41
41
  #
42
- # sqs = RightAws::Sqs.new(aws_access_key_id, aws_secret_access_key)
42
+ # sqs = Aws::Sqs.new(aws_access_key_id, aws_secret_access_key)
43
43
  # queue1 = sqs.queue('my_awesome_queue')
44
44
  # ...
45
- # queue2 = RightAws::Sqs::Queue.create(sqs, 'my_cool_queue', true)
45
+ # queue2 = Aws::Sqs::Queue.create(sqs, 'my_cool_queue', true)
46
46
  # puts queue2.size
47
47
  # ...
48
48
  # message1 = queue2.receive
@@ -73,7 +73,7 @@ module RightAws
73
73
  # Retrieves a list of queues.
74
74
  # Returns an +array+ of +Queue+ instances.
75
75
  #
76
- # RightAws::Sqs.queues #=> array of queues
76
+ # Aws::Sqs.queues #=> array of queues
77
77
  #
78
78
  def queues(prefix=nil)
79
79
  @interface.list_queues(prefix).map do |url|
@@ -84,7 +84,7 @@ module RightAws
84
84
  # Returns Queue instance by queue name.
85
85
  # If the queue does not exist at Amazon SQS and +create+ is true, the method creates it.
86
86
  #
87
- # RightAws::Sqs.queue('my_awesome_queue') #=> #<RightAws::Sqs::Queue:0xb7b626e4 ... >
87
+ # Aws::Sqs.queue('my_awesome_queue') #=> #<Aws::Sqs::Queue:0xb7b626e4 ... >
88
88
  #
89
89
  def queue(queue_name, create=true, visibility=nil)
90
90
  url = @interface.queue_url_by_name(queue_name)
@@ -99,7 +99,7 @@ module RightAws
99
99
  # Returns Queue instance by queue name.
100
100
  # If the queue does not exist at Amazon SQS and +create+ is true, the method creates it.
101
101
  #
102
- # RightAws::Sqs::Queue.create(sqs, 'my_awesome_queue') #=> #<RightAws::Sqs::Queue:0xb7b626e4 ... >
102
+ # Aws::Sqs::Queue.create(sqs, 'my_awesome_queue') #=> #<Aws::Sqs::Queue:0xb7b626e4 ... >
103
103
  #
104
104
  def self.create(sqs, url_or_name, create=true, visibility=nil)
105
105
  sqs.queue(url_or_name, create, visibility)
@@ -108,7 +108,7 @@ module RightAws
108
108
  # Creates new Queue instance.
109
109
  # Does not create a queue at Amazon.
110
110
  #
111
- # queue = RightAws::Sqs::Queue.new(sqs, 'my_awesome_queue')
111
+ # queue = Aws::Sqs::Queue.new(sqs, 'my_awesome_queue')
112
112
  #
113
113
  def initialize(sqs, url_or_name)
114
114
  @sqs = sqs
@@ -181,7 +181,7 @@ module RightAws
181
181
  # Retrieves first accessible message from queue.
182
182
  # Returns Message instance or +nil+ it the queue is empty.
183
183
  #
184
- # queue.receive #=> #<RightAws::Sqs::Message:0xb7bf0884 ... >
184
+ # queue.receive #=> #<Aws::Sqs::Message:0xb7bf0884 ... >
185
185
  #
186
186
  def receive(visibility=nil)
187
187
  list = receive_messages(1, visibility)
@@ -191,7 +191,7 @@ module RightAws
191
191
  # Pops (and deletes) first accessible message from queue.
192
192
  # Returns Message instance or +nil+ if the queue is empty.
193
193
  #
194
- # queue.pop #=> #<RightAws::Sqs::Message:0xb7bf0884 ... >
194
+ # queue.pop #=> #<Aws::Sqs::Message:0xb7bf0884 ... >
195
195
  #
196
196
  def pop
197
197
  list = @sqs.interface.pop_messages(@url, 1)