karafka 2.0.0.rc5 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 52fde84aac9ffef63ecbc1d367e3bfdc7209f6c2904f2a7142f51b1bd0613002
-  data.tar.gz: 4b4e7838e19505469ec20a654a3d7bb9c2588f351f9ea64fdb05e224b476d562
+  metadata.gz: 5adfb5654381a04d5b7111806bd5bbba70f75f02e7044b57af09b91b547dbd09
+  data.tar.gz: 9500da87035507a037218e9df5a11c8803e738c707b5d624c19559917939b689
 SHA512:
-  metadata.gz: 0ebdda184eca4c7dcfe39821125ba7a8645336607300395de792a7c8808cde07f54f5382278946fab58af0e95f3a85ab05be9ed6e7b292fc7692922cb7890747
-  data.tar.gz: 416cb01ed1b6dac0681969ce72505d19855a041e7ceb29e369ed9fc80675755ad1f478a20ee2d1f2c0e925036ba6f08adda727f8ecd3f4f07f39f0be347ae4a1
+  metadata.gz: 1acb20378ecdf95b87378297de714f6791f5abd3d411fbda4701231912e30033163c3b81a21f98a99d2ca247dbbe8cda72d81efc7b1d83a3aa019485dd2e8604
+  data.tar.gz: 2a8d352d68852da005c87b0494457abf3559ec3975deb1098da233e16e4e33fed517020733300b2364ad650cc3764d59deb7fff6efe63e216e4fdb057c3e4ed8

data/.github/workflows/ci.yml

@@ -73,10 +73,6 @@ jobs:
           ruby-version: ${{matrix.ruby}}
           bundler-cache: true
 
-      - name: Ensure all needed Kafka topics are created and wait if not
-        run: |
-          bin/wait_for_kafka
-
       - name: Run all specs
         env:
           GITHUB_COVERAGE: ${{matrix.coverage}}
@@ -120,10 +116,6 @@ jobs:
           bundle config set without development
           bundle install
 
-      - name: Ensure all needed Kafka topics are created and wait if not
-        run: |
-          bin/wait_for_kafka
-
       - name: Run integration tests
         env:
           KARAFKA_PRO_LICENSE_TOKEN: ${{ secrets.KARAFKA_PRO_LICENSE_TOKEN }}

data/CHANGELOG.md

@@ -1,5 +1,101 @@
 # Karafka framework changelog
 
+## 2.0.1 (2022-08-06)
+- Provide `Karafka::Admin` for creation and destruction of topics and fetching cluster info.
+- Update integration specs to always use one-time disposable topics.
+- Remove no longer needed `wait_for_kafka` script.
+- Add more integration specs for cover offset management upon errors.
+
+## 2.0.0 (2022-08-05)
+
+This changelog describes changes between `1.4` and `2.0`. Please refer to appropriate release notes for changes between particular `rc` releases.
+
+Karafka 2.0 is a **major** rewrite that brings many new things to the table but also removes specific concepts that happened not to be as good as I initially thought when I created them.
+
+Please consider getting a Pro version if you want to **support** my work on the Karafka ecosystem!
+
+For anyone worried that I will start converting regular features into Pro: This will **not** happen. Anything free and fully OSS in Karafka 1.4 will **forever** remain free. Most additions and improvements to the ecosystem are to its free parts. Any feature that is introduced as a free and open one will not become paid.
+
+### Additions
+
+This section describes **new** things and concepts introduced with Karafka 2.0.
+
+Karafka 2.0:
+
+- Introduces multi-threaded support for [concurrent work](https://github.com/karafka/karafka/wiki/Concurrency-and-multithreading) consumption for separate partitions as well as for single partition work via [Virtual Partitions](https://github.com/karafka/karafka/wiki/Pro-Virtual-Partitions).
+- Introduces [Active Job adapter](https://github.com/karafka/karafka/wiki/Active-Job) for using Karafka as a jobs backend with Ruby on Rails Active Job.
+- Introduces fully automatic integration end-to-end [test suite](https://github.com/karafka/karafka/tree/master/spec/integrations) that checks any case I could imagine.
+- Introduces [Virtual Partitions](https://github.com/karafka/karafka/wiki/Pro-Virtual-Partitions) for ability to parallelize work of a single partition.
+- Introduces [Long-Running Jobs](https://github.com/karafka/karafka/wiki/Pro-Long-Running-Jobs) to allow for work that would otherwise exceed the `max.poll.interval.ms`.
+- Introduces the [Enhanced Scheduler](https://github.com/karafka/karafka/wiki/Pro-Enhanced-Scheduler) that uses a non-preemptive LJF (Longest Job First) algorithm instead of a a FIFO (First-In, First-Out) one.
+- Introduces [Enhanced Active Job adapter](https://github.com/karafka/karafka/wiki/Pro-Enhanced-Active-Job) that is optimized and allows for strong ordering of jobs and more.
+- Introduces seamless [Ruby on Rails integration](https://github.com/karafka/karafka/wiki/Integrating-with-Ruby-on-Rails-and-other-frameworks) via `Rails::Railte` without need for any extra configuration.
+- Provides `#revoked` [method](https://github.com/karafka/karafka/wiki/Consuming-messages#shutdown-and-partition-revocation-handlers) for taking actions upon topic revocation.
+- Emits underlying async errors emitted from `librdkafka` via the standardized `error.occurred` [monitor channel](https://github.com/karafka/karafka/wiki/Error-handling-and-back-off-policy#error-tracking).
+- Replaces `ruby-kafka` with `librdkafka` as an underlying driver.
+- Introduces official [EOL policies](https://github.com/karafka/karafka/wiki/Versions-Lifecycle-and-EOL).
+- Introduces [benchmarks](https://github.com/karafka/karafka/tree/master/spec/benchmarks) that can be used to profile Karafka.
+- Introduces a requirement that the end user code **needs** to be [thread-safe](https://github.com/karafka/karafka/wiki/FAQ#does-karafka-require-gems-to-be-thread-safe).
+- Introduces a [Pro subscription](https://github.com/karafka/karafka/wiki/Build-vs.-Buy) with a [commercial license](https://github.com/karafka/karafka/blob/master/LICENSE-COMM) to fund further ecosystem development.
+
+### Deletions
+
+This section describes things that are **no longer** part of the Karafka ecosystem.
+
+Karafka 2.0:
+
+- Removes topics mappers concept completely.
+- Removes pidfiles support.
+- Removes daemonization support.
+- Removes support for using `sidekiq-backend` due to introduction of [multi-threading](https://github.com/karafka/karafka/wiki/Concurrency-and-multithreading).
+- Removes the `Responders` concept in favour of WaterDrop producer usage.
+- Removes completely all the callbacks in favour of finalizer method `#shutdown`.
+- Removes single message consumption mode in favour of [documentation](https://github.com/karafka/karafka/wiki/Consuming-messages#one-at-a-time) on how to do it easily by yourself.
+
+### Changes
+
+This section describes things that were **changed** in Karafka but are still present.
+
+Karafka 2.0:
+
+- Uses only instrumentation that comes from Karafka. This applies also to notifications coming natively from `librdkafka`. They are now piped through Karafka prior to being dispatched.
+- Integrates WaterDrop `2.x` tightly with autoconfiguration inheritance and an option to redefine it.
+- Integrates with the `karafka-testing` gem for RSpec that also has been updated.
+- Updates `cli info` to reflect the `2.0` details.
+- Stops validating `kafka` configuration beyond minimum as the rest is handled by `librdkafka`.
+- No longer uses `dry-validation`.
+- No longer uses `dry-monitor`.
+- No longer uses `dry-configurable`.
+- Lowers general external dependencies three **heavily**.
+- Renames `Karafka::Params::BatchMetadata` to `Karafka::Messages::BatchMetadata`.
+- Renames `Karafka::Params::Params` to `Karafka::Messages::Message`.
+- Renames `#params_batch` in consumers to `#messages`.
+- Renames `Karafka::Params::Metadata` to `Karafka::Messages::Metadata`.
+- Renames `Karafka::Fetcher` to `Karafka::Runner` and align notifications key names.
+- Renames `StdoutListener` to `LoggerListener`.
+- Reorganizes [monitoring and logging](https://github.com/karafka/karafka/wiki/Monitoring-and-logging) to match new concepts.
+- Notifies on fatal worker processing errors.
+- Contains updated install templates for Rails and no-non Rails.
+- Changes how the routing style (`0.5`) behaves. It now builds a single consumer group instead of one per topic.
+- Introduces changes that will allow me to build full web-UI in the upcoming `2.1`.
+- Contains updated example apps.
+- Standardizes error hooks for all error reporting (`error.occurred`).
+- Changes license to `LGPL-3.0`.
+- Introduces a `karafka-core` dependency that contains common code used across the ecosystem.
+- Contains updated [wiki](https://github.com/karafka/karafka/wiki) on everything I could think of.
+
+### What's ahead
+
+Karafka 2.0 is just the beginning.
+
+There are several things in the plan already for 2.1 and beyond, including a web dashboard, at-rest encryption, transactions support, and more.
+
+## 2.0.0.rc6 (2022-08-05)
+- Update licenser to use a gem based approach based on `karafka-license`.
+- Do not mark intermediate jobs as consumed when Karafka runs Enhanced Active Job with Virtual Partitions.
+- Improve development experience by adding fast cluster state changes refresh (#944)
+- Improve the license loading.
+
 ## 2.0.0.rc5 (2022-08-01)
 - Improve specs stability
 - Improve forceful shutdown
@@ -53,7 +149,7 @@
 - Add more integration specs related to polling limits.
 - Remove auto-detection of re-assigned partitions upon rebalance as for too fast rebalances it could not be accurate enough. It would also mess up in case of rebalances that would happen right after a `#seek` was issued for a partition.
 - Optimize the removal of pre-buffered lost partitions data.
-- Always rune `#revoked` when rebalance with revocation happens.
+- Always run `#revoked` when rebalance with revocation happens.
 - Evict executors upon rebalance, to prevent race-conditions.
 - Align topics names for integration specs.
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    karafka (2.0.0.rc5)
+    karafka (2.0.1)
       karafka-core (>= 2.0.2, < 3.0.0)
       rdkafka (>= 0.12)
       thor (>= 0.20)

data/LICENSE-COMM

@@ -6,7 +6,7 @@ IMPORTANT: THIS SOFTWARE END-USER LICENSE AGREEMENT ("EULA") IS A LEGAL AGREEMEN
 
 ------------------------------------------------------------------------------
 
-In order to use the Software under this Agreement, you must receive an application token at the time of purchase, in accordance with the scope of use and other terms specified for each type of Software and as set forth in this Section 1 of this Agreement.
+In order to use the Software under this Agreement, you must receive a "Source URL" to a license package at the time of purchase, in accordance with the scope of use and other terms specified for each type of Software and as set forth in this Section 1 of this Agreement.
 
 1. License Grant
 
@@ -22,7 +22,7 @@ In order to use the Software under this Agreement, you must receive an applicati
 
 3. Restricted Uses.
 
-3.1 You shall not (and shall not allow any third party to): (a) decompile, disassemble, or otherwise reverse engineer the Software or attempt to reconstruct or discover any source code, underlying ideas, algorithms, file formats or programming interfaces of the Software by any means whatsoever (except and only to the extent that applicable law prohibits or restricts reverse engineering restrictions); (b) distribute, sell, sublicense, rent, lease or use the Software for time sharing, hosting, service provider or like purposes, except as expressly permitted under this Agreement; (c) redistribute the Software or Modifications other than by including the Software or a portion thereof within your own product, which must have substantially different functionality than the Software or Modifications and must not allow any third party to use the Software or Modifications, or any portions thereof, for software development or application development purposes; (d) redistribute the Software as part of a product, "appliance" or "virtual server"; (e) redistribute the Software on any server which is not directly under your control; (f) remove any product identification, proprietary, copyright or other notices contained in the Software; (g) modify any part of the Software, create a derivative work of any part of the Software (except as permitted in Section 4), or incorporate the Software, except to the extent expressly authorized in writing by Maciej Mensfeld; (h) publicly disseminate performance information or analysis (including, without limitation, benchmarks) from any source relating to the Software; (i) utilize any equipment, device, software, or other means designed to circumvent or remove any form of token verification or copy protection used by Maciej Mensfeld in connection with the Software, or use the Software together with any authorization code, Source URL, serial number, or other copy protection device not supplied by Maciej Mensfeld; (j) use the Software to develop a product which is competitive with any Maciej Mensfeld product offerings; or (k) use unauthorized Source URLS or keycode(s) or distribute or publish Source URLs or keycode(s), except as may be expressly permitted by Maciej Mensfeld in writing. If your unique application token is ever published, Maciej Mensfeld reserves the right to terminate your access without notice.
+3.1 You shall not (and shall not allow any third party to): (a) decompile, disassemble, or otherwise reverse engineer the Software or attempt to reconstruct or discover any source code, underlying ideas, algorithms, file formats or programming interfaces of the Software by any means whatsoever (except and only to the extent that applicable law prohibits or restricts reverse engineering restrictions); (b) distribute, sell, sublicense, rent, lease or use the Software for time sharing, hosting, service provider or like purposes, except as expressly permitted under this Agreement; (c) redistribute the Software or Modifications other than by including the Software or a portion thereof within your own product, which must have substantially different functionality than the Software or Modifications and must not allow any third party to use the Software or Modifications, or any portions thereof, for software development or application development purposes; (d) redistribute the Software as part of a product, "appliance" or "virtual server"; (e) redistribute the Software on any server which is not directly under your control; (f) remove any product identification, proprietary, copyright or other notices contained in the Software; (g) modify any part of the Software, create a derivative work of any part of the Software (except as permitted in Section 4), or incorporate the Software, except to the extent expressly authorized in writing by Maciej Mensfeld; (h) publicly disseminate performance information or analysis (including, without limitation, benchmarks) from any source relating to the Software; (i) utilize any equipment, device, software, or other means designed to circumvent or remove any form of Source URL or copy protection used by Maciej Mensfeld in connection with the Software, or use the Software together with any authorization code, Source URL, serial number, or other copy protection device not supplied by Maciej Mensfeld; (j) use the Software to develop a product which is competitive with any Maciej Mensfeld product offerings; or (k) use unauthorized Source URLS or keycode(s) or distribute or publish Source URLs or keycode(s), except as may be expressly permitted by Maciej Mensfeld in writing. If your unique Source URL is ever published, Maciej Mensfeld reserves the right to terminate your access without notice.
 
 3.2 UNDER NO CIRCUMSTANCES MAY YOU USE THE SOFTWARE AS PART OF A PRODUCT OR SERVICE THAT PROVIDES SIMILAR FUNCTIONALITY TO THE SOFTWARE ITSELF.
 

data/README.md

@@ -4,14 +4,12 @@
 [![Gem Version](https://badge.fury.io/rb/karafka.svg)](http://badge.fury.io/rb/karafka)
 [![Join the chat at https://slack.karafka.io](https://raw.githubusercontent.com/karafka/misc/master/slack.svg)](https://slack.karafka.io)
 
-**Note**: All of the documentation here refers to Karafka `2.0.0.rc4` or higher. If you are looking for the documentation for Karafka `1.4`, please click [here](https://github.com/karafka/wiki/tree/1.4).
-
 ## About Karafka
 
 Karafka is a Ruby and Rails multi-threaded efficient Kafka processing framework that:
 
 - Supports parallel processing in [multiple threads](https://github.com/karafka/karafka/wiki/Concurrency-and-multithreading) (also for a [single topic partition](https://github.com/karafka/karafka/wiki/Pro-Virtual-Partitions) work)
-- Has [ActiveJob backend](https://github.com/karafka/karafka/wiki/Active-Job) support (including ordered jobs)
+- Has [ActiveJob backend](https://github.com/karafka/karafka/wiki/Active-Job) support (including [ordered jobs](https://github.com/karafka/karafka/wiki/Pro-Enhanced-Active-Job#ordered-jobs))
 - [Automatically integrates](https://github.com/karafka/karafka/wiki/Integrating-with-Ruby-on-Rails-and-other-frameworks#integrating-with-ruby-on-rails=) with Ruby on Rails
 - Supports in-development [code reloading](https://github.com/karafka/karafka/wiki/Auto-reload-of-code-changes-in-development)
 - Is powered by [librdkafka](https://github.com/edenhill/librdkafka) (the Apache Kafka C/C++ client library)
@@ -55,7 +53,7 @@ We also maintain many [integration specs](https://github.com/karafka/karafka/tre
 1. Add and install Karafka:
 
 ```bash
-bundle add karafka -v 2.0.0.rc4
+bundle add karafka
 
 bundle exec karafka install
 ```

data/bin/create_token

@@ -9,16 +9,10 @@ PRIVATE_KEY_LOCATION = File.join(Dir.home, '.ssh', 'karafka-pro', 'id_rsa')
 
 # Name of the entity that acquires the license
 ENTITY = ARGV[0]
-# Date till which license is valid
-EXPIRES_ON = Date.parse(ARGV[1])
 
 raise ArgumentError, 'Entity missing' if ENTITY.nil? || ENTITY.empty?
-raise ArgumentError, 'Expires on needs to be in the future' if EXPIRES_ON <= Date.today
 
-pro_token_data = {
-  entity: ENTITY,
-  expires_on: EXPIRES_ON
-}
+pro_token_data = { entity: ENTITY }
 
 # This code uses my private key to generate a new token for Karafka Pro capabilities
 private_key = OpenSSL::PKey::RSA.new(File.read(PRIVATE_KEY_LOCATION))

data/bin/integrations

@@ -22,7 +22,7 @@ ROOT_PATH = Pathname.new(File.expand_path(File.join(File.dirname(__FILE__), '../
 CONCURRENCY = ENV.key?('CI') ? 5 : Etc.nprocessors * 2
 
 # How may bytes do we want to keep from the stdout in the buffer for when we need to print it
-MAX_BUFFER_OUTPUT = 10_240
+MAX_BUFFER_OUTPUT = 51_200
 
 # Abstraction around a single test scenario execution process
 class Scenario

data/docker-compose.yml

@@ -16,36 +16,7 @@ services:
       KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
       KAFKA_AUTO_CREATE_TOPICS_ENABLE: 'true'
       KAFKA_CREATE_TOPICS:
-        "integrations_00_02:2:1,\
-         integrations_01_02:2:1,\
-         integrations_02_02:2:1,\
-         integrations_03_02:2:1,\
-         integrations_04_02:2:1,\
-         integrations_05_02:2:1,\
-         integrations_06_02:2:1,\
-         integrations_07_02:2:1,\
-         integrations_08_02:2:1,\
-         integrations_09_02:2:1,\
-         integrations_10_02:2:1,\
-         integrations_11_02:2:1,\
-         integrations_12_02:2:1,\
-         integrations_13_02:2:1,\
-         integrations_14_02:2:1,\
-         integrations_15_02:2:1,\
-         integrations_16_02:2:1,\
-         integrations_17_02:2:1,\
-         integrations_18_02:2:1,\
-         integrations_19_02:2:1,\
-         integrations_20_02:2:1,\
-         integrations_21_02:2:1,\
-         integrations_00_03:3:1,\
-         integrations_01_03:3:1,\
-         integrations_02_03:3:1,\
-         integrations_03_03:3:1,\
-         integrations_04_03:3:1,\
-         integrations_00_10:10:1,\
-         integrations_01_10:10:1,\
-         benchmarks_00_01:1:1,\
+        "benchmarks_00_01:1:1,\
          benchmarks_00_05:5:1,\
          benchmarks_01_05:5:1,\
          benchmarks_00_10:10:1"

data/lib/karafka/admin.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Karafka
+  # Simple admin actions that we can perform via Karafka on our Kafka cluster
+  #
+  # @note It always initializes a new admin instance as we want to ensure it is always closed
+  #   Since admin actions are not performed that often, that should be ok.
+  #
+  # @note It always uses the primary defined cluster and does not support multi-cluster work.
+  #   If you need this, just replace the cluster info for the time you use this
+  class Admin
+    class << self
+      # Creates Kafka topic with given settings
+      #
+      # @param name [String] topic name
+      # @param partitions [Integer] number of partitions we expect
+      # @param replication_factor [Integer] number of replicas
+      # @param topic_config [Hash] topic config details as described here:
+      #   https://kafka.apache.org/documentation/#topicconfigs
+      def create_topic(name, partitions, replication_factor, topic_config = {})
+        with_admin do |admin|
+          admin
+            .create_topic(name, partitions, replication_factor, topic_config)
+            .wait
+        end
+      end
+
+      # Deleted a given topic
+      #
+      # @param name [String] topic name
+      def delete_topic(name)
+        with_admin do |admin|
+          admin
+            .delete_topic(name)
+            .wait
+        end
+      end
+
+      # @return [Rdkafka::Metadata] cluster metadata info
+      def cluster_info
+        with_admin do |admin|
+          Rdkafka::Metadata.new(admin.instance_variable_get('@native_kafka'))
+        end
+      end
+
+      private
+
+      # Creates admin instance and yields it. After usage it closes the admin instance
+      def with_admin
+        admin = ::Rdkafka::Config.new(Karafka::App.config.kafka).admin
+        result = yield(admin)
+        admin.close
+        result
+      end
+    end
+  end
+end

data/lib/karafka/cli/info.rb

@@ -52,8 +52,7 @@ module Karafka
         if Karafka.pro?
           [
             'License: Commercial',
-            "License entity: #{config.license.entity}",
-            "License expires on: #{config.license.expires_on}"
+            "License entity: #{config.license.entity}"
           ]
         else
           [

data/lib/karafka/connection/client.rb

@@ -345,6 +345,9 @@ module Karafka
         when :network_exception # 13
           reset
           return nil
+        when :unknown_topic_or_part
+          # This is expected and temporary until rdkafka catches up with metadata
+          return nil
         end
 
         raise if time_poll.attempts > MAX_POLL_RETRIES
@@ -364,7 +367,6 @@ module Karafka
         config = ::Rdkafka::Config.new(@subscription_group.kafka)
         config.consumer_rebalance_listener = @rebalance_manager
         consumer = config.consumer
-        consumer.subscribe(*@subscription_group.topics.map(&:name))
         @name = consumer.name
 
         # Register statistics runner for this particular type of callbacks
@@ -389,6 +391,9 @@ module Karafka
           )
         )
 
+        # Subscription needs to happen after we assigned the rebalance callbacks just in case of
+        # a race condition
+        consumer.subscribe(*@subscription_group.topics.map(&:name))
         consumer
       end
 

data/lib/karafka/contracts/config.rb

@@ -21,7 +21,6 @@ module Karafka
       nested(:license) do
         required(:token) { |val| [true, false].include?(val) || val.is_a?(String) }
         required(:entity) { |val| val.is_a?(String) }
-        required(:expires_on) { |val| val.is_a?(Date) }
       end
 
       required(:client_id) { |val| val.is_a?(String) && Contracts::TOPIC_REGEXP.match?(val) }

data/lib/karafka/instrumentation/proctitle_listener.rb

@@ -5,19 +5,19 @@ module Karafka
     # Listener that sets a proc title with a nice descriptive value
     class ProctitleListener
       # Updates proc title to an initializing one
-      # @param _event [Dry::Events::Event] event details including payload
+      # @param _event [Karafka::Core::Monitoring::Event] event details including payload
       def on_app_initializing(_event)
         setproctitle('initializing')
       end
 
       # Updates proc title to a running one
-      # @param _event [Dry::Events::Event] event details including payload
+      # @param _event [Karafka::Core::Monitoring::Event] event details including payload
       def on_app_running(_event)
         setproctitle('running')
       end
 
       # Updates proc title to a stopping one
-      # @param _event [Dry::Events::Event] event details including payload
+      # @param _event [Karafka::Core::Monitoring::Event] event details including payload
       def on_app_stopping(_event)
         setproctitle('stopping')
       end

data/lib/karafka/instrumentation/vendors/datadog/listener.rb

@@ -65,7 +65,7 @@ module Karafka
 
           # Hooks up to WaterDrop instrumentation for emitted statistics
           #
-          # @param event [Dry::Events::Event]
+          # @param event [Karafka::Core::Monitoring::Event]
           def on_statistics_emitted(event)
             statistics = event[:statistics]
 
@@ -76,7 +76,7 @@ module Karafka
 
           # Increases the errors count by 1
           #
-          # @param event [Dry::Events::Event]
+          # @param event [Karafka::Core::Monitoring::Event]
           def on_error_occurred(event)
             extra_tags = ["type:#{event[:type]}"]
 
@@ -94,7 +94,7 @@ module Karafka
 
           # Reports how many messages we've polled and how much time did we spend on it
           #
-          # @param event [Dry::Events::Event]
+          # @param event [Karafka::Core::Monitoring::Event]
           def on_connection_listener_fetch_loop_received(event)
             time_taken = event[:time]
             messages_count = event[:messages_buffer].size
@@ -105,7 +105,7 @@ module Karafka
 
           # Here we report majority of things related to processing as we have access to the
           # consumer
-          # @param event [Dry::Events::Event]
+          # @param event [Karafka::Core::Monitoring::Event]
           def on_consumer_consumed(event)
             messages = event.payload[:caller].messages
             metadata = messages.metadata
@@ -124,7 +124,7 @@ module Karafka
             histogram('consumer.consumption_lag', metadata.consumption_lag, tags: tags)
           end
 
-          # @param event [Dry::Events::Event]
+          # @param event [Karafka::Core::Monitoring::Event]
           def on_consumer_revoked(event)
             messages = event.payload[:caller].messages
             metadata = messages.metadata
@@ -137,7 +137,7 @@ module Karafka
             count('consumer.revoked', 1, tags: tags)
           end
 
-          # @param event [Dry::Events::Event]
+          # @param event [Karafka::Core::Monitoring::Event]
           def on_consumer_shutdown(event)
             messages = event.payload[:caller].messages
             metadata = messages.metadata
@@ -151,7 +151,7 @@ module Karafka
           end
 
           # Worker related metrics
-          # @param event [Dry::Events::Event]
+          # @param event [Karafka::Core::Monitoring::Event]
           def on_worker_process(event)
             jq_stats = event[:jobs_queue].statistics
 
@@ -162,7 +162,7 @@ module Karafka
 
           # We report this metric before and after processing for higher accuracy
           # Without this, the utilization would not be fully reflected
-          # @param event [Dry::Events::Event]
+          # @param event [Karafka::Core::Monitoring::Event]
           def on_worker_processed(event)
             jq_stats = event[:jobs_queue].statistics
 

data/lib/karafka/licenser.rb

@@ -8,8 +8,34 @@ module Karafka
 
     private_constant :PUBLIC_KEY_LOCATION
 
+    # Tries to prepare license and verifies it
+    #
+    # @param license_config [Karafka::Core::Configurable::Node] config related to the licensing
+    def prepare_and_verify(license_config)
+      prepare(license_config)
+      verify(license_config)
+    end
+
+    private
+
+    # @param license_config [Karafka::Core::Configurable::Node] config related to the licensing
+    def prepare(license_config)
+      # If there is token, no action needed
+      # We support a case where someone would put the token in instead of using one from the
+      # license. That's in case there are limitations to using external package sources, etc
+      return if license_config.token
+
+      begin
+        license_config.token || require('karafka-license')
+      rescue LoadError
+        return
+      end
+
+      license_config.token = Karafka::License.token
+    end
+
     # Check license and setup license details (if needed)
-    # @param license_config [Dry::Configurable::Config] config part related to the licensing
+    # @param license_config [Karafka::Core::Configurable::Node] config related to the licensing
     def verify(license_config)
       # If no license, it will just run LGPL components without anything extra
       return unless license_config.token
@@ -29,19 +55,10 @@ module Karafka
       details = data ? JSON.parse(data) : raise_invalid_license_token(license_config)
 
       license_config.entity = details.fetch('entity')
-      license_config.expires_on = Date.parse(details.fetch('expires_on'))
-
-      return if license_config.expires_on > Date.today
-
-      raise_expired_license_token_in_dev(license_config.expires_on)
-
-      notify_if_license_expired(license_config.expires_on)
     end
 
-    private
-
     # Raises an error with info, that used token is invalid
-    # @param license_config [Dry::Configurable::Config]
+    # @param license_config [Karafka::Core::Configurable::Node]
     def raise_invalid_license_token(license_config)
       # We set it to false so `Karafka.pro?` method behaves as expected
       license_config.token = false
@@ -54,42 +71,5 @@ module Karafka
         MSG
       )
     end
-
-    # Raises an error for test and dev environments if running pro with expired license
-    # We never want to cause any non-dev problems and we should never crash anything else than
-    # tests and development envs.
-    #
-    # @param expires_on [Date] when the license expires
-    def raise_expired_license_token_in_dev(expires_on)
-      env = Karafka::App.env
-
-      return unless env.development? || env.test?
-
-      raise Errors::ExpiredLicenseTokenError.new, expired_message(expires_on)
-    end
-
-    # We do not raise an error here as we don't want to cause any problems to someone that runs
-    # Karafka on production. Error message is enough.
-    #
-    # @param expires_on [Date] when the license expires
-    def notify_if_license_expired(expires_on)
-      Karafka.logger.error(expired_message(expires_on))
-
-      Karafka.monitor.instrument(
-        'error.occurred',
-        caller: self,
-        error: Errors::ExpiredLicenseTokenError.new(expired_message(expires_on)),
-        type: 'licenser.expired'
-      )
-    end
-
-    # @param expires_on [Date] when the license expires
-    # @return [String] expired message
-    def expired_message(expires_on)
-      <<~MSG.tr("\n", ' ')
-        Your license expired on #{expires_on}.
-        Please reach us at contact@karafka.io or visit https://karafka.io to obtain a valid one.
-      MSG
-    end
   end
 end

data/lib/karafka/pro/active_job/consumer.rb

@@ -33,6 +33,10 @@ module Karafka
               ::ActiveSupport::JSON.decode(message.raw_payload)
             )
 
+            # We cannot mark jobs as done after each if there are virtual partitions. Otherwise
+            # this could create random markings
+            next if topic.virtual_partitioner?
+
             mark_as_consumed(message)
           end
         end

data/lib/karafka/pro/loader.rb

@@ -36,7 +36,7 @@ module Karafka
 
       class << self
         # Loads all the pro components and configures them wherever it is expected
-        # @param config [Dry::Configurable::Config] whole app config that we can alter with pro
+        # @param config [Karafka::Core::Configurable::Node] app config that we can alter with pro
         #   components
         def setup(config)
           COMPONENTS.each { |component| require_relative(component) }

data/lib/karafka/pro/performance_tracker.rb

@@ -45,7 +45,7 @@ module Karafka
       end
 
       # @private
-      # @param event [Dry::Events::Event] event details
+      # @param event [Karafka::Core::Monitoring::Event] event details
       # Tracks time taken to process a single message of a given topic partition
       def on_consumer_consumed(event)
         consumer = event[:caller]

data/lib/karafka/pro/processing/coordinator.rb

@@ -1,5 +1,14 @@
 # frozen_string_literal: true
 
+# This Karafka component is a Pro component.
+# All of the commercial components are present in the lib/karafka/pro directory of this
+# repository and their usage requires commercial license agreement.
+#
+# Karafka has also commercial-friendly license, commercial support and commercial components.
+#
+# By sending a pull request to the pro components, you are agreeing to transfer the copyright of
+# your code to Maciej Mensfeld.
+
 module Karafka
   module Pro
     module Processing

data/lib/karafka/setup/config.rb

@@ -19,7 +19,20 @@ module Karafka
         'client.id': 'karafka'
       }.freeze
 
-      private_constant :KAFKA_DEFAULTS
+      # Contains settings that should not be used in production but make life easier in dev
+      DEV_DEFAULTS = {
+        # Will create non-existing topics automatically.
+        # Note that the broker needs to be configured with `auto.create.topics.enable=true`
+        # While it is not recommended in prod, it simplifies work in dev
+        'allow.auto.create.topics': 'true',
+        # We refresh the cluster state often as newly created topics in dev may not be detected
+        # fast enough. Fast enough means within reasonable time to provide decent user experience
+        # While it's only a one time thing for new topics, it can still be irritating to have to
+        # restart the process.
+        'topic.metadata.refresh.interval.ms': 5_000
+      }.freeze
+
+      private_constant :KAFKA_DEFAULTS, :DEV_DEFAULTS
 
       # Available settings
 
@@ -34,8 +47,6 @@ module Karafka
         setting :token, default: false
         # option entity [String] for whom we did issue the license
         setting :entity, default: ''
-        # option expires_on [Date] date when the license expires
-        setting :expires_on, default: Date.parse('2100-01-01')
       end
 
       # option client_id [String] kafka client_id - used to provide
@@ -136,8 +147,10 @@ module Karafka
 
           Contracts::Config.new.validate!(config.to_h)
 
-          # Check the license presence (if needed) and
-          Licenser.new.verify(config.license)
+          licenser = Licenser.new
+
+          # Tries to load our license gem and if present will try to load the correct license
+          licenser.prepare_and_verify(config.license)
 
           configure_components
 
@@ -149,13 +162,21 @@ module Karafka
         # Propagates the kafka setting defaults unless they are already present
         # This makes it easier to set some values that users usually don't change but still allows
         # them to overwrite the whole hash if they want to
-        # @param config [Dry::Configurable::Config] dry config of this producer
+        # @param config [Karafka::Core::Configurable::Node] config of this producer
         def merge_kafka_defaults!(config)
           KAFKA_DEFAULTS.each do |key, value|
             next if config.kafka.key?(key)
 
             config.kafka[key] = value
           end
+
+          return if Karafka::App.env.production?
+
+          DEV_DEFAULTS.each do |key, value|
+            next if config.kafka.key?(key)
+
+            config.kafka[key] = value
+          end
         end
 
         # Sets up all the components that are based on the user configuration

data/lib/karafka/version.rb

@@ -3,5 +3,5 @@
 # Main module namespace
 module Karafka
   # Current Karafka version
-  VERSION = '2.0.0.rc5'
+  VERSION = '2.0.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: karafka
 version: !ruby/object:Gem::Version
-  version: 2.0.0.rc5
+  version: 2.0.1
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -34,7 +34,7 @@ cert_chain:
   R2P11bWoCtr70BsccVrN8jEhzwXngMyI2gVt750Y+dbTu1KgRqZKp/ECe7ZzPzXj
   pIy9vHxTANKYVyI4qj8OrFdEM5BQNu8oQpL0iQ==
   -----END CERTIFICATE-----
-date: 2022-08-01 00:00:00.000000000 Z
+date: 2022-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: karafka-core
@@ -152,7 +152,6 @@ files:
 - bin/scenario
 - bin/stress_many
 - bin/stress_one
-- bin/wait_for_kafka
 - certs/karafka-pro.pem
 - certs/mensfeld.pem
 - config/errors.yml
@@ -166,6 +165,7 @@ files:
 - lib/karafka/active_job/job_extensions.rb
 - lib/karafka/active_job/job_options_contract.rb
 - lib/karafka/active_job/routing/extensions.rb
+- lib/karafka/admin.rb
 - lib/karafka/app.rb
 - lib/karafka/base_consumer.rb
 - lib/karafka/cli.rb
@@ -287,9 +287,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.3.7
 signing_key: 

data/bin/wait_for_kafka

@@ -1,20 +0,0 @@
-#!/bin/bash
-
-# This script allows us to wait for Kafka docker to fully be ready
-# We consider it fully ready when all our topics that need to be created are created as expected
-
-KAFKA_NAME='karafka_20_kafka'
-ZOOKEEPER='zookeeper:2181'
-LIST_CMD="kafka-topics.sh --list --zookeeper $ZOOKEEPER"
-
-# Take the number of topics that we need to create prior to running anything
-TOPICS_COUNT=`cat docker-compose.yml | grep -E -i 'integrations_|benchmarks_' | wc -l`
-
-# And wait until all of them are created
-until (((`docker exec $KAFKA_NAME $LIST_CMD | wc -l`) >= $TOPICS_COUNT));
-do
-  echo "Waiting for Kafka to create all the needed topics..."
-  sleep 1
-done
-
-echo "All the needed topics created."