philiprehberger-log_filter 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2ec105d85156aebf2097c6c73be344c4b9247897bb6fb32b9c90e87c4f7ab6e
-  data.tar.gz: 6c5bcfde597acdfb0627c8c246ca7cda3319ec7d82c077292db1deed05c6921a
+  metadata.gz: d87e6f862d6fe0d39c516f49c18c2aecf3917d28fbfb9a074a0f9a06ce627c33
+  data.tar.gz: c3e42d136400a6a0c54f8ff7b342a9340c0b34171e368718236c1043858a32bf
 SHA512:
-  metadata.gz: f91e15c938b5b48ce92d9d1563046f2493774d4e23e3a09b091dcd7febaeef0492daae13061c6b50c3277b90bef2192b09ec3bbdc63ebf163426863b6952ba34
-  data.tar.gz: 03dad2354f01da5eb2a0339c25731b82b6d7c1e5b2557d092ac17c1952148d9d44c5dd85b75621a31aea1ee86ad542918a4e2e26fefdae8be4e468a6c442abb4
+  metadata.gz: 884ed562f6e2f290dcb92689273bc9785db1a7523b3da0c139e70e10c774e9558fc0840e8d1664ffacd48a2706a2b037cf0c4ac7cb9d71cbfdc76e9c03db8253
+  data.tar.gz: da68ea62830a8e198194bd13daaaf9a4604fcec21284597f0b21e2de13bb32d2f1e493b349a2a360e5e07368814c2794d8f24055e025dccaaffa882aaa3d1b65

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-17
+
+### Added
+- `Filter#chain(other)` composes two filters into a new filter that pipes events through both in order (drops short-circuit)
+
 ## [0.2.1] - 2026-03-31
 
 ### Changed

data/README.md

@@ -114,6 +114,30 @@ filter.apply('{"user":"alice","password":"secret","ssn":"123-45-6789"}')
 filter.apply("plain text log line")  # => "plain text log line"
 ```
 
+### Chaining filters
+
+Compose two filters into a new filter whose `apply` pipes each event through
+the first filter and then through the second. If the first filter drops the
+event (returns `nil`), the second is skipped. Composition is associative, so
+`a.chain(b).chain(c)` works as expected.
+
+```ruby
+require "philiprehberger/log_filter"
+
+redact = Philiprehberger::LogFilter::Filter.new
+  .replace(/password=\S+/, "password=[REDACTED]")
+
+drop_debug = Philiprehberger::LogFilter::Filter.new
+  .drop(/DEBUG/)
+
+pipeline = drop_debug.chain(redact)
+
+pipeline.apply("DEBUG noise")                     # => nil (dropped by first filter)
+pipeline.apply("login password=abc123")           # => "login password=[REDACTED]"
+```
+
+The chained filter tracks its own `stats` independently of the source filters.
+
 ### Filter Statistics
 
 ```ruby
@@ -144,6 +168,7 @@ filter.stats  # => { dropped: 0, passed: 0, replaced: 0, sampled: 0 }
 | `Filter#drop_field(key)` | Remove a field from JSON log messages; returns self |
 | `Filter#mask_field(key, with:)` | Mask a field value in JSON log messages; returns self |
 | `Filter#apply(message)` | Run all rules; returns transformed string or nil |
+| `Filter#chain(other)` | Compose with another filter; returns a new filter piping events through both |
 | `Filter#stats` | Return counters: dropped, passed, replaced, sampled |
 | `Filter#reset_stats!` | Zero all statistics counters |
 | `Wrapper.new(logger, filter)` | Wrap a Logger with a filter |

data/lib/philiprehberger/log_filter/filter.rb

@@ -121,6 +121,27 @@ module Philiprehberger
         result
       end
 
+      # Compose this filter with +other+ into a new filter.
+      #
+      # The returned filter's +apply+ runs +self.apply+ first and passes the
+      # result through +other.apply+. If the first filter drops the message
+      # (returns +nil+), the second filter is not invoked and the chained
+      # apply returns +nil+. Composition is associative, so
+      # +a.chain(b).chain(c)+ behaves transitively.
+      #
+      # The chained filter tracks its own +stats+ independently of the two
+      # source filters; each source filter continues to track its own
+      # counters when invoked.
+      #
+      # @param other [Filter] the filter to run after this one
+      # @return [Filter] a new filter composing +self+ and +other+
+      # @raise [ArgumentError] if +other+ is not a {Filter}
+      def chain(other)
+        raise ArgumentError, 'other must be a Philiprehberger::LogFilter::Filter' unless other.is_a?(Filter)
+
+        ChainedFilter.new(self, other)
+      end
+
       private
 
       # @param stat [Symbol] the stat key to increment
@@ -205,5 +226,42 @@ module Philiprehberger
         nil
       end
     end
+
+    # A filter produced by {Filter#chain} that pipes events through two
+    # source filters in order. Tracks its own stats independently of the
+    # inputs. Short-circuits when the first filter drops the event.
+    #
+    # @api private
+    class ChainedFilter < Filter
+      # @param first [Filter] the filter to run first
+      # @param second [Filter] the filter to run on +first+'s output
+      def initialize(first, second)
+        super()
+        @first = first
+        @second = second
+      end
+
+      # Run +first.apply+ then +second.apply+. If the first returns +nil+,
+      # the second is skipped and +nil+ is returned.
+      #
+      # @param message [String] the log message to filter
+      # @return [String, nil] the transformed message, or +nil+ if dropped
+      def apply(message)
+        intermediate = @first.apply(message)
+        if intermediate.nil?
+          increment_stat(:dropped)
+          return nil
+        end
+
+        result = @second.apply(intermediate)
+        if result.nil?
+          increment_stat(:dropped)
+          return nil
+        end
+
+        increment_stat(:passed)
+        result
+      end
+    end
   end
 end

data/lib/philiprehberger/log_filter/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module LogFilter
-    VERSION = '0.2.1'
+    VERSION = '0.3.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-log_filter
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-18 00:00:00.000000000 Z
 dependencies: []
 description: Pattern-based log filtering — drop or transform log lines matching rules.
   Includes preset filters for health checks, static assets, and bot traffic.
@@ -26,11 +26,11 @@ files:
 - lib/philiprehberger/log_filter/presets.rb
 - lib/philiprehberger/log_filter/version.rb
 - lib/philiprehberger/log_filter/wrapper.rb
-homepage: https://github.com/philiprehberger/rb-log-filter
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-log_filter
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-log-filter
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-log_filter
   source_code_uri: https://github.com/philiprehberger/rb-log-filter
   changelog_uri: https://github.com/philiprehberger/rb-log-filter/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-log-filter/issues