lepus 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67f07eb800872caf73d2f74330322cfb4682f740cf60734405f399f815368a9f
-  data.tar.gz: 96257edb75021e9154cef73212e26f450f508ad7aa0fb5659756efebb8b3cb5a
+  metadata.gz: a9eb1d12b4ce05f9c4e9070d7083b68417b7a41b7cdb2b1a99cad2931c9879fe
+  data.tar.gz: 1a6eafc5a47b48a228279e5ede1a06acfea053b04cf686e8984719633d60e66b
 SHA512:
-  metadata.gz: eab85b9d115eade80732103040ca2e0db25e8146e0dc957005e469ec60776f0a0693a59bd5359bc618a1bb69fafd7b8b0ac19502029355703629f1d5a7040e89
-  data.tar.gz: 652b48322bb2372a261c497da6e60d4ea218f90d1ea2ae41da32024da74f6c5d4d288a4249af8279825aba6bf20b385748692190c2db871a63ab35e8e4338d78
+  metadata.gz: 40432e83f566507da124995e9a60130e10dbf54cc499ad8d3a6598369c0b8d3d9b78ab28be9fa6ca82812951092e28baead30d15d8b83feb6eeed9c6a30ebe32
+  data.tar.gz: '08948dbc7e9a927e2d26787a81c1106c1afb392aed5373248c54a02909a96d8d21b7e9f8c42a90e3ac4bc6179bfe1e5cc0c77c483be7d4808293bc6c51259213'

data/.github/workflows/linter.yml

@@ -9,7 +9,7 @@ on:
 jobs:
   rubocop:
     name: "Rubocop"
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1

data/.github/workflows/specs.yml

@@ -8,7 +8,7 @@ on:
 
 jobs:
   ruby-2-7:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     strategy:
       fail-fast: false
       matrix:
@@ -32,7 +32,7 @@ jobs:
         run: bundle exec rspec
 
   ruby-3-0:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     strategy:
       fail-fast: false
       matrix:

data/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.2.2 - 2026-10-30
+* Added: `lepus start --except A,B` (and `Supervisor.new(except:)`) runs every consumer but the ones listed
+
+## 0.2.1 - 2026-10-30
+* Added: `process_delivery.lepus` instrumentation around every consumed message, with consumer, exchange, routing key, redelivered flag and result
+* Added: `consumer_error.lepus` instrumentation when `#perform` raises, before the message is rejected
+* Added: `Lepus::LogSubscriber` logs processed deliveries (info) and consumer errors (error)
+* Fixed: `Lepus.instrument` without a block no longer raises when ActiveSupport is not loaded
+
 ## 0.2.0 - 2026-10-28
 * Added: named producer connections via `config.connection(name, url:, **bunny_options)`; `rabbitmq_url` remains the `:default` connection
 * Added: `connection:` option on `Producer.configure`, `Producer.publish` and `Lepus::Publisher.new`, with one producer connection pool per name

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lepus (0.2.0)
+    lepus (0.2.2)
       base64
       bunny
       concurrent-ruby

data/README.md

@@ -567,6 +567,21 @@ bundle exec lepus start MyConsumer1 MyConsumer2 --debug
 
 Each consumer will run in a separate process, and a supervisor will monitor them. If a consumer crashes, the supervisor will restart it.
 
+To run every consumer except some, for example to move one to its own deployment, use `--except` with a comma-separated list:
+
+```bash
+bundle exec lepus start --except MyConsumer1,MyConsumer2
+```
+
+### Instrumentation and logging
+
+Every consumed message emits a `process_delivery.lepus` event (`consumer`, `exchange`, `routing_key`, `redelivered`, `result`), and an exception raised by `#perform` emits `consumer_error.lepus` (with `error`) before the message is rejected. In Rails, `Lepus::LogSubscriber` logs both to `Lepus.logger`:
+
+```
+Lepus-0.2.1 Processed OrdersConsumer (12.3ms)  exchange: "orders", routing_key: "orders.created", redelivered: false, result: :ack
+Lepus-0.2.1 Error in OrdersConsumer (0.0ms)  exchange: "orders", routing_key: "orders.created", redelivered: false, error: "RuntimeError boom"
+```
+
 ### Puma Plugin
 
 We provide a Puma plugin if you want to run the Lepus's supervisor together with Puma and have Puma monitor and manage it. You just need to add

data/gemfiles/Gemfile.rails-5.2.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    lepus (0.2.0)
+    lepus (0.2.2)
       base64
       bunny
       concurrent-ruby

data/gemfiles/Gemfile.rails-6.1.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    lepus (0.2.0)
+    lepus (0.2.2)
       base64
       bunny
       concurrent-ruby

data/gemfiles/Gemfile.rails-7.2.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    lepus (0.2.0)
+    lepus (0.2.2)
       base64
       bunny
       concurrent-ruby

data/gemfiles/Gemfile.rails-8.0.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    lepus (0.2.0)
+    lepus (0.2.2)
       base64
       bunny
       concurrent-ruby

data/lib/lepus/cli.rb

@@ -10,6 +10,7 @@ module Lepus
     method_option :logfile, type: :string, default: nil
     method_option :pidfile, type: :string, default: nil
     method_option :require_file, type: :string, aliases: "-r", default: nil
+    method_option :except, type: :array, default: nil, desc: "Consumers to leave out"
 
     desc "start FirstConsumer SecondConsumer ... NthConsumer", "Run Consumer"
     default_command :start
@@ -17,9 +18,10 @@ module Lepus
     def start(*consumers)
       opts = (@options || {}).transform_keys(&:to_sym)
 
-      if (list = consumers.flat_map { |c| c.split(",") }.map(&:strip).uniq.sort).any?
+      if (list = consumer_names(consumers)).any?
         opts[:consumers] = list
       end
+      opts[:except] = consumer_names(opts[:except]) if opts[:except]
 
       if (logfile = opts.delete(:logfile))
         Lepus.logger = Logger.new(logfile)
@@ -78,5 +80,11 @@ module Lepus
         MSG
       end
     end
+
+    private
+
+    def consumer_names(names)
+      names.flat_map { |name| name.split(",") }.map(&:strip).reject(&:empty?).uniq.sort
+    end
   end
 end

data/lib/lepus/consumer.rb

@@ -98,26 +98,9 @@ module Lepus
       message = Message.coerce(delivery_info, metadata, payload)
       message.consumer_class = self.class
 
-      combined_chain = MiddlewareChain.combine(
-        Lepus.config.consumer_middleware_chain,
-        self.class.middleware_chain
-      )
-
-      combined_chain.execute(message) do |msg|
-        perform(msg).tap do |result|
-          verify_result(result)
-        end
+      Lepus.instrument(:process_delivery, **delivery_attributes(delivery_info)) do |event|
+        event[:result] = deliver(message, delivery_info)
       end
-    rescue Lepus::InvalidConsumerReturnError
-      raise
-    rescue Exception # rubocop:disable Lint/RescueException
-      on_delivery_error
-      # In testing mode, re-raise exceptions if consumer_raise_errors? is enabled
-      if defined?(Lepus::Testing) && Lepus::Testing.consumer_raise_errors?
-        raise
-      end
-
-      reject!
     end
 
     # Returns whether the last delivery resulted in an error.
@@ -194,6 +177,39 @@ module Lepus
     def on_delivery_error
     end
 
+    def deliver(message, delivery_info)
+      combined_chain = MiddlewareChain.combine(
+        Lepus.config.consumer_middleware_chain,
+        self.class.middleware_chain
+      )
+
+      combined_chain.execute(message) do |msg|
+        perform(msg).tap do |result|
+          verify_result(result)
+        end
+      end
+    rescue Lepus::InvalidConsumerReturnError
+      raise
+    rescue Exception => error # rubocop:disable Lint/RescueException
+      Lepus.instrument(:consumer_error, error: error, **delivery_attributes(delivery_info))
+      on_delivery_error
+      # In testing mode, re-raise exceptions if consumer_raise_errors? is enabled
+      if defined?(Lepus::Testing) && Lepus::Testing.consumer_raise_errors?
+        raise
+      end
+
+      reject!
+    end
+
+    def delivery_attributes(delivery_info)
+      {
+        consumer: self.class.name,
+        exchange: delivery_info&.exchange,
+        routing_key: delivery_info&.routing_key,
+        redelivered: delivery_info&.redelivered
+      }
+    end
+
     def verify_result(result)
       return if %i[ack reject requeue nack].include?(result)
 

data/lib/lepus/rails/log_subscriber.rb

@@ -100,6 +100,14 @@ class Lepus::LogSubscriber < ActiveSupport::LogSubscriber
     end
   end
 
+  def process_delivery(event)
+    info formatted_event(event, action: "Processed #{event.payload[:consumer]}", **event.payload.slice(:exchange, :routing_key, :redelivered, :result))
+  end
+
+  def consumer_error(event)
+    error formatted_event(event, action: "Error in #{event.payload[:consumer]}", **event.payload.slice(:exchange, :routing_key, :redelivered), error: formatted_error(event.payload[:error]))
+  end
+
   private
 
   def formatted_event(event, action:, **attributes)

data/lib/lepus/supervisor.rb

@@ -21,11 +21,13 @@ module Lepus
     # @param pidfile [String] The path to the pidfile where the supervisor's PID will be stored. Default is "tmp/pids/lepus.pid".
     # @param shutdown_timeout [Integer] The timeout in seconds to wait for child processes to terminate gracefully before forcing termination. Default is 5 seconds.
     # @param consumers [Array<String, Class>] An optional list of consumer class names (as strings or constants) to be run by this supervisor. If not provided, all discovered consumer classes will be used.
+    # @param except [Array<String, Class>] An optional list of consumer class names (as strings or constants) to leave out.
     def initialize(require_file: nil, pidfile: "tmp/pids/lepus.pid", shutdown_timeout: 5, **kwargs)
       @pidfile_path = pidfile
       @require_file = require_file
       @shutdown_timeout = shutdown_timeout.to_i
       @consumer_class_names = Array(kwargs[:consumers]).map(&:to_s) if kwargs.key?(:consumers)
+      @excluded_consumer_names = Array(kwargs[:except]).map(&:to_s)
 
       @forks = {}
       @pipes = {}
@@ -79,7 +81,7 @@ module Lepus
         @consumer_class_names.map { |name| Lepus::Primitive::String.new(name).constantize }
       else
         Lepus::Consumer.descendants
-      end.reject(&:abstract_class?)
+      end.reject { |klass| klass.abstract_class? || @excluded_consumer_names.include?(klass.name) }
     end
 
     def boot

data/lib/lepus/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lepus
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

data/lib/lepus.rb

@@ -77,7 +77,7 @@ module Lepus
     def instrument(channel, **options, &block)
       if defined?(ActiveSupport::Notifications)
         ActiveSupport::Notifications.instrument("#{channel}.lepus", **options, &block)
-      else
+      elsif block
         yield(options.dup)
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lepus
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Marcos G. Zimmermann
 autorequire:
 bindir: exec
 cert_chain: []
-date: 2026-10-28 00:00:00.000000000 Z
+date: 2026-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64