karafka-testing 1.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d62320a4a1e6b7caeb25308b9ea810d7948a887cad788b5779e31320a522f52d
+  data.tar.gz: d68f15b96e0ba30d9ebbefce725cf5069842c2f05d6f21c2e22eafa7cea13125
+SHA512:
+  metadata.gz: 3a7bfbbac01df4b3839b959c6af809fd3f3f563893b991d4c62fbf4205c9bbf1a314c8d209536e95b33d5bf1031dce41b70d4f1da33bc19172f8736d36a0b063
+  data.tar.gz: e755c0bbdad3694d2cff2234db2710e16c1ea98785c563cbb3aaf9b219613366ccbd5636c5ecbc11fdf25b96b708729eb97510994895d28722335b4e35a07daf

checksums.yaml.gz.sig

@@ -0,0 +1,2 @@
+#�r�R
+b!��0�u���.�7I��5�#h밵�~Zp�Q{b*t+	��ycV���q-�}����yń$ө����V	x��
���[v�?����1]��k��q�

data/.coditsu/ci.yml

@@ -0,0 +1,3 @@
+repository_id: '4e6326c4-68ac-450e-bf4b-7c9de95f1eee'
+api_key: <%= ENV['CODITSU_API_KEY'] %>
+api_secret: <%= ENV['CODITSU_API_SECRET'] %>

data/.github/FUNDING.yml

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

data/.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: ci
+
+on:
+  push:
+  schedule:
+    - cron:  '0 1 * * *'
+
+jobs:
+  coditsu:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Run Coditsu
+        run: \curl -sSL https://api.coditsu.io/run/ci | bash

data/.gitignore

@@ -0,0 +1,51 @@
+# Created by .ignore support plugin (hsz.mobi)
+.idea
+
+### SublimeText template
+# cache files for sublime text
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+
+# workspace files are user-specific
+*.sublime-workspace
+
+# project files should be checked into the repository, unless a significant
+# proportion of contributors will probably not be using SublimeText
+# *.sublime-project
+
+# sftp configuration file
+sftp-config.json
+
+
+### Ruby template
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/app/lib/bundler/man/
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+.coditsu/local.yml

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.ruby-gemset

@@ -0,0 +1 @@
+karafka-testing

data/.ruby-version

@@ -0,0 +1 @@
+2.7.1

data/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Karafka Test gem changelog
+
+## 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

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,104 @@
+PATH
+  remote: .
+  specs:
+    karafka-testing (1.3.1)
+      karafka (~> 1.3.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    concurrent-ruby (1.1.6)
+    delivery_boy (1.0.1)
+      king_konf (~> 0.3)
+      ruby-kafka (~> 1.0)
+    digest-crc (0.5.1)
+    dry-configurable (0.11.5)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 0.4, >= 0.4.7)
+      dry-equalizer (~> 0.2)
+    dry-container (0.7.2)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 0.1, >= 0.1.3)
+    dry-core (0.4.9)
+      concurrent-ruby (~> 1.0)
+    dry-equalizer (0.3.0)
+    dry-events (0.2.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 0.4)
+      dry-equalizer (~> 0.2)
+    dry-inflector (0.2.0)
+    dry-initializer (3.0.3)
+    dry-logic (1.0.6)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 0.2)
+      dry-equalizer (~> 0.2)
+    dry-monitor (0.3.2)
+      dry-configurable (~> 0.5)
+      dry-core (~> 0.4)
+      dry-equalizer (~> 0.2)
+      dry-events (~> 0.2)
+    dry-schema (1.5.0)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 0.8, >= 0.8.3)
+      dry-core (~> 0.4)
+      dry-equalizer (~> 0.2)
+      dry-initializer (~> 3.0)
+      dry-logic (~> 1.0)
+      dry-types (~> 1.4)
+    dry-types (1.4.0)
+      concurrent-ruby (~> 1.0)
+      dry-container (~> 0.3)
+      dry-core (~> 0.4, >= 0.4.4)
+      dry-equalizer (~> 0.3)
+      dry-inflector (~> 0.1, >= 0.1.2)
+      dry-logic (~> 1.0, >= 1.0.2)
+    dry-validation (1.5.0)
+      concurrent-ruby (~> 1.0)
+      dry-container (~> 0.7, >= 0.7.1)
+      dry-core (~> 0.4)
+      dry-equalizer (~> 0.2)
+      dry-initializer (~> 3.0)
+      dry-schema (~> 1.5)
+    envlogic (1.1.2)
+      dry-inflector (~> 0.1)
+    io-console (0.5.6)
+    irb (1.2.3)
+      reline (>= 0.0.1)
+    karafka (1.3.5)
+      dry-configurable (~> 0.8)
+      dry-inflector (~> 0.1)
+      dry-monitor (~> 0.3)
+      dry-validation (~> 1.2)
+      envlogic (~> 1.1)
+      irb (~> 1.0)
+      multi_json (>= 1.12)
+      rake (>= 11.3)
+      ruby-kafka (>= 0.7.8)
+      thor (>= 0.20)
+      waterdrop (~> 1.3.0)
+      zeitwerk (~> 2.1)
+    king_konf (0.3.7)
+    multi_json (1.14.1)
+    rake (13.0.1)
+    reline (0.1.3)
+      io-console (~> 0.5)
+    ruby-kafka (1.0.0)
+      digest-crc
+    thor (1.0.1)
+    waterdrop (1.3.4)
+      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.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  karafka-testing!
+
+BUNDLED WITH
+   2.1.4

data/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README.md

@@ -0,0 +1,78 @@
+# Karafka Testing library
+
+[![Build Status](https://github.com/karafka/testing/workflows/ci/badge.svg)](https://github.com/karafka/testing/actions?query=workflow%3Aci)
+[![Join the chat at https://gitter.im/karafka/karafka](https://badges.gitter.im/karafka/karafka.svg)](https://gitter.im/karafka/karafka?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+Karafka-Testing is a library that provides rspec helpers, to make testing of Karafka consumers much easier.
+
+## Installation
+
+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 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.
+
+
+**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.
+
+```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
+    publish_for_karafka({ 'number' => nr1_value }.to_json)
+    # Sends second message to Karafka consumer
+    publish_for_karafka({ 'number' => nr2_value }.to_json)
+    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
+```
+
+## 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.
+
+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.
+
+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/test/builds/commit_builds) of the Karafka Testing repository.
+
+[![coditsu](https://coditsu.io/assets/quality_bar.svg)](https://app.coditsu.io/karafka/repositories/testing/builds/commit_builds)

data/certs/mensfeld.pem

@@ -0,0 +1,25 @@
+-----BEGIN CERTIFICATE-----
+MIIEODCCAqCgAwIBAgIBATANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhtYWNp
+ZWovREM9bWVuc2ZlbGQvREM9cGwwHhcNMTkwNzMwMTQ1NDU0WhcNMjAwNzI5MTQ1
+NDU0WjAjMSEwHwYDVQQDDBhtYWNpZWovREM9bWVuc2ZlbGQvREM9cGwwggGiMA0G
+CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQC9fCwtaHZG2SyyNXiH8r0QbJQx/xxl
+dkvwWz9QGJO+O8rEx20FB1Ab+MVkfOscwIv5jWpmk1U9whzDPl1uFtIbgu+sk+Zb
+uQlZyK/DPN6c+/BbBL+RryTBRyvkPLoCVwm7uxc/JZ1n4AI6eF4cCZ2ieZ9QgQbU
+MQs2QPqs9hT50Ez/40GnOdadVfiDDGz+NME2C4ms0BriXwZ1tcRTfJIHe2xjIbbb
+y5qRGfsLKcgMzvLQR24olixyX1MR0s4+Wveq3QL/gBhL4veUcv+UABJA8IJR0kyB
+seHHutusiwZ1v3SjjjW1xLLrc2ARV0mgCb0WaK2T4iA3oFTGLh6Ydz8LNl31KQFv
+94nRd8IhmJxrhQ6dQ/WT9IXoa5S9lfT5lPJeINemH4/6QPABzf9W2IZlCdI9wCdB
+TBaw57MKneGAYZiKjw6OALSy2ltQUCl3RqFl3VP7n8uFy1U987Q5VIIQ3O1UUsQD
+Oe/h+r7GUU4RSPKgPlrwvW9bD/UQ+zF51v8CAwEAAaN3MHUwCQYDVR0TBAIwADAL
+BgNVHQ8EBAMCBLAwHQYDVR0OBBYEFJNIBHdfEUD7TqHqIer2YhWaWhwcMB0GA1Ud
+EQQWMBSBEm1hY2llakBtZW5zZmVsZC5wbDAdBgNVHRIEFjAUgRJtYWNpZWpAbWVu
+c2ZlbGQucGwwDQYJKoZIhvcNAQELBQADggGBAKA4eqko6BTNhlysip6rfBkVTGri
+ZXsL+kRb2hLvsQJS/kLyM21oMlu+LN0aPj3qEFR8mE/YeDD8rLAfruBRTltPNbR7
+xA5eE1gkxY5LfExUtK3b2wPqfmo7mZgfcsMwfYg/tUXw1WpBCnrhAJodpGH6SXmp
+A40qFUZst0vjiOoO+aTblIHPmMJXoZ3K42dTlNKlEiDKUWMRKSgpjjYGEYalFNWI
+hHfCz2r8L2t+dYdMZg1JGbEkq4ADGsAA8ioZIpJd7V4hI17u5TCdi7X5wh/0gN0E
+CgP+nLox3D+l2q0QuQEkayr+auFYkzTCkF+BmEk1D0Ru4mcf3F4CJvEmW4Pzbjqt
+i1tsCWPtJ4E/UUKnKaWKqGbjrjHJ0MuShYzHkodox5IOiCXIQg+1+YSzfXUV6WEK
+KJG/fhg1JV5vVDdVy6x+tv5SQ5ctU0feCsVfESi3rE3zRd+nvzE9HcZ5aXeL1UtJ
+nT5Xrioegu2w1jPyVEgyZgTZC5rvD0nNS5sFNQ==
+-----END CERTIFICATE-----

data/karafka-testing.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'karafka/testing/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'karafka-testing'
+  spec.platform      = Gem::Platform::RUBY
+  spec.version       = Karafka::Testing::VERSION
+  spec.authors       = ['Maciej Mensfeld']
+  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.license       = 'LGPL-3.0'
+  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.5.0'
+
+  if $PROGRAM_NAME.end_with?('gem')
+    spec.signing_key = File.expand_path('~/.ssh/gem-private_key.pem')
+  end
+
+  spec.add_dependency 'karafka', '~> 1.3.0'
+end

data/lib/karafka-testing.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'karafka/testing'

data/lib/karafka/testing.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# Main Karafka module
+module Karafka
+  # Testing lib module
+  module Testing
+  end
+end

data/lib/karafka/testing/errors.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Main module to encapsulate logic
+module Karafka
+  module Testing
+    # Errors that can be raised by this lib
+    module Errors
+      # Base error for all the internal errors
+      BaseError = Class.new(StandardError)
+      # Raised when we want to build a consumer for a topic that does not exist
+      TopicNotFoundError = Class.new(BaseError)
+    end
+  end
+end

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

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require 'karafka/testing/errors'
+
+module Karafka
+  module Testing
+    # All the things related to extra functionalities needed to easier spec out
+    # Karafka things using RSpec
+    module RSpec
+      # RSpec helpers module that needs to be included
+      module Helpers
+        class << self
+          # Adds all the needed extra functionalities to the rspec group
+          # @param base [Class] RSpec example group we want to extend
+          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 }
+          end
+        end
+
+        # Creates a consumer instance for 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
+        # @raise [Karafka::Testing::Errors::TopicNotFoundError] raised when we're unable to find
+        #   topic that was requested
+        #
+        # @example Creates a MyConsumer consumer instance with settings for `my_requested_topic`
+        #   RSpec.describe MyConsumer do
+        #     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
+          ::Karafka::App.consumer_groups.each do |consumer_group|
+            consumer_group.topics.each do |topic|
+              selected_topic = topic if topic.name == requested_topic.to_s
+            end
+          end
+
+          raise Karafka::Testing::Errors::TopicNotFoundError, requested_topic unless selected_topic
+
+          described_class.new(selected_topic)
+        end
+
+        # Adds a new Karafka params instance with given payload and options into an internal
+        # buffer that will be used to simulate messages delivery to the consumer
+        #
+        # @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)
+        #   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)
+        #   end
+        def publish_for_karafka(payload, opts = {})
+          _karafka_raw_data << Karafka::Params::Params
+                               .new
+                               .merge!(message_defaults)
+                               .merge!('payload' => payload)
+                               .merge!(opts)
+
+          subject.params_batch = Karafka::Params::ParamsBatch
+                                 .new(_karafka_raw_data)
+        end
+
+        private
+
+        # @return [Hash] message default options
+        def message_defaults
+          {
+            'deserializer' => subject.topic.deserializer,
+            'create_time' => Time.now,
+            'headers' => {},
+            'is_control_record' => false,
+            'key' => nil,
+            'offset' => 0,
+            'partition' => 0,
+            'receive_time' => Time.now,
+            'topic' => subject.topic.name
+          }
+        end
+      end
+    end
+  end
+end

data/lib/karafka/testing/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# Main module to encapsulate logic
+module Karafka
+  module Testing
+    # Current version of gem. It should match Karafka framework version
+    VERSION = '1.3.1'
+  end
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: karafka-testing
+version: !ruby/object:Gem::Version
+  version: 1.3.1
+platform: ruby
+authors:
+- Maciej Mensfeld
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEODCCAqCgAwIBAgIBATANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhtYWNp
+  ZWovREM9bWVuc2ZlbGQvREM9cGwwHhcNMTkwNzMwMTQ1NDU0WhcNMjAwNzI5MTQ1
+  NDU0WjAjMSEwHwYDVQQDDBhtYWNpZWovREM9bWVuc2ZlbGQvREM9cGwwggGiMA0G
+  CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQC9fCwtaHZG2SyyNXiH8r0QbJQx/xxl
+  dkvwWz9QGJO+O8rEx20FB1Ab+MVkfOscwIv5jWpmk1U9whzDPl1uFtIbgu+sk+Zb
+  uQlZyK/DPN6c+/BbBL+RryTBRyvkPLoCVwm7uxc/JZ1n4AI6eF4cCZ2ieZ9QgQbU
+  MQs2QPqs9hT50Ez/40GnOdadVfiDDGz+NME2C4ms0BriXwZ1tcRTfJIHe2xjIbbb
+  y5qRGfsLKcgMzvLQR24olixyX1MR0s4+Wveq3QL/gBhL4veUcv+UABJA8IJR0kyB
+  seHHutusiwZ1v3SjjjW1xLLrc2ARV0mgCb0WaK2T4iA3oFTGLh6Ydz8LNl31KQFv
+  94nRd8IhmJxrhQ6dQ/WT9IXoa5S9lfT5lPJeINemH4/6QPABzf9W2IZlCdI9wCdB
+  TBaw57MKneGAYZiKjw6OALSy2ltQUCl3RqFl3VP7n8uFy1U987Q5VIIQ3O1UUsQD
+  Oe/h+r7GUU4RSPKgPlrwvW9bD/UQ+zF51v8CAwEAAaN3MHUwCQYDVR0TBAIwADAL
+  BgNVHQ8EBAMCBLAwHQYDVR0OBBYEFJNIBHdfEUD7TqHqIer2YhWaWhwcMB0GA1Ud
+  EQQWMBSBEm1hY2llakBtZW5zZmVsZC5wbDAdBgNVHRIEFjAUgRJtYWNpZWpAbWVu
+  c2ZlbGQucGwwDQYJKoZIhvcNAQELBQADggGBAKA4eqko6BTNhlysip6rfBkVTGri
+  ZXsL+kRb2hLvsQJS/kLyM21oMlu+LN0aPj3qEFR8mE/YeDD8rLAfruBRTltPNbR7
+  xA5eE1gkxY5LfExUtK3b2wPqfmo7mZgfcsMwfYg/tUXw1WpBCnrhAJodpGH6SXmp
+  A40qFUZst0vjiOoO+aTblIHPmMJXoZ3K42dTlNKlEiDKUWMRKSgpjjYGEYalFNWI
+  hHfCz2r8L2t+dYdMZg1JGbEkq4ADGsAA8ioZIpJd7V4hI17u5TCdi7X5wh/0gN0E
+  CgP+nLox3D+l2q0QuQEkayr+auFYkzTCkF+BmEk1D0Ru4mcf3F4CJvEmW4Pzbjqt
+  i1tsCWPtJ4E/UUKnKaWKqGbjrjHJ0MuShYzHkodox5IOiCXIQg+1+YSzfXUV6WEK
+  KJG/fhg1JV5vVDdVy6x+tv5SQ5ctU0feCsVfESi3rE3zRd+nvzE9HcZ5aXeL1UtJ
+  nT5Xrioegu2w1jPyVEgyZgTZC5rvD0nNS5sFNQ==
+  -----END CERTIFICATE-----
+date: 2020-04-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: karafka
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+description: Library which provides helpers for easier Karafka consumers tests
+email:
+- maciej@mensfeld.pl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coditsu/ci.yml"
+- ".github/FUNDING.yml"
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- certs/mensfeld.pem
+- karafka-testing.gemspec
+- lib/karafka-testing.rb
+- lib/karafka/testing.rb
+- lib/karafka/testing/errors.rb
+- lib/karafka/testing/rspec/helpers.rb
+- lib/karafka/testing/version.rb
+homepage: https://github.com/karafka/testing
+licenses:
+- LGPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Library which provides helpers for easier Karafka consumers tests
+test_files: []