rimless 3.2.0 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e998d6e028c6cfc1661ede44cbe302ad1389a21d1300f1e0380f78e65df27d2a
-  data.tar.gz: 8e101b0dc4deecfe313bd7804cac304ecc1386b0b17c1db8898db1517d5dd502
+  metadata.gz: 8b258d50dc6020e58639709dda7cc93bcc0deaf96d53defd689bcc10ae270041
+  data.tar.gz: 82f0ef8f8bed2b01f4fc2577c7a1ca84b13da5526420f264f5d13cbb9afd7af8
 SHA512:
-  metadata.gz: d07a588b59a74984adcfe0d0c31e7c417fc7ee7817d8970a95e1b3d17b8e9e99225e0824793b650cd8828fd31048710f742305064cb01e2ae7750741d86e7e90
-  data.tar.gz: 68e2ea87932e37f8a03de78a1725800b77991709a900d03d7b2681aaed93269f7dbe02b93cadbceaade7ddb278b71ecacc975e307a51500b5e79448f18ef934f
+  metadata.gz: ad93ec539b08cfa0b34daf4cb426a2da1c6c781fa0779e256600a60420536239b83d194ff5a58cfce8f066a4fe644869367bd510c710f86ce8be62fec2e43776
+  data.tar.gz: 1ce1a114e929c2b5fb219343bd42dd44efccd3aa893b9de96445876c94a0f9eb6c80e3aa133e7cf6d1e3b4bb1c710297ad5f12cb313146ad654d23a404d9c8fa

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 * TODO: Replace this bullet point with an actual description of a change.
 
+### 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/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/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/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/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.3.0'
+  VERSION = '3.3.0'
 
   class << self
     # Returns the version of gem as a string.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rimless
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 3.3.0
 platform: ruby
 authors:
 - Hermann Mayer