karafka-core 2.5.9 → 2.5.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f40905132baef109ff513aedd80d0be8aa041a4bc44117e2e897e554daa9b47c
-  data.tar.gz: d4fbaeb025d4f79d834aea13f4defd294f7d874c628973ce5279b840b713d006
+  metadata.gz: fe7a4974267a2a3b2b200e0763a13042d98695c0586931d00d0016087bc5dfe2
+  data.tar.gz: a5bdd9235a999028ad120d79c2986e05986ee1b9df8a5de6b813fff634bc5619
 SHA512:
-  metadata.gz: 8ae8c3a4772bb914737111319cab6706a45a6af62826a16cb357d43a7521f0b390e2ab338e2e818c24c738d586d1feb89c18799b055d83ce4f089b9642c36910
-  data.tar.gz: fbeaeac510a0b2ad3ef23cca8d5a5b958a9e6debbe98899fb4590f3a1dbccaec7543fbd58dea66b5cd344a7783b051d4d60398ba370e66d8fb07a2244ad454d0
+  metadata.gz: be10ba6481782906bbb076ea69ab9aa05c80f4c295ce82c2faacc53ee27a8ebd01e4c7a200088205058fda7e7efef494d71ac96492d3cf074f579ea331597148
+  data.tar.gz: a51a53327518e282ab42461fccc3aea78407de1418d97376a64b25dda687b616a54f0c6639b542d0c104534876b1c34d9f7f1434486300c40708f129f03ad267

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Karafka Core Changelog
 
+## 2.5.10 (2026-03-02)
+- [Enhancement] Introduce `MinitestLocator` helper for minitest/spec subject class auto-discovery from test file paths.
+
 ## 2.5.9 (2026-03-02)
 - [Enhancement] Optimize `StatisticsDecorator` to eliminate per-hash Array allocations by using `each_pair` with a per-call pending-writes buffer instead of `current.keys.each`, reducing allocations from tens of thousands to one per call at scale.
 - [Enhancement] Inline `StatisticsDecorator#append` and `#suffix_keys_for` into `#diff` to reduce method call overhead by ~96% (from ~915k to ~39k calls at 6400 partitions).

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    karafka-core (2.5.9)
+    karafka-core (2.5.10)
       karafka-rdkafka (>= 0.20.0)
       logger (>= 1.6.0)
 

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

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module Karafka
+  module Core
+    module Helpers
+      # Minitest/spec extension for the subject class auto-discovery.
+      # It automatically detects the class name that should be described in the given test
+      # based on the test file path.
+      # @example Extend with instantiation and use `describe_current`
+      #   extend Karafka::Core::Helpers::MinitestLocator.new(__FILE__)
+      class MinitestLocator < Module
+        # @param test_helper_file_path [String] path to the test_helper.rb file
+        # @param inflections [Hash{String => String}] optional inflections map
+        def initialize(test_helper_file_path, inflections = {})
+          super()
+          @inflections = inflections
+          @tests_root_dir = ::File.dirname(test_helper_file_path)
+        end
+
+        # Builds needed API
+        # @param minitest_module [Module] module or main object to extend
+        def extended(minitest_module)
+          super
+          this = self
+          # Allows "auto subject" definitions for the `describe` method, as it will figure
+          # out the proper class that we want to describe
+          # @param block [Proc] block with tests
+          minitest_module.define_singleton_method :describe_current do |&block|
+            describe(this.inherited, &block)
+          end
+        end
+
+        # @return [Class] class name for the minitest `describe` method
+        def inherited
+          caller(2..2)
+            .first
+            .split(":")
+            .first
+            .gsub(@tests_root_dir, "")
+            .gsub("_test.rb", "")
+            .split("/")
+            .delete_if(&:empty?)
+            .itself[1..]
+            .join("/")
+            .then { |path| custom_camelize(path) }
+            .then { |string| transform_inflections(string) }
+            .then { |class_name| custom_constantize(class_name) }
+        end
+
+        private
+
+        # @param string [String] string we want to cast
+        # @return [String] string after inflections
+        def transform_inflections(string)
+          string = string.dup
+          @inflections.each { |from, to| string.gsub!(from, to) }
+          string
+        end
+
+        # Custom implementation of camelize without ActiveSupport
+        # @param string [String] underscored string to convert to CamelCase
+        # @return [String] camel-case string
+        def custom_camelize(string)
+          # First, replace slashes with :: for proper namespacing
+          string = string.gsub("/", "::")
+
+          # Then camelize each segment
+          string.gsub(/(?:^|_|::)([a-z])/) do |match|
+            # If it's a namespace separator, keep it and uppercase the following letter
+            if match.include?("::")
+              "::#{match[-1].upcase}"
+            else
+              match[-1].upcase
+            end
+          end
+        end
+
+        # Custom implementation of constantize without ActiveSupport
+        # @param string [String] string representing a constant name
+        # @return [Class, Module] the constant
+        def custom_constantize(string)
+          names = string.split("::")
+          constant = Object
+          regexp = /^[A-Z][a-zA-Z0-9_]*$/
+
+          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)
+
+            # Get the constant from its parent
+            constant = constant.const_get(name)
+          end
+
+          constant
+        rescue NameError => e
+          raise NameError, "Uninitialized constant #{string}: #{e.message}"
+        end
+      end
+    end
+  end
+end

data/lib/karafka/core/version.rb

@@ -4,6 +4,6 @@ module Karafka
   module Core
     # Current Karafka::Core version
     # We follow the versioning schema of given Karafka version
-    VERSION = "2.5.9"
+    VERSION = "2.5.10"
   end
 end

data/test/support/describe_current_helper.rb

@@ -4,55 +4,11 @@
 # Provides `describe_current` that auto-discovers the class under test from file path,
 # `described_class` and `subject` DSL methods.
 
-TESTS_ROOT_DIR = File.expand_path("..", __dir__)
+require "karafka/core/helpers/minitest_locator"
 
-# Top-level method: auto-discovers the class from the caller file path and opens a describe block
-def describe_current(&block)
-  klass = caller(1..1)
-    .first
-    .split(":")
-    .first
-    .gsub(TESTS_ROOT_DIR, "")
-    .gsub("_test.rb", "")
-    .split("/")
-    .delete_if(&:empty?)
-    .itself[1..]
-    .join("/")
-    .then { |path| custom_camelize(path) }
-    .then { |class_name| custom_constantize(class_name) }
-
-  describe(klass, &block)
-end
-
-# Custom implementation of camelize without ActiveSupport
-def custom_camelize(string)
-  string = string.gsub("/", "::")
-
-  string.gsub(/(?:^|_|::)([a-z])/) do |match|
-    if match.include?("::")
-      "::#{match[-1].upcase}"
-    else
-      match[-1].upcase
-    end
-  end
-end
-
-# Custom implementation of constantize without ActiveSupport
-def custom_constantize(string)
-  names = string.split("::")
-  constant = Object
-  regexp = /^[A-Z][a-zA-Z0-9_]*$/
-
-  names.each do |name|
-    raise NameError, "#{name} is not a valid constant name!" unless name.match?(regexp)
-
-    constant = constant.const_get(name)
-  end
-
-  constant
-rescue NameError => e
-  raise NameError, "Uninitialized constant #{string}: #{e.message}"
-end
+extend Karafka::Core::Helpers::MinitestLocator.new(
+  File.expand_path("../test_helper.rb", __dir__)
+)
 
 # Provide `described_class` for minitest/spec — walks the desc hierarchy to find a Class/Module
 module MinitestDescribedClass

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: karafka-core
 version: !ruby/object:Gem::Version
-  version: 2.5.9
+  version: 2.5.10
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -78,6 +78,7 @@ files:
 - lib/karafka/core/contractable/contract.rb
 - lib/karafka/core/contractable/result.rb
 - lib/karafka/core/contractable/rule.rb
+- lib/karafka/core/helpers/minitest_locator.rb
 - lib/karafka/core/helpers/rspec_locator.rb
 - lib/karafka/core/helpers/time.rb
 - lib/karafka/core/instrumentation.rb