karafka 2.5.2 → 2.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf868e62a336390b27672a8315accbc535b698cef8e0393a93fbae5e36d3ae87
-  data.tar.gz: 1bafbd50c3e3c0544fc36e34a3ce01808eda30df67b991aba63200a9453cdc35
+  metadata.gz: d7b2a6d732bc69e537d14e306a4edc922b6375aa0154dada74527b06efea34fa
+  data.tar.gz: 2e6c1f533f706d70699db822d6d34eac5b6df0c0275bc12366238cc7316a3793
 SHA512:
-  metadata.gz: 57714d5fa6d68c7dde6c911a658793d8898531349922109898038e848cc304ee9316b88023095eb0139b74f8c40a155760e998eb36058e2438d2142c566702fa
-  data.tar.gz: ac31c2972452d8a17e8797d403fb247f85f9179373329a0519e5f9caece5eab6f1dcd3465b2eae73f3f452a9e46f6c30616cb0f6e25712b2a3ae239fcc5de698
+  metadata.gz: c760fb9e76f6e3af5421cfc0d821d03c3c845c629ea4ab1b2bcfa89c50431320b5cada72482eb48dfc9c27718631e1920ca5133ccd3884daddbc84cc6a7288e7
+  data.tar.gz: ce5466e71edc225b9e11283be5f7e1f877f6222a766dd63f69a235a0739a812f5007da341f5010a71eb2322efebb400fa441a7188f41ac6c244acade0b37c4e4

data/.github/workflows/ci_linux_ubuntu_x86_64_gnu.yml

@@ -60,6 +60,23 @@ jobs:
       - name: Run Coditsu
         run: ./coditsu_script.sh
 
+  yard-lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    strategy:
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          fetch-depth: 0
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@d5126b9b3579e429dd52e51e68624dda2e05be25 # v1.267.0
+        with:
+          ruby-version: '3.4.7'
+          bundler-cache: true
+      - name: Run yard-lint
+        run: bundle exec yard-lint lib/
+
   # We do not split RSpec specs to OSS and Pro like integrations because they do not overload
   # Kafka heavily, compute total coverage for specs and are fast enough
   specs:
@@ -265,6 +282,7 @@ jobs:
     needs:
       - karafka-checksum
       - coditsu
+      - yard-lint
       - specs
       - integrations_oss
       - integrations_pro

data/.yard-lint.yml

@@ -0,0 +1,174 @@
+# YARD-Lint Configuration
+# See https://github.com/mensfeld/yard-lint for documentation
+
+# Global settings for all validators
+AllValidators:
+  # YARD command-line options (applied to all validators by default)
+  YardOptions:
+    - --private
+    - --protected
+
+  # Global file exclusion patterns
+  Exclude:
+    - '\.git'
+    - 'vendor/**/*'
+    - 'node_modules/**/*'
+    - 'spec/**/*'
+    - 'test/**/*'
+
+  # Exit code behavior (error, warning, convention, never)
+  FailOnSeverity: error
+
+  # Minimum documentation coverage percentage (0-100)
+  # Fails if coverage is below this threshold
+  MinCoverage: 99.0
+
+  # Diff mode settings
+  DiffMode:
+    # Default base ref for --diff (auto-detects main/master if not specified)
+    DefaultBaseRef: ~
+
+# Documentation validators
+Documentation/UndocumentedObjects:
+  Description: 'Checks for classes, modules, and methods without documentation.'
+  Enabled: true
+  Severity: error
+  ExcludedMethods:
+    - 'initialize/0'  # Exclude parameter-less initialize
+    - '/^_/'          # Exclude private methods (by convention)
+
+Documentation/UndocumentedMethodArguments:
+  Description: 'Checks for method parameters without @param tags.'
+  Enabled: true
+  Severity: error
+
+Documentation/UndocumentedBooleanMethods:
+  Description: 'Checks that question mark methods document their boolean return.'
+  Enabled: true
+  Severity: error
+
+Documentation/UndocumentedOptions:
+  Description: 'Detects methods with options hash parameters but no @option tags.'
+  Enabled: true
+  Severity: error
+
+Documentation/MarkdownSyntax:
+  Description: 'Detects common markdown syntax errors in documentation.'
+  Enabled: true
+  Severity: error
+
+# Tags validators
+Tags/Order:
+  Description: 'Enforces consistent ordering of YARD tags.'
+  Enabled: true
+  Severity: error
+  EnforcedOrder:
+    - param
+    - option
+    - return
+    - raise
+    - example
+
+Tags/InvalidTypes:
+  Description: 'Validates type definitions in @param, @return, @option tags.'
+  Enabled: true
+  Severity: error
+  ValidatedTags:
+    - param
+    - option
+    - return
+
+Tags/TypeSyntax:
+  Description: 'Validates YARD type syntax using YARD parser.'
+  Enabled: true
+  Severity: error
+  ValidatedTags:
+    - param
+    - option
+    - return
+    - yieldreturn
+
+Tags/MeaninglessTag:
+  Description: 'Detects @param/@option tags on classes, modules, or constants.'
+  Enabled: true
+  Severity: error
+  CheckedTags:
+    - param
+    - option
+  InvalidObjectTypes:
+    - class
+    - module
+    - constant
+
+Tags/CollectionType:
+  Description: 'Validates Hash collection syntax consistency.'
+  Enabled: true
+  Severity: error
+  EnforcedStyle: long  # 'long' for Hash{K => V} (YARD standard), 'short' for {K => V}
+  ValidatedTags:
+    - param
+    - option
+    - return
+    - yieldreturn
+
+Tags/TagTypePosition:
+  Description: 'Validates type annotation position in tags.'
+  Enabled: true
+  Severity: error
+  CheckedTags:
+    - param
+    - option
+  # EnforcedStyle: 'type_after_name' (YARD standard: @param name [Type])
+  #                or 'type_first' (@param [Type] name)
+  EnforcedStyle: type_after_name
+
+Tags/ApiTags:
+  Description: 'Enforces @api tags on public objects.'
+  Enabled: false  # Opt-in validator
+  Severity: error
+  AllowedApis:
+    - public
+    - private
+    - internal
+
+Tags/OptionTags:
+  Description: 'Requires @option tags for methods with options parameters.'
+  Enabled: true
+  Severity: error
+
+# Warnings validators - catches YARD parser errors
+Warnings/UnknownTag:
+  Description: 'Detects unknown YARD tags.'
+  Enabled: true
+  Severity: error
+
+Warnings/UnknownDirective:
+  Description: 'Detects unknown YARD directives.'
+  Enabled: true
+  Severity: error
+
+Warnings/InvalidTagFormat:
+  Description: 'Detects malformed tag syntax.'
+  Enabled: true
+  Severity: error
+
+Warnings/InvalidDirectiveFormat:
+  Description: 'Detects malformed directive syntax.'
+  Enabled: true
+  Severity: error
+
+Warnings/DuplicatedParameterName:
+  Description: 'Detects duplicate @param tags.'
+  Enabled: true
+  Severity: error
+
+Warnings/UnknownParameterName:
+  Description: 'Detects @param tags for non-existent parameters.'
+  Enabled: true
+  Severity: error
+
+# Semantic validators
+Semantic/AbstractMethods:
+  Description: 'Ensures @abstract methods do not have real implementations.'
+  Enabled: true
+  Severity: error

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Karafka Framework Changelog
 
+## 2.5.3 (2025-11-14)
+- [Enhancement] Dynamically support `librdkafka` fatal errors with correct reported details.
+- [Enhancement] Add `producer` block API to setup for simplified WaterDrop producer configuration without manual producer instance creation, using a transparent ConfigProxy during setup to avoid polluting the permanent config API.
+- [Change] Require `waterdrop` `>=` `2.8.14` to support new features.
+- [Change] Require `karafka-rdkafka` `>=` `0.23.1` to support new rebalance protocol.
+
 ## 2.5.2 (2025-10-31)
 - **[EOL]** Remove Rails 7.1 support according to EOL while not blocking Rails 7.1 usage.
 - [Enhancement] Retry on the KIP-848 `stale_member_epoch` error.

data/Gemfile

@@ -25,4 +25,5 @@ group :test do
   gem 'factory_bot'
   gem 'ostruct'
   gem 'simplecov'
+  gem 'yard-lint'
 end

data/Gemfile.lock

@@ -1,11 +1,11 @@
 PATH
   remote: .
   specs:
-    karafka (2.5.2)
+    karafka (2.5.3)
       base64 (~> 0.2)
       karafka-core (>= 2.5.6, < 2.6.0)
-      karafka-rdkafka (>= 0.22.0)
-      waterdrop (>= 2.8.9, < 3.0.0)
+      karafka-rdkafka (>= 0.23.1)
+      waterdrop (>= 2.8.14, < 3.0.0)
       zeitwerk (~> 2.3)
 
 GEM
@@ -62,32 +62,32 @@ GEM
     karafka-core (2.5.7)
       karafka-rdkafka (>= 0.20.0)
       logger (>= 1.6.0)
-    karafka-rdkafka (0.22.2)
-      ffi (~> 1.15)
+    karafka-rdkafka (0.23.1)
+      ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.22.2-aarch64-linux-gnu)
-      ffi (~> 1.15)
+    karafka-rdkafka (0.23.1-aarch64-linux-gnu)
+      ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.22.2-arm64-darwin)
-      ffi (~> 1.15)
+    karafka-rdkafka (0.23.1-arm64-darwin)
+      ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.22.2-x86_64-linux-gnu)
-      ffi (~> 1.15)
+    karafka-rdkafka (0.23.1-x86_64-linux-gnu)
+      ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.22.2-x86_64-linux-musl)
-      ffi (~> 1.15)
+    karafka-rdkafka (0.23.1-x86_64-linux-musl)
+      ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
@@ -95,9 +95,9 @@ GEM
     karafka-testing (2.5.4)
       karafka (>= 2.5.0, < 2.6.0)
       waterdrop (>= 2.8.0)
-    karafka-web (0.11.3)
+    karafka-web (0.11.4)
       erubi (~> 1.4)
-      karafka (>= 2.5.0, < 2.6.0)
+      karafka (>= 2.5.2, < 2.6.0)
       karafka-core (>= 2.5.0, < 2.6.0)
       roda (~> 3.68, >= 3.69)
       tilt (~> 2.0)
@@ -107,7 +107,7 @@ GEM
     ostruct (0.6.3)
     raabro (1.4.0)
     rack (3.2.3)
-    rake (13.3.0)
+    rake (13.3.1)
     roda (3.97.0)
       rack
     rspec (3.13.2)
@@ -130,16 +130,20 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    stringio (3.1.7)
+    stringio (3.1.8)
     tilt (2.6.1)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     uri (1.0.4)
     warning (1.5.0)
-    waterdrop (2.8.12)
+    waterdrop (2.8.14)
       karafka-core (>= 2.4.9, < 3.0.0)
-      karafka-rdkafka (>= 0.20.0)
+      karafka-rdkafka (>= 0.23.1)
       zeitwerk (~> 2.3)
+    yard (0.9.37)
+    yard-lint (1.2.3)
+      yard (~> 0.9)
+      zeitwerk (~> 2.6)
     zeitwerk (2.7.3)
 
 PLATFORMS
@@ -168,6 +172,7 @@ DEPENDENCIES
   simplecov
   stringio
   warning
+  yard-lint
 
 BUNDLED WITH
    2.7.1

data/examples/payloads/json/sample_set_03/event_type_1.json

@@ -15,4 +15,4 @@
   "name": "Key",
   "namespace": "production.public.automation_actions",
   "type": "record"
-}
+}

data/examples/payloads/json/sample_set_03/event_type_2.json

@@ -260,4 +260,4 @@
   "name": "Envelope",
   "namespace": "production.public.automation_actions",
   "type": "record"
-}
+}

data/examples/payloads/json/sample_set_03/event_type_3.json

@@ -38,4 +38,4 @@
     },
     "headers": []
   }
-]
+]

data/karafka.gemspec

@@ -23,8 +23,8 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'base64', '~> 0.2'
   spec.add_dependency 'karafka-core', '>= 2.5.6', '< 2.6.0'
-  spec.add_dependency 'karafka-rdkafka', '>= 0.22.0'
-  spec.add_dependency 'waterdrop', '>= 2.8.9', '< 3.0.0'
+  spec.add_dependency 'karafka-rdkafka', '>= 0.23.1'
+  spec.add_dependency 'waterdrop', '>= 2.8.14', '< 3.0.0'
   spec.add_dependency 'zeitwerk', '~> 2.3'
 
   spec.required_ruby_version = '>= 3.2.0'

data/lib/active_job/queue_adapters/karafka_adapter.rb

@@ -21,7 +21,7 @@ module ActiveJob
     # - No Rails: Inherit from Object (standalone ActiveJob usage)
     #
     # @see https://github.com/sidekiq/sidekiq/issues/6746 Similar issue in Sidekiq
-    base = if defined?(Rails) && defined?(Rails::VERSION)
+    base = if defined?(Rails::VERSION)
              (Rails::VERSION::MAJOR == 7 && Rails::VERSION::MINOR < 2 ? Object : AbstractAdapter)
            else
              # Fallback when Rails is not loaded
@@ -31,7 +31,7 @@ module ActiveJob
     # Karafka adapter for enqueuing jobs
     # This is here for ease of integration with ActiveJob.
     class KarafkaAdapter < base
-      include Karafka::Helpers::ConfigImporter.new(
+      include ::Karafka::Helpers::ConfigImporter.new(
         dispatcher: %i[internal active_job dispatcher]
       )
 

data/lib/karafka/active_job/consumer.rb

@@ -5,7 +5,7 @@ module Karafka
   module ActiveJob
     # This is the consumer for ActiveJob that eats the messages enqueued with it one after another.
     # It marks the offset after each message, so we make sure, none of the jobs is executed twice
-    class Consumer < ::Karafka::BaseConsumer
+    class Consumer < Karafka::BaseConsumer
       include Helpers::ConfigImporter.new(
         deserializer: %i[internal active_job deserializer]
       )
@@ -14,7 +14,7 @@ module Karafka
       # @note ActiveJob does not support batches, so we just run one message after another
       def consume
         messages.each do |message|
-          break if Karafka::App.stopping?
+          break if ::Karafka::App.stopping?
 
           consume_job(message)
 

data/lib/karafka/active_job/current_attributes.rb

@@ -23,8 +23,8 @@ module Karafka
           .each { |expandable| expandable.class_attribute :_cattr_klasses, default: {} }
 
         # Do not double inject in case of running persist multiple times
-        Dispatcher.prepend(Persistence) unless Dispatcher.ancestors.include?(Persistence)
-        Consumer.prepend(Loading) unless Consumer.ancestors.include?(Loading)
+        Dispatcher.prepend(Persistence) unless Dispatcher <= Persistence
+        Consumer.prepend(Loading) unless Consumer <= Loading
 
         klasses.map(&:to_s).each do |stringified_klass|
           # Prevent registering same klass multiple times

data/lib/karafka/active_job/deserializer.rb

@@ -43,7 +43,7 @@ module Karafka
       #
       # @param job [ActiveJob::Base, #serialize] job to serialize. The job must respond to
       #   #serialize which returns a Hash of job attributes. When CurrentAttributes are used,
-      #   this may be a JobWrapper instance instead of the original ActiveJob::Base.
+      #   this may be a JobWrapper instance instead of the original ::ActiveJob::Base.
       # @return [String] serialized job payload
       def serialize(job)
         ::ActiveSupport::JSON.encode(job.serialize)

data/lib/karafka/active_job/dispatcher.rb

@@ -19,7 +19,7 @@ module Karafka
 
       # @param job [ActiveJob::Base] job
       def dispatch(job)
-        ::Karafka.producer.public_send(
+        Karafka.producer.public_send(
           fetch_option(job, :dispatch_method, DEFAULTS),
           topic: job.queue_name,
           payload: serialize_job(job)
@@ -43,7 +43,7 @@ module Karafka
         end
 
         dispatches.each do |type, messages|
-          ::Karafka.producer.public_send(
+          Karafka.producer.public_send(
             type,
             messages
           )

data/lib/karafka/admin/configs/resource.rb

@@ -40,10 +40,16 @@ module Karafka
         OPERATIONS_TYPES_MAP.each do |op_name, op_value|
           # Adds an outgoing operation to a given resource of a given type
           # Useful since we alter in batches and not one at a time
+          #
+          # For example, when op_name is :set and op_value is 0:
+          #   def set(name, value)
+          #     @operations[0] << Config.new(name: name, value: value.to_s)
+          #   end
+          default_value = op_name == :delete ? ' = nil' : ''
           class_eval <<~RUBY, __FILE__, __LINE__ + 1
             # @param name [String] name of the config to alter
             # @param value [String] value of the config
-            def #{op_name}(name, value #{op_name == :delete ? ' = nil' : ''})
+            def #{op_name}(name, value#{default_value})
               @operations[#{op_value}] << Config.new(name: name, value: value.to_s)
             end
           RUBY

data/lib/karafka/admin/consumer_groups.rb

@@ -80,15 +80,13 @@ module Karafka
               case casted_position
               # Earliest is not always 0. When compacting/deleting it can be much later, that's why
               # we fetch the oldest possible offset
-              when 'earliest'
+              # false is treated the same as 'earliest'
+              when 'earliest', false
                 LONG_TIME_AGO
               # Latest will always be the high-watermark offset and we can get it just by getting
               # a future position
               when 'latest'
                 Time.now + DAY_IN_SECONDS
-              # Same as `'earliest'`
-              when false
-                LONG_TIME_AGO
               # Regular offset case
               else
                 position
@@ -307,14 +305,14 @@ module Karafka
         # Reads lags and offsets for given topics in the context of consumer groups defined in the
         #   routing
         #
-        # @param consumer_groups_with_topics [Hash<String, Array<String>>] hash with consumer
+        # @param consumer_groups_with_topics [Hash{String => Array<String>}] hash with consumer
         #   groups names with array of topics to query per consumer group inside
         # @param active_topics_only [Boolean] if set to false, when we use routing topics, will
         #   select also topics that are marked as inactive in routing
         #
-        # @return [Hash<String, Hash<Integer, <Hash<Integer>>>>] hash where the top level keys are
-        #   the consumer groups and values are hashes with topics and inside partitions with lags
-        #   and offsets
+        # @return [Hash{String => Hash{Integer => Hash{Integer => Object}}}] hash where the top
+        #   level keys are the consumer groups and values are hashes with topics and inside
+        #   partitions with lags and offsets
         #
         # @note For topics that do not exist, topic details will be set to an empty hash
         #

data/lib/karafka/admin/topics.rb

@@ -36,7 +36,7 @@ module Karafka
 
             # Build the requested range - since first element is on the start offset we need to
             # subtract one from requested count to end up with expected number of elements
-            requested_range = (start_offset..(start_offset + (count - 1)))
+            requested_range = (start_offset..(start_offset + count - 1))
             # Establish theoretical available range. Note, that this does not handle cases related
             # to log retention or compaction
             available_range = (low_offset..(high_offset - 1))
@@ -75,7 +75,7 @@ module Karafka
           # Use topic from routes if we can match it or create a dummy one
           # Dummy one is used in case we cannot match the topic with routes. This can happen
           # when admin API is used to read topics that are not part of the routing
-          topic = ::Karafka::Routing::Router.find_or_initialize_by_name(name)
+          topic = Karafka::Routing::Router.find_or_initialize_by_name(name)
 
           messages.map! do |message|
             Messages::Builders::Message.call(
@@ -143,7 +143,8 @@ module Karafka
         # partitions
         #
         # @param name_or_hash [String, Symbol, Hash] topic name or hash with topics and partitions
-        # @param partition [Integer, nil] partition number (required when first param is topic name)
+        # @param partition [Integer, nil] partition number
+        #   (required when first param is topic name)
         #
         # @return [Array<Integer, Integer>, Hash] when querying single partition returns array with
         #   low and high watermark offsets, when querying multiple returns nested hash
@@ -217,7 +218,7 @@ module Karafka
         # @return [Integer] expected offset
         def resolve_offset(consumer, name, partition, offset)
           if offset.is_a?(Time)
-            tpl = ::Rdkafka::Consumer::TopicPartitionList.new
+            tpl = Rdkafka::Consumer::TopicPartitionList.new
             tpl.add_topic_and_partitions_with_offsets(
               name, partition => offset
             )

data/lib/karafka/admin.rb

@@ -124,13 +124,13 @@ module Karafka
 
       # Reads lags and offsets for given topics in the context of consumer groups defined in the
       #   routing
-      # @param consumer_groups_with_topics [Hash<String, Array<String>>] hash with consumer groups
-      #   names with array of topics to query per consumer group inside
+      # @param consumer_groups_with_topics [Hash{String => Array<String>}] hash with consumer
+      #   groups names with array of topics to query per consumer group inside
       # @param active_topics_only [Boolean] if set to false, when we use routing topics, will
       #   select also topics that are marked as inactive in routing
-      # @return [Hash<String, Hash<Integer, <Hash<Integer>>>>] hash where the top level keys are
-      #   the consumer groups and values are hashes with topics and inside partitions with lags
-      #   and offsets
+      # @return [Hash{String => Hash{Integer => Hash{Integer => Object}}}] hash where the top
+      #   level keys are the consumer groups and values are hashes with topics and inside
+      #   partitions with lags and offsets
       # @see ConsumerGroups.read_lags_with_offsets
       def read_lags_with_offsets(consumer_groups_with_topics = {}, active_topics_only: true)
         ConsumerGroups.read_lags_with_offsets(
@@ -158,7 +158,7 @@ module Karafka
         bind_oauth(bind_id, consumer)
 
         consumer.start
-        proxy = ::Karafka::Connection::Proxy.new(consumer)
+        proxy = Karafka::Connection::Proxy.new(consumer)
         yield(proxy)
       ensure
         # Always unsubscribe consumer just to be sure, that no metadata requests are running
@@ -188,7 +188,7 @@ module Karafka
         bind_oauth(bind_id, admin)
 
         admin.start
-        proxy = ::Karafka::Connection::Proxy.new(admin)
+        proxy = Karafka::Connection::Proxy.new(admin)
         yield(proxy)
       ensure
         admin&.close
@@ -211,7 +211,7 @@ module Karafka
       # @param instance [Rdkafka::Consumer, Rdkafka::Admin] rdkafka instance to be used to set
       #   appropriate oauth token when needed
       def bind_oauth(id, instance)
-        ::Karafka::Core::Instrumentation.oauthbearer_token_refresh_callbacks.add(
+        Karafka::Core::Instrumentation.oauthbearer_token_refresh_callbacks.add(
           id,
           Instrumentation::Callbacks::OauthbearerTokenRefresh.new(
             instance
@@ -224,7 +224,7 @@ module Karafka
       # @param id [String, Symbol] unique (for the lifetime of instance) id that we use for
       #   callback referencing
       def unbind_oauth(id)
-        ::Karafka::Core::Instrumentation.oauthbearer_token_refresh_callbacks.delete(id)
+        Karafka::Core::Instrumentation.oauthbearer_token_refresh_callbacks.delete(id)
       end
 
       # There are some cases where rdkafka admin operations finish successfully but without the
@@ -269,7 +269,7 @@ module Karafka
           # consumer group or do something similar
           .merge!(settings)
           .then { |config| Karafka::Setup::AttributesMap.public_send(type, config) }
-          .then { |config| ::Rdkafka::Config.new(config) }
+          .then { |config| Rdkafka::Config.new(config) }
       end
     end
   end

data/lib/karafka/app.rb

@@ -52,7 +52,7 @@ module Karafka
 
       # Returns current assignments of this process. Both topics and partitions
       #
-      # @return [Hash<Karafka::Routing::Topic, Array<Integer>>]
+      # @return [Hash{Karafka::Routing::Topic => Array<Integer>}]
       def assignments
         Instrumentation::AssignmentsTracker.instance.current
       end
@@ -102,8 +102,8 @@ module Karafka
       #
       # @param contexts [String] librdkafka low level debug contexts for granular debugging
       def debug!(contexts = 'all')
-        logger.level = ::Logger::DEBUG
-        producer.config.logger.level = ::Logger::DEBUG
+        logger.level = Logger::DEBUG
+        producer.config.logger.level = Logger::DEBUG
 
         config.kafka[:debug] = contexts
         producer.config.kafka[:debug] = contexts

data/lib/karafka/base_consumer.rb

@@ -5,7 +5,7 @@ module Karafka
   # Base consumer from which all Karafka consumers should inherit
   class BaseConsumer
     # Allow for consumer instance tagging for instrumentation
-    include ::Karafka::Core::Taggable
+    include Karafka::Core::Taggable
     include Helpers::ConfigImporter.new(
       monitor: %i[monitor]
     )

data/lib/karafka/cli/base.rb

@@ -72,7 +72,7 @@ module Karafka
 
           # All other commands except help and install do require an existing boot file if it was
           # declared
-          raise ::Karafka::Errors::MissingBootFileError, ::Karafka.boot_file
+          raise Karafka::Errors::MissingBootFileError, Karafka.boot_file
         end
 
         # Allows to set options for Thor cli

data/lib/karafka/cli/console.rb

@@ -28,7 +28,7 @@ module Karafka
       def call
         Info.new.call
 
-        command = ::Karafka.rails? ? self.class.rails_console : self.class.console
+        command = Karafka.rails? ? self.class.rails_console : self.class.console
 
         exec "KARAFKA_CONSOLE=true #{command}"
       end