changed 0.0.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9811b29b82154768e261bd90c16604ab7cb1c741eb45ad91cc4a4fe963e23be
-  data.tar.gz: 8c8b3993c740fc868e200842fda818710dc74f05a8f38668582ae4026c833f8f
+  metadata.gz: a624358bc74adfc4ce845ae502cc8a573c2ef90c8f070eaeb196d978c641996b
+  data.tar.gz: 72a7e53ffc9530e7d1d28f5616716e491f8bb9d35e9c48a399c5929c9ac87a60
 SHA512:
-  metadata.gz: 8b5007282b58dbc1c4d36b96f73d4369b126e392b6950fbcc327ebbbf2841005232ee0f70b453cb52f4dc85c2a627119f299e12fd70d54b2a91ed9afe13e7eec
-  data.tar.gz: 22405f5a0d3e2b96f5e3b77823cc4725fe622cf0b888811a317cfde55c887e45f9e144a505be092de7317cd24c2547044e3d648033955ebfd4c8b31bc85a64d1
+  metadata.gz: c7daffb97f36da1931a52d6c6536d2c8221d959c73941e6a72585f6f24a1121615fb64d03d6f2457532a4d0f1b001fffc1a04a0e20f54db65fd52e03352cd0ee
+  data.tar.gz: e272cf28d5f7b674c69411ad5984589caf47e2216576d005412ef8397f631a5dbf487a5894f3e2ca2a10d39f5f81a68d0ec3d10df155ce17f516df443d649415

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright 2018 Clutter
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,8 +1,8 @@
 # Changed
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/changed`. To experiment with that code, run `bin/console` for an interactive prompt.
+[![Gem Version](https://badge.fury.io/rb/changed.svg)](https://badge.fury.io/rb/changed)
 
-TODO: Delete this and the text above, and describe your gem
+A gem for tracking what **changed** when.
 
 ## Installation
 
@@ -14,22 +14,105 @@ gem 'changed'
 
 And then execute:
 
-    $ bundle
+```bash
+$ bundle
+```
 
 Or install it yourself as:
 
-    $ gem install changed
+```bash
+$ gem install changed
+```
+
+After installing the gem run the following to setup:
+
+```bash
+rails changed:install:migrations
+rails db:migrate
+```
 
 ## Usage
 
-TODO: Write usage instructions here
+This gem is designed to integrate with active record objects:
+
+```ruby
+class Employee
+  include Changed::Auditable
+  belongs_to :company
+
+  audited :name, :email, :eid, :company, transformations: { eid: 'Employee ID' }
+end
+```
+
+To ensure the proper 'changer' is tracked, add the following code to your application controller:
+
+```ruby
+before_action :configure_audit_changer
+
+protected
+
+def configure_audit_changer
+  Changed.changer = User.current
+end
+```
 
-## Development
+To execute code with a different timestamp or changer, use the following:
+
+```ruby
+employee = Employee.find_by(name: "...")
+Changed.perform(changer: User.current, timestamp: Time.now) do
+  employee.name = "..."
+  employee.save!
+end
+```
+
+### Fields
+
+Fields (i.e. name, email, phone, etc) are tracked inside the `changeset` key of a generated audit. They can be queried using:
+
+```sql
+SELECT
+  "audits"."timestamp",
+  "audits"."changeset"->'name'->>0 AS "was",
+  "audits"."changeset"->'name'->>1 AS "now",
+  "changers"."name" AS "changer"
+FROM "audits"
+JOIN "users" AS "changers" ON "audits"."changer_id" = "changers"."id" AND "audits"."changer_type" = 'User'
+WHERE "audits"."changeset"->>'name' IS NOT NULL
+```
+
+### Associations
+
+Associations (i.e. user, favourites, etc) are tracked by the `associations` table. They can be queried using:
+
+```sql
+SELECT
+  "audits"."timestamp",
+  "changers"."name" AS "changer",
+  CASE "associations"."kind"
+  WHEN '0' THEN 'ADD'
+  WHEN '1' THEN 'REMOVE'
+  END AS "kind",
+  "users"."name" AS "user"
+FROM "audits"
+JOIN "associations" ON "associations"."audit_id" = "audits"."id"
+JOIN "users" ON "associations"."associated_id" = "users"."id" AND "associations"."associated_type" = 'User'
+JOIN "users" AS "changers" ON "audits"."changer_id" = "changers"."id" AND "audits"."changer_type" = 'User'
+WHERE "associations"."name" = 'user'
+```
+
+## Configuration
+
+Specifying `default_changer_proc` gives a changer if one cannot be inferred otherwise:
+
+```ruby
+Changed.config.default_changer_proc = ->{ User.system }
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+## Status
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+[![CircleCI](https://circleci.com/gh/clutter/changed.svg?style=svg&circle-token=77cf2fadb88cfc6b16bf85643826152305dac75f)](https://circleci.com/gh/clutter/changed)
 
-## Contributing
+## License
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/changed.
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -1,6 +1,12 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+APP_RAKEFILE = File.expand_path('../spec/dummy/Rakefile', __FILE__)
+
+load 'rails/tasks/engine.rake'
+load 'rails/tasks/statistics.rake'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/app/models/changed/application_record.rb

@@ -0,0 +1,5 @@
+module Changed
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/changed/association.rb

@@ -0,0 +1,12 @@
+module Changed
+  class Association < ApplicationRecord
+    belongs_to :audit, class_name: 'Changed::Audit'
+    belongs_to :associated, polymorphic: true
+
+    enum :kind, %i[add remove]
+
+    validates :name, presence: true
+
+    scope :ordered, -> { order(id: :desc) }
+  end
+end

data/app/models/changed/audit.rb

@@ -0,0 +1,109 @@
+module Changed
+  class Audit < ApplicationRecord
+    module Event
+      CREATE = 'create'.freeze
+      UPDATE = 'update'.freeze
+    end
+
+    EVENTS = [
+      Event::CREATE,
+      Event::UPDATE,
+    ].freeze
+
+    belongs_to :changer, polymorphic: true, required: false
+    belongs_to :audited, polymorphic: true
+    has_many :associations, dependent: :destroy, class_name: 'Changed::Association'
+
+    scope :optimized, -> { preload(:changer, :audited, associations: :associated) }
+    scope :ordered, -> { order(id: :desc) }
+    scope :creates, -> { where(event: Event::CREATE) }
+    scope :updates, -> { where(event: Event::UPDATE) }
+
+    validates :event, inclusion: { in: EVENTS }
+    validates :audited, presence: true
+
+    scope :for, ->(audited) { where(audited: audited).ordered }
+
+    after_initialize -> { self.timestamp ||= Changed.timestamp || Time.now }
+
+    def fields
+      changeset.map do |name, value|
+        was, now = value
+        Field.new(was, now, transform(name))
+      end
+    end
+
+    def relationships
+      memo = {}
+      associations.each do |association|
+        memo[association.name] ||= Set.new
+        memo[association.name] << association
+      end
+      memo.map do |name, associations|
+        Relationship.new(associations, transform(name))
+      end
+    end
+
+    def track(event, fields)
+      self.changer = Changed.changer
+
+      fields.each do |attribute|
+        attribute = String(attribute)
+        if audited.saved_change_to_attribute?(attribute)
+          changeset[attribute] = audited.saved_change_to_attribute(attribute)
+        end
+      end
+
+      self.event = event
+    end
+
+    def anything?
+      changeset.any? || associations.any?
+    end
+
+    def changed?(key)
+      fields.map(&:name).include?(key)
+    end
+
+    # The 'change' provided needs to be a block, lambda, or proc that executes
+    # the changes. The other provided block is yielded pre and post the change.
+    def track_attribute_change(attribute, change)
+      attribute_was = yield
+      change.call
+      attribute_now = yield
+
+      return if attribute_was == attribute_now
+
+      changeset[String(attribute)] = [
+        attribute_was,
+        attribute_now,
+      ]
+    end
+
+    def track_association_change(name, change)
+      association_was = yield
+      change.call
+      association_now = yield
+      return if association_was == association_now
+
+      (association_was - association_now).each do |associated|
+        associations.build(name: name, associated: associated, kind: :remove)
+      end
+      (association_now - association_was).each do |associated|
+        associations.build(name: name, associated: associated, kind: :add)
+      end
+    end
+
+  private
+
+    def transform(name)
+      (transformations[name] if transformations) || name
+    end
+
+    def transformations
+      @transformations = audited.class.auditable[:transformations] unless defined?(@transformations)
+      @transformations
+    end
+
+  end
+end

data/db/migrate/20180213015838_create_changed_audits.rb

@@ -0,0 +1,13 @@
+class CreateChangedAudits < ActiveRecord::Migration[6.0]
+  def change
+    create_table :changed_audits do |t|
+      t.references :changer, polymorphic: true, null: true, index: true
+      t.references :audited, polymorphic: true, null: false, index: true
+      t.jsonb :changeset, default: {}, null: false
+      t.string :event, null: false
+      t.datetime :timestamp, null: false
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20180213015849_create_changed_associations.rb

@@ -0,0 +1,14 @@
+class CreateChangedAssociations < ActiveRecord::Migration[6.0]
+  def change
+    create_table :changed_associations do |t|
+      t.references :audit, null: false, index: true
+      t.references :associated, null: false, polymorphic: true, index: true
+      t.string :name, null: false
+      t.integer :kind, null: false
+
+      t.timestamps
+    end
+
+    add_foreign_key :changed_associations, :changed_audits, column: :audit_id
+  end
+end

data/lib/changed/auditable.rb

@@ -0,0 +1,51 @@
+require 'active_support/concern'
+
+module Changed
+  module Auditable
+    extend ActiveSupport::Concern
+
+    # ==== Overview
+    #
+    # A helper that caches an audit between operations. Once an audit is persisted this method handles the generation
+    # of a new audit, thus ensuring that each transaction is audited separately.
+    def audit
+      @audit = Audit.new(audited: self) if @audit.nil? || @audit.persisted?
+      @audit
+    end
+
+    included do
+      has_many :audits, -> { ordered }, as: :audited, class_name: 'Changed::Audit', dependent: :destroy
+
+      # ==== Overview
+      #
+      # A helper for setting up options.
+      #
+      def self.auditable
+        @auditable ||= {}
+      end
+
+      # ==== Overview
+      #
+      # A concern for setting up auditable for a model. An audited model can track the changes to attributes
+      # (ints, bools, strings, dates, times) or associations (`has_many`, `belongs_to`, `has_and_belongs_to_many`).
+      #
+      # The `audit` call needs to be placed after all `has_many`, `belongs_to`, `has_and_belongs_to_many` declarations
+      # in order for the association reflection to work. Multiple inclusions of `audit` are not supported.
+      #
+      # ==== Options
+      #
+      # * +:keys:+ - An array of symbols for the attributes or associations that are tracked with each audit.
+      # * +:transformations:+ - A hash of of attribute name mappings (i.e. 'number' to '#' or 'user' to 'rep').
+      #
+      # ==== Usage
+      #
+      #     audit(:number, :scheduled, :region, :address, :items, transformations: { number: "#", user: "rep" })
+      #
+      def self.audited(*keys, transformations: nil)
+        auditable[:transformations] = ActiveSupport::HashWithIndifferentAccess.new(transformations) if transformations
+        Builder.build(self, *keys)
+      end
+    end
+
+  end
+end

data/lib/changed/builder.rb

@@ -0,0 +1,141 @@
+module Changed
+  class Builder # rubocop:disable Metrics/ClassLength
+    class ArgumentError < ::ArgumentError
+    end
+
+    ARGUMENT_ERROR_EMPTY_KEYS_MESSAGE = 'audited requires specifying a splat of keys'.freeze
+
+    def self.build(*args)
+      new(*args).build
+    end
+
+    def initialize(klass, *keys)
+      raise ArgumentError, ARGUMENT_ERROR_EMPTY_KEYS_MESSAGE if keys.empty?
+
+      @klass = klass
+      @keys = keys
+    end
+
+    def build
+      define_callbacks_for_associations
+      define_after_create_callback
+      define_after_update_callback
+    end
+
+  private
+
+    def define_callbacks_for_associations
+      @keys.each do |key|
+        association = @klass.reflect_on_association(key)
+        case association
+        when ActiveRecord::Reflection::HasManyReflection,
+          ActiveRecord::Reflection::HasAndBelongsToManyReflection,
+          ActiveRecord::Reflection::ThroughReflection
+          define_callbacks_for_has_many(association)
+        when ActiveRecord::Reflection::BelongsToReflection
+          define_callbacks_for_belongs_to(association)
+        when ActiveRecord::Reflection::HasOneReflection
+          define_callbacks_for_has_one(association)
+        end
+      end
+    end
+
+    def after_create_or_update_for_belongs_to_callback(key, foreign_key, foreign_type, class_name)
+      proc do |resource|
+        was_associated_id, now_associated_id = resource.saved_change_to_attribute(foreign_key)
+        was_associated_type, now_associated_type = resource.saved_change_to_attribute(foreign_type)
+        associated_type = resource[foreign_type] || class_name
+
+        if was_associated_id
+          resource.audit.associations.build(
+            name: key,
+            kind: :remove, associated_id: was_associated_id, associated_type: was_associated_type || associated_type
+          )
+        end
+
+        if now_associated_id
+          resource.audit.associations.build(
+            name: key, kind: :add,
+            associated_id: now_associated_id, associated_type: now_associated_type || associated_type
+          )
+        end
+      end
+    end
+
+    def define_callbacks_for_belongs_to(association)
+      callback = after_create_or_update_for_belongs_to_callback(
+        association.name,
+        association.foreign_key,
+        association.foreign_type,
+        association.class_name
+      )
+
+      @klass.after_update callback
+      @klass.after_create callback
+    end
+
+    def before_add_for_has_many_callback(name)
+      proc do |_method, resource, associated|
+        resource.audit.associations.build(name: name, associated: associated, kind: :add)
+      end
+    end
+
+    def before_remove_for_has_many_callback(name)
+      proc do |_method, resource, associated|
+        resource.audit.associations.build(name: name, associated: associated, kind: :remove)
+      end
+    end
+
+    def define_callbacks_for_has_many(association)
+      name = association.name
+
+      # Ensure callback arrays exist before appending to them
+      initialize_association_callbacks(association.name)
+
+      @klass.send(:"before_add_for_#{association.name}") << before_add_for_has_many_callback(name)
+      @klass.send(:"before_remove_for_#{association.name}") << before_remove_for_has_many_callback(name)
+    end
+
+    def define_callbacks_for_has_one(association)
+      raise ArgumentError, "unsupported reflection '#{association.name}'"
+    end
+
+    def initialize_association_callbacks(association_name)
+      # Initialize callback arrays if they don't exist
+      before_add_callback_name = :"before_add_for_#{association_name}"
+      before_remove_callback_name = :"before_remove_for_#{association_name}"
+
+      # rubocop:disable Style/GuardClause
+      unless @klass.respond_to?(before_add_callback_name)
+        @klass.class_eval do
+          class_attribute before_add_callback_name, instance_writer: false, default: []
+        end
+      end
+
+      unless @klass.respond_to?(before_remove_callback_name)
+        @klass.class_eval do
+          class_attribute before_remove_callback_name, instance_writer: false, default: []
+        end
+      end
+      # rubocop:enable Style/GuardClause
+    end
+
+    def define_after_create_callback
+      keys = @keys
+      @klass.after_create do |resource|
+        audit = resource.audit
+        audit.track(Audit::Event::CREATE, keys)
+        audit.save! if audit.anything?
+      end
+    end
+
+    def define_after_update_callback
+      keys = @keys
+      @klass.after_update do |resource|
+        audit = resource.audit
+        audit.track(Audit::Event::UPDATE, keys)
+        audit.save! if audit.anything?
+      end
+    end
+  end
+end

data/lib/changed/config.rb

@@ -0,0 +1,5 @@
+module Changed
+  class Config
+    attr_accessor :default_changer_proc
+  end
+end

data/lib/changed/engine.rb

@@ -0,0 +1,10 @@
+module Changed
+  class Engine < ::Rails::Engine
+    isolate_namespace Changed
+
+    config.generators do |generator|
+      generator.test_framework :rspec
+      generator.fixture_replacement :factory_bot, dir: 'spec/factories'
+    end
+  end
+end

data/lib/changed/version.rb

@@ -1,3 +1,3 @@
 module Changed
-  VERSION = "0.0.1"
+  VERSION = '2.0.0'.freeze
 end

data/lib/changed.rb

@@ -1,5 +1,88 @@
-require "changed/version"
+require 'request_store'
+
+require 'changed/auditable'
+require 'changed/builder'
+require 'changed/config'
+require 'changed/engine'
 
 module Changed
-  # Your code goes here...
+  Field = Struct.new(:was, :now, :name)
+  Relationship = Struct.new(:associations, :name)
+
+  # Access the library configuration.
+  #
+  # ==== Examples
+  #
+  #    Changed.config.default_changer_proc = ->{ User.system }
+  def self.config
+    @config ||= Config.new
+  end
+
+  # Access the timestamp (this value is set as the timestamp within an audit and defaults to now).
+  def self.timestamp
+    options[:timestamp] || Time.now
+  end
+
+  # Customize the timestamp (uses a request store to only change lifeycle event).
+  #
+  # ==== Attributes
+  #
+  # * +timestamp+ - A timestamp to use.
+  #
+  # ==== Examples
+  #
+  #    Changed.timestamp = 2.hours.ago
+  def self.timestamp=(timestamp)
+    options[:timestamp] = timestamp
+  end
+
+  # Access the changer (this value is set as the changer within an audit and defaults to config).
+  def self.changer
+    options[:changer] || config.default_changer_proc&.call
+  end
+
+  # Customize the changer (uses a request store to only change lifeycle event).
+  #
+  # ==== Attributes
+  #
+  # * +changer+ - A changer to use.
+  #
+  # ==== Examples
+  #
+  #    Changed.changer = User.current
+  def self.changer=(changer)
+    options[:changer] = changer
+  end
+
+  # Perform a block with custom override options.
+  #
+  # ==== Attributes
+  #
+  # * +options+ - Values for the changer and / or timestamp.
+  # * +block+ - Some code to run with the new options.
+  #
+  # ==== Examples
+  #
+  #    Changed.perform(changer: User.system, timestamp: 2.hours.ago) do
+  #      widget.name = "Sprocket"
+  #      widget.save!
+  #    end
+  def self.perform(options = {}, &block)
+    backup = self.options
+    self.options = options
+    block.call
+  ensure
+    self.options = backup
+  end
+
+  OPTIONS_REQUEST_STORE_KEY = :changed_options
+  private_constant :OPTIONS_REQUEST_STORE_KEY
+
+  def self.options=(options)
+    RequestStore.store[OPTIONS_REQUEST_STORE_KEY] = options
+  end
+
+  def self.options
+    RequestStore.store[OPTIONS_REQUEST_STORE_KEY] ||= {}
+  end
 end

metadata

@@ -1,79 +1,215 @@
 --- !ruby/object:Gem::Specification
 name: changed
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Kevin Sylvestre
-autorequire: 
-bindir: exe
+autorequire:
+bindir: bin
 cert_chain: []
-date: 2018-05-15 00:00:00.000000000 Z
+date: 2025-08-05 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.5.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.5.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: request_store
+  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'
+- !ruby/object:Gem::Dependency
+  name: brakeman
+  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'
 - !ruby/object:Gem::Dependency
   name: bundler
   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'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  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'
+- !ruby/object:Gem::Dependency
+  name: factory_bot_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: pg
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rspec_junit_formatter
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
-description: 
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  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'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  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'
+- !ruby/object:Gem::Dependency
+  name: shoulda-matchers
+  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'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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: "⏱"
 email:
-- kevin@ksylvest.com
+- kevin@clutter.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
-- Gemfile
+- LICENSE
 - README.md
 - Rakefile
-- bin/console
-- bin/setup
-- changed.gemspec
+- app/models/changed/application_record.rb
+- app/models/changed/association.rb
+- app/models/changed/audit.rb
+- db/migrate/20180213015838_create_changed_audits.rb
+- db/migrate/20180213015849_create_changed_associations.rb
 - lib/changed.rb
+- lib/changed/auditable.rb
+- lib/changed/builder.rb
+- lib/changed/config.rb
+- lib/changed/engine.rb
 - lib/changed/version.rb
-homepage: 
-licenses: []
+homepage: https://github.com/clutter/changed
+licenses:
+- MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -81,16 +217,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
-summary: A simple gem for change tracking.
+summary: Provides insights into what changed.
 test_files: []

data/.gitignore

@@ -1,11 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper

data/.travis.yml

@@ -1,5 +0,0 @@
-sudo: false
-language: ruby
-rvm:
-  - 2.5.1
-before_install: gem install bundler -v 1.16.1

data/Gemfile

@@ -1,6 +0,0 @@
-source "https://rubygems.org"
-
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
-
-# Specify your gem's dependencies in changed.gemspec
-gemspec

data/bin/console

@@ -1,14 +0,0 @@
-#!/usr/bin/env ruby
-
-require "bundler/setup"
-require "changed"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start(__FILE__)

data/bin/setup

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here

data/changed.gemspec

@@ -1,24 +0,0 @@
-
-lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "changed/version"
-
-Gem::Specification.new do |spec|
-  spec.name          = "changed"
-  spec.version       = Changed::VERSION
-  spec.authors       = ["Kevin Sylvestre"]
-  spec.email         = ["kevin@ksylvest.com"]
-
-  spec.summary       = %q{A simple gem for change tracking.}
-
-  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features)/})
-  end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "bundler", "~> 1.16"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-end