rimless 3.2.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e998d6e028c6cfc1661ede44cbe302ad1389a21d1300f1e0380f78e65df27d2a
-  data.tar.gz: 8e101b0dc4deecfe313bd7804cac304ecc1386b0b17c1db8898db1517d5dd502
+  metadata.gz: 5d7d34c4154cca4456eb5e21e165bdcc3206ad9746aba7f6bc2c363e3292a692
+  data.tar.gz: fad1418db344e29e77e2dc7f20d468f31eb2a34d4fe5260e7b18a0120242cd8e
 SHA512:
-  metadata.gz: d07a588b59a74984adcfe0d0c31e7c417fc7ee7817d8970a95e1b3d17b8e9e99225e0824793b650cd8828fd31048710f742305064cb01e2ae7750741d86e7e90
-  data.tar.gz: 68e2ea87932e37f8a03de78a1725800b77991709a900d03d7b2681aaed93269f7dbe02b93cadbceaade7ddb278b71ecacc975e307a51500b5e79448f18ef934f
+  metadata.gz: 3b0619589bb1b8d4c6df09340f6de6956b387858d0d5199f984378ba83cf04520b28d1bc17daa750fe127967c7b40d9ad824a6bbcda15459e0c77d18c7328be9
+  data.tar.gz: dc90562a7a290f6175fe2adae8b07d01b89978c885355f70ff924b21222c23cd5ab62c5e50a9bd86553c92750b4d046a446c6822651c84f72d4cd1e766b04dc2

data/.github/workflows/release.yml

@@ -26,12 +26,12 @@ jobs:
           settings: '${{ github.repository }}'
           target: ci/gem-test
 
-      - name: Install Ruby 3.3
+      - name: Install Ruby 4.0
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.3
+          ruby-version: 4.0
           bundler-cache: true
-          rubygems: '3.7.2'
+          rubygems: '4.0.11'
 
       - name: Switch to SSH remotes for the Git repository
         run: git-ssh-remotes

data/.github/workflows/test.yml

@@ -18,8 +18,8 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: ['3.3', '3.4', '4.0']
-        rails: ['8.0', '8.1']
+        ruby: ['4.0']
+        rails: ['8.1']
     env:
       BUNDLE_GEMFILE: 'gemfiles/rails_${{ matrix.rails }}.gemfile'
     steps:
@@ -36,7 +36,7 @@ jobs:
         with:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
-          rubygems: '3.7.2'
+          rubygems: '4.0.11'
 
       - name: Run the gem tests
         run: make test

data/.rubocop.yml

@@ -17,8 +17,8 @@ AllCops:
   NewCops: enable
   SuggestExtensions: false
   DisplayCopNames: true
-  TargetRubyVersion: 3.3
-  TargetRailsVersion: 8.0
+  TargetRubyVersion: 4.0
+  TargetRailsVersion: 8.1
   Exclude:
     - bin/**/*
     - vendor/**/*

data/Appraisals

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-appraise 'rails-8.0' do
-  gem 'activejob', '~> 8.0.0'
-  gem 'activesupport', '~> 8.0.0'
-end
-
 appraise 'rails-8.1' do
   gem 'activejob', '~> 8.1.0'
   gem 'activesupport', '~> 8.1.0'

data/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 * TODO: Replace this bullet point with an actual description of a change.
 
+### 3.4.0 (4 May 2026)
+
+* Dropped Ruby 3.x and Rails <8.1 support ([#77](https://github.com/hausgold/rimless/pull/77))
+
+### 3.3.0 (16 April 2026)
+
+* Added a new configuration (`avro_deserializer_parse_datetimes`) which allows
+  to configure the default Apache Avro deserializer to automatically parse
+  date/time/datetime's from deeply nested strings (disabled by default for
+  compatibility) ([#76](https://github.com/hausgold/rimless/pull/76))
+
 ### 3.2.0 (7 April 2026)
 
 * Restored non-buffered (`$stdout.sync = true`) logging to stdout ([#75](https://github.com/hausgold/rimless/pull/75))

data/Dockerfile

@@ -1,8 +1,8 @@
-FROM hausgold/ruby:3.3
+FROM hausgold/ruby:4.0
 LABEL org.opencontainers.image.authors="containers@hausgold.de"
 
 # Update system gem
-RUN gem update --system '3.7.2'
+RUN gem update --system '4.0.11'
 
 # Install system packages and the latest bundler
 RUN apt-get update -yqqq && \
@@ -11,7 +11,7 @@ RUN apt-get update -yqqq && \
     ca-certificates \
     bash-completion inotify-tools && \
   echo 'en_US.UTF-8 UTF-8' >> /etc/locale.gen && /usr/sbin/locale-gen && \
-  gem install bundler -v '~> 2.7.2' --no-document --no-prerelease
+  gem install bundler -v '~> 4.0.11' --no-document --no-prerelease
 
 # Add new web user
 RUN mkdir /app && \

data/Makefile

@@ -118,7 +118,7 @@ test-style: \
 test-style-ruby:
 	# Run the static code analyzer (rubocop)
 	@$(call run-shell,$(BUNDLE) exec $(RUBOCOP) -a \
-		|| ($(TEST) $$($(RUBY_VERSION)) != '3.3' && true))
+		|| ($(TEST) $$($(RUBY_VERSION)) != '4.0' && true))
 
 clean:
 	# Clean the dependencies

data/README.md

@@ -322,13 +322,13 @@ architecture looks like this:
               |
               v
   +-----------------------------+
-  | Karafka/Rimless Consumer    |    +--------------------------------------+
-  |   Shares a single consumer  |--->| ActiveJob                            |
-  |   group, multiple processes |    |   Runs the consumer class (children  |
-  +-----------------------------+    |   of Rimless::BaseConsumer) for each |
-                                     |   message (Rimless::ConsumerJob),    |
-                                     |   one message per job                |
-                                     +--------------------------------------+
+  | Karafka/Rimless Consumer    |    +----------------------------------------+
+  |   Shares a single consumer  |--->| ActiveJob                              |
+  |   group, multiple processes |    |   Runs the consumer class (children    |
+  +-----------------------------+    |   of Rimless::Consumer::Base) for each |
+                                     |   message (Rimless::Consumer::Job),    |
+                                     |   one message per job                  |
+                                     +----------------------------------------+
 ```
 
 This architecture allows the consumer process to run mostly non-blocking and

data/doc/kafka-playground/Dockerfile

@@ -2,7 +2,7 @@ FROM hausgold/ruby:4.0
 LABEL org.opencontainers.image.authors="containers@hausgold.de"
 
 # Update system gem
-RUN gem update --system '4.0.9'
+RUN gem update --system '4.0.11'
 
 # Install nodejs 25
 RUN curl -sL https://deb.nodesource.com/setup_25.x | bash -
@@ -14,7 +14,7 @@ RUN apt-get update -yqqq && \
     ca-certificates jq curl cmake \
     bash-completion inotify-tools && \
   echo 'en_US.UTF-8 UTF-8' >> /etc/locale.gen && /usr/sbin/locale-gen && \
-  gem install bundler -v '~> 4.0.9' --no-document --no-prerelease
+  gem install bundler -v '~> 4.0.11' --no-document --no-prerelease
 
 # Install kcat (formerly known as kafkacat)
 RUN curl -sL -o - \

data/doc/kafka-playground/Gemfile.lock

@@ -211,4 +211,4 @@ CHECKSUMS
   zeitwerk (2.7.5) sha256=d8da92128c09ea6ec62c949011b00ed4a20242b255293dd66bf41545398f73dd
 
 BUNDLED WITH
-  4.0.9
+  4.0.11

data/lib/rimless/configuration.rb

@@ -134,6 +134,11 @@ module Rimless
       Rimless::Consumer::AvroDeserializer
     end
 
+    # This configuration allows to configure the default Apache Avro
+    # deserializer to automatically parse date/time/datetime's from deeply
+    # nested strings.
+    config_accessor(:avro_deserializer_parse_datetimes) { false }
+
     # The ActiveJob job queue to use for consuming jobs
     config_accessor(:consumer_job_queue) do
       ENV.fetch(

data/lib/rimless/consumer/app.rb

@@ -118,10 +118,10 @@ module Rimless
       # @param topics [Hash{Hash => Class, Proc}] the topic to consumer mapping
       # @yield the given block on the routing table
       # @return [Rimless::Consumer::App] the application instance for chaining
-      def topics(topics = [], &block)
+      def topics(topics = [], &)
         routes.draw do
           consumer_group(Rimless.configuration.client_id) do
-            instance_exec(&block) if block_given?
+            instance_exec(&) if block_given?
 
             topics.each do |topic_parts, dest_consumer|
               Rimless.consumer.topic_names(topic_parts).each do |topic_name|

data/lib/rimless/consumer/avro_deserializer.rb

@@ -4,6 +4,12 @@ module Rimless
   module Consumer
     # A custom Apache Avro compatible message deserializer.
     class AvroDeserializer
+      # The ISO8601 date/time format
+      ISO_TIME_FORMAT = /\A\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?/m
+
+      # The ISO8601 date format
+      ISO_DATE_FORMAT = /\A\d{4}-\d{2}-\d{2}\Z/m
+
       # Deserialize an Apache Avro encoded Apache Kafka message.
       #
       # @param message [Karafka::Messages::Message] the Karafka message to
@@ -25,6 +31,36 @@ module Rimless
           .then { |data| data.transform_keys { |key| key.delete('\\') } }
           .then { |data| Unsparsify(data, sparse_array: true) }
           .deep_symbolize_keys
+          .then do |obj|
+            # When the configuration says we should not parse datetimes,
+            # we skip further processing
+            next obj \
+              unless Rimless.configuration.avro_deserializer_parse_datetimes
+
+            # Otherwise we parse them
+            parse_timestamps!(obj)
+          end
+      end
+
+      # Search recursively through the given object for ISO date/time string
+      # values and replace them with their parsed date representation. This
+      # works on hashes, arrays, and combinations of this.
+      #
+      # @param value [Mixed] the input to process
+      # @return [Mixed] the processed input
+      def parse_timestamps!(obj)
+        case obj
+        when Hash
+          obj.each { |key, val| obj[key] = parse_timestamps!(val) }
+        when Array
+          obj.each_with_index { |cur, idx| obj[idx] = parse_timestamps!(cur) }
+        when ISO_TIME_FORMAT
+          Time.zone.parse(obj)
+        when ISO_DATE_FORMAT
+          Date.parse(obj)
+        else
+          obj
+        end
       end
     end
   end

data/lib/rimless/extensions/avro_helpers.rb

@@ -23,7 +23,7 @@ module Rimless
         # @param schema [String, Symbol] name of the schema that should be used
         # @param opts [Hash{Symbol => Mixed}] additional options
         # @return [String] the Apache Avro blob
-        def avro_encode(data, schema:, **opts)
+        def avro_encode(data, schema:, **)
           data = avro_sanitize(data)
 
           # When the deep-relative form (+.deep.deep[..]+) is present, we add
@@ -31,7 +31,7 @@ module Rimless
           schema = avro_utils.namespace + schema.to_s \
             if schema.to_s.start_with? '.'
 
-          avro.encode(data, schema_name: schema.to_s, **opts)
+          avro.encode(data, schema_name: schema.to_s, **)
         end
         alias_method :encode, :avro_encode
 
@@ -40,8 +40,8 @@ module Rimless
         # @param data [String] the Apache Avro blob
         # @param opts [Hash{Symbol => Mixed}] additional options
         # @return [Mixed] the decoded data structure
-        def avro_decode(data, **opts)
-          avro.decode(data, **opts).deep_symbolize_keys!
+        def avro_decode(data, **)
+          avro.decode(data, **).deep_symbolize_keys!
         end
         alias_method :decode, :avro_decode
 

data/lib/rimless/extensions/dependencies.rb

@@ -49,7 +49,7 @@ module Rimless
           # for situations like Rails asset precompilations, etc. - on runtime
           # the settings should be available, otherwise the message producing
           # just fails/raise.
-          return if Rimless.configuration.kafka_brokers.empty? \
+          return if Rimless.configuration.kafka_brokers.empty?
             || Rimless.configuration.client_id.blank?
 
           # Register a global waterdrop producer instance

data/lib/rimless/version.rb

@@ -4,8 +4,8 @@
 module Rimless
   # The version of the +rimless+ gem
   # TODO: Change back before release.
-  # VERSION = '3.2.0'
-  VERSION = '3.2.0'
+  # VERSION = '3.4.0'
+  VERSION = '3.4.0'
 
   class << self
     # Returns the version of gem as a string.

data/rimless.gemspec

@@ -33,10 +33,10 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 3.3'
+  spec.required_ruby_version = '>= 4.0'
 
-  spec.add_dependency 'activejob', '>= 8.0'
-  spec.add_dependency 'activesupport', '>= 8.0'
+  spec.add_dependency 'activejob', '>= 8.1'
+  spec.add_dependency 'activesupport', '>= 8.1'
   spec.add_dependency 'avro_turf', '~> 1.20'
   spec.add_dependency 'karafka', '~> 2.5'
   spec.add_dependency 'karafka-testing', '~> 2.5'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rimless
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 3.4.0
 platform: ruby
 authors:
 - Hermann Mayer
@@ -15,28 +15,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '8.1'
 - !ruby/object:Gem::Dependency
   name: avro_turf
   requirement: !ruby/object:Gem::Requirement
@@ -228,7 +228,6 @@ files:
 - doc/upgrade-guide-sources/dep-karafka-2.0.md
 - doc/upgrade-guide-sources/dep-waterdrop-2.8.md
 - docker-compose.yml
-- gemfiles/rails_8.0.gemfile
 - gemfiles/rails_8.1.gemfile
 - lib/rimless.rb
 - lib/rimless/avro_utils.rb
@@ -273,14 +272,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.3'
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.11
 specification_version: 4
 summary: A bundle of opinionated Apache Kafka / Confluent Schema Registry helpers.
 test_files: []

data/gemfiles/rails_8.0.gemfile

@@ -1,24 +0,0 @@
-# This file was generated by Appraisal
-
-source "https://rubygems.org"
-
-gem "appraisal", "~> 2.4"
-gem "bundler", ">= 2.6", "< 5"
-gem "countless", "~> 2.2"
-gem "factory_bot", "~> 6.2"
-gem "guard-rspec", "~> 4.7"
-gem "rake", "~> 13.0"
-gem "redcarpet", "~> 3.5"
-gem "rspec", "~> 3.12"
-gem "rubocop"
-gem "rubocop-rails"
-gem "rubocop-rspec"
-gem "simplecov", ">= 0.22"
-gem "timecop", ">= 0.9.6"
-gem "vcr", "~> 6.0"
-gem "yard", ">= 0.9.28"
-gem "yard-activesupport-concern", ">= 0.0.1"
-gem "activejob", "~> 8.0.0"
-gem "activesupport", "~> 8.0.0"
-
-gemspec path: "../"