em-amazon-sqs 0.1.0

data/CHANGELOG.md

@@ -0,0 +1,23 @@
+## 0.2.1
+
+Bugfixes:
+
+  - Add missing InvalidClientTokenId error [#1]
+
+## 0.2
+
+Features:
+
+  - Add new SQS endpoints
+  - Add new support for MaximumMessageSize, MessageRetentionPeriod attributes for queue
+
+## 0.1.2
+
+Features:
+
+  - Add exists? class method to SimpleQS::Queue
+  - Add delete class method to SimpleQS::Queue
+
+Bugfixes:
+
+  - Fix gemspec, gem now works as it should :)

data/Gemfile

@@ -0,0 +1,10 @@
+source :gemcutter
+
+gem 'ruby-hmac', :require => false
+gem 'xml-simple'
+gem 'em-http-request',:git => 'git://github.com/igrigorik/em-http-request.git', :require => 'em-http'
+gem 'addressable', :require => 'addressable/uri'
+
+group :test do
+  gem 'rspec'
+end

data/Gemfile.lock

@@ -0,0 +1,18 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    rcov (0.9.8)
+    rr (0.10.11)
+    rspec (1.3.0)
+    ruby-hmac (0.4.0)
+    xml-simple (1.0.12)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rcov
+  rr
+  rspec
+  ruby-hmac
+  xml-simple

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Marjan Krekoten'
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOa AND
+NONINFRINGEMENT. IN NO EVENT SaALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,284 @@
+# English #
+
+## Installation ##
+
+		[sudo] gem install simple_qs
+
+## Usage ##
+
+		require 'simple_qs'
+		SimpleQS.account_id = 'your-account-id'
+		SimpleQS.access_key_id = 'YOUR_ACCESS_KEY'
+		SimpleQS.secret_access_key = 'YOUR_SECRET_ACCESS_KEY'
+
+### Region ###
+
+You can select region for queue:
+
+		# :us_east_1      => 'sqs.us-east-1.amazonaws.com',
+		# :us_west_1      => 'sqs.us-west-1.amazonaws.com',
+		# :eu_west_1      => 'sqs.eu-west-1.amazonaws.com',
+		# :ap_southeast_1 => 'sqs.ap-southeast-1.amazonaws.com'
+		SimpleQS.host # => 'sqs.us-east-1.amazonaws.com'
+		
+		SimpleQS.host = :eu_west_1
+		SimpleQS.host # => 'sqs.eu-west-1.amazonaws.com'
+
+### Queues ###
+
+Create a queue:
+
+		queue = SimpleQS::Queue.create('queue_name')
+
+Or:
+
+		SimpleQS::Queue.create('queue_name') do |queue|
+			# ...
+		end
+
+Create a queue with specific default visibility timeout for received messages:
+
+		SimpleQS::Queue.create('queue_name', 60) # Visibility timeout set to 60 secinds instead of default 30
+
+List all account's queues:
+
+		SimpleQS::Queue.list # returns list of SimpleQS::Queue objects
+
+List all account's queues starting with 'test':
+
+		SimpleQS::Queue.list('test')
+
+Check if queue exists:
+
+		SimpleQS::Queue.exists?('queue_name')
+
+Change default visibility timeout for queue:
+
+		SimpleQS::Queue.new('queue_name').set_visibility_timeout(120)
+
+Change maximum message size for queue:
+
+		SimpleQS::Queue.new('queue_name').set_maximum_message_size(65536)
+
+Change message retention period:
+
+		SimpleQS::Queue.new('queue_name').set_message_retention_period(1209600)
+
+Set queue attributes:
+
+		SimpleQS::Queue.new('queue_name').set_attributes({:VisibilityTimeout => 120, :Policy => "policy JSON here"})
+
+Get queue attributes:
+
+		SimpleQS::Queue.new('queue_name').get_attributes(:All)
+
+Add permissions:
+
+		SimpleQS::Queue.new('queue_name').add_permissions('testPerms', [
+			{:account_id => '098166147350', :action => 'SendMessage'},
+			{:account_id => '098166147350', :action => 'ReceiveMessage'}
+		])
+
+Remove permissions:
+
+		SimpleQS::Queue.new('queue_name').remove_permissions('testPerms')
+
+Delete queue:
+
+		SimpleQS::Queue.new('queue_name').delete
+
+Or:
+
+		SimpleQS::Queue.delete('queue_name')
+
+### Messages ###
+
+Send message:
+
+		queue = SimpleQS::Queue.new('queue_name')
+		queue.send_message('message 1')
+		queue.send_message('message 2')
+
+Or:
+
+		SimpleQS::Message.send(queue, 'message 1')
+		SimpleQS::Message.send(queue, 'message 2')
+
+Receive message(s):
+
+		queue.receive_messages # always returns array of messages
+		queue.receive_messages(:All, 10, 70) # receive maximum 10 messages with all attributes (:All)
+											 # and set for them visibility timeout to 70 seconds
+
+Or:
+
+		SimpleQS::Message.receive(queue)
+		SimpleQS::Message.receive(queue, :All, 10, 70)
+
+Resend received message:
+
+		messages = queue.receive_messages
+		messages.first.resend
+
+Change visibility timeout for this message:
+
+		messages.first.change_visibility(120) # Change to 120 seconds
+
+Delete received message:
+
+		messages.first.delete
+
+## TODO ##
+
+See [TODO](http://github.com/krekoten/SimpleQS/blob/master/TODO.md) file
+
+## Issues ##
+
+[ISSUES](http://github.com/krekoten/SimpleQS/issues)
+
+## Authors ##
+
+Marjan Krekoten' (krekoten@gmail.com)
+
+# Українською #
+
+## Встановлення ##
+
+		[sudo] gem install simple_qs
+
+## Користування ##
+
+		require 'simple_qs'
+		SimpleQS.account_id = 'your-account-id'
+		SimpleQS.access_key_id = 'YOUR_ACCESS_KEY'
+
+		SimpleQS.secret_access_key = 'YOUR_SECRET_ACCESS_KEY'
+
+### Регіон ###
+
+Можна обрати регіон, в якому буде створена черга:
+
+		# :us_east_1      => 'sqs.us-east-1.amazonaws.com',
+		# :us_west_1      => 'sqs.us-west-1.amazonaws.com',
+		# :eu_west_1      => 'sqs.eu-west-1.amazonaws.com',
+		# :ap_southeast_1 => 'sqs.ap-southeast-1.amazonaws.com'
+		SimpleQS.host # => 'sqs.us-east-1.amazonaws.com'
+
+		SimpleQS.host = :eu_west_1
+		SimpleQS.host # => 'sqs.eu-west-1.amazonaws.com'
+
+### Черги ###
+
+Створити чергу:
+
+		queue = SimpleQS::Queue.create('queue_name')
+
+Або:
+
+		SimpleQS::Queue.create('queue_name') do |queue|
+			# ...
+		end
+
+Створити чергу із специфічним обмеженням часу невидимості для отриманих повідомлень:
+
+		SimpleQS::Queue.create('queue_name', 60) # Час невидимості встановленно на 60 секунд, натомість типових 30-ти
+
+Перелічити всі черги даного рахунку:
+
+		SimpleQS::Queue.list # returns list of SimpleQS::Queue objects
+
+Перелічити всі черги даного рахунку, що починаються на 'test':
+
+		SimpleQS::Queue.list('test')
+
+Перевірити чи черга існує:
+
+		SimpleQS::Queue.exists?('queue_name')
+
+Змінити типовий час невидимості для даної черги:
+
+		SimpleQS::Queue.new('queue_name').set_visibility_timeout(120)
+
+Змінити максимальний розмір повідомлення:
+
+		SimpleQS::Queue.new('queue_name').set_maximum_message_size(65536)
+
+Змінити період зберігання повідомлень для черги:
+
+		SimpleQS::Queue.new('queue_name').set_message_retention_period(1209600)
+
+Встановити атрибути черги:
+
+		SimpleQS::Queue.new('queue_name').set_attributes({:VisibilityTimeout => 120, :Policy => "policy JSON here"})
+
+Отримати поточні атрибути черги:
+
+		SimpleQS::Queue.new('queue_name').get_attributes(:All)
+
+Надати дозволи:
+
+		SimpleQS::Queue.new('queue_name').add_permissions('testPerms', [
+			{:account_id => '098166147350', :action => 'SendMessage'},
+			{:account_id => '098166147350', :action => 'ReceiveMessage'}
+		])
+
+Скасувати дозволи:
+
+		SimpleQS::Queue.new('queue_name').remove_permissions('testPerms')
+
+Видалити чергу:
+
+		SimpleQS::Queue.new('queue_name').delete
+
+Або:
+
+		SimpleQS::Queue.delete('queue_name')
+
+### Повідомлення ###
+
+Відправити повідомлення:
+
+		queue = SimpleQS::Queue.new('queue_name')
+		queue.send_message('message 1')
+		queue.send_message('message 2')
+
+Або:
+
+		SimpleQS::Message.send(queue, 'message 1')
+		SimpleQS::Message.send(queue, 'message 2')
+
+Отримати повідомлення:
+
+		queue.receive_messages # завжди повертає масив
+		queue.receive_messages(:All, 10, 70) # отримати максимум 10 повідомлень зі всіма атрибутами (:All)
+											 # та встановленим часом невидимості у 70 секунд
+
+Або:
+
+		SimpleQS::Message.receive(queue)
+		SimpleQS::Message.receive(queue, :All, 10, 70)
+
+Надіслати отримані повідомлення ще раз:
+
+		messages = queue.receive_messages
+		messages.first.resend
+
+Змінити час невидимості для даного повідомлення:
+
+		messages.first.change_visibility(120) # Встановити у 120 секунд
+
+Видалити отримане повідомлення з черги:
+
+		messages.first.delete
+
+## Що потрібно зробити ##
+
+Дивіться [TODO](http://github.com/krekoten/SimpleQS/blob/master/TODO.md)
+
+## Помилки, побажання і т.і. ##
+
+[ISSUES](http://github.com/krekoten/SimpleQS/issues)
+
+## Автори ##
+
+Мар'ян Крекотень (krekoten@gmail.com)

data/Rakefile

@@ -0,0 +1,57 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "em-amazon-sqs"
+    gem.summary = %Q{Asyncronous amazon simple queue service}
+    gem.description = %Q{Async amazon simple queue service }
+    gem.email = "jeff.durand@gmail.com"
+    gem.homepage = "https://github.com/johnnyiller/SimpleQS"
+    gem.authors = ["jeff durand"]
+    gem.add_dependency "xml-simple"
+    gem.add_dependency "em-http-request"
+    gem.add_dependency "addressable"
+    gem.add_dependency "ruby-hmac"
+    #gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "em-amazon-sqs #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/TODO.md

@@ -0,0 +1,2 @@
+ * RDoc
+ * Add interface for policy

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/example/client.rb

@@ -0,0 +1,22 @@
+$: << File.expand_path(File.join(File.dirname(__FILE__), '..'))
+require 'rubygems'
+require 'lib/simple_qs'
+
+unless ENV['AWS_ACCESS_KEY_ID'] && ENV['AWS_SECRET_ACCESS_KEY'] && ENV['AWS_ACCOUNT_ID']
+  abort "Please set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_ACCOUNT_ID environment variables"
+end
+
+SimpleQS.access_key_id      = ENV['AWS_ACCESS_KEY_ID']
+SimpleQS.secret_access_key  = ENV['AWS_SECRET_ACCESS_KEY']
+SimpleQS.account_id         = ENV['AWS_ACCOUNT_ID']
+
+@queue = SimpleQS::Queue.create('testMessageBus')
+
+while true do
+  message = STDIN.gets.chomp
+  @queue.send_message(message)
+  if message == 'quit'
+    puts "Quitting..."
+    break
+  end
+end