lepus 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67f07eb800872caf73d2f74330322cfb4682f740cf60734405f399f815368a9f
-  data.tar.gz: 96257edb75021e9154cef73212e26f450f508ad7aa0fb5659756efebb8b3cb5a
+  metadata.gz: 8cf7f4418578e3ab6600df2c9de267e134311af605a96db80f7b0f746763096d
+  data.tar.gz: 469fda46acebe440afe6ecca36e78b7b4395c520bc789ed90183553c3eb78ed7
 SHA512:
-  metadata.gz: eab85b9d115eade80732103040ca2e0db25e8146e0dc957005e469ec60776f0a0693a59bd5359bc618a1bb69fafd7b8b0ac19502029355703629f1d5a7040e89
-  data.tar.gz: 652b48322bb2372a261c497da6e60d4ea218f90d1ea2ae41da32024da74f6c5d4d288a4249af8279825aba6bf20b385748692190c2db871a63ab35e8e4338d78
+  metadata.gz: ed0693421c238ba690ad399d072449920d73fdc63ec2437095ce8d8352bdf5aabfb65517ce34ed5aaae06fe68fa45aefa55dd31a3c1a743e5f80e43b3dbaad18
+  data.tar.gz: 4fc5b7a1735979b94c94b7d6a6fd6979bf84c3479e19ec0661ba355c604af9233f218bf735dca9990a4d31197b468185506739c1f17b5618a2ffc664c39d3a43

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,12 @@ 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.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.1)
       base64
       bunny
       concurrent-ruby

data/README.md

@@ -567,6 +567,15 @@ 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.
 
+### 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.1)
       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.1)
       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.1)
       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.1)
       base64
       bunny
       concurrent-ruby

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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lepus
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 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.1
 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