ears 0.22.2 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6483233146640e82b3de7c02e3429615e31a7b231109846528735068054f9bb
-  data.tar.gz: 54a0f5b927c41292232f8f4c0926da9d7a9fd44457bc618ad99bf028ce13c41e
+  metadata.gz: bb14b9ea691e7c7161be693c96c6d6290da592be3c369acef5dab1b9e52f5cf5
+  data.tar.gz: 2383344432fd4124b3da7c0198050ea26e769764a931612ec58c01de14c93951
 SHA512:
-  metadata.gz: da2668020244abab87e630625ea191f61cc2aacc45f08f59a194c0d4fc3e1e25445842f20349d8919c04738f3dcfecbb0979ea71d7b0249220e3f8148cfb1e7e
-  data.tar.gz: 525197d5ee63152fcaddb09af9339ad0c4ff054fcb8c0a3c74069b08f6a6f7beab5755522c13ae1c18be15716979badb0b9dd536e64ced620cf5ad537ae20a75
+  metadata.gz: 54adea3a1dfdb3913864257b55d0a8d7a785da918da135ffe119606862591bbbb3afca40d6d152581a0d8756f80acd69c81a1daeac24e61727b270dadb121555
+  data.tar.gz: 9cbd63bfeea67f04711b0fdbcdfc30d7cd430dde5f17008a92746eff15a516efb7a761f85cda9d9690ca32b8755b4a08281b6b430e6ba276f9a4e4621a487965

data/.github/workflows/build.yml

@@ -15,13 +15,13 @@ jobs:
         ruby-version: ['3.2', '3.3', '3.4']
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
           node-version: '24'
       - name: Run prettier
@@ -37,7 +37,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:

data/.github/workflows/codeql.yml

@@ -41,11 +41,11 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@v3
+        uses: github/codeql-action/init@v4
         with:
           languages: ${{ matrix.language }}
           # If you wish to specify custom queries, you can do so here or in a config file.
@@ -58,7 +58,7 @@ jobs:
       # Autobuild attempts to build any compiled languages  (C/C++, C#, Go, or Java).
       # If this step fails, then you should remove it and run the build manually (see below)
       - name: Autobuild
-        uses: github/codeql-action/autobuild@v3
+        uses: github/codeql-action/autobuild@v4
 
       # ℹ️ Command-line programs to run using the OS shell.
       # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
@@ -71,6 +71,6 @@ jobs:
       #     ./location_of_script_within_repo/buildscript.sh
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v3
+        uses: github/codeql-action/analyze@v4
         with:
           category: '/language:${{matrix.language}}'

data/.github/workflows/dependency-review.yml

@@ -15,6 +15,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 'Checkout Repository'
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: 'Dependency Review'
         uses: actions/dependency-review-action@v4

data/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 
-## 0.22.2 (2025-01-19)
+## 0.24.0 (2025-12-18)
+
+- Replace `MultiJson` in `Ears::Middlewares::JSON` with `JSON`
+
+## 0.23.0 (2025-11-06)
+
+- Add `have_been_published` rspec matcher
+
+## 0.22.2 (2025-09-19)
 
 ### Fixed
 

data/Gemfile.lock

@@ -1,10 +1,10 @@
 PATH
   remote: .
   specs:
-    ears (0.22.2)
+    ears (0.24.0)
       bunny (>= 2.22.0)
       connection_pool (~> 2.4)
-      multi_json
+      json (>= 2.9.0)
 
 GEM
   remote: https://rubygems.org/
@@ -20,7 +20,6 @@ GEM
     json (2.13.2)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    multi_json (1.17.0)
     parallel (1.27.0)
     parser (3.3.9.0)
       ast (~> 2.4.1)
@@ -84,13 +83,9 @@ GEM
     yard (0.9.37)
 
 PLATFORMS
-  arm64-darwin-20
-  arm64-darwin-21
-  arm64-darwin-22
+  arm64-darwin
   ruby
-  x86_64-darwin-20
-  x86_64-darwin-21
-  x86_64-darwin-22
+  x86_64-darwin
   x86_64-linux
 
 DEPENDENCIES
@@ -111,11 +106,10 @@ CHECKSUMS
   connection_pool (2.5.4) sha256=e9e1922327416091f3f6542f5f4446c2a20745276b9aa796dd0bb2fd0ea1e70a
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
-  ears (0.22.2)
+  ears (0.24.0)
   json (2.13.2) sha256=02e1f118d434c6b230a64ffa5c8dee07e3ec96244335c392eaed39e1199dbb68
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
-  multi_json (1.17.0) sha256=76581f6c96aebf2e85f8a8b9854829e0988f335e8671cd1a56a1036eb75e4a1b
   parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
   parser (3.3.9.0) sha256=94d6929354b1a6e3e1f89d79d4d302cc8f5aa814431a6c9c7e0623335d7687f2
   prettier_print (1.2.1) sha256=a72838b5f23facff21f90a5423cdcdda19e4271092b41f4ea7f50b83929e6ff9

data/README.md

@@ -663,6 +663,83 @@ Each captured message has the following properties:
 - `timestamp` - When the message was captured
 - `thread_id` - Thread that published the message
 
+### Custom RSpec Matcher: `have_been_published`
+
+To make tests more expressive, Ears provides a custom RSpec matcher that allows you to easily assert that a specific message was published to a mocked exchange.
+
+#### Usage
+
+Include the matcher by requiring `ears/testing` in your RSpec tests and including the helper module:
+
+```ruby
+require 'ears/testing/matchers'
+
+RSpec.describe MyPublisher do
+  include Ears::Testing::Matchers
+
+  before { mock_ears('events') }
+  after { ears_reset! }
+
+  it 'publishes a user.created message' do
+    publisher = Ears::Publisher.new('events', :topic)
+    publisher.publish({ user_id: 1 }, routing_key: 'user.created')
+
+    expect(
+      exchange_name: 'events',
+      routing_key: 'user.created',
+      data: {
+        user_id: 1,
+      },
+    ).to have_been_published
+  end
+
+  # also works with negative assertions
+  it 'does not publish a user.deleted message' do
+    publisher = Ears::Publisher.new('events', :topic)
+    publisher.publish({ user_id: 1 }, routing_key: 'user.created')
+
+    expect(
+      exchange_name: 'events',
+      routing_key: 'user.deleted',
+      data: {
+        user_id: 1,
+      },
+    ).not_to have_been_published
+  end
+end
+```
+
+#### Supported Keys
+
+You can match on any or all of the following attributes:
+
+| Key              | Description                                    | Example                                             |
+| ---------------- | ---------------------------------------------- | --------------------------------------------------- |
+| `:exchange_name` | The exchange where the message was published   | `'events'`                                          |
+| `:routing_key`   | The routing key used for the message           | `'user.created'`                                    |
+| `:data`          | The message payload (exact match)              | `{ user_id: 1 }`                                    |
+| `:options`       | Message options such as headers or persistence | `{ persistent: true, headers: { version: '1.0' } }` |
+
+If a key is omitted, it will not be checked — allowing partial matches (for example, matching only on `exchange_name` and `routing_key`).
+
+#### Example: Matching with Options
+
+> **Note:** When matching `:options`, you only need to specify the options you want to verify — the matcher will ignore any additional options present in the published message.
+
+```ruby
+expect(
+  exchange_name: 'events',
+  routing_key: 'user.created',
+  data: {
+    id: 42,
+    name: 'Alice',
+  },
+  options: {
+    persistent: true,
+  },
+).to have_been_published
+```
+
 ### Error Handling
 
 By default, publishing to unmocked exchanges raises an error:

data/ears.gemspec

@@ -34,5 +34,5 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'bunny', '>= 2.22.0'
   spec.add_dependency 'connection_pool', '~> 2.4'
-  spec.add_dependency 'multi_json'
+  spec.add_dependency 'json', '>= 2.9.0'
 end

data/lib/ears/middlewares/json.rb

@@ -1,5 +1,5 @@
+require 'json'
 require 'ears/middleware'
-require 'multi_json'
 
 module Ears
   module Middlewares
@@ -17,7 +17,7 @@ module Ears
       def call(delivery_info, metadata, payload, app)
         begin
           parsed_payload =
-            MultiJson.load(payload, symbolize_keys: symbolize_keys)
+            ::JSON.parse(payload, symbolize_names: symbolize_keys)
         rescue => e
           return on_error.call(e)
         end

data/lib/ears/testing/matchers.rb

@@ -0,0 +1,43 @@
+module Ears
+  module Testing
+    module Matchers
+      RSpec::Matchers.define :have_been_published do # rubocop:disable Metrics/BlockLength
+        include Ears::Testing::TestHelper
+
+        match do |expected|
+          exchange_name = expected[:exchange_name]
+          messages = published_messages(exchange_name)
+
+          messages.any? { |message| matches_message?(message, expected) }
+        end
+
+        failure_message do |expected|
+          "expected a message with #{expected.inspect} to have been published, " \
+            "but published were:\n" \
+            "#{published_messages(expected[:exchange_name]).map(&:inspect).join("\n")}"
+        end
+
+        failure_message_when_negated do |expected|
+          matching =
+            published_messages(expected[:exchange_name]).select do |m|
+              matches_message?(m, expected)
+            end
+          "expected no message with #{expected.inspect} to have been published, but found:\n" \
+            "#{matching.map(&:inspect).join("\n")}"
+        end
+
+        def matches_message?(published, expected)
+          routing_key = expected[:routing_key]
+          data = expected[:data]
+          options = expected[:options]
+
+          [
+            (routing_key.nil? || published.routing_key == routing_key),
+            (data.nil? || published.data == data),
+            (options.nil? || options.all? { |k, v| published.options[k] == v }),
+          ].all?
+        end
+      end
+    end
+  end
+end

data/lib/ears/version.rb

@@ -1,3 +1,3 @@
 module Ears
-  VERSION = '0.22.2'
+  VERSION = '0.24.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ears
 version: !ruby/object:Gem::Version
-  version: 0.22.2
+  version: 0.24.0
 platform: ruby
 authors:
 - InVision AG
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-22 00:00:00.000000000 Z
+date: 2025-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny
@@ -39,19 +39,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.4'
 - !ruby/object:Gem::Dependency
-  name: multi_json
+  name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.9.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.9.0
 description: A gem for building RabbitMQ consumers.
 email:
 - johannes.luedke@invision.de
@@ -93,6 +93,7 @@ files:
 - lib/ears/publisher_retry_handler.rb
 - lib/ears/setup.rb
 - lib/ears/testing.rb
+- lib/ears/testing/matchers.rb
 - lib/ears/testing/message_capture.rb
 - lib/ears/testing/publisher_mock.rb
 - lib/ears/testing/test_helper.rb