paper_trail-human 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4dea24fd23784bda5b3b0f6d704f5f3a53a2ab00c8ed8500fe69a1b432eb3f47
-  data.tar.gz: 6c074d6f13efd43f93e1c201e36d9310420095c516980bc80c74dc6116551105
+  metadata.gz: dfb8c783e819dfade94289a84366e1d04f13f711339c6c08ca471d4a2daac52c
+  data.tar.gz: 6ff6a8161a65ee10cc25a84c77f5986a33c9a13b285854efc7e8fce30597f198
 SHA512:
-  metadata.gz: bf9745f8aba245105b94e41f5739ec4358d657311d7cc9b5527db3353ff1e217243955f3f033cd576f98fd0d8fa0a6079f927496f101a4be31813bc734ac75bd
-  data.tar.gz: e5fb5fc24f36be842103d727af163f64545c0208229178dd7bc93f2559b09022d5177cffb4c82e448aed78a21a5564a6ff79376875184c9501b298685ff37e37
+  metadata.gz: dcc23c680e095752b9413ece751ebb82c5d4b3b8bf060811d01acfb775f4b803f2a65a318f175d40e288716b2bf6a13e35ca56a586391187900d60a1f2b0ec5c
+  data.tar.gz: '08542e032fd13d2e8ad3a9ae4949145ca5bf82d0e5290cbc2387393df0cbf1de8ebb4724fb16ea756b96394a5a43e4add686f4f9b14612f9cd7c85b78e0fe22c'

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.5.0] - 2026-06-01
+
+### Added
+- Text diff mode: `m.field :body, :text, diff: true` returns additions/deletions/summary
+- Event system: `config.on_format { |result, version| ... }` for multiple callbacks
+- Callbacks are fault-tolerant (errors in one don't block others)
+- `resolve_pair?` port method for resolvers that need both old and new values
+
+### Changed
+- Extracted `AfterFormat` module shared by `Presenter` and `BatchPresenter`
+
 ## [0.4.0] - 2026-05-31
 
 ### Added

data/lib/paper_trail/human/adapters/resolvers/text.rb

@@ -9,13 +9,39 @@ module PaperTrail
 
           DEFAULT_MAX_LENGTH = 80
 
-          def initialize(max_length: DEFAULT_MAX_LENGTH, show_diff_stats: false, **)
+          def initialize(max_length: DEFAULT_MAX_LENGTH, show_diff_stats: false, diff: false, **)
             @max_length = max_length
             @show_diff_stats = show_diff_stats
+            @diff = diff
+          end
+
+          def resolve_pair?
+            @diff
           end
 
           def resolve(value)
-            text = value.to_s
+            truncate(value.to_s)
+          end
+
+          def resolve_change(previous_value, new_value)
+            old_lines = previous_value.to_s.lines.map(&:chomp)
+            new_lines = new_value.to_s.lines.map(&:chomp)
+
+            additions = (new_lines - old_lines).size
+            deletions = (old_lines - new_lines).size
+
+            {
+              previous_value: truncate(previous_value.to_s),
+              value: truncate(new_value.to_s),
+              additions: additions,
+              deletions: deletions,
+              summary: "+#{additions}/-#{deletions} lines"
+            }
+          end
+
+          private
+
+          def truncate(text)
             return text if text.length <= @max_length
 
             truncated = "#{text[0, @max_length]}..."

data/lib/paper_trail/human/configuration.rb

@@ -7,7 +7,7 @@ module PaperTrail
 
       attr_accessor :whodunnit_resolver, :extend_version_model, :field_name_resolver,
                     :translate_events, :after_format
-      attr_reader :ignored_fields, :custom_resolvers, :custom_formatters
+      attr_reader :ignored_fields, :custom_resolvers, :custom_formatters, :format_callbacks
 
       def initialize
         @model_configs = {}
@@ -19,6 +19,7 @@ module PaperTrail
         @after_format = nil
         @custom_resolvers = {}
         @custom_formatters = {}
+        @format_callbacks = []
         @mutex = Mutex.new
       end
 
@@ -40,6 +41,10 @@ module PaperTrail
         @mutex.synchronize { @custom_formatters[type.to_sym] = klass }
       end
 
+      def on_format(&block)
+        @mutex.synchronize { @format_callbacks << block }
+      end
+
       def config_for(model_name)
         @model_configs[model_name.to_s]
       end

data/lib/paper_trail/human/core/after_format.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module PaperTrail
+  module Human
+    module Core
+      module AfterFormat
+        private
+
+        def apply_after_format(result, version)
+          result = @configuration.after_format.call(result, version) if @configuration.after_format
+          @configuration.format_callbacks.each do |callback|
+            callback.call(result, version)
+          rescue StandardError
+            nil
+          end
+          result
+        end
+      end
+    end
+  end
+end

data/lib/paper_trail/human/core/batch_presenter.rb

@@ -4,6 +4,8 @@ module PaperTrail
   module Human
     module Core
       class BatchPresenter
+        include AfterFormat
+
         def initialize(configuration)
           @configuration = configuration
           @change_extractor = ChangeExtractor.new
@@ -122,12 +124,6 @@ module PaperTrail
         rescue NameError
           {}
         end
-
-        def apply_after_format(result, version)
-          return result unless @configuration.after_format
-
-          @configuration.after_format.call(result, version)
-        end
       end
     end
   end

data/lib/paper_trail/human/core/field_formatter.rb

@@ -26,11 +26,15 @@ module PaperTrail
           config = field_config(field_name)
           resolver = build_resolver(config, field_name)
 
-          {
-            field: human_field_name(field_name),
-            previous_value: resolve_value(resolver, previous_value),
-            value: resolve_value(resolver, new_value)
-          }
+          if resolver&.resolve_pair?
+            resolver.resolve_change(previous_value, new_value).merge(field: human_field_name(field_name))
+          else
+            {
+              field: human_field_name(field_name),
+              previous_value: resolve_value(resolver, previous_value),
+              value: resolve_value(resolver, new_value)
+            }
+          end
         end
 
         private

data/lib/paper_trail/human/core/presenter.rb

@@ -4,6 +4,8 @@ module PaperTrail
   module Human
     module Core
       class Presenter
+        include AfterFormat
+
         def initialize(configuration)
           @configuration = configuration
           @change_extractor = ChangeExtractor.new
@@ -68,12 +70,6 @@ module PaperTrail
 
           result
         end
-
-        def apply_after_format(result, version)
-          return result unless @configuration.after_format
-
-          @configuration.after_format.call(result, version)
-        end
       end
     end
   end

data/lib/paper_trail/human/ports/resolver.rb

@@ -7,6 +7,10 @@ module PaperTrail
         def resolve(value)
           raise NotImplementedError, "#{self.class}#resolve must be implemented"
         end
+
+        def resolve_pair?
+          false
+        end
       end
     end
   end

data/lib/paper_trail/human/version.rb

@@ -2,6 +2,6 @@
 
 module PaperTrail
   module Human
-    VERSION = '0.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/paper_trail/human.rb

@@ -5,6 +5,7 @@ require_relative 'human/configuration'
 require_relative 'human/core/change_extractor'
 require_relative 'human/core/field_formatter'
 require_relative 'human/core/event_translator'
+require_relative 'human/core/after_format'
 require_relative 'human/core/presenter'
 require_relative 'human/core/batch_presenter'
 require_relative 'human/core/timeline'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paper_trail-human
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Gabriel
@@ -65,6 +65,7 @@ files:
 - lib/paper_trail/human/adapters/resolvers/relation.rb
 - lib/paper_trail/human/adapters/resolvers/text.rb
 - lib/paper_trail/human/configuration.rb
+- lib/paper_trail/human/core/after_format.rb
 - lib/paper_trail/human/core/batch_presenter.rb
 - lib/paper_trail/human/core/change_extractor.rb
 - lib/paper_trail/human/core/event_translator.rb