snappier 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2927f513086b61df8edaadcc710dfdfde6bce30f94710c3d78a343ddce5b1161
-  data.tar.gz: 825ad55fc4328d3168d7c37fbd4e85952546c9d0c77281b466f93e0e569e44ea
+  metadata.gz: b2b91bfac18970f816c688c50f628f2936b4d9542d91cf2fb941bed3e89d20c3
+  data.tar.gz: 9852bc0fc596ee1f8c5e38a56334bdb5c95fae7366325443dc66fd4dfa625053
 SHA512:
-  metadata.gz: e8a9a9c560b514a332ed813a53c1d9f9e9845ed44cbdbe7eb0bd36f0e5c9f4ffd834cc5d0f236a5b914f0d48a2d385e5f17ff06808b6d3e8dffa37f12f6ed30a
-  data.tar.gz: fdff950af91eaa75ebfd44b02ecc3d25ebf58541fd10adb92cf57d6856ae0d3fae5318315b268f72d2e1d9127025146fa5240c889e8842c22796ae49368765a3
+  metadata.gz: c3735760364dd88d933d8ad919f6c886d27f8a98d400915b649e7aa902ba3392f7f554ee5beac7e000c8540d6049aba39047e9cfe447c83e76ad8c2681ae781e
+  data.tar.gz: 3eef0ad2728221c2390d1770dcd1505ca8650f0b10042f9d8d24f367da9fba82557e9f2b8fadf045708a8df8eb3b07afe3c7a909c7a052ec99afb02510f8d3b0

data/.rubocop.yml

@@ -1,8 +1,43 @@
+plugins:
+  - rubocop-rake
+  - rubocop-rspec
+
 AllCops:
   TargetRubyVersion: 3.1
+  NewCops: enable
 
 Style/StringLiterals:
   EnforcedStyle: double_quotes
 
 Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
+
+Style/TrailingCommaInArguments:
+  EnforcedStyleForMultiline: comma
+
+Style/Documentation:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/InstanceVariable:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false
+
+RSpec/VerifiedDoubles:
+  Enabled: false
+
+Metrics/AbcSize:
+  Max: 30
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/MethodLength:
+  Max: 30
+
+Metrics/PerceivedComplexity:
+  Max: 15

data/exe/snappier_replay

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), "..", "lib")
+
+require "snappier"
+
+type = ARGV.shift
+id = ARGV.shift
+
+Snappier::Replay.for(
+  type: type,
+  id: id,
+) do |entry|
+  pp entry
+end

data/lib/snappier/changes.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module Snappier
+  module Changes
+    def self.between(previous_state, current_state)
+      {}.tap { |changes| append_changes(changes, previous_state, current_state) }
+    end
+
+    def self.append_changes(changes, previous_state, current_state, path = [])
+      keys = Set.new(previous_state.keys + current_state.keys)
+
+      keys.each do |key|
+        previous_value = previous_state[key]
+        current_value = current_state[key]
+
+        if previous_value.is_a?(Array) || current_value.is_a?(Array)
+          append_changes_for_collections(changes, previous_value, current_value, path + [key])
+          next
+        end
+
+        if previous_value.is_a?(Hash) || current_value.is_a?(Hash)
+          previous_id = (previous_value || {}).delete("id")
+          current_id = (current_value || {}).delete("id")
+
+          if previous_id || current_id
+            if previous_id == current_id
+              append_changes(changes, previous_value, current_value, path + [key, previous_id])
+            else
+              append_changes(changes, previous_value, {}, path + [key, previous_id])
+              append_changes(changes, {}, current_value, path + [key, current_id])
+            end
+          else
+            append_changes(changes, previous_value, current_value, path + [key])
+          end
+
+          next
+        end
+
+        next if previous_value == current_value
+
+        changes[path + [key]] = [previous_value, current_value]
+      end
+    end
+
+    def self.append_changes_for_collections(changes, previous_collection, current_collection, path)
+      ids = Set.new
+      previous_collection.each { |e| ids << e["id"] if e["id"] }
+      current_collection.each { |e| ids << e["id"] if e["id"] }
+
+      if ids.empty?
+        changes[path] = [previous_collection, current_collection]
+        return
+      end
+
+      ids.each do |id|
+        previous_value = previous_collection.find { |r| r["id"] == id } || {}
+        current_value = current_collection.find { |r| r["id"] == id } || {}
+        previous_value.delete("id")
+        current_value.delete("id")
+
+        append_changes(changes, previous_value, current_value, path + [id])
+      end
+    end
+  end
+end

data/lib/snappier/file_persistence.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module Snappier
+  class FilePersistence
+    def persist(type:, id:, at:, args:)
+      path = File.join("tmp", "snappier", type, id, "#{at}.yml")
+      FileUtils.mkdir_p(File.dirname(path))
+      File.write(path, args.to_yaml)
+    end
+
+    def each(type:, id:)
+      dir_path = File.join("tmp", "snappier", type.to_s, id)
+      Dir["#{dir_path}/*.yml"].each do |file_path|
+        milliseconds = File.basename(file_path).split(".").first
+        yield(
+          {
+            at: Time.at(milliseconds.to_i / 1000),
+            content: YAML.load_file(file_path)
+          }
+        )
+      end
+    end
+  end
+end

data/lib/snappier/job.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative "registry"
+require "sidekiq"
+require "yaml"
+
+module Snappier
+  class Job
+    include Sidekiq::Job
+
+    def perform(args)
+      type = args["type"]
+      id = args["id"]
+      at = args["at"]
+
+      args["at"] = Time.at(at.to_i / 1000).to_s
+      args["state"] = JSON.parse(args["state"])
+
+      Registry.persistence.persist(
+        type: type,
+        id: id,
+        at: at,
+        args: args,
+      )
+    end
+  end
+end

data/lib/snappier/registry.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "file_persistence"
+
+module Snappier
+  module Registry
+    def self.reset
+      @for_class_name = {}
+      @persistence = nil
+    end
+
+    def self.all
+      @for_class_name
+    end
+
+    def self.register_persistence(instance)
+      @persistence = instance
+    end
+
+    def self.persistence
+      @persistence || FilePersistence.new
+    end
+
+    def self.register(map)
+      @for_class_name ||= {}
+      map.each_key do |key|
+        @for_class_name[key] = map[key]
+      end
+    end
+
+    def self.for_entity(entity)
+      @for_class_name ||= {}
+      class_name = @for_class_name[entity.class.name]
+      return unless class_name
+
+      class_name.split("::").reduce(Object) { |acc, elem| acc.const_get(elem) }
+    end
+  end
+end

data/lib/snappier/replay.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative "registry"
+require_relative "changes"
+
+module Snappier
+  module Replay
+    def self.for(type:, id:)
+      previous_state = {}
+
+      Registry.persistence.each(type: type, id: id) do |current|
+        content = current.delete(:content)
+        current[:who] = content.delete("who")
+        current[:state] = content.delete("state")
+        current[:changes] = Changes.between(previous_state, current[:state])
+
+        yield(current)
+
+        previous_state = current[:state]
+      end
+    end
+
+    def self.for_entity(entity)
+      self.for(type: entity.class.name, id: entity.id)
+    end
+  end
+end

data/lib/snappier/take.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "registry"
+require_relative "job"
+require_relative "who"
+require "json"
+
+module Snappier
+  module Take
+    def self.for(entity)
+      action = "update"
+      action = "create" if entity.previously_new_record?
+      action = "destroy" if entity.destroyed?
+
+      snapper = Registry.for_entity(entity)
+      state = snapper ? snapper.snap(entity) : entity.attributes
+
+      Job.perform_async(
+        "at" => Time.now.strftime("%s%L"),
+        "action" => action,
+        "id" => entity.id,
+        "type" => entity.class.name,
+        "state" => state.to_json,
+        "who" => Who.current,
+      )
+
+      entity
+    end
+  end
+end

data/lib/snappier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Snappier
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

data/lib/snappier/who.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Snappier
+  module Who
+    def self.current=(value)
+      Thread.current[:snappier_who_current] = value
+    end
+
+    def self.current
+      Thread.current[:snappier_who_current]
+    end
+  end
+end

data/lib/snappier.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require_relative "snappier/version"
+require_relative "snappier/take"
+require_relative "snappier/replay"
 
 module Snappier
   class Error < StandardError; end

metadata

@@ -1,17 +1,32 @@
 --- !ruby/object:Gem::Specification
 name: snappier
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Mark Ryall
 bindir: exe
 cert_chain: []
 date: 2025-05-25 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sidekiq
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 email:
 - mark@ryall.name
-executables: []
+executables:
+- snappier_replay
 extensions: []
 extra_rdoc_files: []
 files:
@@ -21,8 +36,16 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- exe/snappier_replay
 - lib/snappier.rb
+- lib/snappier/changes.rb
+- lib/snappier/file_persistence.rb
+- lib/snappier/job.rb
+- lib/snappier/registry.rb
+- lib/snappier/replay.rb
+- lib/snappier/take.rb
 - lib/snappier/version.rb
+- lib/snappier/who.rb
 - sig/snappier.rbs
 homepage: https://github.com/markryall/snappier
 licenses:
@@ -30,6 +53,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/markryall/snappier
   source_code_uri: https://github.com/markryall/snappier
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib