ears 0.11.2 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 288afca56e18d5cd8add5e50155a37d243daf862079893c2e2aa54728b5ce6dc
-  data.tar.gz: 7e961cf4efaf97fd72c79a8ff8fd49f2536decc6728a1f8d8ddb176b42de5ff3
+  metadata.gz: 2b5be9543cc8c9a75eb078b181786cd85864515064cce8ddb130647e53611700
+  data.tar.gz: 48b47f63a7e90c9e149cb008c6a34c35b9d8f4b8133f43c558906fe1fb5398ec
 SHA512:
-  metadata.gz: afee5b7d9069bfda962b20776cbb38e0d9b0a416461cb9a41a7eae3c3aa1531d6e29dedebcd7210d1295b17ff9b1bce17fcf0d91bc516d3ff302f067f2f23461
-  data.tar.gz: f595da01d69259e73d497aef6dee354d202d6bb413fb4e4dba240b1060fc6794352f4f43c16f6bc12f53ef553bbdce025bff5867ecfc2d6c770cdc73169fc09c
+  metadata.gz: c0e1a9620e0b167921c80e54df06f52fbfff47ea1023d07f8533f888e81443c5583addf46fa3129c32944b534da1595f7b23bff93e457575e72502b1fb7e98c9
+  data.tar.gz: 119f76252574d361b0d339e427203dbd952045afda5d329e6a327d48f5cabdcacb752f04e4ebe4398d86d55ac26314d678f61d925bf79e81d9e11f67b3f4240f

data/.rspec

@@ -1 +1,2 @@
 --require spec_helper
+--format doc

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.12.0 (2023-10-26)
+
+- add new interface to setup consumers including their exchange, queue and binding the queue to the exchange via routing key via `Ears.setup_consumers` and `configure(queue:, exchange:,routing_key:, ...)` for Ears::Consumers subclasses
+
 ## 0.11.2 (2023-10-25)
 
 - Add documentation generation via yard

data/Gemfile

@@ -2,13 +2,13 @@ source 'https://rubygems.org'
 
 gemspec
 
-group :development, :test do
-  gem 'prettier'
+group :test do
+  gem 'prettier', require: false
   gem 'rake'
-  gem 'redcarpet'
   gem 'rspec'
-  gem 'rubocop'
-  gem 'rubocop-rake'
-  gem 'rubocop-rspec'
-  gem 'yard'
+  gem 'rubocop', require: false
+  gem 'rubocop-rake', require: false
+  gem 'rubocop-rspec', require: false
+  gem 'simplecov'
+  gem 'yard', require: false
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ears (0.11.2)
+    ears (0.12.0)
       bunny (~> 2.22.0)
       multi_json
 
@@ -15,6 +15,7 @@ GEM
       amq-protocol (~> 2.3, >= 2.3.1)
       sorted_set (~> 1, >= 1.0.2)
     diff-lcs (1.5.0)
+    docile (1.4.0)
     haml (6.1.2)
       temple (>= 0.8.2)
       thor
@@ -36,7 +37,6 @@ GEM
     rake (13.0.6)
     rbs (3.1.3)
     rbtree (0.4.6)
-    redcarpet (3.6.0)
     regexp_parser (2.8.1)
     rexml (3.2.6)
     rspec (3.12.0)
@@ -78,6 +78,12 @@ GEM
       rubocop-factory_bot (~> 2.22)
     ruby-progressbar (1.13.0)
     set (1.0.3)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
     sorted_set (1.0.3)
       rbtree
       set (~> 1.0)
@@ -101,6 +107,7 @@ PLATFORMS
   arm64-darwin-20
   arm64-darwin-21
   arm64-darwin-22
+  ruby
   x86_64-darwin-20
   x86_64-darwin-21
   x86_64-darwin-22
@@ -110,11 +117,11 @@ DEPENDENCIES
   ears!
   prettier
   rake
-  redcarpet
   rspec
   rubocop
   rubocop-rake
   rubocop-rspec
+  simplecov
   yard
 
 BUNDLED WITH

data/Rakefile

@@ -2,13 +2,23 @@
 
 require 'rake/clean'
 require 'bundler/gem_tasks'
+require 'rubocop'
+require 'rubocop/rake_task'
 require 'rspec/core/rake_task'
 require 'yard'
 
 CLEAN << '.yardoc'
-CLOBBER << 'doc'
+CLOBBER << 'doc' << 'coverage'
 
 RSpec::Core::RakeTask.new(:spec)
 YARD::Rake::YardocTask.new { |t| t.stats_options = %w[--list-undoc] }
 
-task default: :spec
+RuboCop::RakeTask.new(:rubocop) do |task|
+  task.formatters = ['simple']
+  task.fail_on_error = true
+end
+
+desc 'Run Prettier'
+task(:prettier) { sh 'npm run lint' }
+
+task default: %i[spec rubocop prettier]

data/lib/ears/consumer.rb

@@ -27,6 +27,28 @@ module Ears
       middlewares << middleware.new(opts)
     end
 
+    # Configures the consumer, setting queue, exchange and other options to be used by
+    # the add_consumer method.
+    #
+    # @param [Hash] opts The options to configure the consumer with.
+    # @option opts [String] :queue The name of the queue to consume from.
+    # @option opts [String] :exchange The name of the exchange the queue should be bound to.
+    # @option opts [String] :routing_key The routing key used the queue binding.
+    # @option opts [Boolean] :durable_queue (true) Whether the queue should be durable.
+    # @option opts [Boolean] :retry_queue (false) Whether a retry queue should be provided.
+    # @option opts [Integer] :retry_delay (5000) The delay in milliseconds before retrying a message.
+    # @option opts [Boolean] :error_queue (false) Whether an error queue should be provided.
+    # @option opts [Boolean] :durable_exchange (true) Whether the exchange should be durable.
+    # @option opts [Symbol] :exchange_type (:topic) The type of exchange to use.
+    def self.configure(opts = {})
+      self.queue = opts.fetch(:queue)
+      self.exchange = opts.fetch(:exchange)
+      self.routing_key = opts.fetch(:routing_key)
+      self.queue_options = queue_options_from(opts: opts)
+      self.durable_exchange = opts.fetch(:durable_exchange, true)
+      self.exchange_type = opts.fetch(:exchange_type, :topic)
+    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!
     #
@@ -101,5 +123,32 @@ module Ears
         raise InvalidReturnError, result
       end
     end
+
+    class << self
+      attr_reader :queue,
+                  :exchange,
+                  :routing_key,
+                  :queue_options,
+                  :durable_exchange,
+                  :exchange_type
+
+      private
+
+      def queue_options_from(opts:)
+        {
+          durable: opts.fetch(:durable_queue, true),
+          retry_queue: opts.fetch(:retry_queue, false),
+          retry_delay: opts.fetch(:retry_delay, 5000),
+          error_queue: opts.fetch(:error_queue, false),
+        }
+      end
+
+      attr_writer :queue,
+                  :exchange,
+                  :routing_key,
+                  :queue_options,
+                  :durable_exchange,
+                  :exchange_type
+    end
   end
 end

data/lib/ears/middlewares/max_retries.rb

@@ -15,6 +15,7 @@ module Ears
 
       def call(delivery_info, metadata, payload, app)
         return handle_exceeded(payload) if retries_exceeded?(metadata)
+
         app.call(delivery_info, metadata, payload)
       end
 

data/lib/ears/setup.rb

@@ -58,8 +58,28 @@ module Ears
       end
     end
 
+    # Sets up consumers, including bindings to exchanges and queues.
+    #
+    # @param [Array<Class<Ears::Consumer>>] consumer_classes An array of subclasses of {Ears::Consumer} that call {Ears::Consumer#configure} in their class definition.
+    def setup_consumers(*consumer_classes)
+      consumer_classes.each { |consumer_class| setup_consumer(consumer_class) }
+    end
+
     private
 
+    def setup_consumer(consumer_class)
+      exchange =
+        exchange(
+          consumer_class.exchange,
+          consumer_class.exchange_type,
+          durable: consumer_class.durable_exchange,
+        )
+      configured_queue =
+        queue(consumer_class.queue, consumer_class.queue_options)
+      configured_queue.bind(exchange, routing_key: consumer_class.routing_key)
+      consumer(configured_queue, consumer_class)
+    end
+
     def queue_options(bunny_opts, retry_arguments)
       return bunny_opts unless retry_arguments
 

data/lib/ears/version.rb

@@ -1,3 +1,3 @@
 module Ears
-  VERSION = '0.11.2'
+  VERSION = '0.12.0'
 end

data/lib/ears.rb

@@ -8,7 +8,6 @@ require 'ears/version'
 module Ears
   class << self
     # The global configuration for Ears.
-    #
     # @return [Ears::Configuration]
     def configuration
       @configuration ||= Ears::Configuration.new
@@ -48,6 +47,11 @@ module Ears
       Ears::Setup.new.instance_eval(&block)
     end
 
+    # Quick setup your consumers (including exchanges and queues).
+    def setup_consumers(*consumer_classes)
+      Ears::Setup.new.setup_consumers(*consumer_classes)
+    end
+
     # Blocks the calling thread until +SIGTERM+ or +SIGINT+ is received.
     # Used to keep the process alive while processing messages.
     def run!
@@ -74,9 +78,7 @@ module Ears
 
     # Used internally for testing.
     def reset!
-      @connection = nil
-      @configuration = nil
-      Thread.current[:ears_channel] = nil
+      @configuration = @connection = Thread.current[:ears_channel] = nil
     end
 
     private

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ears
 version: !ruby/object:Gem::Version
-  version: 0.11.2
+  version: 0.12.0
 platform: ruby
 authors:
 - InVision AG
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-10-25 00:00:00.000000000 Z
+date: 2023-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny