fast_versioning 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 6bb8ed66caeccf8831f4f7758d39701592388310
-  data.tar.gz: 7fb141bbd2c2f43255cd83cc38e5488037c9e1d1
+SHA256:
+  metadata.gz: 87613fb753cc329fe499c239bc0a84ce505879abb87c4c74cff07c657b0b86db
+  data.tar.gz: 7dec724f5f187384c874ff7af8bd4751054d5462e0e2233d94dfc03075f5e3f7
 SHA512:
-  metadata.gz: 33e1c46ca59a82034ae997da35a4728df1cd0845530f9c38e808fd72350cb7252eb171568190da53f9c78ea82f23b546c9d73605fe9ad18036b46c3500c031e8
-  data.tar.gz: 0653f9df4613c74619feb1a0d7d7fec7cec2bdccb66ec912509e690e226045afa6192d7a80d73e435800371f89c9fb24bcfdb5c2a5565e5ae75e9b40cc267037
+  metadata.gz: 9b635ba136aed6ec8b8ef573a4e8d958826ff5d481a83fc75f1dddee18d706b6b8909a3b323d1e3db18bf6042f7e4cda7c03ad770848a22147ee19a7e982f8b1
+  data.tar.gz: 8a2ca6a9207836d1f54feaa6ffddfd86a3583493b00aad0897eb3a25f321e47752892f84b68e7298e96247d944b6c389f1c4742ce04fe4ef2b530b511f143f88

data/README.md

@@ -20,6 +20,17 @@ gem 'fast_versioning'
 rake fast_versioning:install:migrations
 ```
 
+Prerequisites
+-------------
+- PaperTrail needs to be added to your model
+- Storing changes needs to be enabled for PaperTrail
+- Attributes tracked with FastVersioning need to also be present in PaperTrail
+ie.
+```ruby
+has_paper_trail only: :status
+has_fast_versions :status
+```
+
 Configuration
 -------------
 1. Include the concern in your model
@@ -46,8 +57,21 @@ has_fast_versions(
 
 Usage
 -----
+### Creating and recreating fast versions
+FastVersioning versions are created based on the `PaperTrail::Version` instance. When available, the `changeset` is used, otherwise, FastVersioning will attempt to `reify` the object comparing the changes for the tracked columns.
+
+At any point you can retroactively recreate FastVersioning versions (especially, initially, when adding fast versions to existing PaperTrail configuration, or when adding/changing FastVersioning options for a model), to do so you need to call the `recreate_fast_versions!` on the `PaperTrail::Version` instance. It will destroy all previous fast versions if they exist and recreate them.
+
+Example usage:
+```ruby
+    # recreate fast versions for a single model instance
+    your_model.versions.find_each(&:recreate_fast_versions!)
+
+    # recreate fast versions for all model instances
+    YourModel.find_each { |your_model| your_model.versions.find_each(&:recreate_fast_versions!) }
+```
 
-### samples
+### Querying
 ```ruby
     your_model.fast_versions # get all fast versions
     your_model.fast_versions_for(:plan_type) # get fast versions for given property - chain

data/Rakefile

@@ -4,6 +4,8 @@ rescue LoadError
   puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
 end
 
+require 'bundler/gem_tasks'
+
 require 'rdoc/task'
 
 RDoc::Task.new(:rdoc) do |rdoc|
@@ -13,25 +15,3 @@ RDoc::Task.new(:rdoc) do |rdoc|
   rdoc.rdoc_files.include('README.md')
   rdoc.rdoc_files.include('lib/**/*.rb')
 end
-
-APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
-load 'rails/tasks/engine.rake'
-
-
-load 'rails/tasks/statistics.rake'
-
-
-
-require 'bundler/gem_tasks'
-
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib'
-  t.libs << 'test'
-  t.pattern = 'test/**/*_test.rb'
-  t.verbose = false
-end
-
-
-task default: :test

data/db/migrate/20160914161314_create_fast_versioning_fast_versions.rb

@@ -1,4 +1,4 @@
-class CreateFastVersioningFastVersions < ActiveRecord::Migration
+class CreateFastVersioningFastVersions < ActiveRecord::Migration[5.0]
   def change
     create_table :fast_versioning_fast_versions do |t|
       t.references :item, polymorphic: true, index: { name: 'fast_version_item_index' }

data/lib/fast_versioning/paper_trail_extensions.rb

@@ -12,19 +12,24 @@ module FastVersioning
         value_change = FastVersioning::ValueChange.new(version: self)
 
         item.send(:fast_version_for).each do |tracked_attribute|
-          if value_change.value_was(tracked_attribute.name) != value_change.value_became(tracked_attribute.name)
-            fast_versions.create(
-              item_id: item_id,
-              item_type: item_type,
-              whodunnit_id: whodunnit.to_i,
-              whodunnit_type: whodunnit_type,
-              name: tracked_attribute.name,
-              value: value_change.value_became(tracked_attribute.name),
-              prev_value: value_change.value_was(tracked_attribute.name),
-              meta: tracked_attribute.meta,
-              created_at: created_at
-            )
-          end
+          name = tracked_attribute.name
+          new_value = value_change.value_became(name)
+          prev_value = value_change.value_was(name)
+
+          # Skip if value unchanged.
+          next if prev_value == new_value
+
+          fast_versions.create(
+            item_id: item_id,
+            item_type: item_type,
+            whodunnit_id: whodunnit&.to_i,
+            whodunnit_type: whodunnit_type,
+            name: name,
+            value: new_value,
+            prev_value: prev_value,
+            meta: tracked_attribute.meta,
+            created_at: created_at
+          )
         end
       end
       true

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fast_versioning
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Arcadia Power
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-23 00:00:00.000000000 Z
+date: 2019-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -18,28 +18,40 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: paper_trail
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -105,8 +117,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 3.0.2
 signing_key: 
 specification_version: 4
 summary: Fast versioning extension for paper_trail