rabbit_tracks 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 63c5da5a2ae609680959081a677d6041fc96ab61173ae0b7ab421945b983f21d
+  data.tar.gz: 50d62e9ae89dd1c3f9f95b1c78a42f576333bff54dc069b1bfbaf52f7e5b847b
+SHA512:
+  metadata.gz: e1f8ec6d872d963efb9a7d9ef71b38f2ded6784a1f537fdceeccec452d7565e091ec9decfa9bc50d16e6c614f7b2d22aa8b255f5af35ddfbef11e7de639a9d65
+  data.tar.gz: a89bad85be6898594ef8ad1ba30cd134d460040edf5764e37d3cd8d64fb8f5465d9733d94df1f1ccff7728deac381de1ef6346153dd69b0556da62b7122f0f45

data/.github/workflows/gem-push.yml

@@ -0,0 +1,48 @@
+name: Ruby Gem
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Ruby 2.6
+    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
+    # change this to (see https://github.com/ruby/setup-ruby#versioning):
+    # uses: ruby/setup-ruby@v1
+      uses: ruby/setup-ruby@55283cc23133118229fd3f97f9336ee23a179fcf # v1.146.0
+      with:
+        ruby-version: 2.6.x
+
+    - name: Publish to GPR
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:github: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push --KEY github --host https://rubygems.pkg.github.com/${OWNER} *.gem
+      env:
+        GEM_HOST_API_KEY: "Bearer ${{secrets.GITHUB_TOKEN}}"
+        OWNER: ${{ github.repository_owner }}
+
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"

data/.gitignore

@@ -0,0 +1 @@
+.rspec_status

data/Gemfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,185 @@
+PATH
+  remote: .
+  specs:
+    rabbit_tracks (1.0.0)
+      activerecord-import (~> 2.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (8.1.2)
+      actionview (= 8.1.2)
+      activesupport (= 8.1.2)
+      nokogiri (>= 1.8.5)
+      rack (>= 2.2.4)
+      rack-session (>= 1.0.1)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+      useragent (~> 0.16)
+    actionview (8.1.2)
+      activesupport (= 8.1.2)
+      builder (~> 3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activemodel (8.1.2)
+      activesupport (= 8.1.2)
+    activerecord (8.1.2)
+      activemodel (= 8.1.2)
+      activesupport (= 8.1.2)
+      timeout (>= 0.4.0)
+    activerecord-import (2.2.0)
+      activerecord (>= 4.2)
+    activesupport (8.1.2)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (4.0.1)
+    builder (3.3.0)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
+    crass (1.0.6)
+    date (3.5.1)
+    diff-lcs (1.6.2)
+    drb (2.2.3)
+    erb (6.0.1)
+    erubi (1.13.1)
+    generator_spec (0.10.0)
+      activesupport (>= 3.0.0)
+      railties (>= 3.0.0)
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    io-console (0.8.2)
+    irb (1.16.0)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.18.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    loofah (2.25.0)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
+    minitest (6.0.1)
+      prism (~> 1.5)
+    nokogiri (1.19.0-aarch64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.19.0-x86_64-linux-gnu)
+      racc (~> 1.4)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.7.0)
+    psych (5.3.1)
+      date
+      stringio
+    racc (1.8.1)
+    rack (3.2.4)
+    rack-session (2.1.1)
+      base64 (>= 0.1.0)
+      rack (>= 3.0.0)
+    rack-test (2.2.0)
+      rack (>= 1.3)
+    rackup (2.3.1)
+      rack (>= 3)
+    rails-dom-testing (2.3.0)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.6.2)
+      loofah (~> 2.21)
+      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
+    railties (8.1.2)
+      actionpack (= 8.1.2)
+      activesupport (= 8.1.2)
+      irb (~> 1.13)
+      rackup (>= 1.0.0)
+      rake (>= 12.2)
+      thor (~> 1.0, >= 1.2.2)
+      tsort (>= 0.2)
+      zeitwerk (~> 2.6)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    rdoc (7.0.3)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (1.82.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    sqlite3 (2.9.0-aarch64-linux-gnu)
+    sqlite3 (2.9.0-x86_64-linux-gnu)
+    stringio (3.2.0)
+    thor (1.5.0)
+    timeout (0.6.0)
+    tsort (0.2.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    useragent (0.16.11)
+    zeitwerk (2.7.4)
+
+PLATFORMS
+  aarch64-linux
+  x86_64-linux
+
+DEPENDENCIES
+  bundler (~> 2.7.2)
+  generator_spec (~> 0.10.0)
+  rabbit_tracks!
+  rake (~> 13.3.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.82.1)
+  sqlite3 (~> 2.9.0)
+
+BUNDLED WITH
+   2.7.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Peter Zhang
+
+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

@@ -0,0 +1,154 @@
+# Rabbit Tracks
+
+Rabbit Tracks is a gem keeps all model changes you care about.
+It keeps a record of who made which change at what time.
+
+You can skip any database columns as well.
+For example: `updated_at`, `created_at` and `password` etc.
+
+## Installation
+
+Add it to your `Gemfile` then `bundle install`
+
+```
+gem 'rabbit_tracks'
+```
+
+Next we need to generate a migration and create a table to keep all changes
+
+```
+rails generate rabbit_tracks:install RabbitTracks
+```
+
+Then:
+
+```sh
+rails db:migrate
+```
+
+## Use Rabbit Tracks Gem
+
+1. **ActiveRecord Models**  
+   Enable rabbit_tracks for Active Record Model,  
+   just put following line in very beginning of model file.
+
+```ruby
+enable_rabbit_tracks :ignore=>[:updated_at]
+```
+
+Put any columns you do not want to keep in the rabbit tracks table in `:ignore` option.  
+eg. the password hash
+
+Then the system should record every changes the user made to rabbit_tracks table.  
+If you are making changes within Model file:  
+For Example:
+
+```ruby
+# this is a model file
+def making_some_changes
+  user = User.first
+  user.email = 'test@example.com'
+  user.save
+end
+```
+
+An attribute called `whodidit` is automatically available.  
+So if you want to keep the changes in this scenario, do following:
+
+```ruby
+# this is a model file
+def making_some_changes
+  user = User.first
+  user.email = 'test@example.com'
+  user.whodidit = 'TestUser'
+  user.save
+end
+```
+
+2. **Optional: Add current_user Method in application_controller.rb**
+
+This method will tell rabbit_tracks who is the current user
+
+```ruby
+def current_user
+  return session[:user] # replace this with your own code
+end
+```
+
+3. **About the RabbitTrack Model**  
+   RabbitTrack model is core ActiveRecord model used by rabbit_tracks gem.
+
+You can use it directly in your model, controller even in helper.
+
+For example:
+
+```ruby
+# List all changes
+RabbitTrack.all
+```
+
+```ruby
+# List all changes made by specific user
+RabbitTrack.where('user = ?', 'example_user')
+```
+
+```ruby
+# List all changes for specific table
+RabbitTrack.where('table_name = ?', 'accounts')
+```
+
+4. **Turn RabbitTrack off in testing environment**  
+   You can globally turn it off for your testing.
+
+```ruby
+# config/environment.rb
+RabbitTracks.enabled = false if Rails.env.test?
+```
+
+5. **Database and table name**  
+   rabbit_tracks gem can save changes into separate database from the main application.  
+   The database could be Postgres, SQLite, MySQL or any other database that active record is happy to connect with.
+
+Here is an example of database.yml when using separate database for 'rabbit_tracks':
+
+```yaml
+rabbit_tracks:
+  adapter: mysql2
+  encoding: utf8
+  database: a_different_database
+  username: username
+  password: ********
+  host: hostname
+  port: 3306
+```
+
+And also you need to tell rabbit_tracks gem to establish the connection.
+
+```ruby
+# config/environment.rb
+RabbitTrack.establish_connection(:rabbit_tracks)
+```
+
+Table name is also configurable. Instead of 'rabbit_tracks', choose your preferred table name and run the migration.  
+Just remember in your environment.rb file, you need to tell rabbit_tracks gem what is your table name:
+
+```ruby
+# config/environment.rb
+RabbitTrack.table_name :a_different_table_name
+```
+
+## Testing
+Run
+
+```
+bundle exec rspec spec
+```
+
+## Bug reporting or any enquiries
+
+Please use Github Issues or Discussions: https://github.com/peterpengnz/rabbit_tracks
+
+### Author
+
+Peter Zhang  
+Copyright (c) 2026 Peter Zhang, released under the MIT license

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/generators/rabbit_tracks/install.rb

@@ -0,0 +1,17 @@
+require 'rails/generators/active_record'
+require 'rails/generators/named_base'
+
+module RabbitTracks
+  module Generators
+    class Install < Rails::Generators::NamedBase
+      source_root File.expand_path('templates', __dir__)
+
+      def create_migration
+        migration_file_name = 'create_rabbit_tracks.rb'
+        timestamp = Time.now.utc.strftime('%Y%m%d%H%M%S')
+        destination = File.join('db', 'migrate', "#{timestamp}_#{migration_file_name}")
+        template migration_file_name, destination
+      end
+    end
+  end
+end

data/lib/generators/rabbit_tracks/templates/create_rabbit_tracks.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Migration template for creating the rabbit_tracks table
+class CreateRabbitTracks < ActiveRecord::Migration[8.1]
+  def change
+    create_table :rabbit_tracks do |t|
+      t.integer :version, null: false      # store version of each change
+      t.string :record_id, limit: 64       # store the actual record id
+      t.string :table_name, limit: 64      # store the table name
+      t.string :attribute_name, limit: 64  # store the column name
+      t.string :user, limit: 64            # store the user who made the change
+      t.string :action, limit: 6           # store the change action: create, read, update, delete
+      t.text :old_value                    # the value before change
+      t.text :new_value                    # value after change
+      t.string :field_type, limit: 30      # the column type eg. date, text, varchar, int etc
+      t.timestamps
+    end
+  end
+end

data/lib/rabbit_tracks/config.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module RabbitTracks
+  class Config
+    include Singleton
+    attr_accessor :enabled
+
+    def initialize
+      # Indicates whether RabbitTracks is on or off.
+      @enabled = true
+    end
+  end
+end

data/lib/rabbit_tracks/controller.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module RabbitTracks
+  module Controller
+    def self.included(base)
+      base.before_filter :set_rabbit_tracks_whodidit
+    end
+
+    protected
+
+    # Returns the user who is responsible for any changes that occur.
+    # By default this calls `current_user` and returns the result.
+    #
+    # Override this method in your controller to call a different
+    # method, e.g. `current_login_user`, or anything.
+    def rabbit_tracks_current_user
+      current_user
+    rescue StandardError
+      nil
+    end
+
+    private
+
+    # Tells RabbitTracks who is responsible for any changes.
+    def set_rabbit_tracks_whodidit
+      ::RabbitTracks.whodidit = rabbit_tracks_current_user
+    end
+  end
+end

data/lib/rabbit_tracks/has_rabbit_tracks.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+require 'rabbit_tracks/railtie' if defined?(Rails)
+
+module RabbitTracks
+  module Model
+    def self.included(base)
+      base.send :extend, ClassMethods
+    end
+
+    module ClassMethods
+      # Declare this in your model to keep a change record for every create, update, and destroy.
+      # Option:
+      # :ignore    an array of attributes will be ignored when saving changes to rabbit tracks
+      def include_rabbit_tracks(options = {})
+        send :include, InstanceMethods
+
+        cattr_accessor :ignore, :whodidit
+        self.ignore = (options[:ignore] || []).map(&:to_s)
+        # Indicates whether or not RabbitTracks is active for this class.
+        # This is independent of whether RabbitTracks is globally enabled or disabled.
+        cattr_accessor :rabbit_tracks_enabled
+        self.rabbit_tracks_enabled = true
+        after_create  :record_create
+        before_update :record_update
+        after_destroy :record_destroy
+      end
+
+      # Disables RabbitTracks for this class.
+      def disable_rabbit_tracks
+        self.rabbit_tracks_enabled = false
+      end
+
+      # Enables RabbitTracks for this class.
+      def enable_rabbit_tracks
+        self.rabbit_tracks_enabled = true
+      end
+    end
+
+    # Wrap the following methods in a module so we can include them only in the
+    # ActiveRecord models that declare `include_rabbit_tracks`.
+    module InstanceMethods
+      def record_create
+        # do nothing if the rabbit tracks is not enabled
+        return unless enabled?
+
+        changes = []
+        attributes.map do |key, value|
+          next if ignore.include?(key.to_sym)
+
+          changes << {
+            action: 'INSERT',
+            record_id: id,
+            table_name: self.class.table_name,
+            user: RabbitTracks.whodidit,
+            attribute_name: key,
+            new_value: value,
+            version: 1
+          }
+        end
+        RabbitTrack.update_records_with(changes)
+      end
+
+      def record_update
+        # do nothing if the rabbit tracks is not enabled or failed active record validation or no changes has been made
+        return unless enabled? && valid? && changed?
+
+        changes = []
+        # saving changes to rabbit tracks
+        self.changes.each do |attribute_name, value|
+          # do not record changes between nil <=> ''
+          # and ignore the changes for ignored columns
+          if value[1].eql?(value[0]) || (value[1].blank? && value[0].blank?) || ignore.include?(attribute_name.to_s)
+            next
+          end
+
+          changes << {
+            action: 'UPDATE',
+            record_id: id,
+            table_name: self.class.table_name,
+            user: RabbitTracks.whodidit,
+            attribute_name: attribute_name,
+            old_value: value[0],
+            new_value: value[1],
+            version: RabbitTracks.get_version_number(id, self.class.table_name)
+          }
+        end
+        RabbitTrack.update_records_with(changes)
+      end
+
+      def record_destroy
+        return unless enabled?
+
+        changes = [{
+          action: 'DELETE',
+          table_name: self.class.table_name,
+          record_id: id,
+          user: RabbitTracks.whodidit,
+          version: RabbitTrack.get_version_number(id, self.class.table_name)
+        }]
+        RabbitTrack.update_records_with(changes)
+      end
+
+      # Return a list of changes records
+      # Return empty array if not record found
+      def rabbit_tracks
+        RabbitTrack.where(table_name: self.class.table_name, record_id: id).order('created_at DESC')
+      end
+
+      # Return `true` if current record has a list of changes records
+      # otherwise `false`.
+      def rabbit_tracks?
+        RabbitTrack.exists?(table_name: self.class.table_name, record_id: id)
+      end
+
+      private
+
+      # Returns `true` if RabbitTracks is globally enabled and active for this class,
+      # `false` otherwise.
+      def enabled?
+        RabbitTracks.enabled? && self.class.rabbit_tracks_enabled
+      end
+    end
+  end
+end

data/lib/rabbit_tracks/rabbit_track.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'active_record'
+require 'activerecord-import'
+
+class RabbitTrack < ActiveRecord::Base
+  self.table_name = 'rabbit_tracks'
+  def self.update_records_with(changes = [])
+    records = []
+    changes.each do |option|
+      record = RabbitTrack.new(option)
+      record.field_type = get_field_type(option[:action], option[:table_name], option[:attribute_name])
+      record.user = option[:user].id if option[:user].respond_to?(:id)
+      records << record
+    end
+    RabbitTrack.import records, validate: false
+    true
+  end
+
+  # return the latest version number for this change
+  def self.get_version_number(id, table_name)
+    latest_version = RabbitTrack.where(record_id: id, table_name: table_name).maximum(:version)
+    latest_version.nil? ? 1 : latest_version.next
+  end
+
+  def self.get_field_type(curd_action, table_name, field_name)
+    raise ArgumentError, 'Table name and field name cannot be blank' if table_name.blank? || field_name.blank?
+    return if curd_action.to_s.upcase == 'DELETE'
+
+    ActiveRecord::Base.connection.columns(table_name).each do |field|
+      return field.sql_type if field.name.eql?(field_name)
+    end
+  end
+end

data/lib/rabbit_tracks/railtie.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'rails/railtie'
+
+module RabbitTracks
+  class Railtie < Rails::Railtie
+    initializer 'rabbit_tracks.active_record' do
+      ActiveSupport.on_load(:active_record) do
+        include RabbitTracks::Model
+      end
+    end
+  end
+end

data/lib/rabbit_tracks/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RabbitTracks
+  VERSION = '1.0.0'
+end

data/lib/rabbit_tracks.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'singleton'
+require 'yaml'
+require 'rabbit_tracks/config'
+require 'rabbit_tracks/controller'
+require 'rabbit_tracks/has_rabbit_tracks'
+require 'rabbit_tracks/rabbit_track'
+
+# RabbitTracks's module methods can be called in both models and controllers.
+module RabbitTracks
+  # Switches RabbitTracks on or off.
+  def self.enabled=(value)
+    RabbitTracks.config.enabled = value
+  end
+
+  # Returns `true` if RabbitTracks is on, `false` otherwise.
+  # RabbitTracks is enabled by default.
+  def self.enabled?
+    !!RabbitTracks.config.enabled
+  end
+
+  # Returns who is responsible for any changes that occur.
+  def self.whodidit
+    rabbit_tracks_store[:whodidit]
+  end
+
+  # Sets who is responsible for any changes that occur.
+  # In a controller it automatically get the value from `current_user` action.
+  def self.whodidit=(value)
+    rabbit_tracks_store[:whodidit] = value
+  end
+
+  # Thread-safe hash to hold RabbitTracks's data.
+  def self.rabbit_tracks_store
+    Thread.current[:rabbit_tracks] ||= {}
+  end
+
+  # Returns RabbitTracks's configuration object.
+  def self.config
+    @config ||= RabbitTracks::Config.instance
+  end
+end

data/rabbit_tracks.gemspec

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rabbit_tracks/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'rabbit_tracks'
+  spec.version       = RabbitTracks::VERSION
+  spec.authors       = ['Peter Zhang']
+  spec.email         = ['peterpengnz@gmail.com']
+
+  spec.summary       = 'Rabbit Tracks is a gem keeps all model changes you care about.'
+  spec.description   = 'Rabbit Tracks keeps a record of who made which change at what time.
+                          You can skip any database columns as well.
+                          For example: `updated_at`, `created_at` and `password` etc.'
+  spec.homepage      = 'https://github.com/peterpengnz/rabbit_tracks'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 2.7'
+
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org/'
+
+    spec.metadata['homepage_uri'] = spec.homepage
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
+  end
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |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', '~> 2.7.2'
+  spec.add_development_dependency 'generator_spec', '~> 0.10.0'
+  spec.add_development_dependency 'rake', '~> 13.3.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 1.82.1'
+  spec.add_development_dependency 'sqlite3', '~> 2.9.0'
+
+  spec.add_dependency 'activerecord-import', '~> 2.2.0'
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: rabbit_tracks
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Peter Zhang
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.2
+- !ruby/object:Gem::Dependency
+  name: generator_spec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 13.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 13.3.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.82.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.82.1
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+- !ruby/object:Gem::Dependency
+  name: activerecord-import
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+description: |-
+  Rabbit Tracks keeps a record of who made which change at what time.
+                            You can skip any database columns as well.
+                            For example: `updated_at`, `created_at` and `password` etc.
+email:
+- peterpengnz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".DS_Store"
+- ".github/workflows/gem-push.yml"
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/.DS_Store
+- lib/generators/rabbit_tracks/install.rb
+- lib/generators/rabbit_tracks/templates/create_rabbit_tracks.rb
+- lib/rabbit_tracks.rb
+- lib/rabbit_tracks/config.rb
+- lib/rabbit_tracks/controller.rb
+- lib/rabbit_tracks/has_rabbit_tracks.rb
+- lib/rabbit_tracks/rabbit_track.rb
+- lib/rabbit_tracks/railtie.rb
+- lib/rabbit_tracks/version.rb
+- rabbit_tracks.gemspec
+homepage: https://github.com/peterpengnz/rabbit_tracks
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org/
+  homepage_uri: https://github.com/peterpengnz/rabbit_tracks
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Rabbit Tracks is a gem keeps all model changes you care about.
+test_files: []