karafka-sidekiq-backend 1.3.1 → 1.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17c9b70dae94209206085ae737ec81cac9ef56359729135525c652000c190fac
-  data.tar.gz: d7ac4a58f1fa843a9e87db4d28621e1c66f0b040b43ec3400172e2232131c626
+  metadata.gz: df894f5849e760cf4fc34d38606fed44f0fef045336fd316b5a67af6f949a264
+  data.tar.gz: d2f26478a4ce8ff38423faf55874ed6f5127ce2895dd8907fc0559f008f8564c
 SHA512:
-  metadata.gz: 02cddb92ffda427312796059c33673639de572036d3785035bc7a00ca6f6777b66091eba0ff78fd54f44fcdd64f5221bd8b16ebacc36e08ebde73b56aebf33fb
-  data.tar.gz: 12e11fb7cba09851d377d9de7bd2ea6ab90ea4b27500296a1213886748a4722df2a72a81dab4c58b4f50365df59f737d2ab314f5b2a1639c2740324f3ec921cc
+  metadata.gz: 8fe7c353bce5b28ab7abf84136d7a0550387627a036c4a9f90e8bd567441931c765f48781f282cc74a0f47f23df91c80b605f614bcfab917ccd2c002a8471cfa
+  data.tar.gz: 1d7764a08a7c407457762acb6c84110c5ef43cd3f630d7d89d284629cb76d2bf0bfef98bf3587020c3ce640b85428b27830bb86737569a29cf946d4211b848b9

data/.diffend.yml

@@ -0,0 +1,3 @@
+project_id: '0dab66ec-affc-405a-b994-4077d0b20140'
+shareable_id: '61e9572e-2947-4b2b-bdcb-0652853bfdb0'
+shareable_key: 'c9ea8a34-51de-4175-919f-d734bdc3c775'

data/.github/workflows/ci.yml

@@ -1,6 +1,7 @@
 name: ci
 
 on:
+  pull_request:
   push:
   schedule:
     - cron:  '0 1 * * *'
@@ -8,15 +9,17 @@ on:
 jobs:
   specs:
     runs-on: ubuntu-latest
+    needs: diffend
     strategy:
       fail-fast: false
       matrix:
         ruby:
+          - '3.0'
           - '2.7'
           - '2.6'
-          - '2.5'
+          - 'jruby-9.3.1.0'
         include:
-          - ruby: '2.7'
+          - ruby: '3.0'
             coverage: 'true'
     steps:
       - uses: actions/checkout@v2
@@ -36,6 +39,26 @@ jobs:
         env:
           GITHUB_COVERAGE: ${{matrix.coverage}}
         run: bundle exec rspec
+
+  diffend:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.0
+      - name: Install latest bundler
+        run: gem install bundler --no-document
+      - name: Install Diffend plugin
+        run: bundle plugin install diffend
+      - name: Bundle Secure
+        run: bundle secure
+
   coditsu:
     runs-on: ubuntu-latest
     strategy:

data/.ruby-version

@@ -1 +1 @@
-2.7.1
+3.0.3

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Karafka Sidekiq Backend
 
+## 1.4.3 (2021-12-05)
+- Source code metadata url added to the gemspec
+
+## 1.4.2 (2021-04-21)
+- Remove Ruby 2.5 support and update minimum Ruby requirement to 2.6
+
+## 1.4.1 (2020-27-10)
+- Corrected interchanger documentation (Jack12816)
+- Corrected the interchanger key reference (Jack12816)
+
+## 1.4.0 (2020-09-05)
+- Update to match Karafka 1.4.0 params and batch metadata setup
+
 ## 1.3.1 (2020-04-27)
 - Ruby 2.6.5 support
 - Ruby 2.7.1 support

data/Gemfile

@@ -2,6 +2,8 @@
 
 source 'https://rubygems.org'
 
+plugin 'diffend'
+
 gemspec
 
 group :test do

data/Gemfile.lock

@@ -1,131 +1,121 @@
 PATH
   remote: .
   specs:
-    karafka-sidekiq-backend (1.3.1)
-      karafka (~> 1.3.0)
+    karafka-sidekiq-backend (1.4.3)
+      karafka (~> 1.4.0)
       sidekiq (>= 4.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    concurrent-ruby (1.1.6)
-    connection_pool (2.2.2)
-    delivery_boy (1.0.1)
-      king_konf (~> 0.3)
+    concurrent-ruby (1.1.9)
+    connection_pool (2.2.5)
+    delivery_boy (1.1.0)
+      king_konf (~> 1.0)
       ruby-kafka (~> 1.0)
-    diff-lcs (1.3)
-    digest-crc (0.5.1)
-    docile (1.3.2)
-    dry-configurable (0.11.5)
+    diff-lcs (1.4.4)
+    digest-crc (0.6.4)
+      rake (>= 12.0.0, < 14.0.0)
+    docile (1.4.0)
+    dry-configurable (0.13.0)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 0.4, >= 0.4.7)
-      dry-equalizer (~> 0.2)
-    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.4.9)
+      dry-configurable (~> 0.13, >= 0.13.0)
+    dry-core (0.7.1)
       concurrent-ruby (~> 1.0)
-    dry-equalizer (0.3.0)
-    dry-events (0.2.0)
+    dry-events (0.3.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)
+      dry-core (~> 0.5, >= 0.5)
+    dry-inflector (0.2.1)
+    dry-initializer (3.0.4)
+    dry-logic (1.2.0)
       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-core (~> 0.5, >= 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.5.0)
+    dry-schema (1.8.0)
       concurrent-ruby (~> 1.0)
-      dry-configurable (~> 0.8, >= 0.8.3)
-      dry-core (~> 0.4)
-      dry-equalizer (~> 0.2)
+      dry-configurable (~> 0.13, >= 0.13.0)
+      dry-core (~> 0.5, >= 0.5)
       dry-initializer (~> 3.0)
       dry-logic (~> 1.0)
-      dry-types (~> 1.4)
-    dry-types (1.4.0)
+      dry-types (~> 1.5)
+    dry-types (1.5.1)
       concurrent-ruby (~> 1.0)
       dry-container (~> 0.3)
-      dry-core (~> 0.4, >= 0.4.4)
-      dry-equalizer (~> 0.3)
+      dry-core (~> 0.5, >= 0.5)
       dry-inflector (~> 0.1, >= 0.1.2)
       dry-logic (~> 1.0, >= 1.0.2)
-    dry-validation (1.5.0)
+    dry-validation (1.7.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)
-    envlogic (1.1.2)
+      dry-schema (~> 1.8, >= 1.8.0)
+    envlogic (1.1.4)
       dry-inflector (~> 0.1)
-    io-console (0.5.6)
-    irb (1.2.3)
-      reline (>= 0.0.1)
-    karafka (1.3.6)
-      dry-configurable (~> 0.8)
-      dry-inflector (~> 0.1)
-      dry-monitor (~> 0.3)
-      dry-validation (~> 1.2)
+    io-console (0.5.9)
+    irb (1.3.7)
+      reline (>= 0.2.7)
+    karafka (1.4.11)
+      dry-configurable (~> 0.13)
+      dry-inflector (~> 0.2)
+      dry-monitor (~> 0.5)
+      dry-validation (~> 1.7)
       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)
-    rack (2.2.2)
-    rack-protection (2.0.8.1)
-      rack
-    rake (13.0.1)
-    redis (4.1.3)
-    reline (0.1.4)
+      irb (~> 1.3)
+      ruby-kafka (>= 1.3.0)
+      thor (>= 1.1)
+      waterdrop (~> 1.4)
+      zeitwerk (~> 2.4)
+    king_konf (1.0.0)
+    rack (2.2.3)
+    rake (13.0.6)
+    redis (4.5.1)
+    reline (0.2.7)
       io-console (~> 0.5)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.1)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
-    ruby-kafka (1.0.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.3)
+    ruby-kafka (1.4.0)
       digest-crc
-    sidekiq (6.0.7)
+    sidekiq (6.3.1)
       connection_pool (>= 2.2.2)
       rack (~> 2.0)
-      rack-protection (>= 2.0.0)
-      redis (>= 4.1.0)
-    simplecov (0.18.5)
+      redis (>= 4.2.0)
+    simplecov (0.21.2)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
-    simplecov-html (0.12.2)
-    thor (1.0.1)
-    waterdrop (1.3.4)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.3)
+    thor (1.1.0)
+    waterdrop (1.4.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)
+      dry-configurable (~> 0.13)
+      dry-monitor (~> 0.5)
+      dry-validation (~> 1.7)
+      ruby-kafka (>= 1.3.0)
+      zeitwerk (~> 2.4)
+    zeitwerk (2.5.1)
 
 PLATFORMS
-  ruby
+  x86_64-darwin
+  x86_64-linux
 
 DEPENDENCIES
   karafka-sidekiq-backend!
@@ -133,4 +123,4 @@ DEPENDENCIES
   simplecov
 
 BUNDLED WITH
-   2.1.4
+   2.2.32

data/MIT-LICENSE

@@ -0,0 +1,18 @@
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,7 +1,16 @@
 # Karafka Sidekiq Backend
 
+## Deprecation notice
+
+This backend was designed to compensate for lack of multi-threading in Karafka. After Karafka `2.0` release, this backend development won't be continued.
+
+We will **still** support it for Karafka `1.4` but it won't work with Karafka `2.0`. We will however provide an extensive guide on how you can achieve similar functionality with Sidekiq yourself.
+
+## About
+
 [![Build Status](https://github.com/karafka/sidekiq-backend/workflows/ci/badge.svg)](https://github.com/karafka/sidekiq-backend/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)
+[![Gem Version](https://badge.fury.io/rb/karafka-sidekiq-backend.svg)](http://badge.fury.io/rb/karafka-sidekiq-backend)
+[![Join the chat at https://slack.karafka.io](https://raw.githubusercontent.com/karafka/misc/master/slack.svg)](https://slack.karafka.io)
 
 [Karafka Sidekiq Backend](https://github.com/karafka/sidekiq-backend) provides support for consuming (processing) received Kafka messages inside of Sidekiq workers.
 
@@ -48,7 +57,7 @@ App.routes.draw do
       backend :sidekiq
       consumer Videos::DetailsConsumer
       worker Workers::DetailsWorker
-      interchanger Interchangers::MyCustomInterchanger
+      interchanger Interchangers::MyCustomInterchanger.new
     end
   end
 end
@@ -63,7 +72,7 @@ There are two options you can set inside of the ```topic``` block:
 | Option       | Value type | Description                                                                                                       |
 |--------------|------------|-------------------------------------------------------------------------------------------------------------------|
 | worker       | Class      | Name of a worker class that we want to use to schedule perform code                                               |
-| interchanger | Class      | Name of an interchanger class that we want to use to pass the incoming data to Sidekiq                            |
+| interchanger | Instance   | Instance of an interchanger class that we want to use to pass the incoming data to Sidekiq                        |
 
 
 ### Workers
@@ -101,7 +110,7 @@ App.routes.draw do
   consumer_group :videos_consumer do
     topic :binary_video_details do
       consumer Videos::DetailsConsumer
-      interchanger Interchangers::MyCustomInterchanger
+      interchanger Interchangers::MyCustomInterchanger.new
     end
   end
 end
@@ -109,17 +118,13 @@ end
 Each custom interchanger should define `encode` to encode params before they get stored in Redis, and `decode` to convert the params to hash format, as shown below:
 
 ```ruby
-class Base64Interchanger
-  class << self
-    def encode(params_batch)
-      # Note, that you need to cast the params_batch to an array in order to get it work
-      # in sidekiq later
-      Base64.encode64(Marshal.dump(params_batch.to_a))
-    end
+class Base64Interchanger < ::Karafka::Interchanger
+  def encode(params_batch)
+    Base64.encode64(Marshal.dump(super))
+  end
 
-    def decode(params_string)
-      Marshal.load(Base64.decode64(params_string))
-    end
+  def decode(params_string)
+    Marshal.load(Base64.decode64(super))
   end
 end
 
@@ -135,12 +140,8 @@ end
 
 ## Note on contributions
 
-First, thank you for considering contributing to Karafka! 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.
+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!
 
-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/karafka-sidekiq-backend/builds/commit_builds) of Karafka Sidekiq Backend repository.
+Each pull request must pass all the RSpec specs, integration tests and meet our quality requirements.
 
-[![coditsu](https://coditsu.io/assets/quality_bar.svg)](https://app.coditsu.io/karafka/repositories/karafka-sidekiq-backend/builds/commit_builds)
+Fork it, update and wait for the Github Actions results.

data/certs/mensfeld.pem

@@ -1,25 +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
+ZWovREM9bWVuc2ZlbGQvREM9cGwwHhcNMjEwODExMTQxNTEzWhcNMjIwODExMTQx
+NTEzWjAjMSEwHwYDVQQDDBhtYWNpZWovREM9bWVuc2ZlbGQvREM9cGwwggGiMA0G
+CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQDV2jKH4Ti87GM6nyT6D+ESzTI0MZDj
+ak2/TEwnxvijMJyCCPKT/qIkbW4/f0VHM4rhPr1nW73sb5SZBVFCLlJcOSKOBdUY
+TMY+SIXN2EtUaZuhAOe8LxtxjHTgRHvHcqUQMBENXTISNzCo32LnUxweu66ia4Pd
+1mNRhzOqNv9YiBZvtBf7IMQ+sYdOCjboq2dlsWmJiwiDpY9lQBTnWORnT3mQxU5x
+vPSwnLB854cHdCS8fQo4DjeJBRZHhEbcE5sqhEMB3RZA3EtFVEXOxlNxVTS3tncI
+qyNXiWDaxcipaens4ObSY1C2HTV7OWb7OMqSCIybeYTSfkaSdqmcl4S6zxXkjH1J
+tnjayAVzD+QVXGijsPLE2PFnJAh9iDET2cMsjabO1f6l1OQNyAtqpcyQcgfnyW0z
+g7tGxTYD+6wJHffM9d9txOUw6djkF6bDxyqB8lo4Z3IObCx18AZjI9XPS9QG7w6q
+LCWuMG2lkCcRgASqaVk9fEf9yMc2xxz5o3kCAwEAAaN3MHUwCQYDVR0TBAIwADAL
+BgNVHQ8EBAMCBLAwHQYDVR0OBBYEFBqUFCKCOe5IuueUVqOB991jyCLLMB0GA1Ud
 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==
+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-sidekiq-backend.gemspec

@@ -9,15 +9,15 @@ Gem::Specification.new do |spec|
   spec.version     = Karafka::Backends::Sidekiq::VERSION
   spec.platform    = Gem::Platform::RUBY
   spec.authors     = ['Maciej Mensfeld']
-  spec.email       = %w[maciej@coditsu.io]
-  spec.homepage    = 'https://github.com/karafka/karafka-sidekiq-backend'
+  spec.email       = %w[maciej@mensfeld.pl]
+  spec.homepage    = 'https://karafka.io'
   spec.summary     = 'Karafka Sidekiq backend for background messages processing'
   spec.description = 'Karafka Sidekiq backend for background messages processing'
-  spec.license     = 'LGPL-3.0'
+  spec.license     = 'MIT'
 
-  spec.add_dependency 'karafka', '~> 1.3.0'
+  spec.add_dependency 'karafka', '~> 1.4.0'
   spec.add_dependency 'sidekiq', '>= 4.2'
-  spec.required_ruby_version = '>= 2.5.0'
+  spec.required_ruby_version = '>= 2.6.0'
 
   if $PROGRAM_NAME.end_with?('gem')
     spec.signing_key = File.expand_path('~/.ssh/gem-private_key.pem')
@@ -27,4 +27,5 @@ Gem::Specification.new do |spec|
   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.metadata      = { 'source_code_uri' => 'https://github.com/karafka/sidekiq-backend' }
 end

data/lib/karafka/backends/sidekiq.rb

@@ -6,7 +6,7 @@ module Karafka
     # Sidekiq backend that schedules stuff to Sidekiq worker for delayed execution
     module Sidekiq
       # Karafka Sidekiq backend version
-      VERSION = '1.3.1'
+      VERSION = '1.4.3'
 
       # Enqueues the execution of perform method into a worker.
       # @note Each worker needs to have a class #perform_async method that will allow us to pass
@@ -18,7 +18,7 @@ module Karafka
           topic.worker.perform_async(
             topic.id,
             topic.interchanger.encode(params_batch),
-            respond_to?(:metadata) ? metadata : nil
+            respond_to?(:batch_metadata) ? batch_metadata.to_h : nil
           )
         end
       end

data/lib/karafka/base_worker.rb

@@ -19,6 +19,7 @@ module Karafka
       # @param subclass [Class] subclass of the worker
       # @return [Class] subclass of the worker that was selected
       def inherited(subclass)
+        super
         @inherited ||= subclass
       end
     end
@@ -54,7 +55,7 @@ module Karafka
       )
 
       if topic.batch_fetching
-        consumer.metadata = Params::Builders::Metadata.from_hash(
+        consumer.batch_metadata = Params::Builders::BatchMetadata.from_hash(
           metadata,
           topic
         )

data/lib/karafka/extensions/{metadata_builder.rb → batch_metadata_builder.rb}

@@ -3,7 +3,7 @@
 module Karafka
   module Extensions
     # Extension for metadata builder to allow building metadata from a hash
-    module MetadataBuilder
+    module BatchMetadataBuilder
       # Builds metadata from hash
       # @param hash [Hash] hash with metadata
       # @param topic [Karafka::Routing::Topic] topic instance
@@ -11,10 +11,12 @@ module Karafka
       def from_hash(hash, topic)
         # Parser needs to be merged as this is the only non-serializable object
         # so it gets reconstructed from the topic
-        Karafka::Params::Metadata
-          .new
-          .merge!(hash)
-          .merge!('deserializer' => topic.deserializer)
+        Karafka::Params::BatchMetadata
+          .new(
+            **hash
+              .merge('deserializer' => topic.deserializer)
+              .transform_keys(&:to_sym)
+          )
       end
     end
   end

data/lib/karafka/extensions/params_batch_builder.rb

@@ -10,11 +10,11 @@ module Karafka
       # @return [Karafka::Params::ParamsBatch] built batch
       # @note We rebuild the params batch from array after the serialization
       def from_array(array, topic)
-        params_array = array.map! do |hash|
+        params_array = array.map do |hash|
           Karafka::Params::Builders::Params.from_hash(hash, topic)
         end
 
-        Karafka::Params::ParamsBatch.new(params_array)
+        Karafka::Params::ParamsBatch.new(params_array).freeze
       end
     end
   end

data/lib/karafka/extensions/params_builder.rb

@@ -9,10 +9,15 @@ module Karafka
       # @param topic [Karafka::Routing::Topic] topic for which we build the params
       # @return [Karafka::Params::Params] built params
       def from_hash(hash, topic)
+        metadata = Karafka::Params::Metadata.new(
+          **hash
+            .fetch('metadata')
+            .merge('deserializer' => topic.deserializer)
+            .transform_keys(&:to_sym)
+        ).freeze
+
         Karafka::Params::Params
-          .new
-          .merge!(hash)
-          .merge!('deserializer' => topic.deserializer)
+          .new(hash.fetch('raw_payload'), metadata)
       end
     end
   end

data/lib/karafka/extensions/sidekiq_topic_attributes.rb

@@ -11,8 +11,8 @@ module Karafka
         @worker ||= backend == :sidekiq ? Karafka::Workers::Builder.new(consumer).build : nil
       end
 
-      # @return [Class] Interchanger class (not an instance) that we want to use to interchange
-      #   params between Karafka server and Karafka background job
+      # @return [#encode, #decode] Interchanger instance (not a class) that we want to use to
+      #   interchange params between Karafka server and Karafka background job
       def interchanger
         @interchanger ||= Karafka::Interchanger.new
       end

data/lib/karafka/extensions/stdout_listener.rb

@@ -8,7 +8,7 @@ module Karafka
       # Logs info about scheduling of a certain dataset with a Sidekiq backend
       # @param event [Dry::Events::Event] event details including payload
       def on_backends_sidekiq_process(event)
-        count = event[:caller].send(:params_batch).to_a.size
+        count = event[:caller].send(:params_batch).size
         topic = event[:caller].topic.name
         time = event[:time]
         info "Scheduling of #{count} messages to Sidekiq on topic #{topic} took #{time} ms"
@@ -17,7 +17,7 @@ module Karafka
       # Logs ino about processing certain events with a given Sidekiq worker
       # @param event [Dry::Events::Event] event details including payload
       def on_backends_sidekiq_base_worker_perform(event)
-        count = event[:consumer].send(:params_batch).to_a.size
+        count = event[:consumer].send(:params_batch).size
         topic = event[:consumer].topic.name
         time = event[:time]
         info "Sidekiq processing of topic #{topic} with #{count} messages took #{time} ms"

data/lib/karafka/interchanger.rb

@@ -11,10 +11,14 @@ module Karafka
   # This interchanger uses default Sidekiq options to exchange data
   class Interchanger
     # @param params_batch [Karafka::Params::ParamsBatch] Karafka params batch object
-    # @return [Array<Karafka::Params::Params>] Array with hash/hashwithindiff values that will
-    #   be serialized using Sidekiq serialization engine
+    # @return [Array<Hash>] Array with hash built out of params data
     def encode(params_batch)
-      params_batch.to_a
+      params_batch.map do |param|
+        {
+          'raw_payload' => param.raw_payload,
+          'metadata' => param.metadata.to_h
+        }
+      end
     end
 
     # @param params_batch [Array<Hash>] Sidekiq params that are now an array

data/lib/karafka_sidekiq_backend.rb

@@ -16,7 +16,7 @@ Zeitwerk::Loader
 
 Karafka::Params::Builders::Params.extend(Karafka::Extensions::ParamsBuilder)
 Karafka::Params::Builders::ParamsBatch.extend(Karafka::Extensions::ParamsBatchBuilder)
-Karafka::Params::Builders::Metadata.extend(Karafka::Extensions::MetadataBuilder)
+Karafka::Params::Builders::BatchMetadata.extend(Karafka::Extensions::BatchMetadataBuilder)
 Karafka::Routing::Topic.include(Karafka::Extensions::SidekiqTopicAttributes)
 Karafka::AttributesMap.prepend(Karafka::Extensions::SidekiqAttributesMap)
 Karafka::Instrumentation::StdoutListener.include(Karafka::Extensions::StdoutListener)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: karafka-sidekiq-backend
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.3
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -11,30 +11,30 @@ cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
   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
-  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
+  ZWovREM9bWVuc2ZlbGQvREM9cGwwHhcNMjEwODExMTQxNTEzWhcNMjIwODExMTQx
+  NTEzWjAjMSEwHwYDVQQDDBhtYWNpZWovREM9bWVuc2ZlbGQvREM9cGwwggGiMA0G
+  CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQDV2jKH4Ti87GM6nyT6D+ESzTI0MZDj
+  ak2/TEwnxvijMJyCCPKT/qIkbW4/f0VHM4rhPr1nW73sb5SZBVFCLlJcOSKOBdUY
+  TMY+SIXN2EtUaZuhAOe8LxtxjHTgRHvHcqUQMBENXTISNzCo32LnUxweu66ia4Pd
+  1mNRhzOqNv9YiBZvtBf7IMQ+sYdOCjboq2dlsWmJiwiDpY9lQBTnWORnT3mQxU5x
+  vPSwnLB854cHdCS8fQo4DjeJBRZHhEbcE5sqhEMB3RZA3EtFVEXOxlNxVTS3tncI
+  qyNXiWDaxcipaens4ObSY1C2HTV7OWb7OMqSCIybeYTSfkaSdqmcl4S6zxXkjH1J
+  tnjayAVzD+QVXGijsPLE2PFnJAh9iDET2cMsjabO1f6l1OQNyAtqpcyQcgfnyW0z
+  g7tGxTYD+6wJHffM9d9txOUw6djkF6bDxyqB8lo4Z3IObCx18AZjI9XPS9QG7w6q
+  LCWuMG2lkCcRgASqaVk9fEf9yMc2xxz5o3kCAwEAAaN3MHUwCQYDVR0TBAIwADAL
+  BgNVHQ8EBAMCBLAwHQYDVR0OBBYEFBqUFCKCOe5IuueUVqOB991jyCLLMB0GA1Ud
   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==
+  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: 2020-04-27 00:00:00.000000000 Z
+date: 2021-12-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: karafka
@@ -42,14 +42,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.4.0
 - !ruby/object:Gem::Dependency
   name: sidekiq
   requirement: !ruby/object:Gem::Requirement
@@ -66,13 +66,13 @@ dependencies:
         version: '4.2'
 description: Karafka Sidekiq backend for background messages processing
 email:
-- maciej@coditsu.io
+- maciej@mensfeld.pl
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".coditsu/ci.yml"
-- ".github/FUNDING.yml"
+- ".diffend.yml"
 - ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
@@ -81,7 +81,7 @@ files:
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
-- LICENSE
+- MIT-LICENSE
 - README.md
 - Rakefile
 - certs/mensfeld.pem
@@ -91,7 +91,7 @@ files:
 - lib/karafka/base_worker.rb
 - lib/karafka/cli/worker.rb
 - lib/karafka/errors.rb
-- lib/karafka/extensions/metadata_builder.rb
+- lib/karafka/extensions/batch_metadata_builder.rb
 - lib/karafka/extensions/params_batch_builder.rb
 - lib/karafka/extensions/params_builder.rb
 - lib/karafka/extensions/sidekiq_attributes_map.rb
@@ -100,10 +100,11 @@ files:
 - lib/karafka/interchanger.rb
 - lib/karafka/workers/builder.rb
 - lib/karafka_sidekiq_backend.rb
-homepage: https://github.com/karafka/karafka-sidekiq-backend
+homepage: https://karafka.io
 licenses:
-- LGPL-3.0
-metadata: {}
+- MIT
+metadata:
+  source_code_uri: https://github.com/karafka/sidekiq-backend
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -112,14 +113,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.2.32
 signing_key: 
 specification_version: 4
 summary: Karafka Sidekiq backend for background messages processing

data/.github/FUNDING.yml

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

data/LICENSE

@@ -1,165 +0,0 @@
-                   GNU LESSER GENERAL PUBLIC LICENSE
-                       Version 3, 29 June 2007
-
- Copyright (C) 2007 Free Software Foundation, Inc. <http://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.