better_sqs 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c6ab639c3edfc471887f487626ebcebf9b0dbf71
+  data.tar.gz: 43f95965ec9edc194a6f16d3ceec1f406dd36350
+SHA512:
+  metadata.gz: 3ef5b247cf8e2974a09c188bc7cb89386487bb53eb7c7665268721b6232da4a4e1b32d2897aeb178d8e983794f3e257b136e6a62f05864094cfa47491a37898f
+  data.tar.gz: e58dbb3e89731bf35022750af27b2cee539ec67552f5209d1ac9985f19b05f3aff27354bc94950adfd4e36161192d6ce70796250f9ec5a046054a256accdc526

data/.gitignore

@@ -0,0 +1,89 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Ruby template
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+
+### JetBrains template
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion
+
+*.iml
+
+## Directory-based project format:
+.idea/
+# if you remove the above rule, at least ignore the following:
+
+# User-specific stuff:
+# .idea/workspace.xml
+# .idea/tasks.xml
+# .idea/dictionaries
+
+# Sensitive or high-churn files:
+# .idea/dataSources.ids
+# .idea/dataSources.xml
+# .idea/sqlDataSources.xml
+# .idea/dynamic.xml
+# .idea/uiDesigner.xml
+
+# Gradle:
+# .idea/gradle.xml
+# .idea/libraries
+
+# Mongo Explorer plugin:
+# .idea/mongoSettings.xml
+
+## File-based project format:
+*.ipr
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+
+
+projectFilesBackup

data/.rubocop.yml

@@ -0,0 +1,75 @@
+inherit_from: .rubocop_todo.yml
+
+Lint/UselessAssignment:
+  Enabled: true
+
+Lint/UnusedMethodArgument:
+  Enabled: true
+
+Lint/UnusedBlockArgument:
+  Enabled: true
+
+Metrics/AbcSize:
+  Exclude:
+    - spec/**/*
+
+Style/DotPosition:
+  Enabled: true
+  EnforcedStyle: trailing
+
+Style/PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%':  ()    # interpolated String
+    '%i': '[]'  # Array of symbols
+    '%q': ()    # Single quoted string
+    '%Q': ()    # Double quoted string
+    '%r': '{}'  # Regex
+    '%s': ()    # Symbol
+    '%w': '[]'  # Array of strings
+    '%W': '[]'  # Array of strings, interpolated
+    '%x': ()    # shell command
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/CollectionMethods:
+  Enabled: true
+  # Mapping from undesired method to desired_method
+  # e.g. use `detect` over `find`:
+  PreferredMethods:
+    find: 'detect'
+    find_all: 'select'
+
+Style/AlignHash:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
+Style/AndOr:
+  # Whether `and` and `or` are banned only in conditionals (conditionals)
+  # or completely (always).
+  EnforcedStyle: conditionals # and/or are sometimes used for flow control.
+
+Style/BlockDelimiters:
+  EnforcedStyle: semantic
+
+Style/HashSyntax:
+  EnforcedStyle: ruby19_no_mixed_keys
+
+Style/NumericLiterals:
+  MinDigits: 5
+
+Style/SingleSpaceBeforeFirstArg:
+  Enabled: false
+
+# Configuration parameters: EnforcedStyleForMultiline, SupportedStyles.
+Style/TrailingComma:
+  EnforcedStyleForMultiline: comma
+
+Style/SingleLineBlockParams:
+  Enabled: false
+
+Style/EachWithObject:
+  Enabled: false
+
+Style/Lambda:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,20 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2016-01-26 02:10:21 +0000 using RuboCop version 0.35.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 15
+# Configuration parameters: AllowURI, URISchemes.
+Metrics/LineLength:
+  Max: 173
+
+# Offense count: 1
+# Configuration parameters: Exclude.
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/better_sqs.rb'

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Referly
+
+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,44 @@
+# Better SQS
+
+Making it _easier_ for you to quickly interact with SQS in an idiomatic fashion.
+
+## Status
+
+[![Circle CI](https://circleci.com/gh/Referly/better_sqs.svg?style=svg)](https://circleci.com/gh/Referly/better_sqs)
+
+## Usage
+
+```ruby
+require "better_sqs"
+
+better = BetterSqs::Client.new 
+better.push "better_sqs_dev_queue", "You pushed the message successfully!"
+# At this point you can confirm that the message was enqueued in the AWS console
+message = better.reserve "better_sqs_dev_queue"
+ 
+puts message.message_body
+
+message.delete
+```
+
+## Configuration
+
+To configure BetterSqs use the configuration block pattern
+
+```ruby
+require "better_sqs"
+BetterSqs.configure do |config|
+    # When a message is deferred, this number of seconds is added to the time period that the message
+    # will remain invisible to other consumers. SQS has a hard cap of 12 hours on visibility.
+    # It defaults to 60 seconds
+    config.sqs_message_deferral_seconds = 120
+    
+    # If you want to hardcode which region of SQS should be used then you can set this option. It is recommended
+    # to use the environment variable ENV["AWS_REGION"] instead
+    config.region = "us-west-2"
+    
+    # for aws_access_key_id and aws_secret_access_key you can set them in this fashion, but it is strongly
+    # recommended that you just use the environment variables instead: ENV["AWS_ACCESS_KEY_ID"], 
+    # ENV["AWS_SECRET_ACCESS_KEY"]
+end
+```

data/better_sqs.gemspec

@@ -0,0 +1,21 @@
+Gem::Specification.new do |s|
+  s.name        = "better_sqs"
+  s.version     = "0.1.0"
+  s.license     = "MIT"
+  s.date        = "2016-01-26"
+  s.summary     = "A more idiomatic interface to SQS."
+  s.description = "A convenient API for developers to interact with SQS with a trivial amount of effort"
+  s.authors     = ["Courtland Caldwell"]
+  s.email       = "engineering@mattermark.com"
+  s.files         = `git ls-files`.split("\n") - %w[Gemfile Gemfile.lock]
+  s.test_files    = `git ls-files -- {spec,features}/*`.split("\n")
+  s.homepage =
+    "https://github.com/Referly/better_sqs"
+  s.add_runtime_dependency "lincoln_logger", "~> 1.0"                   # Mattermark gem
+  s.add_runtime_dependency "aws-sdk", "~> 2"                            # Apache2 https://github.com/aws/aws-sdk-ruby/blob/master/LICENSE.txt
+  s.add_development_dependency "rspec", "~> 3.2"                        # MIT - @link https://github.com/rspec/rspec/blob/master/License.txt
+  s.add_development_dependency "byebug", "~> 3.5"                       # BSD (content is BSD) https://github.com/deivid-rodriguez/byebug/blob/master/LICENSE
+  s.add_development_dependency "simplecov", "~> 0.10"                   # MIT - @link https://github.com/colszowka/simplecov/blob/master/MIT-LICENSE
+  s.add_development_dependency "rubocop", "~> 0.31"                     # Create Commons Attribution-NonCommerical https://github.com/bbatsov/rubocop/blob/master/LICENSE.txt
+  s.add_development_dependency "rspec_junit_formatter", "~> 0.2"        # MIT https://github.com/sj26/rspec_junit_formatter/blob/master/LICENSE
+end

data/circle.yml

@@ -0,0 +1,15 @@
+machine:
+
+  timezone:
+    America/Los_Angeles # Set the timezone
+
+  # Version of ruby to use
+  ruby:
+    version:
+      2.1.3
+
+test:
+  override:
+    - bundle exec rubocop
+    - mkdir -p $CIRCLE_TEST_REPORTS/rspec
+    - bundle exec rspec --format RspecJunitFormatter --out $CIRCLE_TEST_REPORTS/rspec/rspec.xml spec --format progress

data/lib/better_sqs/client.rb

@@ -0,0 +1,64 @@
+require "aws-sdk"
+module BetterSqs
+  # A class that wraps the aws sdk v2 SQS client to reduce interface complexity
+  class Client
+    attr_accessor :sqs
+
+    def initialize
+      # if BetterSqs has not been configured then run the default configuration
+      BetterSqs.configure unless BetterSqs.configured?
+    end
+
+    # Push a message onto a queue
+    #
+    # @param queue_name [String, Symbol] the name of the queue that the message should pushed onto
+    # @param message_body [String] the message as it will be pushed onto the queue, no serialization occurs as
+    #  part of this method. You need to encode or serialize your object to a string before sending it to this method
+    # @return [Types::SendMessageResult] the sent message object returned from s3
+    def push(queue_name, message_body)
+      sqs.send_message(queue_url: url_for_queue(queue_name), message_body: message_body)
+    end
+
+    # Reserve a message from the specified queue
+    #
+    # @param queue_name [String, Symbol] the name of the SQS queue to reserve a message from
+    # @return [Messages::Sqs, NilClass] the message retrieved from the queue
+    def reserve(queue_name)
+      resp = sqs.receive_message(queue_url: url_for_queue(queue_name), max_number_of_messages: 1)
+      return nil unless resp.messages.any?
+      Message.new queue_client: self, queue: queue_name, sqs_message: resp.messages.first
+    end
+
+    # Delete a message from the queue
+    #
+    # @param message [Messages::Sqs] the message that should be deleted
+    def delete(message)
+      sqs.delete_message queue_url: url_for_queue(message.queue), receipt_handle: message.receipt_handle
+    end
+
+    # Updates the message visibility timeout to create some delay before an attempt will be made to reprocess the
+    #  message
+    #
+    # @param message [Messages::Sqs] the message for which the next retry should be delayed
+    def defer_retry(message)
+      sqs.change_message_visibility queue_url:          url_for_queue(message.queue),
+                                    receipt_handle:     message.receipt_handle,
+                                    visibility_timeout: BetterSqs.configuration.sqs_message_deferral_seconds
+    end
+
+    # Get the existing or create a new instances of the SQS client
+    #
+    # @return [Aws::SQS::Client] an instance of the SQS client
+    def sqs
+      @sqs ||= Aws::SQS::Client.new
+    end
+
+    # Get the specified queue instance if it already exists, otherwise create it and wait for it to be readied
+    #
+    # @param queue_name [String, Symbol] the name of the queue to be created
+    # @return [AWS::SQS::Queue] the requested queue instance
+    def url_for_queue(queue_name)
+      sqs.create_queue(queue_name: queue_name).queue_url
+    end
+  end
+end

data/lib/better_sqs/configuration.rb

@@ -0,0 +1,24 @@
+module BetterSqs
+  # Provides configuration management for the BetterSqs gem
+  class Configuration
+    attr_accessor :queue_name,
+                  :region,
+                  :sqs_message_deferral_seconds,
+                  :aws_access_key_id,
+                  :aws_secret_access_key
+
+    def initialize
+      @sqs_message_deferral_seconds = 60
+      @aws_access_key_id      = ENV["AWS_ACCESS_KEY_ID"]
+      @aws_secret_access_key  = ENV["AWS_SECRET_ACCESS_KEY"]
+      @region                 = ENV["AWS_REGION"]
+    end
+
+    def configure_aws
+      Aws.config.update(
+        region:      region,
+        credentials: Aws::Credentials.new(aws_access_key_id, aws_secret_access_key),
+      )
+    end
+  end
+end

data/lib/better_sqs/message.rb

@@ -0,0 +1,43 @@
+module BetterSqs
+  # A class that wraps Aws::Types::Message by reducing the size of the interface and adding imperative actions
+  # like deletion of self from a queue.
+  class Message
+    attr_accessor :sqs_message, :queue_client, :queue
+
+    # @param queue_client [Clients::Sqs] a SQS client instance
+    # @param queue [String, Symbol] the name of the queue the message came from
+    # @param sqs_message [Types::Message] the message result object
+    def initialize(queue_client: nil, queue: nil, sqs_message: nil)
+      @queue_client = queue_client
+      @queue = queue
+      @sqs_message = sqs_message
+    end
+
+    # @return [String] the receipt handle that is used to uniquely identify this particular receipt of the message
+    def receipt_handle
+      sqs_message.receipt_handle
+    end
+
+    # @return [String] the message's body contents
+    def message_body
+      sqs_message.body
+    end
+    alias_method :body, :message_body
+
+    # Delete self from the SQS queue
+    def delete
+      BetterSqs.logger.info "Deleting message from SQS queue."
+      queue_client.delete self
+    end
+
+    # Defer for sqs_message_deferral_seconds the message, before it will be made visible in sqs
+    def defer_retry
+      BetterSqs.logger.warn "Deferring retry processing of the message for #{BetterSqs.configuration.sqs_message_deferral_seconds} in SQS."
+      queue_client.defer_retry self
+    end
+
+    def ==(other)
+      sqs_message == other.sqs_message && queue_client == other.queue_client && queue == other.queue
+    end
+  end
+end

data/lib/better_sqs.rb

@@ -0,0 +1,36 @@
+require "lincoln_logger"
+require "better_sqs/configuration"
+require "better_sqs/client"
+require "better_sqs/message"
+module BetterSqs
+  class << self
+    # Allows the user to set configuration options
+    #  by yielding the configuration block
+    #
+    # @param opts [Hash] an optional hash of options, supported options are `reset: true`
+    # @param block [Block] an optional configuration block
+    # @return [Configuration] the current configuration object
+    def configure(opts = {}, &_block)
+      @configuration = nil if opts.key?(:reset) && opts[:reset]
+      yield(configuration) if block_given?
+
+      configuration.configure_aws
+      configuration
+    end
+
+    # Returns the singleton class's configuration object
+    #
+    # @return [Configuration] the current configuration object
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configured?
+      !@configuration.nil?
+    end
+
+    def logger
+      LincolnLogger.logger
+    end
+  end
+end

data/spec/better_sqs/client_spec.rb

@@ -0,0 +1,94 @@
+require "spec_helper"
+
+describe BetterSqs::Client do
+  subject { described_class.new }
+
+  let(:queue_name) { "anotherqueue" }
+  let(:sqs) { mock_aws_sqs_client queue_url: "sqs://foo/bar" }
+  let(:sqs_message) { mock_sqs_message }
+
+  before do
+    subject.sqs = sqs
+  end
+
+  describe "#push" do
+    let(:message_body) { "I am an important message" }
+
+    it "enqueues the message into the SQS queue" do
+      expect(sqs).
+        to receive(:send_message).
+        with(queue_url: sqs.url_for_queue(queue_name), message_body: message_body).
+        and_return(double "SendMessageResult")
+
+      subject.push queue_name, message_body
+    end
+  end
+
+  describe "#reserve" do
+    let(:receive_message_response) { mock_aws_sqs_receive_message_response messages: [sqs_message] }
+    before do
+      allow(sqs).to receive(:receive_message).and_return receive_message_response
+    end
+
+    it "retrieves a message from SQS" do
+      expect(sqs).
+        to receive(:receive_message).
+        with(queue_url: sqs.url_for_queue(queue_name), max_number_of_messages: 1).
+        and_return receive_message_response
+
+      subject.reserve queue_name
+    end
+
+    it "wraps the message in a BetterSqs::Message object" do
+      expected_message = BetterSqs::Message.new queue_client: subject,
+                                                queue:        queue_name,
+                                                sqs_message:  sqs_message
+      expect(subject.reserve queue_name).to eq expected_message
+    end
+  end
+
+  describe "#delete" do
+    it "deletes a message from SQS" do
+      message_to_delete = BetterSqs::Message.new queue_client: subject,
+                                                 queue:        queue_name,
+                                                 sqs_message:  sqs_message
+      expect(sqs).
+        to receive(:delete_message).
+        with(queue_url: sqs.url_for_queue(queue_name), receipt_handle: sqs_message.receipt_handle)
+
+      subject.delete message_to_delete
+    end
+  end
+
+  describe "#url_for_queue" do
+    let(:mock_queue) {
+      mq = SqsMocks::MockQueue.new
+      mq.queue_name = queue_name
+      mq.queue_url = sqs.queue_url
+      mq
+    }
+    it "creates the queue" do
+      expect(sqs).to receive(:create_queue).with(queue_name: queue_name).and_return mock_queue
+      subject.url_for_queue queue_name
+    end
+
+    it "is the queue_url for the queue" do
+      expect(subject.url_for_queue queue_name).to eq sqs.queue_url
+    end
+  end
+
+  describe "#defer_retry" do
+    it "increases the visibility timeout for the message" do
+      message_to_defer = BetterSqs::Message.new queue_client: subject,
+                                                queue:        queue_name,
+                                                sqs_message:  sqs_message
+
+      expect(sqs).
+        to receive(:change_message_visibility).
+        with(queue_url:          sqs.url_for_queue(queue_name),
+             receipt_handle:     message_to_defer.receipt_handle,
+             visibility_timeout: BetterSqs.configuration.sqs_message_deferral_seconds)
+      subject.defer_retry message_to_defer
+    end
+  end
+end

data/spec/better_sqs/message_spec.rb

@@ -0,0 +1,54 @@
+require "spec_helper"
+
+describe BetterSqs::Message do
+  let(:queue_client) { mock_queue_client }
+  let(:queue) { "queue_name" }
+  let(:sqs_message) { mock_sqs_message }
+
+  subject { described_class.new }
+
+  describe "creating a new QueueMessage instance" do
+    {
+      queue_client: :imagine_i_am_a_queue_client,
+      queue:        "queue_name",
+      sqs_message:  "I like to eat peanut butter.",
+    }.each do |optional_param, value|
+      it "supports #{optional_param} as an optional parameter" do
+        instance = described_class.new optional_param => value
+        expect(instance.public_send optional_param).to eq value
+      end
+    end
+  end
+
+  describe "#receipt_handle" do
+    it "is the s3_message's receipt handle" do
+      subject.sqs_message = sqs_message
+      expect(subject.receipt_handle).to eq sqs_message.receipt_handle
+    end
+  end
+
+  describe "#message_body" do
+    it "is the s3_message's body" do
+      subject.sqs_message = sqs_message
+      expect(subject.message_body).to eq sqs_message.body
+    end
+  end
+
+  describe "#delete" do
+    it "deletes itself from the SQS queue" do
+      expect(queue_client).to receive(:delete).with(subject).and_return Aws::EmptyStructure
+      subject.queue_client = queue_client
+
+      subject.delete
+    end
+  end
+
+  describe "#defer_retry" do
+    it "increases the visibility timeout for the message" do
+      expect(queue_client).to receive(:defer_retry).with(subject).and_return Aws::EmptyStructure
+      subject.queue_client = queue_client
+
+      subject.defer_retry
+    end
+  end
+end

data/spec/better_sqs_spec.rb

@@ -0,0 +1,76 @@
+require "spec_helper"
+
+describe BetterSqs do
+  describe "configuring BetterSqs" do
+    describe ".configure" do
+      it "yields an instance of BetterSqs::Configuration to the provided configuration block" do
+        expect { |b| BetterSqs.configure(&b) }.to yield_with_args BetterSqs::Configuration
+      end
+      describe "configurable attributes" do
+        {
+          queue_name: "handsomequeue",
+          region:     "us-east-1",
+        }.each do |k, v|
+          describe "#{k}" do
+            let(:key) { k }
+            let(:value) { v }
+
+            let(:configure_block) do
+              proc do |config|
+                config.send "#{key}=", value
+              end
+            end
+
+            it "is configurable" do
+              described_class.configure(&configure_block)
+
+              expect(described_class.configuration.public_send k).to eq v
+            end
+          end
+        end
+      end
+      it "allows the configuration to be reset" do
+        described_class.configure do |c|
+          c.queue_name = "original_queue_name"
+        end
+        first_configuration = described_class.configuration
+
+        described_class.configure(reset: true) do |c|
+          c.region = "ca-1"
+        end
+
+        expect(described_class.configuration).not_to eq first_configuration
+        expect(described_class.configuration.queue_name).not_to eq "original_queue_name"
+        expect(described_class.configuration.region).to eq "ca-1"
+      end
+    end
+  end
+
+  describe "accessing the current BetterSqs configuration" do
+    describe ".configuration" do
+      context "when the BetterSqs has been previously configured" do
+        before do
+          described_class.configure
+        end
+
+        it "is the current configuration of the BetterSqs" do
+          expected_configuration = described_class.instance_variable_get :@configuration
+
+          expect(described_class.configuration).to eq expected_configuration
+        end
+      end
+
+      context "when the BetterSqs has not been previously configured" do
+        it "sets the current configuration to a new instance of Configuration" do
+          described_class.configuration
+
+          expect(described_class.instance_variable_get :@configuration).to be_a BetterSqs::Configuration
+        end
+
+        it "returns the new Configuration instance" do
+          expect(described_class.configuration).to eq described_class.instance_variable_get :@configuration
+        end
+      end
+    end
+  end
+end

data/spec/simplecov_custom_profile.rb

@@ -0,0 +1,4 @@
+require "simplecov"
+SimpleCov.profiles.define "better_sqs" do
+  add_filter "/spec"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require_relative "simplecov_custom_profile"
+SimpleCov.start "better_sqs"
+require "better_sqs"
+require "byebug"
+require_relative "support/mocks"

data/spec/support/mocks.rb

@@ -0,0 +1,41 @@
+def mock_queue_client
+  double "QueueClient"
+end
+
+def mock_sqs_message
+  double "SqsMessage", receipt_handle: "0111532-2342124", body: "this is the body of the message"
+end
+
+def mock_aws_sqs_receive_message_response(messages: [])
+  double "ReceiveMessageResponse", messages: messages
+end
+
+module SqsMocks
+  class MockQueue
+    attr_accessor :queue_name, :queue_url
+  end
+
+  class MockClient
+    attr_accessor :queue_name, :queue_url
+
+    def initialize(queue_url)
+      @queue_url = queue_url
+    end
+
+    def create_queue(queue_name)
+      @queue_name = queue_name
+      q = MockQueue.new
+      q.queue_name = queue_name
+      q.queue_url = queue_url
+      q
+    end
+
+    def url_for_queue(_queue_name)
+      @queue_url
+    end
+  end
+end
+
+def mock_aws_sqs_client(queue_url: nil)
+  SqsMocks::MockClient.new queue_url
+end

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification
+name: better_sqs
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Courtland Caldwell
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lincoln_logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.31'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.31'
+- !ruby/object:Gem::Dependency
+  name: rspec_junit_formatter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: A convenient API for developers to interact with SQS with a trivial amount
+  of effort
+email: engineering@mattermark.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- LICENSE
+- README.md
+- better_sqs.gemspec
+- circle.yml
+- lib/better_sqs.rb
+- lib/better_sqs/client.rb
+- lib/better_sqs/configuration.rb
+- lib/better_sqs/message.rb
+- spec/better_sqs/client_spec.rb
+- spec/better_sqs/message_spec.rb
+- spec/better_sqs_spec.rb
+- spec/simplecov_custom_profile.rb
+- spec/spec_helper.rb
+- spec/support/mocks.rb
+homepage: https://github.com/Referly/better_sqs
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A more idiomatic interface to SQS.
+test_files:
+- spec/better_sqs/client_spec.rb
+- spec/better_sqs/message_spec.rb
+- spec/better_sqs_spec.rb
+- spec/simplecov_custom_profile.rb
+- spec/spec_helper.rb
+- spec/support/mocks.rb
+has_rdoc: