servus 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eaa6e4a6098ddae071c236515fc72aa59fdc3707aa43bb145b14eb6830bef5dd
-  data.tar.gz: e418da17ac2136fd8daac9a22b6fd3f2ff686fb9fc681b131eb4060e7363b1eb
+  metadata.gz: '0560049029e2b803e64323461fb8d5c8b56cdc1d69c5b5de83ca0e6a1858a65c'
+  data.tar.gz: 0d1e6a460fbbf1b5c7c26811ee8fbb5eccccf151f2c4d8d94a8270c1f1d5ef41
 SHA512:
-  metadata.gz: 73a3a30becf0f5cc0da3829239332a8e619f4f156713b7743251b76b0213aece56c802f572f4aa9b761db4858e7266a7e11b14344bf0412d78eb34f1224f2384
-  data.tar.gz: f091bb4cf55750907ca52c27c2aedaa0484692895bec7144368581d49f8a5741246588fc7e2b29c2d712795cffd1930656ac59b5434150180cd61b558faa3e13
+  metadata.gz: f59299fe30eb202c0a71858dc2c1491a29f4dd5a330e65ec471b412a1e060329bfca5c51eea2d7759fbddebbb2747fd65ccb79ecd048fc4d2dc07faba3f92420
+  data.tar.gz: 81f9a1277db2e3d6b4d383c29a4be4f9c4cf92ba1bac10f680e687ea6cf4438067ec4b2b19d05ccd3909962e87e7eec738721a28cf1b65f281548bec7fbcb42e

data/lib/servus/config.rb

@@ -112,6 +112,39 @@ module Servus
     # @see Servus::Support::Lockdown
     attr_reader :lockdown_enabled
 
+    # Keys whose values are filtered from Servus's service-call argument
+    # logging, shown as `[FILTERED]`. Accepts the same notations as
+    # ActiveSupport::ParameterFilter (partial-match strings/symbols,
+    # regexps, procs).
+    #
+    # Defaults to `[]` — no filtering. Set the keys you want masked in your
+    # initializer; Rails users can simply reuse their app's request-log
+    # filtering as the value:
+    #
+    #   config.log_filter_parameters = Rails.application.config.filter_parameters
+    #
+    # @return [Array] parameter filter patterns
+    attr_reader :log_filter_parameters
+
+    # Sets the log filter list, invalidating the memoized
+    # {#parameter_filter}. The list is frozen on assignment — reconfigure
+    # by assigning a new list, not by mutating in place.
+    #
+    # @param value [Array] parameter filter patterns
+    # @return [Array] the new value
+    def log_filter_parameters=(value)
+      @log_filter_parameters = Array(value).dup.freeze
+      @parameter_filter      = nil
+    end
+
+    # Parameter filter built from {#log_filter_parameters}, memoized until
+    # the list is reassigned.
+    #
+    # @return [ActiveSupport::ParameterFilter]
+    def parameter_filter
+      @parameter_filter ||= ActiveSupport::ParameterFilter.new(log_filter_parameters)
+    end
+
     # Sets whether lockdown is enforced, immediately re-applying the
     # resulting `.new` visibility to {Servus::Base}.
     #
@@ -132,6 +165,7 @@ module Servus
       @require_service_arguments_schema = false
       @require_service_result_schema    = false
       @require_event_payload_schema     = false
+      @log_filter_parameters            = [].freeze
     end
 
     def set_default_directories

data/lib/servus/support/logger.rb

@@ -17,12 +17,17 @@ module Servus
         end
       end
 
-      # Logs a call to a service
+      # Logs a call to a service.
+      #
+      # When {Servus::Config#log_filter_parameters} is configured, matching
+      # argument values are replaced with `[FILTERED]` before logging. With
+      # the default empty list, arguments are logged verbatim.
       #
       # @param service_class [Class] The service class
       # @param args [Hash] The arguments passed to the service
       def self.log_call(service_class, args)
-        logger.info("Calling #{service_class.name} with args: #{args.inspect}")
+        rendered = log_parameters(args)
+        logger.info("Calling #{service_class.name} with args: #{rendered.inspect}")
       end
 
       # Logs a result from a service
@@ -88,6 +93,18 @@ module Servus
       def self.log_exception(service_class, exception)
         logger.error("#{service_class.name} uncaught exception: #{exception.class} - #{exception.message}")
       end
+
+      # Filters parameters for logging based on the configured filter list.
+      #
+      # @param params [Hash] The parameters to filter
+      # @return [Hash] The filtered parameters
+      def self.log_parameters(params)
+        if Servus.config.log_filter_parameters.empty?
+          params
+        else
+          Servus.config.parameter_filter.filter(params)
+        end
+      end
     end
   end
 end

data/lib/servus/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Servus
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: servus
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Sebastian Scholl
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-21 00:00:00.000000000 Z
+date: 2026-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport