ears 0.3.0 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c122db057142136f9cbd1a20760711e0391494df1fa4d57eec4182ad5f748903
-  data.tar.gz: 92301abc303c0623cdcf33a24b20923a86514c3c3cbf0fff6515bdaecd66fd47
+  metadata.gz: 6b46a87dfab0c7135fbb74534070d44ef48b693f7dfd848b3df9d68ceb915b29
+  data.tar.gz: 3880d424b10a408d49a51dfb1f6e22650ede251d23b642ee5983e42cfa4c0b82
 SHA512:
-  metadata.gz: b32705e3c3a137514451440dc8e151ab2181f938f7e772a47d698f7bec115165b8a7c867a163cbd1f6507f0b200fba070babd1d31ece9a3571f764eab6b27830
-  data.tar.gz: 606693da62fc02b53efcde24be5b92ed0eafd10a83795cc8fd08c56cfa0f496bdbacad8b7350fddfa3080e87982307567c994bae5c3aab04b8ebc4766b3b592d
+  metadata.gz: d7c3368085535d3c385778d0711b89755dbe4f5e2fd8f91fb986c573bf4beeb8a86253c00e8238be5cc38c78e5fbe727dc403500c16752985ac7e04e208d9075
+  data.tar.gz: ba1ee1434321eb492948027c31d7180d1254f89bcd756cf3edd11f64abdaae9c553841bacc8fef1607939ac6aa8341cb5c9751441c4b48f807bf9ba73e4a8cf4

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.4.3 (2021-07-26)
+
+### Changes
+
+- Ears will not exit gracefully on unhandled errors anymore. You have to take care of proper flushing and cleanup yourself (see README for example).
+
+## 0.3.3 (2021-06-07)
+
+### Changes
+
+- Ears will now exit gracefully on unhandled errors to give the application a chance to do flushing and cleanup work
+
+## 0.3.2 (2021-05-21)
+
+### Changes
+
+- added YARD documentation and usage instructions to README
+- introduced `Ears::Middleware` as an abstract base class for middlewares
+
+## 0.3.1 (2021-05-07)
+
+### Changes
+
+- internally, user-defined `Ears::Consumer` instances are now wrapped by `Ears::ConsumerWrapper` to make the user-defined class smaller and easier to test
+
 ## 0.3.0 (2021-05-07)
 
 ### Breaking

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ears (0.3.0)
+    ears (0.4.3)
       bunny
       multi_json
 
@@ -19,6 +19,7 @@ GEM
       ast (~> 2.4.1)
     rainbow (3.0.0)
     rake (13.0.3)
+    redcarpet (3.5.1)
     regexp_parser (2.1.1)
     rexml (3.2.4)
     rspec (3.10.0)
@@ -52,6 +53,7 @@ GEM
       rubocop-ast (>= 1.1.0)
     ruby-progressbar (1.11.0)
     unicode-display_width (2.0.0)
+    yard (0.9.26)
 
 PLATFORMS
   x86_64-darwin-20
@@ -60,10 +62,12 @@ PLATFORMS
 DEPENDENCIES
   ears!
   rake
+  redcarpet
   rspec
   rubocop
   rubocop-rake
   rubocop-rspec
+  yard
 
 BUNDLED WITH
    2.2.3

data/README.md

@@ -1,6 +1,6 @@
 # Ears
 
-TODO: Write description here
+`Ears` is a small, simple library for writing RabbitMQ consumers.
 
 ## Installation
 
@@ -20,16 +20,151 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### Basic usage
+
+First, you should configure where `Ears` should connect to.
+
+```ruby
+require 'ears'
+
+Ears.configure do |config|
+  config.rabbitmq_url = 'amqp://user:password@myrmq:5672'
+end
+```
+
+Next, define your exchanges, queues, and consumers by calling `Ears.setup`.
+
+```ruby
+Ears.setup do
+  # define a durable topic exchange
+  my_exchange = exchange('my_exchange', :topic, durable: true)
+
+  # define a queue
+  my_queue = queue('my_queue', durable: true)
+
+  # bind your queue to the exchange
+  my_queue.bind(my_exchange, routing_key: 'my.routing.key')
+
+  # define a consumer that handles messages for that queue
+  consumer(my_queue, MyConsumer)
+end
+```
+
+Finally, you need to implement `MyConsumer` by subclassing `Ears::Consumer`.
+
+```ruby
+class MyConsumer < Ears::Consumer
+  def work(delivery_info, metadata, payload)
+    message = JSON.parse(payload)
+    do_stuff(message)
+
+    ack
+  end
+end
+```
+
+And, do not forget to run it. Be prepared that unhandled errors will be reraised. So, take care of cleanup work.
+
+```ruby
+begin
+  Ears.run!
+ensure
+  # all your cleanup work goes here...
+end
+```
+
+At the end of the `#work` method, you must always return `ack`, `reject`, or `requeue` to signal what should be done with the message.
+
+### Middlewares
+
+`Ears` supports middlewares that you can use for recurring tasks that you don't always want to reimplement. It comes with some built-in middlewares:
+
+- `Ears::JSON` for automatically parsing JSON payloads
+- `Ears::Appsignal` for automatically wrapping `#work` in an Appsignal transaction
+
+You can use a middleware by just calling `use` with the middleware you want to register in your consumer.
+
+```ruby
+require 'ears/middlewares/json'
+
+class MyConsumer < Ears::Consumer
+  # register the JSON middleware and don't symbolize keys (this can be omitted, the default is true)
+  use Ears::Middlewares::JSON, symbolize_keys: false
+
+  def work(delivery_info, metadata, payload)
+    return ack unless payload['data'].nil? # this now just works
+  end
+end
+```
+
+If you want to implement your own middleware, just subclass `Ears::Middleware` and implement `#call` (and if you need it `#initialize`).
+
+```ruby
+class MyMiddleware < Ears::Middleware
+  def initialize(opts = {})
+    @my_option = opts.fetch(:my_option, nil)
+  end
+
+  def call(delivery_info, metadata, payload, app)
+    do_stuff
+
+    # always call the next middleware in the chain or your consumer will never be called
+    app.call(delivery_info, metadata, payload)
+  end
+end
+```
+
+### Multiple threads
+
+If you need to handle a lot of messages, you might want to have multiple instances of the same consumer all working on a dedicated thread. This is supported out of the box. You just have to define how many consumers you want when calling `consumer` in `Ears.setup`.
+
+```ruby
+Ears.setup do
+  my_exchange = exchange('my_exchange', :topic, durable: true)
+  my_queue = queue('my_queue', durable: true)
+  my_queue.bind(my_exchange, routing_key: 'my.routing.key')
+
+  # this will instantiate MyConsumer 10 times and run every instance on a dedicated thread
+  consumer(my_queue, MyConsumer, 10)
+end
+```
+
+It may also be interesting for you to increase the prefetch amount. The default prefetch amount is 1, but if you have a lot of very small, fast to process messages, a higher prefetch is a good idea. Just set it when defining your consumer.
+
+```ruby
+Ears.setup do
+  my_exchange = exchange('my_exchange', :topic, durable: true)
+  my_queue = queue('my_queue', durable: true)
+  my_queue.bind(my_exchange, routing_key: 'my.routing.key')
+
+  # this will instantiate one consumer but with a prefetch value of 10
+  consumer(my_queue, MyConsumer, 1, prefetch: 10)
+end
+```
+
+### Setting arbitrary exchange/queue parameters
+
+If you need some custom arguments on your exchange or queue, you can just pass these to `queue` or `exchange` inside `Ears.setup`. These are then just passed on to `Bunny::Queue` and `Bunny::Exchange`.
+
+```ruby
+Ears.setup do
+  my_queue =
+    queue('my_queue', durable: true, arguments: { 'x-message-ttl' => 10_000 })
+end
+```
+
+## Documentation
+
+If you need more in-depth information, look at [our API documentation](https://www.rubydoc.info/gems/ears).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/ears. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/ears/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/ivx/ears. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/ivx/ears/blob/master/CODE_OF_CONDUCT.md).
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open-source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 ## Code of Conduct
 
-Everyone interacting in the Ears project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/ears/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Ears project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [code of conduct](https://github.com/ivx/ears/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -1,6 +1,9 @@
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
+require 'yard'
 
 RSpec::Core::RakeTask.new(:spec)
 
+YARD::Rake::YardocTask.new { |t| t.files = ['lib/**/*.rb'] }
+
 task default: :spec

data/ears.gemspec

@@ -19,6 +19,12 @@ Gem::Specification.new do |spec|
   spec.metadata['changelog_uri'] =
     'https://github.com/ivx/ears/blob/master/CHANGELOG.md'
 
+  spec.post_install_message =
+    '
+Ears: the new version changed the exit behaviour in case of uncaught exceptions.
+You may want to have a look into the CHANGELOG!
+'
+
   spec.files =
     Dir.chdir(File.expand_path('..', __FILE__)) do
       `git ls-files -z`.split("\x0").reject do |f|
@@ -33,8 +39,10 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'multi_json'
 
   spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'redcarpet'
   spec.add_development_dependency 'rspec'
   spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'rubocop-rake'
   spec.add_development_dependency 'rubocop-rspec'
+  spec.add_development_dependency 'yard'
 end

data/lib/ears.rb

@@ -1,47 +1,70 @@
 require 'bunny'
 require 'ears/configuration'
 require 'ears/consumer'
+require 'ears/middleware'
 require 'ears/setup'
 require 'ears/version'
 
 module Ears
-  class Error < StandardError
-  end
-
   class << self
+    # The global configuration for Ears.
+    #
+    # @return [Ears::Configuration]
     def configuration
       @configuration ||= Ears::Configuration.new
     end
 
+    # Yields the global configuration instance so you can modify it.
+    # @yieldparam configuration [Ears::Configuration] The global configuration instance.
     def configure
       yield(configuration)
     end
 
+    # The global RabbitMQ connection used by Ears.
+    #
+    # @return [Bunny::Session]
     def connection
       @connection ||= Bunny.new.tap { |conn| conn.start }
     end
 
+    # The channel for the current thread.
+    #
+    # @return [Bunny::Channel]
     def channel
       Thread.current[:ears_channel] ||=
         connection
           .create_channel(nil, 1, true)
           .tap do |channel|
             channel.prefetch(1)
-            channel.on_uncaught_exception { |error| Thread.main.raise(error) }
+            channel.on_uncaught_exception { |error| Ears.error!(error) }
           end
     end
 
+    # Used to set up your exchanges, queues and consumers. See {Ears::Setup} for implementation details.
     def setup(&block)
       Ears::Setup.new.instance_eval(&block)
     end
 
+    # Blocks the calling thread until +SIGTERM+ or +SIGINT+ is received.
+    # Used to keep the process alive while processing messages.
     def run!
       running = true
       Signal.trap('INT') { running = false }
       Signal.trap('TERM') { running = false }
-      sleep 1 while running
+      sleep 1 while running && !@uncaught_error_occurred
+      raise @error if @uncaught_error_occurred
+    end
+
+    # Signals that an uncaught error has occurred and the process should be stopped.
+    #
+    # @param [Exception] error The unhandled error that occurred.
+    def error!(error)
+      puts(error.full_message)
+      @uncaught_error_occurred = true
+      @error = error
     end
 
+    # Used internally for testing.
     def reset!
       @connection = nil
       Thread.current[:ears_channel] = nil

data/lib/ears/configuration.rb

@@ -1,7 +1,9 @@
 module Ears
+  # The class representing the global {Ears} configuration.
   class Configuration
     DEFAULT_RABBITMQ_URL = 'amqp://guest:guest@localhost:5672'
 
+    # @return [String] the connection string for RabbitMQ.
     attr_accessor :rabbitmq_url
 
     def initialize

data/lib/ears/consumer.rb

@@ -1,7 +1,10 @@
 require 'bunny'
 
 module Ears
-  class Consumer < Bunny::Consumer
+  # The abstract base class for consumers processing messages from queues.
+  # @abstract Subclass and override {#work} to implement.
+  class Consumer
+    # Error that is raised when an invalid value is returned from {#work}
     class InvalidReturnError < StandardError
       def initialize(value)
         super(
@@ -10,18 +13,38 @@ module Ears
       end
     end
 
+    # List of registered middlewares. Register new middlewares with {.use}.
+    # @return [Array<Ears::Middleware>]
     def self.middlewares
       @middlewares ||= []
     end
 
+    # Registers a new middleware by instantiating +middleware+ and passing it +opts+.
+    #
+    # @param [Class<Ears::Middleware>] middleware The middleware class to instantiate and register.
+    # @param [Hash] opts The options for instantiating the middleware.
     def self.use(middleware, opts = {})
       middlewares << middleware.new(opts)
     end
 
+    # The method that is called when a message from the queue is received.
+    # Keep in mind that the parameters received can be altered by middlewares!
+    #
+    # @param [Bunny::DeliveryInfo] delivery_info The delivery info of the message.
+    # @param [Bunny::MessageProperties] metadata The metadata of the message.
+    # @param [String] payload The payload of the message.
+    #
+    # @return [:ack, :reject, :requeue] A symbol denoting what should be done with the message.
     def work(delivery_info, metadata, payload)
       raise NotImplementedError
     end
 
+    # Wraps #work to add middlewares. This is being called by Ears when a message is received for the consumer.
+    #
+    # @param [Bunny::DeliveryInfo] delivery_info The delivery info of the received message.
+    # @param [Bunny::MessageProperties] metadata The metadata of the received message.
+    # @param [String] payload The payload of the received message.
+    # @raise [InvalidReturnError] if you return something other than +:ack+, +:reject+ or +:requeue+ from {#work}.
     def process_delivery(delivery_info, metadata, payload)
       self.class.middlewares.reverse.reduce(
         work_proc,
@@ -32,14 +55,24 @@ module Ears
 
     protected
 
+    # Helper method to ack a message.
+    #
+    # @return [:ack]
     def ack
       :ack
     end
 
+    # Helper method to reject a message.
+    #
+    # @return [:reject]
+    #
     def reject
       :reject
     end
 
+    # Helper method to requeue a message.
+    #
+    # @return [:requeue]
     def requeue
       :requeue
     end
@@ -49,7 +82,7 @@ module Ears
     def work_proc
       ->(delivery_info, metadata, payload) do
         work(delivery_info, metadata, payload).tap do |result|
-          process_result(result, delivery_info.delivery_tag)
+          verify_result(result)
         end
       end
     end
@@ -60,15 +93,8 @@ module Ears
       end
     end
 
-    def process_result(result, delivery_tag)
-      case result
-      when :ack
-        channel.ack(delivery_tag, false)
-      when :reject
-        channel.reject(delivery_tag)
-      when :requeue
-        channel.reject(delivery_tag, true)
-      else
+    def verify_result(result)
+      unless %i[ack reject requeue].include?(result)
         raise InvalidReturnError, result
       end
     end

data/lib/ears/consumer_wrapper.rb

@@ -0,0 +1,44 @@
+require 'bunny'
+
+module Ears
+  # Wraps the user-defined consumer to provide the expected interface to Bunny.
+  class ConsumerWrapper < Bunny::Consumer
+    # @param [Ears::Consumer] consumer The user-defined consumer implementation derived from {Ears::Consumer}.
+    # @param [Bunny::Channel] channel The channel used for the consumer.
+    # @param [Bunny::Queue] queue The queue the consumer is subscribed to.
+    # @param [String] consumer_tag A string identifying the consumer instance.
+    # @param [Hash] arguments Arguments that are passed on to +Bunny::Consumer.new+.
+    def initialize(consumer, channel, queue, consumer_tag, arguments = {})
+      @consumer = consumer
+      super(channel, queue, consumer_tag, false, false, arguments)
+    end
+
+    # Called when a message is received from the subscribed queue.
+    #
+    # @param [Bunny::DeliveryInfo] delivery_info The delivery info of the received message.
+    # @param [Bunny::MessageProperties] metadata The metadata of the received message.
+    # @param [String] payload The payload of the received message.
+    def process_delivery(delivery_info, metadata, payload)
+      consumer
+        .process_delivery(delivery_info, metadata, payload)
+        .tap { |result| process_result(result, delivery_info.delivery_tag) }
+    end
+
+    private
+
+    attr_reader :consumer
+
+    def process_result(result, delivery_tag)
+      case result
+      when :ack
+        channel.ack(delivery_tag, false)
+      when :reject
+        channel.reject(delivery_tag)
+      when :requeue
+        channel.reject(delivery_tag, true)
+      else
+        raise InvalidReturnError, result
+      end
+    end
+  end
+end

data/lib/ears/middleware.rb

@@ -0,0 +1,15 @@
+module Ears
+  # The abstract base class for middlewares.
+  # @abstract Subclass and override {#call} (and maybe +#initialize+) to implement.
+  class Middleware
+    # Invokes the middleware.
+    #
+    # @param [Bunny::DeliveryInfo] delivery_info The delivery info of the received message.
+    # @param [Bunny::MessageProperties] metadata The metadata of the received message.
+    # @param [String] payload The payload of the received message.
+    # @param app The next middleware to call or the actual consumer instance.
+    def call(delivery_info, metadata, payload, app)
+      raise NotImplementedError
+    end
+  end
+end

data/lib/ears/middlewares/appsignal.rb

@@ -1,9 +1,14 @@
+require 'ears/middleware'
+
 module Ears
   module Middlewares
-    class Appsignal
-      attr_reader :transaction_name, :class_name, :method
-
+    # A middleware that automatically wraps {Ears::Consumer#work} in an Appsignal transaction.
+    class Appsignal < Middleware
+      # @param [Hash] opts The options for the middleware.
+      # @option opts [String] :transaction_name The name of the Appsignal transaction.
+      # @option opts [String] :class_name The name of the class you want to monitor.
       def initialize(opts)
+        super()
         @transaction_name = opts.fetch(:transaction_name)
         @class_name = opts.fetch(:class_name)
       end
@@ -16,6 +21,10 @@ module Ears
           queue_start: Time.now.utc,
         ) { app.call(delivery_info, metadata, payload) }
       end
+
+      private
+
+      attr_reader :transaction_name, :class_name
     end
   end
 end

data/lib/ears/middlewares/json.rb

@@ -1,11 +1,14 @@
+require 'ears/middleware'
 require 'multi_json'
 
 module Ears
   module Middlewares
-    class JSON
-      attr_reader :symbolize_keys
-
+    # A middleware that automatically parses your JSON payload.
+    class JSON < Middleware
+      # @param [Hash] opts The options for the middleware.
+      # @option opts [Boolean] :symbolize_keys Whether to symbolize the keys of your payload.
       def initialize(opts = {})
+        super()
         @symbolize_keys = opts.fetch(:symbolize_keys, true)
       end
 
@@ -13,6 +16,10 @@ module Ears
         parsed_payload = MultiJson.load(payload, symbolize_keys: symbolize_keys)
         app.call(delivery_info, metadata, parsed_payload)
       end
+
+      private
+
+      attr_reader :symbolize_keys
     end
   end
 end

data/lib/ears/setup.rb

@@ -1,16 +1,36 @@
 require 'bunny'
 require 'ears/consumer'
+require 'ears/consumer_wrapper'
 
 module Ears
+  # Contains methods used in {Ears.setup} to set up your exchanges, queues and consumers.
   class Setup
+    # Creates a new exchange if it does not already exist.
+    #
+    # @param [String] name The name of the exchange.
+    # @param [Symbol] type The type of the exchange (:direct, :fanout, :topic or :headers).
+    # @param [Hash] opts The options for the exchange. These are passed on to +Bunny::Exchange.new+.
+    # @return [Bunny::Exchange] The exchange that was either newly created or was already there.
     def exchange(name, type, opts = {})
       Bunny::Exchange.new(Ears.channel, type, name, opts)
     end
 
+    # Creates a new queue if it does not already exist.
+    #
+    # @param [String] name The name of the queue.
+    # @param [Hash] opts The options for the queue. These are passed on to +Bunny::Exchange.new+.
+    # @return [Bunny::Queue] The queue that was either newly created or was already there.
     def queue(name, opts = {})
       Bunny::Queue.new(Ears.channel, name, opts)
     end
 
+    # Creates and starts one or many consumers bound to the given queue.
+    #
+    # @param [Bunny::Queue] queue The queue the consumers should be subscribed to.
+    # @param [Class<Ears::Consumer>] consumer_class A class implementing {Ears::Consumer} that holds the consumer behavior.
+    # @param [Integer] threads The number of threads that should be used to process messages from the queue.
+    # @param [Hash] args The arguments for the consumer. These are passed on to +Bunny::Consumer.new+.
+    # @option args [Integer] :prefetch (1) The prefetch count used for this consumer.
     def consumer(queue, consumer_class, threads = 1, args = {})
       threads.times do |n|
         consumer_queue = create_consumer_queue(queue, args)
@@ -27,12 +47,11 @@ module Ears
     private
 
     def create_consumer(queue, consumer_class, args, number)
-      consumer_class.new(
+      ConsumerWrapper.new(
+        consumer_class.new,
         queue.channel,
         queue,
         "#{consumer_class.name}-#{number}",
-        false,
-        false,
         args,
       )
     end
@@ -43,7 +62,7 @@ module Ears
         .create_channel(nil, 1, true)
         .tap do |channel|
           channel.prefetch(args.fetch(:prefetch, 1))
-          channel.on_uncaught_exception { |error| Thread.main.raise(error) }
+          channel.on_uncaught_exception { |error| Ears.error!(error) }
         end
     end
 

data/lib/ears/version.rb

@@ -1,3 +1,3 @@
 module Ears
-  VERSION = '0.3.0'
+  VERSION = '0.4.3'
 end

data/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "on-prem-importer",
+  "name": "ears",
   "private": true,
   "scripts": {
     "prettify": "prettier \"**/*.{ru,rb,yml,yaml,md,gemspec,json}\" --ignore-path=\".gitignore\"",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ears
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.3
 platform: ruby
 authors:
 - Mario Mainz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-05-07 00:00:00.000000000 Z
+date: 2021-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny
@@ -52,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -108,6 +122,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A gem for building RabbitMQ consumers.
 email:
 - mario.mainz@invision.de
@@ -131,6 +159,8 @@ files:
 - lib/ears.rb
 - lib/ears/configuration.rb
 - lib/ears/consumer.rb
+- lib/ears/consumer_wrapper.rb
+- lib/ears/middleware.rb
 - lib/ears/middlewares/appsignal.rb
 - lib/ears/middlewares/json.rb
 - lib/ears/setup.rb
@@ -145,7 +175,10 @@ metadata:
   homepage_uri: https://github.com/ivx/ears
   source_code_uri: https://github.com/ivx/ears
   changelog_uri: https://github.com/ivx/ears/blob/master/CHANGELOG.md
-post_install_message:
+post_install_message: |2
+
+  Ears: the new version changed the exit behaviour in case of uncaught exceptions.
+  You may want to have a look into the CHANGELOG!
 rdoc_options: []
 require_paths:
 - lib