karafka-core 2.6.3 → 2.6.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70aa3940193aebd6b4f232950a2b765ee57025aea6b3d3d7c72234429f904de4
-  data.tar.gz: e4a550006b517eea864370ef12534dacdb6fddae40f3adf7308981fa99a1e7a1
+  metadata.gz: 236e0814cbc0a24dc6758f75c71057e7744c0827f1c9cb4b5be5f305bceefc46
+  data.tar.gz: b3d9b8d7b42e9af2aaa2609bd929dab513375aa86ebf49d198c94e11cb81427c
 SHA512:
-  metadata.gz: '05908e99fd999ee007bcb3efd46a6a3b949d88e40d980c5ca4e8aa90a3c312755717dc8feef7a7de42c5c7c235e3ac623e26b91e9a3456568e4d552a2d8782ea'
-  data.tar.gz: 61456523b5822db6c78ad36c839ed6e3bdcbd9bc18d56cebfb95947443296aad94b917b3bef7798f093b471d703ae9d5a7f43d1b09d726ea655e0b2a0b091a3c
+  metadata.gz: e6cabe34dc4bb8449ba87cec2d1dc7d120277fecc771ee7a90509f34454e28705a7ab3e883a68799ac128badd9e5f8ad3d5d6898e2e4d1565568dad3b98f0bb9
+  data.tar.gz: 80072d69c0ae0eb59b933c83d530e3099bf16f16c596b34bdf16c70f0986938c599dbb65c13331c69e7881119cde8c200fc51713729e84a085c15dd6d989fdba

data/.github/workflows/ci.yml

@@ -24,7 +24,6 @@ jobs:
           - '4.0'
           - '3.4'
           - '3.3'
-          - '3.2'
         include:
           - ruby: '4.0'
             coverage: 'true'
@@ -37,7 +36,7 @@ jobs:
         run: "[ -e $APT_DEPS ] || sudo apt-get install -y --no-install-recommends $APT_DEPS"
 
       - name: Set up Ruby
-        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
+        uses: ruby/setup-ruby@651ff0d62c5c79bed6d53ec518387aae20e72c1a # v1.329.0
         with:
           ruby-version: ${{matrix.ruby}}
           bundler: 'latest'
@@ -69,9 +68,9 @@ jobs:
         with:
           fetch-depth: 0
       - name: Set up Ruby
-        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
+        uses: ruby/setup-ruby@651ff0d62c5c79bed6d53ec518387aae20e72c1a # v1.329.0
         with:
-          ruby-version: '4.0.6'
+          ruby-version: '4.0.7'
           bundler-cache: true
       - name: Run rubocop
         run: bundle exec rubocop
@@ -86,9 +85,9 @@ jobs:
         with:
           fetch-depth: 0
       - name: Set up Ruby
-        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
+        uses: ruby/setup-ruby@651ff0d62c5c79bed6d53ec518387aae20e72c1a # v1.329.0
         with:
-          ruby-version: '4.0.6'
+          ruby-version: '4.0.7'
           bundler-cache: true
       - name: Run yard-lint
         run: bundle exec yard-lint lib/
@@ -101,7 +100,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Set up Node.js
-        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
         with:
           node-version: '20'
           cache: 'npm'

data/.github/workflows/push.yml

@@ -24,7 +24,7 @@ jobs:
           fetch-depth: 0
 
       - name: Set up Ruby
-        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
+        uses: ruby/setup-ruby@651ff0d62c5c79bed6d53ec518387aae20e72c1a # v1.329.0
         with:
           bundler-cache: false
 

data/.gitignore

@@ -40,6 +40,7 @@ db/*.sqlite3
 /specifications
 rerun.txt
 pickle-email-*.html
+.codex
 
 # If you find yourself ignoring temporary files generated by your text editor
 # or operating system, you probably want to add a global ignore instead:

data/.rubocop.yml

@@ -11,7 +11,7 @@ inherit_gem:
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 3.2
+  TargetRubyVersion: 3.3
   Include:
     - "**/*.rb"
     - "**/*.gemspec"

data/.ruby-version

@@ -1 +1 @@
-4.0.6
+4.0.7

data/CHANGELOG.md

@@ -1,42 +1,49 @@
 # Karafka Core Changelog
 
+## 2.6.5 (2026-10-19)
+- **[EOL]** Drop Ruby 3.2 support due to EOL; require Ruby 3.3+.
+- [Change] Use the offending value (event id, setting name, class or constant name) as the message of errors raised by `Notifications`, `Configurable::Node`, `Configurable::Importer` and the spec locators.
+
+## 2.6.4 (2026-09-11)
+- [Enhancement] Add `Configurable::Importer`, a subclassable base for injecting memoized config readers into a class via `include` or `extend`.
+
 ## 2.6.3 (2026-08-31)
-- [Enhancement] Add `Configurable::Injector`, a reusable base for injecting default values into a config hash without overwriting user-provided settings, with support for layering extra defaults on top.
+- [Enhancement] Add `Configurable::Injector`, a reusable base for injecting default values into a config hash without overwriting user settings.
 
 ## 2.6.2 (2026-06-29)
-- [Enhancement] Document that a leaf's `default` value is shared by reference across all config instances, so a mutable default (e.g. `default: []`) mutated in place is visible everywhere. Assign it inside a `configure` block if you need a per-instance copy.
-- [Fix] `require "pathname"` explicitly in `lib/karafka-core.rb` (with the other top-level requires). `Karafka::Core.gem_root` returns a `Pathname`, but the gem never required `pathname` -- it only worked because Bundler (or another gem) happened to load it first. In an environment where nothing else loads it, `gem_root` raised `NameError: uninitialized constant Pathname`.
+- [Enhancement] Document that a setting default is shared across all config instances, so a mutable default such as `[]` must not be changed in place.
+- [Fix] Require `pathname` explicitly, so `Karafka::Core.gem_root` no longer raises `NameError` when nothing else loaded it.
 - [Enhancement] Document that a `virtual` rule must return a freshly built `Array` of `[path, message]` error pairs on each call; a memoized, shared or frozen array is unsupported.
-- [Fix] `Configurable::Node#register` raises the documented "already registered" `ArgumentError` for a name already used by an unread lazy-with-constructor setting. The duplicate guard only checked `@configs_refs`, but a lazy setting with a constructor is absent from it until first read, so `register` silently overwrote it; it now checks the defined children.
-- [Fix] `Contractable::Contract.nested` now pops its path in an `ensure`. If the block raised while the contract was being defined and the caller rescued it, the path stayed on the nesting stack and was prefixed onto every rule defined afterwards.
-- [Fix] `Contract#call` no longer raises `NoMethodError` when validating a non-Hash root with a 1-key or 2-key rule path; it reports the path as missing, consistent with the 3+-key path (and the non-Hash intermediate handling added in 2.6.1).
-- [Fix] Honor `excluded_keys` containing `"cgrp"` in `StatisticsDecorator` `only_keys` mode. The `cgrp` branch of the structure-aware fast path lacked the exclusion guard that the `brokers` and `topics` branches have, so excluding the consumer-group subtree still decorated it (inconsistent with the full-decoration path).
-- [Fix] Guard the patched rdkafka error callback against a null client pointer. librdkafka can invoke the error callback with a NULL `rd_kafka_t` (e.g. very early in client construction); calling `rd_kafka_name` on it dereferenced the null pointer and could segfault the process. Mirrors the upstream `ErrorCallback`.
-- [Fix] Resolve fatal errors in the patched rdkafka error callback. `ERR__FATAL` is only a generic marker, so the callback now fetches the real underlying error code and description via `RdkafkaError.build_fatal` (`rd_kafka_fatal_error`) instead of reporting the generic fatal code. Mirrors the upstream `ErrorCallback`.
+- [Fix] `Configurable::Node#register` now raises the documented "already registered" `ArgumentError` for a name used by an unread lazy-with-constructor setting, which it previously overwrote silently.
+- [Fix] Stop a rescued error inside `Contractable::Contract.nested` from prefixing its path onto every rule defined afterwards.
+- [Fix] Report a missing path instead of raising `NoMethodError` when validating a non-Hash root with a 1-key or 2-key rule.
+- [Fix] Honor `excluded_keys` containing `"cgrp"` in `StatisticsDecorator` `only_keys` mode; the `cgrp` branch lacked the exclusion guard its `brokers` and `topics` siblings have.
+- [Fix] Guard the patched rdkafka error callback against a null client pointer, which librdkafka can pass early in client construction and which could segfault the process.
+- [Fix] Resolve fatal errors in the patched rdkafka error callback via `RdkafkaError.build_fatal`, so the real underlying error is reported instead of the generic `ERR__FATAL` marker.
 - [Fix] A lazy setting declared without a constructor (`setting(:x, lazy: true)`) no longer raises when read; it now behaves like a regular setting backed by its default.
-- [Fix] `Contract#call` no longer raises `NoMethodError` when a virtual rule returns `false`. A virtual rule now signals "no errors" with any non-Array result (`true`/`false`/`nil`); only an `Array` of error pairs is collected. Previously a `false` return reached `false.each` (a `nil` return was already tolerated).
-- [Fix] Make `CallbacksManager` thread-safe under concurrent `add`/`delete` during dispatch. A callback registered or removed while callbacks were firing could be lost — kept firing after removal, or never fired after being added. librdkafka fires these from a background thread, so it was reachable in practice.
-- [Fix] Make `Notifications` subscriptions thread-safe: a listener that unsubscribes itself (or another) from within its own handler no longer causes the next listener to be skipped, and concurrent subscribe/unsubscribe during dispatch is now safe.
-- [Fix] Report a freeze duration (`_fd`) of `0` for statistics keys that first appear mid-stream (e.g. a new broker or partition) instead of the time since the previous emission, which was incorrect and made the related spec flaky.
-- [Fix] Make assigning a setting on a frozen `Configurable::Node` atomic. The ivar-backed writer evaluated `@configs_refs[name] = value` before `instance_variable_set`, so a frozen node mutated the canonical store and only then raised `FrozenError`, leaving the store and the ivar-backed reader permanently out of sync. It now raises before touching any state.
-- [Fix] `Configurable::Node#to_h` no longer raises for a setting using the `->(default) { ... }` constructor form when its value has not been set yet (e.g. `#to_h` on an unconfigured instance or an unread lazy setting).
-- [Fix] Honor `excluded_keys` inside `StatisticsDecorator` `only_keys` decoration. A key listed in both `only_keys` and `excluded_keys` was still decorated because the direct-access decoration loop never consulted `excluded_keys`; exclusion now wins, matching the full-decoration path.
-- [Fix] Strip the tests/specs root directory as an anchored prefix (`sub(/\A.../)`) instead of a global `gsub` in `MinitestLocator` and `RSpecLocator`. When the root directory string recurred later in a test/spec file path, the global replace removed every occurrence and corrupted the derived subject class path; only the leading prefix is now removed.
+- [Fix] Stop `Contract#call` from raising `NoMethodError` when a virtual rule returns `false`.
+- [Fix] Make `CallbacksManager` thread-safe under concurrent `add`/`delete` during dispatch, so a callback registered or removed while callbacks were firing is no longer lost.
+- [Fix] Make `Notifications` subscriptions thread-safe, so a listener unsubscribing during dispatch no longer causes the next listener to be skipped.
+- [Fix] Report a freeze duration (`_fd`) of `0` for statistics keys that first appear mid-stream.
+- [Fix] Stop an assignment on a frozen `Configurable::Node` from leaving the setting in an inconsistent state.
+- [Fix] Stop `Configurable::Node#to_h` from raising for an unset setting that uses the `->(default) { ... }` constructor form.
+- [Fix] Honor `excluded_keys` when combined with `only_keys` in `StatisticsDecorator`.
+- [Fix] Fix subject path detection in `MinitestLocator` and `RSpecLocator` when the tests root name repeats later in the path.
 
 ## 2.6.1 (2026-06-15)
 - [Enhancement] Speed up `Contract#call` by ~1.25–1.4x, the per-message validation path in WaterDrop producers.
-- [Fix] `Contract#call` with rule paths of 3+ keys no longer raises `NoMethodError` when an intermediate value is not a `Hash` and reports the path as missing instead, consistent with the 2-key path behavior.
-- [Change] Reject reserved setting names with an `ArgumentError` in `Configurable::Node#setting` and `#register`: internal state names (`node_name`, `children`, `nestings`, `compiled`, `configs_refs`, `local_defs`) and the node public API names (`setting`, `configure`, `to_h`, `deep_dup`, `register`, `compile`). Previously such names silently shadowed the node own accessors, breaking `deep_dup` or `to_h`, and assignments like `config.children = value` corrupted the node internal state.
+- [Fix] Report a missing path instead of raising `NoMethodError` when a 3+ key rule path meets a non-Hash intermediate value.
+- [Change] Reject reserved setting names in `Configurable::Node#setting` and `#register` with an `ArgumentError`, since they could corrupt the node state.
 - [Enhancement] Speed up `Monitor#instrument` dispatch (~1.2x) on the common no-subscribers path.
 - [Enhancement] Speed up `Configurable::Node` settings reads (~1.4x flat, ~1.6x nested) on hot paths.
-- [Enhancement] Instantiate each `Configurable::Node` through a per-layout anonymous subclass so the ivar-backed settings do not grow object shape variations on the shared `Node` class (which would degrade ivar access and trigger Ruby performance warnings). `deep_dup` reuses the template's subclass, so duplicated configs share object shapes.
-- [Fix] Symbolize setting names at definition time (`setting`, same as `register`) and on config store writes so `String` setting names work end to end (accessors, `#to_h`, recompilation state) and cannot corrupt node internal state when matching reserved internal names (previously string-named settings were quietly broken as accessors and the store disagreed on the key type).
-- [Change] Config nodes are now instances of anonymous `Node` subclasses: `is_a?(Karafka::Core::Configurable::Node)` still holds, but `instance_of?(Node)` is now `false` and `node.class.name` is `nil`.
+- [Enhancement] Reduce object shape variations of config nodes by giving each settings layout its own anonymous `Node` subclass.
+- [Fix] Symbolize setting names at definition time and on config store writes, so `String` setting names work end to end and cannot corrupt node internal state when they match reserved internal names.
+- [Change] Config nodes are instances of anonymous `Node` subclasses: `is_a?(Karafka::Core::Configurable::Node)` still holds, but `instance_of?(Node)` is `false` and `node.class.name` is `nil`.
 - [Change] Assigning a setting on a frozen config node now raises `FrozenError` (previously the write silently mutated internal storage despite the freeze).
 
 ## 2.6.0 (2026-06-10)
 - [Enhancement] Add `Node#register` to allow runtime key-value registration on compiled nodes without going through the static `setting` DSL. Useful for dynamic registries (e.g. named clusters) where setting names are not known at class-load time.
-- [Enhancement] Replace version-gated `Warning[:performance]` with a `Warning.categories`-based loop that enables all opt-in Ruby warning categories automatically, picking up new categories (e.g. `strict_unused_block` in Ruby 3.4+) without future patches.
+- [Enhancement] Enable all opt-in Ruby warning categories via `Warning.categories`, so new ones (e.g. `strict_unused_block` in Ruby 3.4+) are picked up automatically.
 
 ## 2.5.13 (2026-04-08)
 - [Enhancement] Extract `decorate_partitions` method from `StatisticsDecorator` to allow subclasses to filter which partitions are decorated (e.g. skip unassigned partitions in a consumer context).
@@ -52,10 +59,10 @@
 - [Enhancement] Cache a frozen success `Result` singleton via `Result.success` to eliminate 1 object allocation per successful `Contract#call` on the happy path.
 - [Enhancement] Skip nestings block re-evaluation in `Node#deep_dup` to avoid recreating children that are immediately overwritten, yielding ~14x faster deep_dup and reducing allocations from ~620 to ~66 objects for large configs.
 - [Enhancement] Cache `CallbacksManager#call` values snapshot and invalidate on `add`/`delete` to avoid allocating a new Array on every invocation while preserving thread-safety snapshot semantics, saving 1 Array allocation per call.
-- [Enhancement] Store execution time separately in `Event` and build the merged payload hash lazily on `#payload` access, eliminating 1 Hash allocation per `Notifications#instrument` call when listeners use `#[]` access (the common pattern), yielding ~1.7x faster event dispatch.
+- [Enhancement] Build the `Event` payload hash lazily on `#payload` access, saving one Hash allocation per `Notifications#instrument` call with `#[]` access, for ~1.7x faster event dispatch.
 - [Enhancement] Replace `StatisticsDecorator#diff` pending-writes buffer with `keys.each` direct-write iteration, eliminating the buffer and write-back loop for ~13% faster decoration at scale (10 brokers, 20 topics, 2000 partitions).
 - [Enhancement] Reorder `StatisticsDecorator#diff` type checks to test `Numeric` before `Hash`, matching the ~80% numeric value distribution in librdkafka statistics.
-- [Enhancement] Support `only_keys` option in `StatisticsDecorator` to decorate only specified numeric keys (e.g. `consumer_lag`, `committed_offset`). When combined with `excluded_keys`, reduces decoration cost from ~80ms to ~8.5ms per call on large clusters (10 brokers, 20 topics, 2000 partitions) by using structure-aware navigation of the librdkafka statistics tree and direct key access instead of full-hash iteration.
+- [Enhancement] Support an `only_keys` option in `StatisticsDecorator` to decorate only the listed numeric keys. With `excluded_keys`, this cuts decoration cost from ~80ms to ~8.5ms per call on large clusters.
 - [Enhancement] Cache `Tags#to_a` values array and invalidate on `add`/`delete`/`clear` to avoid allocating a new Array and running `uniq` on every call, yielding ~7x faster reads at 5 tags and ~28x faster at 20 tags.
 
 ## 2.5.10 (2026-03-02)
@@ -177,7 +184,7 @@
 
 ## 2.2.1 (2023-09-10)
 - Optimize statistics decorator by minimizing number of new objects created.
-- Expand the decoration to include new value `_fd` providing freeze duration in milliseconds. This value informs us for how many consecutive ms the given value did not change. It can be useful for detecting values that should change once in a while but are stale.
+- Expand the decoration with the `_fd` value: the freeze duration in milliseconds, showing how long a value has not changed. Useful to detect stale values.
 
 ## 2.2.0 (2023-09-01)
 - [Maintenance] Update the signing cert (old expired)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    karafka-core (2.6.3)
+    karafka-core (2.6.5)
       karafka-rdkafka (>= 0.20.0)
       logger (>= 1.6.0)
 
@@ -22,39 +22,39 @@ GEM
     ffi (1.17.4-x86_64-darwin)
     ffi (1.17.4-x86_64-linux-gnu)
     ffi (1.17.4-x86_64-linux-musl)
-    io-console (0.8.2)
-    json (2.21.2)
-    karafka-rdkafka (0.28.0)
+    io-console (0.9.4)
+    json (3.0.2)
+    karafka-rdkafka (0.30.2)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.28.0-aarch64-linux-gnu)
+    karafka-rdkafka (0.30.2-aarch64-linux-gnu)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.28.0-aarch64-linux-musl)
+    karafka-rdkafka (0.30.2-aarch64-linux-musl)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.28.0-arm64-darwin)
+    karafka-rdkafka (0.30.2-arm64-darwin)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.28.0-x86_64-linux-gnu)
+    karafka-rdkafka (0.30.2-x86_64-linux-gnu)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
       mini_portile2 (~> 2.6)
       rake (> 12)
-    karafka-rdkafka (0.28.0-x86_64-linux-musl)
+    karafka-rdkafka (0.30.2-x86_64-linux-musl)
       ffi (~> 1.17.1)
       json (> 2.0)
       logger
@@ -67,9 +67,9 @@ GEM
       prism (~> 1.5)
     prism (1.9.0)
     rake (13.4.2)
-    reline (0.6.3)
+    reline (0.7.0)
       io-console (~> 0.5)
-    simplecov (1.1.1)
+    simplecov (1.3.2)
     warning (1.6.0)
 
 PLATFORMS

data/README.md

@@ -1,9 +1,9 @@
+# Karafka-Core
+
 [![Build Status](https://github.com/karafka/karafka-core/actions/workflows/ci.yml/badge.svg)](https://github.com/karafka/karafka-core/actions/workflows/ci.yml)
-[![Gem Version](https://badge.fury.io/rb/karafka-core.svg)](http://badge.fury.io/rb/karafka-core)
+[![Gem Version](https://badge.fury.io/rb/karafka-core.svg)](https://badge.fury.io/rb/karafka-core)
 [![Join the chat at https://slack.karafka.io](https://raw.githubusercontent.com/karafka/misc/master/slack.svg)](https://slack.karafka.io)
 
-## Karafka-Core
-
 Karafka-Core contains toolset of small support modules used throughout the [Karafka](https://github.com/karafka/karafka/) ecosystem.
 
 It includes:

data/karafka-core.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "karafka-rdkafka", ">= 0.20.0"
   spec.add_dependency "logger", ">= 1.6.0"
 
-  spec.required_ruby_version = ">= 3.2.0"
+  spec.required_ruby_version = ">= 3.3.0"
 
   spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test)/}) }
   spec.require_paths = %w[lib]

data/lib/karafka/core/configurable/importer.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+module Karafka
+  module Core
+    module Configurable
+      # Base class for config importers.
+      #
+      # An importer builds memoized config readers on a target, so a class can read a few config
+      # values under short, local names instead of spelling out the full config path at every
+      # call site.
+      #
+      # The config root is not hardcoded and is not passed per use site: it is defined once, by
+      # overriding {root} in a subclass. Each consumer therefore ships one importer subclass
+      # pointing at its own config tree (e.g. `Karafka::App.config` or `Karafka::Web.config`),
+      # and every use site only names the attributes it wants.
+      #
+      # {root} is a method rather than a stored config object, so it is resolved lazily, on the
+      # first read of a given attribute. That matters because importers are typically built while
+      # a class body is being loaded, which is usually before the config itself has been set up.
+      #
+      # Each attribute is memoized per target, so the path is walked only once and every later
+      # read is a plain instance variable lookup. Memoization is `||=`-based, so an attribute
+      # whose configured value is `nil` or `false` is re-read on each call.
+      #
+      # @example Define the importer once, with the root
+      #   module Karafka
+      #     module Web
+      #       module Helpers
+      #         class ConfigImporter < Karafka::Core::Configurable::Importer
+      #           class << self
+      #             def root
+      #               Karafka::Web.config
+      #             end
+      #           end
+      #         end
+      #       end
+      #     end
+      #   end
+      #
+      # @example Import instance-level readers
+      #   class LagStats
+      #     include Karafka::Web::Helpers::ConfigImporter.new(
+      #       skew_threshold: %i[ui health lags skew_threshold]
+      #     )
+      #
+      #     def skewed?(lag)
+      #       lag > skew_threshold
+      #     end
+      #   end
+      #
+      # @example Import class-level readers
+      #   class Message
+      #     extend Karafka::Web::Helpers::ConfigImporter.new(per_page: %i[ui per_page])
+      #   end
+      #
+      #   Message.per_page
+      #
+      # @example Import the whole config root under `#config` (the default)
+      #   class Consumer
+      #     include Karafka::Web::Helpers::ConfigImporter.new
+      #   end
+      #
+      # @note The base class defines no root of its own; it is not useful directly and is expected
+      #   to be subclassed. Reading an attribute off an importer whose class defines no {root}
+      #   raises `NotImplementedError`.
+      #
+      # @note The readers are defined directly on the target, so an attribute name that collides
+      #   with an existing method silently replaces it.
+      class Importer < Module
+        # Default attributes map, exposing the whole config root under `#config`.
+        DEFAULT_ATTRIBUTES = { config: %i[itself] }.freeze
+
+        private_constant :DEFAULT_ATTRIBUTES
+
+        class << self
+          # @return [Object] config root the attribute paths are resolved against. Override in
+          #   subclasses; the base class defines none. Called on each memoization miss rather
+          #   than when the importer is built, so it may safely reference a config that does not
+          #   exist yet at load time.
+          # @raise [NotImplementedError] when called on a class that does not define a root
+          def root
+            raise(NotImplementedError, self)
+          end
+        end
+
+        # @param attributes [Hash{Symbol => Array<Symbol>}] map defining what to import. The key
+        #   is the name the reader will be available under and the value is the path to the
+        #   attribute, relative to the root, as an array of message names.
+        def initialize(attributes = DEFAULT_ATTRIBUTES)
+          super()
+          @attributes = attributes
+        end
+
+        # @return [Object] config root this importer resolves against, as defined by its class
+        def root
+          self.class.root
+        end
+
+        # Defines the readers as instance methods on the target.
+        #
+        # @param model [Object] object to which we want to add the config fetchers
+        # @return [void]
+        def included(model)
+          super
+
+          define_readers(model, :define_method)
+        end
+
+        # Defines the readers as class-level methods on the target.
+        #
+        # @param model [Object] object to which we want to add the config fetchers on a class
+        #   level
+        # @return [void]
+        def extended(model)
+          super
+
+          define_readers(model, :define_singleton_method)
+        end
+
+        private
+
+        # Defines one memoized reader per configured attribute on the target.
+        #
+        # @param model [Object] object the readers are defined on
+        # @param definer [Symbol] method used to define them, either `:define_method` for
+        #   instance-level readers or `:define_singleton_method` for class-level ones
+        # @return [void]
+        def define_readers(model, definer)
+          importer = self
+
+          @attributes.each do |name, path|
+            ivar = :"@#{name}"
+
+            model.public_send(definer, name) do
+              instance_variable_get(ivar) || instance_variable_set(
+                ivar,
+                path.reduce(importer.root) { |node, part| node.public_send(part) }
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/karafka/core/configurable/node.rb

@@ -192,7 +192,7 @@ module Karafka
           # is not written to @configs_refs until first read, so a `@configs_refs.key?` guard
           # alone would silently overwrite it instead of raising the documented error.
           if @children.any? { |child| child.node_name == name }
-            raise ArgumentError, "#{name} is already registered"
+            raise ArgumentError, name
           end
 
           leaf = Leaf.new(name, value, nil, true, false)
@@ -360,7 +360,7 @@ module Karafka
         def prevent_reserved_names!(name)
           return unless RESERVED_NAMES.key?(name)
 
-          raise ArgumentError, "#{name} is a reserved name and cannot be used as a setting name"
+          raise ArgumentError, name
         end
       end
     end

data/lib/karafka/core/contractable/contract.rb

@@ -105,7 +105,7 @@ module Karafka
         # @param data [Hash] hash with data we want to validate
         # @param scope [Array<String>] scope of this contract (if any) or empty array if no parent
         #   scope is needed if contract starts from root
-        # @return [Result] validaton result
+        # @return [Result] validation result
         def call(data, scope: EMPTY_ARRAY)
           errors = []
 
@@ -153,6 +153,8 @@ module Karafka
           Result.new(errors, self)
         end
 
+        # Runs the validation like `#call`, but raises instead of returning a failed `Result`
+        #
         # @param data [Hash] data for validation
         # @param error_class [Class] error class that should be used when validation fails
         # @param scope [Array<String>] scope of this contract (if any) or empty array if no parent
@@ -182,7 +184,7 @@ module Karafka
         #
         # @param data [Hash]
         # @param keys [Array<Symbol>]
-        # @return [DIG_MISS, Object] found element or DIGG_MISS indicating that not found
+        # @return [DIG_MISS, Object] found element or DIG_MISS indicating that not found
         def dig(data, keys)
           case keys.length
           when 1

data/lib/karafka/core/contractable/result.rb

@@ -3,7 +3,7 @@
 module Karafka
   module Core
     module Contractable
-      # Representation of a validaton result with resolved error messages
+      # Representation of a validation result with resolved error messages
       class Result
         attr_reader :errors
 

data/lib/karafka/core/helpers/minitest_locator.rb

@@ -85,15 +85,15 @@ module Karafka
 
           names.each do |name|
             # Make sure we're dealing with a valid constant name
-            raise NameError, "#{name} is not a valid constant name!" unless name.match?(regexp)
+            raise NameError, name unless name.match?(regexp)
 
             # Get the constant from its parent
             constant = constant.const_get(name)
           end
 
           constant
-        rescue NameError => e
-          raise NameError, "Uninitialized constant #{string}: #{e.message}"
+        rescue NameError
+          raise NameError, string
         end
       end
     end

data/lib/karafka/core/helpers/rspec_locator.rb

@@ -88,15 +88,15 @@ module Karafka
 
           names.each do |name|
             # Make sure we're dealing with a valid constant name
-            raise NameError, "#{name} is not a valid constant name!" unless name.match?(regexp)
+            raise NameError, name unless name.match?(regexp)
 
             # Get the constant from its parent
             constant = constant.const_get(name)
           end
 
           constant
-        rescue NameError => e
-          raise NameError, "Uninitialized constant #{string}: #{e.message}"
+        rescue NameError
+          raise NameError, string
         end
       end
     end

data/lib/karafka/core/helpers/time.rb

@@ -6,16 +6,9 @@ module Karafka
     module Helpers
       # Time related methods used across Karafka
       module Time
-        if RUBY_VERSION >= "3.2"
-          # @return [Float] current monotonic time in milliseconds
-          def monotonic_now
-            ::Process.clock_gettime(::Process::CLOCK_MONOTONIC, :float_millisecond)
-          end
-        else
-          # @return [Float] current monotonic time in milliseconds
-          def monotonic_now
-            ::Process.clock_gettime(::Process::CLOCK_MONOTONIC) * 1_000
-          end
+        # @return [Float] current monotonic time in milliseconds
+        def monotonic_now
+          ::Process.clock_gettime(::Process::CLOCK_MONOTONIC, :float_millisecond)
         end
 
         # @return [Float] current time in float

data/lib/karafka/core/monitoring/monitor.rb

@@ -9,7 +9,7 @@ module Karafka
       # It provides abstraction layer that allows us to use both our internal notifications as well
       # as `ActiveSupport::Notifications`.
       class Monitor
-        # Empty has to save on objects allocation
+        # Empty hash to save on objects allocation
         EMPTY_HASH = {}.freeze
 
         private_constant :EMPTY_HASH

data/lib/karafka/core/monitoring/notifications.rb

@@ -60,7 +60,7 @@ module Karafka
               return
             end
 
-            raise(EventNotRegistered, "#{event_id} not registered!")
+            raise(EventNotRegistered, event_id)
           end
         end
 

data/lib/karafka/core/patches/rdkafka/bindings.rb

@@ -13,7 +13,7 @@ module Karafka
             # Add extra methods that we need
             # @param mod [::Rdkafka::Bindings] rdkafka bindings module
             def included(mod)
-              # Default rdkafka setup for errors doest not propagate client details, thus it always
+              # Default rdkafka setup for errors does not propagate client details, thus it always
               # publishes all the stuff for all rdkafka instances. We change that by providing
               # function that fetches the instance name, allowing us to have better notifications
               mod.send(:remove_const, :ErrorCallback)

data/lib/karafka/core/version.rb

@@ -3,6 +3,6 @@
 module Karafka
   module Core
     # Current Karafka::Core version. We follow the versioning schema of given Karafka version
-    VERSION = "2.6.3"
+    VERSION = "2.6.5"
   end
 end

data/lib/karafka-core.rb

@@ -16,6 +16,7 @@ require "karafka/core/configurable"
 require "karafka/core/configurable/leaf"
 require "karafka/core/configurable/node"
 require "karafka/core/configurable/injector"
+require "karafka/core/configurable/importer"
 require "karafka/core/contractable/contract"
 require "karafka/core/contractable/result"
 require "karafka/core/contractable/rule"

data/package-lock.json

@@ -103,9 +103,9 @@
       }
     },
     "node_modules/fastq": {
-      "version": "1.20.1",
-      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz",
-      "integrity": "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==",
+      "version": "1.20.3",
+      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.3.tgz",
+      "integrity": "sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==",
       "dev": true,
       "license": "ISC",
       "dependencies": {
@@ -286,9 +286,9 @@
       }
     },
     "node_modules/smol-toml": {
-      "version": "1.7.1",
-      "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.7.1.tgz",
-      "integrity": "sha512-PPlsspAZ4jbMBu5DMFhfUGDQLu/vrL4SyBROVS37x8ynnVmFIs1VPBz1Co8Xks3TvpIaZXmU85y4DrQ+UyVFoQ==",
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.9.0.tgz",
+      "integrity": "sha512-hpd+HLON7HdZXqYchMM/+LaTTbdK0AU3NngIJ4KVyWbY9bfQqdL9cD+4yf6dUoU2Ap4VsU0JkQi6FxAI1B2mXQ==",
       "dev": true,
       "license": "BSD-3-Clause",
       "engines": {
@@ -312,9 +312,9 @@
       }
     },
     "node_modules/yaml": {
-      "version": "2.9.0",
-      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz",
-      "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==",
+      "version": "2.9.1",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.1.tgz",
+      "integrity": "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==",
       "dev": true,
       "license": "ISC",
       "bin": {

data/renovate.json

@@ -1,4 +1,7 @@
 {
+  "bundler": {
+    "managerFilePatterns": ["/(^|/)Gemfile\\.lint$/"]
+  },
   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
   "extends": [
     "config:recommended"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: karafka-core
 version: !ruby/object:Gem::Version
-  version: 2.6.3
+  version: 2.6.5
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -72,6 +72,7 @@ files:
 - lib/karafka-core.rb
 - lib/karafka/core.rb
 - lib/karafka/core/configurable.rb
+- lib/karafka/core/configurable/importer.rb
 - lib/karafka/core/configurable/injector.rb
 - lib/karafka/core/configurable/leaf.rb
 - lib/karafka/core/configurable/node.rb
@@ -114,14 +115,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Karafka ecosystem core modules
 test_files: []