karafka-testing 1.4.2 → 2.0.0.alpha2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf9bf583523d313a336fcc66427ccfeb0ed2a854f43437b80997e6e1013596ea
-  data.tar.gz: c949566d9675d397c265255d9951c1524bf4e7f5b0a7c5f2390943ec49accb13
+  metadata.gz: 15ad20f0c6aec1676017e4b0ae1a22275418d4c7bf455d07d27cf0696e93b483
+  data.tar.gz: 7316128b067662b376f001903eb993983752b9bd2fd2221ef900ba87891f047a
 SHA512:
-  metadata.gz: d235a752c5de038dcf15006f745f9fb9111ac38d2dd26de52b306debb56b8b160c9160b732f1e53a4f3c8d0133d568874dba6c2b966bd5ebcefb5bb4172f0359
-  data.tar.gz: bfb955a6f6f988710d46c3f0b82e5b7608b73ffab0659ca369cc35badc47530771f15d87e2d60d043b9a8cab0f68b6c2c72b6c19dc9f610bb80f50fe22b347a0
+  metadata.gz: 1dd7c25d36e028d43566249a5cc46670bdaaada4c7610da2dbc7758d3f6b09f75f06520670ed1772cc1d1197a41b95096d5d857c53d78c39ab101ff534f4e946
+  data.tar.gz: 3f318b4fa8690f7a44de1ac3774675044c1dfce57ace3f649a6656b03a8d97f296a25976438a208d7ff56fcc06a2d075aa142fcf94e37566e72920a61ecdede0

data/.github/workflows/ci.yml

@@ -1,5 +1,7 @@
 name: ci
 
+concurrency: ci-${{ github.ref }}
+
 on:
   pull_request:
   push:
@@ -14,11 +16,11 @@ jobs:
       fail-fast: false
       matrix:
         ruby:
+          - '3.1'
           - '3.0'
           - '2.7'
-          - '2.6'
         include:
-          - ruby: '3.0'
+          - ruby: '3.1'
             coverage: 'true'
     steps:
       - uses: actions/checkout@v2
@@ -46,7 +48,7 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.0
+          ruby-version: 3.1
       - name: Install latest bundler
         run: gem install bundler --no-document
       - name: Install Diffend plugin

data/.ruby-version

@@ -1 +1 @@
-3.0.1
+3.1.0

data/2.0-Upgrade.md

@@ -0,0 +1,60 @@
+# Welcome to Karafka-Testing 2.0!
+
+Karafka-Testing 2.0 some breaking changes in the way consumer builder and message publishing is done.
+
+## Upgrade
+
+Please upgrade your application to `Karafka 2.0` first.
+
+- Replace `#karafka_consumer_for` in your specs with `#karafka.consumer_for`
+- Replace `#publish_for_karafka` in your specs with `#karafka.publish`
+
+And that's all!
+
+Below you can find same example written for Karafka `2.0` and `1.4`.
+
+### Karafka 2.0
+
+```ruby
+RSpec.describe CountersConsumer do
+  subject(:consumer) { karafka.consumer_for(:counters) }
+
+  let(:nr1_value) { rand }
+  let(:nr2_value) { rand }
+  let(:sum) { nr1_value + nr2_value }
+
+  before do
+    karafka.publish({ 'number' => nr1_value }.to_json)
+    karafka.publish({ 'number' => nr2_value }.to_json, partition: 2)
+    allow(Karafka.logger).to receive(:info)
+  end
+
+  it 'expects to log a proper message' do
+    expect(Karafka.logger).to receive(:info).with("Sum of 2 elements equals to: #{sum}")
+    consumer.consume
+  end
+end
+```
+
+### Karafka 1.4
+
+```ruby
+RSpec.describe InlineBatchConsumer do
+  subject(:consumer) { karafka_consumer_for(:counters) }
+
+  let(:nr1_value) { rand }
+  let(:nr2_value) { rand }
+  let(:sum) { nr1_value + nr2_value }
+
+  before do
+    publish_for_karafka({ 'number' => nr1_value }.to_json)
+    publish_for_karafka({ 'number' => nr2_value }.to_json, partition: 2)
+    allow(Karafka.logger).to receive(:info)
+  end
+
+  it 'expects to log a proper message' do
+    expect(Karafka.logger).to receive(:info).with("Sum of 2 elements equals to: #{sum}")
+    consumer.consume
+  end
+end
+```

data/CHANGELOG.md

@@ -1,24 +1,14 @@
 # Karafka Test gem changelog
 
-## 1.4.2 (2021-04-21)
-- Restore MIT license
-- Remove Ruby 2.5 support and update minimum Ruby requirement to 2.6
+## 2.0.0.alpha2 (2022-02-19)
+- Add `rubygems_mfa_required`
 
-## 1.4.1 (2020-09-05)
-- Fix for Ruby 2.5 and 2.6 support
+## 2.0.0.alpha1 (2022-01-30)
+- Change the API to be more comprehensive
+- Update to work with Karafka 2.0
+- Support for Ruby 3.1
+- Drop support for ruby 2.6
 
-## 1.4.0 (2020-09-05)
-- Update to match Karafka 1.4.0 params and batch metadata setup
+## 1.4.*
 
-## 1.3.1 (2020-04-24)
-- change license to LGPL-3.0
-- Ruby 2.6.5 support
-- Ruby 2.7.1 support
-- JRuby support
-- Change license to LGPL-3.0
-
-## 1.3.0 (2019-09-09)
-- Dynamic `App` name (#2)
-
-## 1.3.0.rc1 (2019-07-31)
-- Support for Karafka 1.3
+If you are looking for the changelog of `1.4`, please go [here](https://github.com/karafka/testing/blob/1.4/CHANGELOG.md).

data/Gemfile.lock

@@ -1,42 +1,36 @@
 PATH
   remote: .
   specs:
-    karafka-testing (1.4.2)
-      karafka (~> 1.4.0)
+    karafka-testing (2.0.0.alpha2)
+      karafka (~> 2.0.alpha2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    concurrent-ruby (1.1.8)
-    delivery_boy (1.1.0)
-      king_konf (~> 1.0)
-      ruby-kafka (~> 1.0)
-    digest-crc (0.6.3)
-      rake (>= 12.0.0, < 14.0.0)
-    dry-configurable (0.12.1)
+    concurrent-ruby (1.1.9)
+    dry-configurable (0.14.0)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 0.5, >= 0.5.0)
-    dry-container (0.7.2)
+      dry-core (~> 0.6)
+    dry-container (0.9.0)
       concurrent-ruby (~> 1.0)
-      dry-configurable (~> 0.1, >= 0.1.3)
-    dry-core (0.5.0)
+      dry-configurable (~> 0.13, >= 0.13.0)
+    dry-core (0.7.1)
       concurrent-ruby (~> 1.0)
-    dry-equalizer (0.3.0)
     dry-events (0.3.0)
       concurrent-ruby (~> 1.0)
       dry-core (~> 0.5, >= 0.5)
-    dry-inflector (0.2.0)
-    dry-initializer (3.0.4)
-    dry-logic (1.1.1)
+    dry-inflector (0.2.1)
+    dry-initializer (3.1.1)
+    dry-logic (1.2.0)
       concurrent-ruby (~> 1.0)
       dry-core (~> 0.5, >= 0.5)
-    dry-monitor (0.4.0)
-      dry-configurable (~> 0.5)
+    dry-monitor (0.5.0)
+      dry-configurable (~> 0.13, >= 0.13.0)
       dry-core (~> 0.5, >= 0.5)
       dry-events (~> 0.2)
-    dry-schema (1.6.2)
+    dry-schema (1.9.1)
       concurrent-ruby (~> 1.0)
-      dry-configurable (~> 0.8, >= 0.8.3)
+      dry-configurable (~> 0.13, >= 0.13.0)
       dry-core (~> 0.5, >= 0.5)
       dry-initializer (~> 3.0)
       dry-logic (~> 1.0)
@@ -47,50 +41,43 @@ GEM
       dry-core (~> 0.5, >= 0.5)
       dry-inflector (~> 0.1, >= 0.1.2)
       dry-logic (~> 1.0, >= 1.0.2)
-    dry-validation (1.6.0)
+    dry-validation (1.8.0)
       concurrent-ruby (~> 1.0)
       dry-container (~> 0.7, >= 0.7.1)
-      dry-core (~> 0.4)
-      dry-equalizer (~> 0.2)
+      dry-core (~> 0.5, >= 0.5)
       dry-initializer (~> 3.0)
-      dry-schema (~> 1.5, >= 1.5.2)
-    envlogic (1.1.3)
-      dry-inflector (~> 0.1)
-    io-console (0.5.9)
-    irb (1.3.5)
-      reline (>= 0.1.5)
-    karafka (1.4.4)
-      dry-configurable (~> 0.8)
-      dry-inflector (~> 0.1)
-      dry-monitor (~> 0.3)
-      dry-validation (~> 1.2)
-      envlogic (~> 1.1)
-      irb (~> 1.0)
-      ruby-kafka (>= 1.0.0)
+      dry-schema (~> 1.9, >= 1.9.1)
+    ffi (1.15.5)
+    karafka (2.0.0.alpha2)
+      dry-configurable (~> 0.13)
+      dry-monitor (~> 0.5)
+      dry-validation (~> 1.7)
+      rdkafka (>= 0.10)
       thor (>= 0.20)
-      waterdrop (~> 1.4.0)
-      zeitwerk (~> 2.1)
-    king_konf (1.0.0)
-    rake (13.0.3)
-    reline (0.2.5)
-      io-console (~> 0.5)
-    ruby-kafka (1.3.0)
-      digest-crc
-    thor (1.1.0)
-    waterdrop (1.4.2)
-      delivery_boy (>= 0.2, < 2.x)
-      dry-configurable (~> 0.8)
-      dry-monitor (~> 0.3)
-      dry-validation (~> 1.2)
-      ruby-kafka (>= 0.7.8)
-      zeitwerk (~> 2.1)
-    zeitwerk (2.4.2)
+      waterdrop (>= 2.2.0, < 3.0.0)
+      zeitwerk (~> 2.3)
+    mini_portile2 (2.7.1)
+    rake (13.0.6)
+    rdkafka (0.11.1)
+      ffi (~> 1.15)
+      mini_portile2 (~> 2.6)
+      rake (> 12)
+    thor (1.2.1)
+    waterdrop (2.2.0)
+      concurrent-ruby (>= 1.1)
+      dry-configurable (~> 0.13)
+      dry-monitor (~> 0.5)
+      dry-validation (~> 1.7)
+      rdkafka (>= 0.10)
+      zeitwerk (~> 2.3)
+    zeitwerk (2.5.4)
 
 PLATFORMS
+  x86_64-darwin
   x86_64-linux
 
 DEPENDENCIES
   karafka-testing!
 
 BUNDLED WITH
-   2.2.16
+   2.3.6

data/README.md

@@ -1,10 +1,14 @@
 # Karafka Testing library
 
+**Note**: Documentation presented below works with Karafka `2.0.0.alpha1` and higher.
+
+Please refer to [this](https://github.com/karafka/testing/tree/1.4) branch and its documentation for details about usage with Karafka `1.4`.
+
 [![Build Status](https://github.com/karafka/testing/workflows/ci/badge.svg)](https://github.com/karafka/testing/actions?query=workflow%3Aci)
 [![Gem Version](https://badge.fury.io/rb/karafka-testing.svg)](http://badge.fury.io/rb/karafka-testing)
-[![Join the chat at https://gitter.im/karafka/karafka](https://badges.gitter.im/karafka/karafka.svg)](https://gitter.im/karafka/karafka)
+[![Join the chat at https://slack.karafka.io](https://raw.githubusercontent.com/karafka/misc/master/slack.svg)](https://slack.karafka.io)
 
-Karafka-Testing is a library that provides rspec helpers, to make testing of Karafka consumers much easier.
+Karafka-Testing is a library that provides RSpec helpers, to make testing of Karafka consumers much easier.
 
 ## Installation
 
@@ -28,18 +32,17 @@ end
 
 ## Usage
 
-Once included into your RSpec setup, this library will provide you two methods that you can use with your specs:
-
-- `#karafka_consumer_for` - this method will create a consumer instance for the desired topic. It **needs** to be set as the spec subject.
-- `#publish_for_karafka` - this method will "send" message to the consumer instance.
+Once included into your RSpec setup, this library will provide you with a special object `#karafka` that includes two methods that you can use with your specs:
 
+- `#consumer_for` - creates a consumer instance for the desired topic. It **needs** to be set as the spec subject.
+- `#publish` - "sends" message to the consumer instance.
 
-**Note:** Messages sent using the `#publish_for_karafka` method won't be sent to Kafka. They will be "virtually" delegated to the created consumer instance so your specs can run without Kafka setup.
+**Note:** Messages sent using the `#publish` method won't be sent to Kafka. They will be "virtually" delegated to the created consumer instance so your specs can run without Kafka setup.
 
 ```ruby
 RSpec.describe InlineBatchConsumer do
   # This will create a consumer instance with all the settings defined for the given topic
-  subject(:consumer) { karafka_consumer_for(:inline_batch_data) }
+  subject(:consumer) { karafka.consumer_for(:inline_batch_data) }
 
   let(:nr1_value) { rand }
   let(:nr2_value) { rand }
@@ -47,9 +50,9 @@ RSpec.describe InlineBatchConsumer do
 
   before do
     # Sends first message to Karafka consumer
-    publish_for_karafka({ 'number' => nr1_value }.to_json)
+    karafka.publish({ 'number' => nr1_value }.to_json)
     # Sends second message to Karafka consumer
-    publish_for_karafka({ 'number' => nr2_value }.to_json)
+    karafka.publish({ 'number' => nr2_value }.to_json, partition: 2)
     allow(Karafka.logger).to receive(:info)
   end
 
@@ -60,18 +63,10 @@ RSpec.describe InlineBatchConsumer do
 end
 ```
 
-## References
-
-* [Karafka framework](https://github.com/karafka/karafka)
-* [Karafka Testing Actions CI](https://github.com/karafka/testing/actions?query=workflow%3Aci)
-* [Karafka Testing Coditsu](https://app.coditsu.io/karafka/repositories/testing)
-
 ## Note on contributions
 
-First, thank you for considering contributing to Karafka Testing! It's people like you that make the open source community such a great community!
-
-Each pull request must pass all the RSpec specs and meet our quality requirements.
+First, thank you for considering contributing to the Karafka ecosystem! It's people like you that make the open source community such a great community!
 
-To check if everything is as it should be, we use [Coditsu](https://coditsu.io) that combines multiple linters and code analyzers for both code and documentation. Once you're done with your changes, submit a pull request.
+Each pull request must pass all the RSpec specs, integration tests and meet our quality requirements.
 
-Coditsu will automatically check your work against our quality standards. You can find your commit check results on the [builds page](https://app.coditsu.io/karafka/repositories/testing/builds/commit_builds) of the Karafka Testing repository.
+Fork it, update and wait for the Github Actions results.

data/certs/mensfeld.pem

@@ -1,25 +1,25 @@
 -----BEGIN CERTIFICATE-----
 MIIEODCCAqCgAwIBAgIBATANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhtYWNp
-ZWovREM9bWVuc2ZlbGQvREM9cGwwHhcNMjAwODExMDkxNTM3WhcNMjEwODExMDkx
-NTM3WjAjMSEwHwYDVQQDDBhtYWNpZWovREM9bWVuc2ZlbGQvREM9cGwwggGiMA0G
-CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQDCpXsCgmINb6lHBXXBdyrgsBPSxC4/
-2H+weJ6L9CruTiv2+2/ZkQGtnLcDgrD14rdLIHK7t0o3EKYlDT5GhD/XUVhI15JE
-N7IqnPUgexe1fbZArwQ51afxz2AmPQN2BkB2oeQHXxnSWUGMhvcEZpfbxCCJH26w
-hS0Ccsma8yxA6hSlGVhFVDuCr7c2L1di6cK2CtIDpfDaWqnVNJEwBYHIxrCoWK5g
-sIGekVt/admS9gRhIMaIBg+Mshth5/DEyWO2QjteTodItlxfTctrfmiAl8X8T5JP
-VXeLp5SSOJ5JXE80nShMJp3RFnGw5fqjX/ffjtISYh78/By4xF3a25HdWH9+qO2Z
-tx0wSGc9/4gqNM0APQnjN/4YXrGZ4IeSjtE+OrrX07l0TiyikzSLFOkZCAp8oBJi
-Fhlosz8xQDJf7mhNxOaZziqASzp/hJTU/tuDKl5+ql2icnMv5iV/i6SlmvU29QNg
-LCV71pUv0pWzN+OZbHZKWepGhEQ3cG9MwvkCAwEAAaN3MHUwCQYDVR0TBAIwADAL
-BgNVHQ8EBAMCBLAwHQYDVR0OBBYEFImGed2AXS070ohfRidiCEhXEUN+MB0GA1Ud
+ZWovREM9bWVuc2ZlbGQvREM9cGwwHhcNMjEwODExMTQxNTEzWhcNMjIwODExMTQx
+NTEzWjAjMSEwHwYDVQQDDBhtYWNpZWovREM9bWVuc2ZlbGQvREM9cGwwggGiMA0G
+CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQDV2jKH4Ti87GM6nyT6D+ESzTI0MZDj
+ak2/TEwnxvijMJyCCPKT/qIkbW4/f0VHM4rhPr1nW73sb5SZBVFCLlJcOSKOBdUY
+TMY+SIXN2EtUaZuhAOe8LxtxjHTgRHvHcqUQMBENXTISNzCo32LnUxweu66ia4Pd
+1mNRhzOqNv9YiBZvtBf7IMQ+sYdOCjboq2dlsWmJiwiDpY9lQBTnWORnT3mQxU5x
+vPSwnLB854cHdCS8fQo4DjeJBRZHhEbcE5sqhEMB3RZA3EtFVEXOxlNxVTS3tncI
+qyNXiWDaxcipaens4ObSY1C2HTV7OWb7OMqSCIybeYTSfkaSdqmcl4S6zxXkjH1J
+tnjayAVzD+QVXGijsPLE2PFnJAh9iDET2cMsjabO1f6l1OQNyAtqpcyQcgfnyW0z
+g7tGxTYD+6wJHffM9d9txOUw6djkF6bDxyqB8lo4Z3IObCx18AZjI9XPS9QG7w6q
+LCWuMG2lkCcRgASqaVk9fEf9yMc2xxz5o3kCAwEAAaN3MHUwCQYDVR0TBAIwADAL
+BgNVHQ8EBAMCBLAwHQYDVR0OBBYEFBqUFCKCOe5IuueUVqOB991jyCLLMB0GA1Ud
 EQQWMBSBEm1hY2llakBtZW5zZmVsZC5wbDAdBgNVHRIEFjAUgRJtYWNpZWpAbWVu
-c2ZlbGQucGwwDQYJKoZIhvcNAQELBQADggGBAKiHpwoENVrMi94V1zD4o8/6G3AU
-gWz4udkPYHTZLUy3dLznc/sNjdkJFWT3E6NKYq7c60EpJ0m0vAEg5+F5pmNOsvD3
-2pXLj9kisEeYhR516HwXAvtngboUcb75skqvBCU++4Pu7BRAPjO1/ihLSBexbwSS
-fF+J5OWNuyHHCQp+kGPLtXJe2yUYyvSWDj3I2//Vk0VhNOIlaCS1+5/P3ZJThOtm
-zJUBI7h3HgovwRpcnmk2mXTmU4Zx/bCzX8EA6VY0khEvnmiq7S6eBF0H9qH8KyQ6
-EkVLpvmUDFcf/uNaBQdazEMB5jYtwoA8gQlANETNGPi51KlkukhKgaIEDMkBDJOx
-65N7DzmkcyY0/GwjIVIxmRhcrCt1YeCUElmfFx0iida1/YRm6sB2AXqScc1+ECRi
-2DND//YJUikn1zwbz1kT70XmHd97B4Eytpln7K+M1u2g1pHVEPW4owD/ammXNpUy
-nt70FcDD4yxJQ+0YNiHd0N8IcVBM1TMIVctMNQ==
+c2ZlbGQucGwwDQYJKoZIhvcNAQELBQADggGBADD0/UuTTFgW+CGk2U0RDw2RBOca
+W2LTF/G7AOzuzD0Tc4voc7WXyrgKwJREv8rgBimLnNlgmFJLmtUCh2U/MgxvcilH
+yshYcbseNvjkrtYnLRlWZR4SSB6Zei5AlyGVQLPkvdsBpNegcG6w075YEwzX/38a
+8V9B/Yri2OGELBz8ykl7BsXUgNoUPA/4pHF6YRLz+VirOaUIQ4JfY7xGj6fSOWWz
+/rQ/d77r6o1mfJYM/3BRVg73a3b7DmRnE5qjwmSaSQ7u802pJnLesmArch0xGCT/
+fMmRli1Qb+6qOTl9mzD6UDMAyFR4t6MStLm0mIEqM0nBO5nUdUWbC7l9qXEf8XBE
+2DP28p3EqSuS+lKbAWKcqv7t0iRhhmaod+Yn9mcrLN1sa3q3KSQ9BCyxezCD4Mk2
+R2P11bWoCtr70BsccVrN8jEhzwXngMyI2gVt750Y+dbTu1KgRqZKp/ECe7ZzPzXj
+pIy9vHxTANKYVyI4qj8OrFdEM5BQNu8oQpL0iQ==
 -----END CERTIFICATE-----

data/karafka-testing.gemspec

@@ -13,18 +13,23 @@ Gem::Specification.new do |spec|
   spec.email         = %w[maciej@mensfeld.pl]
   spec.summary       = 'Library which provides helpers for easier Karafka consumers tests'
   spec.description   = 'Library which provides helpers for easier Karafka consumers tests'
-  spec.homepage      = 'https://github.com/karafka/testing'
+  spec.homepage      = 'https://karafka.io'
   spec.license       = 'MIT'
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(spec)/}) }
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.require_paths = %w[lib]
   spec.cert_chain    = %w[certs/mensfeld.pem]
 
-  spec.required_ruby_version = '>= 2.6.0'
+  spec.required_ruby_version = '>= 2.7'
 
   if $PROGRAM_NAME.end_with?('gem')
     spec.signing_key = File.expand_path('~/.ssh/gem-private_key.pem')
   end
 
-  spec.add_dependency 'karafka', '~> 1.4.0'
+  spec.add_dependency 'karafka', '~> 2.0.alpha2'
+
+  spec.metadata = {
+    'source_code_uri' => 'https://github.com/karafka/karafka',
+    'rubygems_mfa_required' => 'true'
+  }
 end

data/lib/karafka/testing/dummy_client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Karafka
+  module Testing
+    # A dummy client that takes over client delegated methods from the consumers
+    # For specs we do not mark anything as consumed, nor do we really send heartbeats.
+    # Those things are tested in the framework itself
+    class DummyClient
+      %i[
+        mark_as_consumed
+        mark_as_consumed!
+      ].each do |caught_delegator|
+        define_method(caught_delegator) { |*| }
+      end
+    end
+  end
+end

data/lib/karafka/testing/rspec/helpers.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require 'karafka/testing/errors'
+require 'karafka/testing/dummy_client'
+require 'karafka/testing/rspec/proxy'
 
 module Karafka
   module Testing
@@ -15,14 +17,15 @@ module Karafka
           def included(base)
             # This is an internal buffer for keeping "to be sent" messages before
             # we run the consume
-            base.let(:_karafka_raw_data) { [] }
-            # Clear the messages buffer after each spec, so nothing will leak
-            # in between them
-            base.after { _karafka_raw_data.clear }
+            base.let(:_karafka_messages) { [] }
+            base.let(:karafka) { Karafka::Testing::RSpec::Proxy.new(self) }
+            # Clear the messages buffer after each spec, so nothing leaks in between them
+            base.after { _karafka_messages.clear }
           end
         end
 
-        # Creates a consumer instance for given topic
+        # Creates a consumer instance for a given topic
+        #
         # @param requested_topic [String, Symbol] name of the topic for which we want to
         #   create a consumer instance
         # @return [Object] described_class instance
@@ -31,12 +34,12 @@ module Karafka
         #
         # @example Creates a MyConsumer consumer instance with settings for `my_requested_topic`
         #   RSpec.describe MyConsumer do
-        #     subject(:consumer) { karafka_consumer_for(:my_requested_topic) }
+        #     subject(:consumer) { karafka.consumer_for(:my_requested_topic) }
         #   end
         def karafka_consumer_for(requested_topic)
           selected_topic = nil
 
-          # @note Remove in 2.0. This won't work without the global state
+          # @note Remove in 2.1. This won't work without the global state
           ::Karafka::App.consumer_groups.each do |consumer_group|
             consumer_group.topics.each do |topic|
               selected_topic = topic if topic.name == requested_topic.to_s
@@ -45,47 +48,59 @@ module Karafka
 
           raise Karafka::Testing::Errors::TopicNotFoundError, requested_topic unless selected_topic
 
-          described_class.new(selected_topic)
+          consumer = described_class.new
+          consumer.topic = selected_topic
+          consumer.client = Karafka::Testing::DummyClient.new
+          consumer
         end
 
-        # Adds a new Karafka params instance with given payload and options into an internal
+        # Adds a new Karafka message instance with given payload and options into an internal
         # buffer that will be used to simulate messages delivery to the consumer
         #
-        # @param raw_payload [String] anything you want to send
+        # @param payload [String] anything you want to send
         # @param opts [Hash] additional options with which you want to overwrite the
         #   message defaults (key, offset, etc)
         #
         # @example Send a json message to consumer
         #   before do
-        #     publish_for_karafka({ 'hello' => 'world' }.to_json)
+        #     karafka.publish({ 'hello' => 'world' }.to_json)
         #   end
         #
         # @example Send a json message to consumer and simulate, that it is partition 6
         #   before do
-        #     publish_for_karafka({ 'hello' => 'world' }.to_json, 'partition' => 6)
+        #     karafka.publish({ 'hello' => 'world' }.to_json, 'partition' => 6)
         #   end
-        def publish_for_karafka(raw_payload, opts = {})
-          metadata = Karafka::Params::Metadata.new(
-            **metadata_defaults.merge(opts)
+        def karafka_publish(payload, opts = {})
+          metadata = Karafka::Messages::Metadata.new(
+            **karafka_message_metadata_defaults.merge(opts)
           ).freeze
 
-          _karafka_raw_data << Karafka::Params::Params.new(raw_payload, metadata)
-          subject.params_batch = Karafka::Params::ParamsBatch.new(_karafka_raw_data)
+          # Add this message to previously published messages
+          _karafka_messages << Karafka::Messages::Message.new(payload, metadata)
+
+          # Update batch metadata
+          batch_metadata = Karafka::Messages::Builders::BatchMetadata.call(
+            _karafka_messages,
+            subject.topic,
+            Time.now
+          )
+
+          # Update consumer messages batch
+          subject.messages = Karafka::Messages::Messages.new(_karafka_messages, batch_metadata)
         end
 
         private
 
         # @return [Hash] message default options
-        def metadata_defaults
+        def karafka_message_metadata_defaults
           {
             deserializer: subject.topic.deserializer,
-            create_time: Time.now,
+            timestamp: Time.now,
             headers: {},
-            is_control_record: false,
             key: nil,
-            offset: 0,
+            offset: _karafka_messages.size,
             partition: 0,
-            receive_time: Time.now,
+            received_at: Time.now,
             topic: subject.topic.name
           }
         end

data/lib/karafka/testing/rspec/proxy.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Karafka
+  module Testing
+    module RSpec
+      # Proxy object for a nicer `karafka.` API within RSpec
+      class Proxy
+        # @param rspec_example [RSpec::ExampleGroups] rspec context
+        def initialize(rspec_example)
+          @rspec_example = rspec_example
+        end
+
+        # @param args Anything that the `#karafka_consumer_for` accepts
+        def consumer_for(*args)
+          @rspec_example.karafka_consumer_for(*args)
+        end
+
+        # @param args Anything that the `#karafka_publish` accepts
+        def publish(*args)
+          @rspec_example.karafka_publish(*args)
+        end
+      end
+    end
+  end
+end

data/lib/karafka/testing/version.rb

@@ -4,6 +4,6 @@
 module Karafka
   module Testing
     # Current version of gem. It should match Karafka framework version
-    VERSION = '1.4.2'
+    VERSION = '2.0.0.alpha2'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: karafka-testing
 version: !ruby/object:Gem::Version
-  version: 1.4.2
+  version: 2.0.0.alpha2
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -11,30 +11,30 @@ cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
   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
-  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
+  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
-  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
-  nt70FcDD4yxJQ+0YNiHd0N8IcVBM1TMIVctMNQ==
+  c2ZlbGQucGwwDQYJKoZIhvcNAQELBQADggGBADD0/UuTTFgW+CGk2U0RDw2RBOca
+  W2LTF/G7AOzuzD0Tc4voc7WXyrgKwJREv8rgBimLnNlgmFJLmtUCh2U/MgxvcilH
+  yshYcbseNvjkrtYnLRlWZR4SSB6Zei5AlyGVQLPkvdsBpNegcG6w075YEwzX/38a
+  8V9B/Yri2OGELBz8ykl7BsXUgNoUPA/4pHF6YRLz+VirOaUIQ4JfY7xGj6fSOWWz
+  /rQ/d77r6o1mfJYM/3BRVg73a3b7DmRnE5qjwmSaSQ7u802pJnLesmArch0xGCT/
+  fMmRli1Qb+6qOTl9mzD6UDMAyFR4t6MStLm0mIEqM0nBO5nUdUWbC7l9qXEf8XBE
+  2DP28p3EqSuS+lKbAWKcqv7t0iRhhmaod+Yn9mcrLN1sa3q3KSQ9BCyxezCD4Mk2
+  R2P11bWoCtr70BsccVrN8jEhzwXngMyI2gVt750Y+dbTu1KgRqZKp/ECe7ZzPzXj
+  pIy9vHxTANKYVyI4qj8OrFdEM5BQNu8oQpL0iQ==
   -----END CERTIFICATE-----
-date: 2021-04-21 00:00:00.000000000 Z
+date: 2022-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: karafka
@@ -42,14 +42,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 2.0.alpha2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 2.0.alpha2
 description: Library which provides helpers for easier Karafka consumers tests
 email:
 - maciej@mensfeld.pl
@@ -59,12 +59,12 @@ extra_rdoc_files: []
 files:
 - ".coditsu/ci.yml"
 - ".diffend.yml"
-- ".github/FUNDING.yml"
 - ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
 - ".ruby-gemset"
 - ".ruby-version"
+- 2.0-Upgrade.md
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
@@ -74,13 +74,17 @@ files:
 - karafka-testing.gemspec
 - lib/karafka-testing.rb
 - lib/karafka/testing.rb
+- lib/karafka/testing/dummy_client.rb
 - lib/karafka/testing/errors.rb
 - lib/karafka/testing/rspec/helpers.rb
+- lib/karafka/testing/rspec/proxy.rb
 - lib/karafka/testing/version.rb
-homepage: https://github.com/karafka/testing
+homepage: https://karafka.io
 licenses:
 - MIT
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/karafka/karafka
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -89,14 +93,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.3.3
 signing_key: 
 specification_version: 4
 summary: Library which provides helpers for easier Karafka consumers tests

data/.github/FUNDING.yml

@@ -1 +0,0 @@
-open_collective: karafka