fast_versioning 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b964a2fa26408fcc41f0a70ccbed7cf48b26e8ad1e0cc997abccd62a81d56565
-  data.tar.gz: 6cb92fbca8479834a2cc146c2e73abb4a47c6c7843a2a72f428c2ff516300d75
+  metadata.gz: 2bd60ff0e35e539783059550b97c8075a76422d3a2ed83f025a9633e5c5396ec
+  data.tar.gz: d5ec4ba1e53650f50edb668abb3e4f77f9275984f7b051708401ed92c6469630
 SHA512:
-  metadata.gz: 6cec867522c2a081a4399714a2d9126ba6994661348a83be153edd681cf640ea94301b870af14d35ef0b429c2083ca31f8bb7cb8446bf7581b04c471ef639bfe
-  data.tar.gz: a03dd2e567088081d9e2752f54e16f705a476d55852197c4e70ab1dac0a7acff758cc231d97928620267ff630ef9dcbbe161b56969a7fd714044491b83d0e532
+  metadata.gz: 6ae2748e70169334cd3d1920fa13ea740bdcb6310dd4d656d1b188b96a2bfb3ce029551b229cff7a1080295c5884827ecee9c6ea8bd8b29593ed8b04b445d0e9
+  data.tar.gz: 57b5ba1b6e5444dd4aa2caf694a89fabe7cbc9a4268e974a8d664f3075e37e507a81b1f1d1d5156f24da28da9eb99fa89b0a3d03db698716c23ef43d8986a7ee

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.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'

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

metadata

@@ -1,16 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fast_versioning
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
-- Arcadia Power
-- Iwo Dziechciarow
-- Justin Doody
-autorequire: 
+- Arcadia
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-01-13 00:00:00.000000000 Z
+date: 2021-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -88,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: []
@@ -105,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
@@ -126,8 +140,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.1
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: Fast versioning extension for paper_trail
 test_files: []