fast_versioning 0.4.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23f653a3f9017175d02635e4631b112c39f4c172d574ff773c28fddb8779819c
-  data.tar.gz: 05e54ed2435fb1590af1013445a151d60aed19bd86d24c35339a5bba8ee4bdda
+  metadata.gz: b1f61010645683fd0891a8cd04d683760f1dd8693a69a216cfe3d3b914e57dac
+  data.tar.gz: ab643c5cda9cef86f684e54f4fa83098cf9ee4947419938ca0dfbd0fa3c21673
 SHA512:
-  metadata.gz: dc289843b4225045ba104c24f887b4da440e86b22ee58df62ee323c0e89e908999cd8555bfd94cddda0608e010dff2f8af827e45d6cf4d613604a99fcdd3f36b
-  data.tar.gz: 0c4a213dbd1ab861ce77cd0a1a04dca9c5166f693f1296c585655e622b1e535590b825f0393742ff9b42a92adc8262f69d45a41f56ad6c9b97ac4eacfd1cd06c
+  metadata.gz: a41e86ce08b616ccdc27059a328b99e5a724422fb2d05edae66d0462ae85b2db95fbb27800e3a5243a312e0f42d9623812e54b15f191cc4e32e3068c300d2ff0
+  data.tar.gz: d3b79718003b4fc2729730d3d7274aca7c9374111d71b23bf506e4a1e5cf2ef9e71b5d21edafe670e2f5e0d64b87e1260512d76c5b9ba7b497bd79cf6de29599

data/README.md

@@ -95,6 +95,23 @@ Example usage:
     )
 ```
 
+### Timeline helper
+`FastVersioning::Timeline` is a simple helper you can use to generate a timeline hash for a tracked property
+
+example usage:
+```ruby
+FastVersioning::Timeline.new(
+  fast_versions: model.fast_versions,
+  name: "status"
+).to_h
+
+# {
+#   Thu, 01 Apr 2021 14:08:48 EDT -04:00..Mon, 05 Apr 2021 21:53:48 EDT -04:00 => 'active',
+#   Mon, 05 Apr 2021 21:53:48 EDT -04:00..Mon, 05 Apr 2021 22:02:44 EDT -04:00 => 'inactive',
+#   Mon, 05 Apr 2021 22:02:44 EDT -04:00..Infinity => 'active'
+# }
+```
+
 Testing
 -------------
 ```
@@ -102,4 +119,4 @@ bundle exec appraisal install
 bundle exec appraisal rspec
 ```
 
-An [Arcadia Power](http://www.arcadiapower.com) Project
+An [Arcadia](http://www.arcadia.com) Project

data/lib/fast_versioning/timeline.rb

@@ -0,0 +1,47 @@
+module FastVersioning
+  # a timeline for a tracked property
+  class Timeline
+    # @param name [String] tracked property name
+    # @param fast_versions [ActiveRecord::Collection] FastVersion collection
+    #
+    def initialize(fast_versions:, name:)
+      self.fast_versions = fast_versions
+      self.name = name
+    end
+
+    # @return [Hash] hash of duration => date ranges
+    #
+    # @example
+    #
+    #   FastVersioning::Timeline.new(fast_versions: model.fast_versions, name: 'status').to_h
+    #
+    #   {
+    #     Thu, 01 Apr 2021 14:08:48 EDT -04:00..Mon, 05 Apr 2021 21:53:48 EDT -04:00 => 'active',
+    #     Mon, 05 Apr 2021 21:53:48 EDT -04:00..Mon, 05 Apr 2021 22:02:44 EDT -04:00 => 'inactive'
+    #   }
+    #
+    def to_h
+      durations_array.map do |duration|
+        [duration.date_range, duration.value]
+      end.to_h
+    end
+
+    private
+
+      attr_accessor :fast_versions, :name
+
+      def filtered_fast_versions
+        fast_versions.where(name: name).order('created_at')
+      end
+
+      def durations_array
+        @value_durations ||= (filtered_fast_versions.to_a + [nil]).each_cons(2).map do |item, prev_item|
+          Timelines::Duration.new(
+            value: item.value,
+            start_date: item.created_at,
+            end_date: prev_item&.created_at
+          )
+        end
+      end
+  end
+end

data/lib/fast_versioning/timelines/duration.rb

@@ -0,0 +1,32 @@
+module FastVersioning
+  # value duration period
+  # @private
+  module Timelines
+    class Duration
+      # @param value [String] tracked property name
+      # @param start_date [Time] when was the value set
+      # @param end_date [Time, nil] when was the value unset (nil will default to Float::INFINITY)
+      def initialize(value:, start_date:, end_date:)
+        self.value = value
+        self.start_date = start_date
+        self.end_date = end_date
+      end
+
+      # @return [Range]
+      def date_range
+        start_date..end_date_or_the_future
+      end
+
+      attr_reader :value
+
+      private
+
+      attr_accessor :start_date, :end_date
+      attr_writer :value
+
+      def end_date_or_the_future
+        end_date || Float::INFINITY
+      end
+    end
+  end
+end

data/lib/fast_versioning.rb

@@ -2,6 +2,8 @@ require 'paper_trail'
 require 'fast_versioning/tracked_attribute'
 require 'fast_versioning/fast_versioned'
 require 'fast_versioning/value_change'
+require 'fast_versioning/timelines/duration'
+require 'fast_versioning/timeline'
 require 'fast_versioning/paper_trail_extensions'
 require 'fast_versioning/railtie'
 require 'fast_versioning/engine'

metadata

@@ -1,31 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: fast_versioning
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.7.0
 platform: ruby
 authors:
-- Arcadia Power
-- Iwo Dziechciarow
-- Justin Doody
-autorequire: 
+- Arcadia
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-09-10 00:00:00.000000000 Z
+date: 2022-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.2'
 - !ruby/object:Gem::Dependency
   name: paper_trail
   requirement: !ruby/object:Gem::Requirement
@@ -44,16 +48,16 @@ dependencies:
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.3.13
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.3.13
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
@@ -82,9 +86,23 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Fast versioning extension for paper_trail
 email:
-- engineering@arcadiapower.com
+- engineering@arcadia.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -99,13 +117,15 @@ files:
 - lib/fast_versioning/fast_versioned.rb
 - lib/fast_versioning/paper_trail_extensions.rb
 - lib/fast_versioning/railtie.rb
+- lib/fast_versioning/timeline.rb
+- lib/fast_versioning/timelines/duration.rb
 - lib/fast_versioning/tracked_attribute.rb
 - lib/fast_versioning/value_change.rb
 homepage: https://github.com/ArcadiaPower/fast-versioning
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -120,8 +140,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.2.9
+signing_key:
 specification_version: 4
 summary: Fast versioning extension for paper_trail
 test_files: []