fake_sqs 0.0.2

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in fake_sqs.gemspec
+gemspec

data/MIT-LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 iain
+
+MIT License
+
+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 PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL 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,89 @@
+# Fake SQS [![Build Status](https://secure.travis-ci.org/iain/fake_sqs.png)](http://travis-ci.org/iain/fake_sqs)
+
+Inspired by [Fake DynamoDB] [fake_dynamo], this is an AWS SQS compatible
+message queue that can be ran locally. This makes it ideal for integration
+testing, just like you would have a local database running. Fake SQS doesn't
+persist anything, not even the queues themselves. You'll have to create the
+queues everytime you start it.
+
+This implementation is **not complete** yet.
+
+Done so far are:
+
+* Creating queues
+* Deleting queues
+* Listing queues (with prefixes)
+* Get queue url via the name
+* Send messages (and in batch)
+* Receive messages (and in batch)
+* Deleting messages (and in batch)
+
+Certain bits are left off on purpose, to make it easier to work with, such as:
+
+* No checking on access keys or signatures
+* No 60 second delay between deleting a queue and recreating it.
+* No visibility timeouts (see below about special hooks)
+
+Other parts are just not done yet:
+
+* Permissions
+* Changing queue attributes
+* Changing message visibility
+* Error handling
+
+So, actually, just the basics are implemented at this point.
+
+## Usage
+
+To install:
+
+```
+$ gem install fake_sqs
+```
+
+To start:
+
+```
+$ fake_sqs
+```
+
+To configure, see the options in the help:
+
+```
+$ fake_sqs --help
+```
+
+This is an example of how to configure the official [aws-sdk gem] [aws-sdk], to
+let it talk to Fake SQS.
+
+``` ruby
+AWS.config(
+  :use_ssl           => false,
+  :sqs_endpoint      => "localhost",
+  :sqs_port          => 4567,
+  :access_key_id     => "access key id",
+  :secret_access_key => "secret access key"
+)
+```
+
+If you have the configuration options for other libraries, please give them to
+me.
+
+To reset the entire server, during tests for example, send a DELETE request to
+the server. For example:
+
+```
+$ curl -X DELETE http://localhost:4567/
+```
+
+Within SQS, after receiving, messages will be available again automatically
+after a certain time. While this is not implemented (for now at least), you can
+trigger this behavior at at will, with a PUT request.
+
+```
+$ curl -X PUT http://localhost:4567/
+```
+
+
+  [fake_dynamo]: https://github.com/ananthakumaran/fake_dynamo
+  [aws-sdk]: https://github.com/amazonwebservices/aws-sdk-for-ruby

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/fake_sqs

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+
+require 'fake_sqs'
+require 'fake_sqs/web_interface'
+require 'optparse'
+
+app = FakeSQS::WebInterface
+
+parser = OptionParser.new do |o|
+
+  o.on "-p", "--port PORT", Integer, "Port to use (default: 4567)" do |port|
+    app.set :port, port
+  end
+
+  o.on "-o", "--bind HOST", "Host to bind to (default: 0.0.0.0)" do |bind|
+    app.set :bind, bind
+  end
+
+  o.on "-s", "--server SERVER", ['thin', 'mongrel', 'webrick'], "Server to use: thin, mongrel or webrick" do |server|
+    app.set :server, server
+  end
+
+  o.on "-v", "--verbose", "Shows input parameters and output XML" do
+    require 'fake_sqs/show_output'
+    app.use FakeSQS::ShowOutput
+  end
+
+  o.on_tail "--version", "Shows the version" do
+    puts "fake_sqs version #{FakeSQS::VERSION}"
+    exit
+  end
+
+  o.on_tail "-h", "--help", "Shows this help page" do
+    puts o
+    exit
+  end
+
+end
+
+parser.parse!
+app.run!

data/fake_sqs.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fake_sqs/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "fake_sqs"
+  gem.version       = FakeSQS::VERSION
+  gem.authors       = ["iain"]
+  gem.email         = ["iain@iain.nl"]
+  gem.description   = %q{Provides a fake SQS server that you can run locally to test against}
+  gem.summary       = %q{Provides a fake SQS server that you can run locally to test against}
+  gem.homepage      = "https://github.com/iain/fake_sqs"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "sinatra"
+  gem.add_dependency "builder"
+
+  gem.add_development_dependency "rspec"
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "aws-sdk"
+  gem.add_development_dependency "webmock"
+  gem.add_development_dependency "faraday"
+  gem.add_development_dependency "thin"
+  gem.add_development_dependency "verbose_hash_fetch"
+  gem.add_development_dependency "activesupport"
+
+end

data/lib/fake_sqs.rb

@@ -0,0 +1,35 @@
+require 'fake_sqs/version'
+require 'fake_sqs/server'
+require 'fake_sqs/queues'
+require 'fake_sqs/responder'
+require 'fake_sqs/queue'
+require 'fake_sqs/queue_factory'
+require 'fake_sqs/message'
+
+module FakeSQS
+
+  def self.server(options = {})
+    Server.new(options.merge(queues: queues, responder: responder))
+  end
+
+  def self.queues
+    Queues.new(queue_factory: queue_factory)
+  end
+
+  def self.responder
+    Responder.new
+  end
+
+  def self.queue_factory
+    QueueFactory.new(message_factory: message_factory, queue: queue)
+  end
+
+  def self.message_factory
+    Message
+  end
+
+  def self.queue
+    Queue
+  end
+
+end

data/lib/fake_sqs/message.rb

@@ -0,0 +1,21 @@
+require 'securerandom'
+
+module FakeSQS
+  class Message
+
+    attr_reader :body
+
+    def initialize(options = {})
+      @body = options.fetch("MessageBody")
+    end
+
+    def id
+      @id ||= SecureRandom.uuid
+    end
+
+    def md5
+      @md5 ||= Digest::MD5.hexdigest(body)
+    end
+
+  end
+end

data/lib/fake_sqs/queue.rb

@@ -0,0 +1,67 @@
+require 'securerandom'
+
+module FakeSQS
+
+  ReadCountOutOfRange = Class.new(RuntimeError)
+
+  class Queue
+
+    attr_reader :name, :messages, :message_factory, :messages_in_flight
+
+    def initialize(options = {})
+      @name = options.fetch("QueueName")
+      @message_factory = options.fetch(:message_factory)
+      reset
+    end
+
+    def send_message(options = {})
+      message = message_factory.new(options)
+      messages << message
+      message
+    end
+
+    def receive_message(options = {})
+      amount = Integer options.fetch("MaxNumberOfMessages") { "1" }
+
+      fail ReadCountOutOfRange, amount if amount > 10
+
+      return {} if messages.empty?
+
+      result = {}
+
+      actual_amount = amount > size ? size : amount
+
+      actual_amount.times do
+        message = messages.delete_at(rand(size))
+        receipt = generate_receipt
+        messages_in_flight[receipt] = message
+        result[receipt] = message
+      end
+
+      result
+    end
+
+    def delete_message(receipt)
+      message = messages_in_flight.delete(receipt)
+    end
+
+    def reset
+      @messages = []
+      @messages_in_flight = {}
+    end
+
+    def expire
+      @messages += messages_in_flight.values
+      @messages_in_flight = {}
+    end
+
+    def size
+      messages.size
+    end
+
+    def generate_receipt
+      SecureRandom.hex
+    end
+
+  end
+end

data/lib/fake_sqs/queue_factory.rb

@@ -0,0 +1,16 @@
+module FakeSQS
+  class QueueFactory
+
+    attr_reader :message_factory, :queue
+
+    def initialize(options = {})
+      @message_factory = options.fetch(:message_factory)
+      @queue = options.fetch(:queue)
+    end
+
+    def new(options)
+      queue.new(options.merge(:message_factory => message_factory))
+    end
+
+  end
+end

data/lib/fake_sqs/queues.rb

@@ -0,0 +1,57 @@
+module FakeSQS
+
+  QueueNameExists  = Class.new(RuntimeError)
+  NonExistentQueue = Class.new(RuntimeError)
+
+  class Queues
+
+    attr_reader :queues, :queue_factory
+
+    def initialize(options = {})
+      @queue_factory = options.fetch(:queue_factory)
+      reset
+    end
+
+    def create(name, options = {})
+      if queues[name]
+        fail QueueNameExists, name
+      else
+        queue = queue_factory.new(options)
+        queues[name] = queue
+      end
+    end
+
+    def delete(name, options = {})
+      if queues[name]
+        queues.delete(name)
+      else
+        fail NonExistentQueue, name
+      end
+    end
+
+    def list(options = {})
+      if (prefix = options["QueueNamePrefix"])
+        queues.select { |name, queue| name =~ /^#{prefix}/ }.values
+      else
+        queues.values
+      end
+    end
+
+    def get(name, options = {})
+      if queues[name]
+        queues[name]
+      else
+        fail NonExistentQueue, name
+      end
+    end
+
+    def reset
+      @queues = {}
+    end
+
+    def expire
+      queues.each { |name, queue| queue.expire }
+    end
+
+  end
+end

data/lib/fake_sqs/responder.rb

@@ -0,0 +1,22 @@
+require 'builder'
+require 'securerandom'
+
+module FakeSQS
+  class Responder
+
+    def call(name, &block)
+      xml = Builder::XmlMarkup.new(:indent => 4)
+      xml.tag! "#{name}Response" do
+        if block
+          xml.tag! "#{name}Result" do
+            yield xml
+          end
+        end
+        xml.ResponseMetadata do
+          xml.RequestId SecureRandom.uuid
+        end
+      end
+    end
+
+  end
+end