karafka-testing 2.0.3 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7a7e11e7f5ba273fc7875d3c20bd2b1457d46f315f168e933f1f48f82f6bbf6
-  data.tar.gz: 0ac2a1804d0b7e94cfd409763edd8ced61dd64fdde2219d9d42a375f9a21542a
+  metadata.gz: 560aa633f1c2710d530871e4194d0cb631540c2844a97207b05bfe7297dba13a
+  data.tar.gz: 6fb1dbb71bbb69f427356ee78b9ddc9fdeee83a9105564d7d9798ba6da3c6a70
 SHA512:
-  metadata.gz: 38d9372fcf299860d91efe18061ed219583a95fb1955a4817536a9fe4ae5ac6e9f86fc4e92c35c02a256cf9b9a1162f0a2cd54c17d6dd48b503f9a36c1d2be6c
-  data.tar.gz: fa0f0e8395e9fc00b155074a5e0059ad8dc4aecf0f9e93b0edaf6806574a873e17e183ad8bbede526237e3dcd321b378664252755d05d82204329c3351361861
+  metadata.gz: 0d0f3c2504f22eb9d3d36ba620b5e4f439c97d19b5607931a32a8bbbdf014a1cc772e0436d889e7536006c46b53239b248c44bfc230a0b69ae6d5c91b2e623ce
+  data.tar.gz: 67f249bfd323f1c5f27bc97f78e33701a5cf6d42715c11e0b146857bf90ef7f00f307e4d1cb9e186947390c9fdff2bf98453fcc9483192a4a491a026d420e2f2

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Karafka Test gem changelog
 
+## 2.0.4 (2022-10-14)
+- Align changes with Karafka `2.0.13` changes.
+
 ## 2.0.3 (2022-09-30)
 - Fix direct name reference `consumer` instead of `subject` (#97).
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    karafka-testing (2.0.3)
+    karafka-testing (2.0.4)
       karafka (>= 2.0, < 3.0.0)
 
 GEM
@@ -9,13 +9,13 @@ GEM
   specs:
     concurrent-ruby (1.1.10)
     ffi (1.15.5)
-    karafka (2.0.11)
+    karafka (2.0.13)
       karafka-core (>= 2.0.2, < 3.0.0)
       rdkafka (>= 0.12)
       thor (>= 0.20)
       waterdrop (>= 2.4.1, < 3.0.0)
       zeitwerk (~> 2.3)
-    karafka-core (2.0.2)
+    karafka-core (2.0.3)
       concurrent-ruby (>= 1.1)
     mini_portile2 (2.8.0)
     rake (13.0.6)
@@ -28,7 +28,7 @@ GEM
       karafka-core (>= 2.0.2, < 3.0.0)
       rdkafka (>= 0.10)
       zeitwerk (~> 2.3)
-    zeitwerk (2.6.0)
+    zeitwerk (2.6.1)
 
 PLATFORMS
   x86_64-linux

data/README.md

@@ -6,114 +6,9 @@
 
 Karafka-Testing is a library that provides RSpec helpers, to make testing of Karafka consumers and producer much easier.
 
-## Installation
+## Installation and usage
 
-Add this gem to your Gemfile in the `test` group:
-```ruby
-group :test do
-  gem 'karafka-testing'
-  gem 'rspec'
-end
-```
-
-and then in your `spec_helper.rb` file:
-
-```ruby
-require 'karafka/testing/rspec/helpers'
-
-RSpec.configure do |config|
-  config.include Karafka::Testing::RSpec::Helpers
-end
-```
-
-## Usage
-
-Once included in your RSpec setup, this library will provide you with a special `#karafka` object that contains three methods that you can use within your specs:
-
-- `#consumer_for` - creates a consumer instance for the desired topic. It **needs** to be set as the spec subject.
-- `#produce` - "sends" message to the consumer instance.
-- `#produced_messages` - contains all the messages "sent" to Kafka during spec execution.
-
-**Note:** Messages sent using the `#produce` method and directly from `Karafka.producer` won't be sent to Kafka. They will be buffered and accessible in a per-spec buffer in case you want to test messages production.
-
-Messages that target the topic built using the `karafka#consumer_for` method will additionally be delivered to the consumer you want to test.
-
-### Testing messages consumption (consumers)
-
-```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') }
-
-  let(:nr1_value) { rand }
-  let(:nr2_value) { rand }
-  let(:sum) { nr1_value + nr2_value }
-
-  before do
-    # Sends first message to Karafka consumer
-    karafka.produce({ 'number' => nr1_value }.to_json)
-
-    # Sends second message to Karafka consumer
-    karafka.produce({ '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
-```
-
-If your consumers use `producer` to dispatch messages, you can check its operations as well:
-
-```ruby
-RSpec.describe InlineBatchConsumer do
-  subject(:consumer) { karafka.consumer_for(:inline_batch_data) }
-
-  before { karafka.produce({ 'number' => 1 }.to_json) }
-
-  it 'expects to dispatch async message to messages topic with value bigger by 1' do
-    consumer.consume
-
-    expect(karafka.produced_messages.last.payload).to eq({ number: 2 }.to_json)
-  end
-end
-```
-
-### Testing messages production (producer)
-
-When running RSpec, Karafka will not dispatch messages to Kafka using `Karafka.producer` but will buffer them internally.
-
-This means you can check your application flow, making sure your logic acts as expected:
-
-```ruby
-# Example class in which there is a message production
-class UsersBuilder
-  def create(user_details)
-    user = ::User.create!(user_details)
-
-    Karafka.producer.produce_sync(
-      topic: 'users_changes',
-      payload: { user_id: user.id, type: 'user.created' },
-      key: user.id.to_s
-    )
-
-    user
-  end
-end
-
-RSpec.describe InlineBatchConsumer do
-  let(:created_user) { UsersBuilder.new.create(user_details) }
-
-  before { created_user }
-
-  it { expect(karafka.produced_messages.size).to eq(1) }
-  it { expect(karafka.produced_messages.first[:topic]).to eq('user.created') }
-  it { expect(karafka.produced_messages.first[:key]).to eq(created_user.id.to_s) }
-end
-```
+`karafka-testing` docs are part of Karafka framework docs. You can find the testing section [here](https://karafka.io/docs/Testing/).
 
 ## Note on contributions
 

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

@@ -163,6 +163,7 @@ module Karafka
           consumer.producer = Karafka::App.producer
           consumer.client = _karafka_consumer_client
           consumer.coordinator = coordinators.find_or_create(topic.name, 0)
+          consumer.coordinator.seek_offset = 0
           consumer
         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 = '2.0.3'
+    VERSION = '2.0.4'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: karafka-testing
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.0.4
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -35,7 +35,7 @@ cert_chain:
   Qf04B9ceLUaC4fPVEz10FyobjaFoY4i32xRto3XnrzeAgfEe4swLq8bQsR3w/EF3
   MGU0FeSV2Yj7Xc2x/7BzLK8xQn5l7Yy75iPF+KP3vVmDHnNl
   -----END CERTIFICATE-----
-date: 2022-09-30 00:00:00.000000000 Z
+date: 2022-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: karafka