gotime_aws 2.5.6

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.
data/lib/ses/ses.rb ADDED
@@ -0,0 +1,123 @@
1
+ require_relative "../awsbase/awsbase"
2
+ module Aws
3
+
4
+ require 'xmlsimple'
5
+
6
+ class Ses < AwsBase
7
+
8
+ include AwsBaseInterface
9
+
10
+ API_VERSION = "2010-12-01"
11
+ DEFAULT_HOST = "email.us-east-1.amazonaws.com"
12
+ DEFAULT_PATH = '/'
13
+ DEFAULT_PROTOCOL = 'https'
14
+ DEFAULT_PORT = 443
15
+
16
+ def self.connection_name
17
+ :ses_connection
18
+ end
19
+
20
+ @@bench = AwsBenchmarkingBlock.new
21
+
22
+ def self.bench
23
+ @@bench
24
+ end
25
+
26
+ def self.bench_xml
27
+ @@bench.xml
28
+ end
29
+
30
+ def self.bench_ec2
31
+ @@bench.service
32
+ end
33
+
34
+ # Current API version (sometimes we have to check it outside the GEM).
35
+ @@api = ENV['SES_API_VERSION'] || API_VERSION
36
+
37
+ def self.api
38
+ @@api
39
+ end
40
+
41
+
42
+ def initialize(aws_access_key_id=nil, aws_secret_access_key=nil, params={})
43
+ init({:name => 'SES',
44
+ :default_host => ENV['SES_URL'] ? URI.parse(ENV['SES_URL']).host : DEFAULT_HOST,
45
+ :default_port => ENV['SES_URL'] ? URI.parse(ENV['SES_URL']).port : DEFAULT_PORT,
46
+ :default_service => ENV['SES_URL'] ? URI.parse(ENV['SES_URL']).path : DEFAULT_PATH,
47
+ :default_protocol => ENV['SES_URL'] ? URI.parse(ENV['SES_URL']).scheme : DEFAULT_PROTOCOL,
48
+ :api_version => API_VERSION,
49
+ :signature_version=>'3'},
50
+ aws_access_key_id || ENV['AWS_ACCESS_KEY_ID'],
51
+ aws_secret_access_key|| ENV['AWS_SECRET_ACCESS_KEY'],
52
+ params)
53
+ end
54
+
55
+ def do_request(action, params, options={})
56
+ link = generate_request(action, params)
57
+ puts "request=" + link[:request].inspect
58
+ resp = request_info_xml_simple3(self, link,
59
+ :group_tags =>{"LoadBalancersDescriptions"=>"LoadBalancersDescription",
60
+ "DBParameterGroups" =>"DBParameterGroup",
61
+ "DBSecurityGroups" =>"DBSecurityGroup",
62
+ "EC2SecurityGroups" =>"EC2SecurityGroup",
63
+ "IPRanges" =>"IPRange"},
64
+ :force_array =>["DBInstances",
65
+ "DBParameterGroups",
66
+ "DBSecurityGroups",
67
+ "EC2SecurityGroups",
68
+ "IPRanges"],
69
+ :pull_out_array =>options[:pull_out_array],
70
+ :pull_out_single=>options[:pull_out_single],
71
+ :wrapper =>options[:wrapper])
72
+ end
73
+
74
+
75
+ #-----------------------------------------------------------------
76
+ # REQUESTS
77
+ #-----------------------------------------------------------------
78
+
79
+
80
+ # options:
81
+ # :marker => value received from previous response if IsTruncated = true
82
+ # :max_items => number of items you want returned
83
+ # :path_previx => for filtering results, default is /
84
+ def get_send_quota(options={})
85
+ @logger.info("get_send_quota")
86
+
87
+ resp = do_request("GetSendQuota", options)
88
+
89
+
90
+ rescue Exception
91
+ on_exception
92
+ end
93
+
94
+ #
95
+ # name: name of certificate
96
+ # public_key: public key certificate in PEM-encoded format
97
+ # private_key: private key in PEM-encoded format
98
+ # options:
99
+ # :path => specify a path you want it stored in
100
+ # :certificate_chain => contents of certificate chain
101
+ def upload_server_certificate(name, public_key, private_key, options={})
102
+ params = {}
103
+ params['ServerCertificateName'] = name
104
+ params['PrivateKey'] = private_key
105
+ params['CertificateBody'] = public_key
106
+
107
+ params['CertificateChain'] = options[:certificate_chain] if options[:certificate_chain]
108
+ params['Path'] = options[:path] if options[:path]
109
+
110
+ p params
111
+
112
+ resp = do_request("UploadServerCertificate", params, :pull_out_array=>[:list_server_certificates_result, :server_certificate_metadata_list])
113
+
114
+
115
+ rescue Exception
116
+ on_exception
117
+ end
118
+
119
+
120
+ end
121
+
122
+
123
+ end
data/lib/sqs/sqs.rb ADDED
@@ -0,0 +1,307 @@
1
+ #
2
+ # Copyright (c) 2008 RightScale Inc
3
+ #
4
+ # Permission is hereby granted, free of charge, to any person obtaining
5
+ # a copy of this software and associated documentation files (the
6
+ # "Software"), to deal in the Software without restriction, including
7
+ # without limitation the rights to use, copy, modify, merge, publish,
8
+ # distribute, sublicense, and/or sell copies of the Software, and to
9
+ # permit persons to whom the Software is furnished to do so, subject to
10
+ # the following conditions:
11
+ #
12
+ # The above copyright notice and this permission notice shall be
13
+ # included in all copies or substantial portions of the Software.
14
+ #
15
+ # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16
+ # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17
+ # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18
+ # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
19
+ # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
20
+ # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
21
+ # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22
+ #
23
+
24
+ module Aws
25
+
26
+ #
27
+ # Aws::Sqs -- RightScale's Amazon SQS interface, API version
28
+ # 2008-01-01 and later.
29
+ # The Aws::Sqs class provides a complete interface to the second generation of Amazon's Simple
30
+ # Queue Service.
31
+ # For explanations of the semantics
32
+ # of each call, please refer to Amazon's documentation at
33
+ # http://developer.amazonwebservices.com/connect/kbcategory.jspa?categoryID=31
34
+ #
35
+ #
36
+ # Aws::Sqs is built atop Aws::SqsInterface, a lower-level
37
+ # procedural API that may be appropriate for certain programs.
38
+ #
39
+ # Error handling: all operations raise an Aws::AwsError in case
40
+ # of problems. Note that transient errors are automatically retried.
41
+ #
42
+ # sqs = Aws::Sqs.new(aws_access_key_id, aws_secret_access_key)
43
+ # queue1 = sqs.queue('my_awesome_queue')
44
+ # ...
45
+ # queue2 = Aws::Sqs::Queue.create(sqs, 'my_cool_queue', true)
46
+ # puts queue2.size
47
+ # ...
48
+ # message1 = queue2.receive
49
+ # message1.visibility = 0
50
+ # puts message1
51
+ # ...
52
+ # queue2.clear(true)
53
+ # queue2.send_message('Ola-la!')
54
+ # message2 = queue2.pop
55
+ # ...
56
+ #
57
+ # NB: Second-generation SQS has eliminated the entire access grant mechanism present in Gen 1.
58
+ #
59
+ # Params is a hash:
60
+ #
61
+ # {:server => 'queue.amazonaws.com' # Amazon service host: 'queue.amazonaws.com' (default)
62
+ # :port => 443 # Amazon service port: 80 or 443 (default)
63
+ # :multi_thread => true|false # Multi-threaded (connection per each thread): true or false (default)
64
+ # :signature_version => '0' # The signature version : '0' or '1'(default)
65
+ # :logger => Logger Object} # Logger instance: logs to STDOUT if omitted }
66
+ class Sqs
67
+ attr_reader :interface
68
+
69
+ def initialize(aws_access_key_id=nil, aws_secret_access_key=nil, params={})
70
+ @interface = SqsInterface.new(aws_access_key_id, aws_secret_access_key, params)
71
+ end
72
+
73
+ def close_connection
74
+ @interface.close_connection
75
+ end
76
+
77
+
78
+ # Retrieves a list of queues.
79
+ # Returns an +array+ of +Queue+ instances.
80
+ #
81
+ # Aws::Sqs.queues #=> array of queues
82
+ #
83
+ def queues(prefix=nil)
84
+ @interface.list_queues(prefix).map do |url|
85
+ Queue.new(self, url)
86
+ end
87
+ end
88
+
89
+ # Returns Queue instance by queue name.
90
+ # If the queue does not exist at Amazon SQS and +create+ is true, the method creates it.
91
+ #
92
+ # Aws::Sqs.queue('my_awesome_queue') #=> #<Aws::Sqs::Queue:0xb7b626e4 ... >
93
+ #
94
+ def queue(queue_name, create=true, visibility=nil)
95
+ if create
96
+ url = @interface.create_queue(queue_name, visibility) # this returns the url even if it exists
97
+ else
98
+ url = @interface.queue_url_by_name(queue_name)
99
+ end
100
+
101
+ url ? Queue.new(self, url) : nil
102
+ end
103
+
104
+
105
+ class Queue
106
+ attr_reader :name, :url, :sqs
107
+
108
+ # Returns Queue instance by queue name.
109
+ # If the queue does not exist at Amazon SQS and +create+ is true, the method creates it.
110
+ #
111
+ # Aws::Sqs::Queue.create(sqs, 'my_awesome_queue') #=> #<Aws::Sqs::Queue:0xb7b626e4 ... >
112
+ #
113
+ def self.create(sqs, url_or_name, create=true, visibility=nil)
114
+ sqs.queue(url_or_name, create, visibility)
115
+ end
116
+
117
+ # Creates new Queue instance.
118
+ # Does not create a queue at Amazon.
119
+ #
120
+ # queue = Aws::Sqs::Queue.new(sqs, 'my_awesome_queue')
121
+ #
122
+ def initialize(sqs, url_or_name)
123
+ @sqs = sqs
124
+ @url = @sqs.interface.queue_url_by_name(url_or_name)
125
+ raise ResourceNotFoundError, "Queue '#{url_or_name}' not found." unless @url
126
+ @name = @sqs.interface.queue_name_by_url(@url)
127
+ end
128
+
129
+ # Retrieves queue size.
130
+ #
131
+ # queue.size #=> 1
132
+ #
133
+ def size
134
+ @sqs.interface.get_queue_length(@url)
135
+ end
136
+
137
+ # Clears queue, deleting only the visible messages. Any message within its visibility
138
+ # timeout will not be deleted, and will re-appear in the queue in the
139
+ # future when the timeout expires.
140
+ #
141
+ # To delete all messages in a queue and eliminate the chance of any
142
+ # messages re-appearing in the future, it's best to delete the queue and
143
+ # re-create it as a new queue. Note that doing this will take at least 60
144
+ # s since SQS does not allow re-creation of a queue within this interval.
145
+ #
146
+ # queue.clear() #=> true
147
+ #
148
+ def clear()
149
+ @sqs.interface.clear_queue(@url)
150
+ end
151
+
152
+ # Deletes queue. Any messages in the queue will be permanently lost.
153
+ # Returns +true+.
154
+ #
155
+ # NB: Use with caution; severe data loss is possible!
156
+ #
157
+ # queue.delete(true) #=> true
158
+ #
159
+ def delete(force=false)
160
+ @sqs.interface.delete_queue(@url)
161
+ end
162
+
163
+ # Sends new message to queue.
164
+ # Returns new Message instance that has been sent to queue.
165
+ def send_message(message)
166
+ message = message.to_s
167
+ res = @sqs.interface.send_message(@url, message)
168
+ msg = Message.new(self, res['MessageId'], nil, message)
169
+ msg.send_checksum = res['MD5OfMessageBody']
170
+ msg.sent_at = Time.now
171
+ msg
172
+ end
173
+
174
+ alias_method :push, :send_message
175
+
176
+ # Retrieves several messages from queue.
177
+ # Returns an array of Message instances.
178
+ #
179
+ # queue.receive_messages(2,10) #=> array of messages
180
+ #
181
+ def receive_messages(number_of_messages=1, visibility=nil)
182
+ list = @sqs.interface.receive_message(@url, number_of_messages, visibility)
183
+ list.map! do |entry|
184
+ msg = Message.new(self, entry['MessageId'], entry['ReceiptHandle'],
185
+ entry['Body'], visibility)
186
+ msg.received_at = Time.now
187
+ msg.receive_checksum = entry['MD5OfBody']
188
+ msg
189
+ end
190
+ end
191
+
192
+ # Retrieves first accessible message from queue.
193
+ # Returns Message instance or +nil+ it the queue is empty.
194
+ #
195
+ # queue.receive #=> #<Aws::Sqs::Message:0xb7bf0884 ... >
196
+ #
197
+ def receive(visibility=nil)
198
+ list = receive_messages(1, visibility)
199
+ list.empty? ? nil : list[0]
200
+ end
201
+
202
+ # Pops (and deletes) first accessible message from queue.
203
+ # Returns Message instance or +nil+ if the queue is empty.
204
+ #
205
+ # queue.pop #=> #<Aws::Sqs::Message:0xb7bf0884 ... >
206
+ #
207
+ def pop
208
+ list = @sqs.interface.pop_messages(@url, 1)
209
+ return nil if list.empty?
210
+ entry = list[0]
211
+ msg = Message.new(self, entry['MessageId'], entry['ReceiptHandle'],
212
+ entry['Body'], visibility)
213
+ msg.received_at = Time.now
214
+ msg.receive_checksum = entry['MD5OfBody']
215
+ msg
216
+ end
217
+
218
+ # Retrieves +VisibilityTimeout+ value for the queue.
219
+ # Returns new timeout value.
220
+ #
221
+ # queue.visibility #=> 30
222
+ #
223
+ def visibility
224
+ @sqs.interface.get_queue_attributes(@url, 'VisibilityTimeout')['VisibilityTimeout']
225
+ end
226
+
227
+ # Sets new +VisibilityTimeout+ for the queue.
228
+ # Returns new timeout value.
229
+ #
230
+ # queue.visibility #=> 30
231
+ # queue.visibility = 33
232
+ # queue.visibility #=> 33
233
+ #
234
+ def visibility=(visibility_timeout)
235
+ @sqs.interface.set_queue_attributes(@url, 'VisibilityTimeout', visibility_timeout)
236
+ visibility_timeout
237
+ end
238
+
239
+ # Sets new queue attribute value.
240
+ # Not all attributes may be changed: +ApproximateNumberOfMessages+ (for example) is a read only attribute.
241
+ # Returns a value to be assigned to attribute.
242
+ # Currently, 'VisibilityTimeout' is the only settable queue attribute.
243
+ # Attempting to set non-existent attributes generates an indignant
244
+ # exception.
245
+ #
246
+ # queue.set_attribute('VisibilityTimeout', '100') #=> '100'
247
+ # queue.get_attribute('VisibilityTimeout') #=> '100'
248
+ #
249
+ def set_attribute(attribute, value)
250
+ @sqs.interface.set_queue_attributes(@url, attribute, value)
251
+ value
252
+ end
253
+
254
+ # Retrieves queue attributes.
255
+ # At this moment Amazon supports +VisibilityTimeout+ and +ApproximateNumberOfMessages+ only.
256
+ # If the name of attribute is set, returns its value. Otherwise, returns a hash of attributes.
257
+ #
258
+ # queue.get_attribute('VisibilityTimeout') #=> {"VisibilityTimeout"=>"45"}
259
+ #
260
+ def get_attribute(attribute='All')
261
+ attributes = @sqs.interface.get_queue_attributes(@url, attribute)
262
+ attribute=='All' ? attributes : attributes[attribute]
263
+ end
264
+ end
265
+
266
+ class Message
267
+ attr_reader :queue, :id, :body, :visibility, :receipt_handle
268
+ attr_accessor :sent_at, :received_at, :send_checksum, :receive_checksum
269
+
270
+ def initialize(queue, id=nil, rh = nil, body=nil, visibility=nil)
271
+ @queue = queue
272
+ @id = id
273
+ @receipt_handle = rh
274
+ @body = body
275
+ @visibility = visibility
276
+ @sent_at = nil
277
+ @received_at = nil
278
+ @send_checksum = nil
279
+ @receive_checksum = nil
280
+ end
281
+
282
+ # Returns +Message+ instance body.
283
+ def to_s
284
+ @body
285
+ end
286
+
287
+ # Removes message from queue.
288
+ # Returns +true+.
289
+ def delete
290
+ @queue.sqs.interface.delete_message(@queue.url, @receipt_handle) if @receipt_handle
291
+ end
292
+
293
+ # Updates visibility timeout.
294
+ def visibility=(visibility_timeout)
295
+ if @receipt_handle
296
+ @queue.sqs.interface.change_message_visibility(
297
+ @queue.url, @receipt_handle, visibility_timeout
298
+ )
299
+ @visibility = visibility_timeout
300
+ end
301
+ end
302
+
303
+ end
304
+
305
+
306
+ end
307
+ end