Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Smart, performant auditing of ActiveRecord models

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md
Octocat-spinner-32 Rakefile
Octocat-spinner-32 TODO
Octocat-spinner-32 track_history.gemspec
README.md

TrackHistory

Introduction

Sometimes you want to track changes in a model, but in larger tables its really inefficient to query against a polymorphic relationship in a single table like 'audits'. TrackHistory is a way to do this in a performant way, and its still easy!

Imagine you want to track how the name of users change over time:

# add a mix-in to your model (yes, that's all)
track_history

Then create a migration for a table with the following structure (generator coming soon):

id, user_id, email_before, email_after, created_at

If you want to also record creations and deletions, you should add a column like:

action ENUM ('create', 'update', 'destroy') # action can also be a varchar

You will automatically get:

user.histories
user.histories.first.class # User::History

user.histories.first.modifications # ["email"]

You can do this with any field or method.


There's more

But wait, you say! I want to use this to annotate some more information when there's changes, about the current state of the object.

# add the field, ex: 'name' in a migration
track_history do
  annotate :name
  annotate :name, :as => :the_name
end

# or you can pass a block
track_history do
  annotate(:name) { "#{name} !!!" }
end

If you need to change the field names to work with legacy tables you can do that too:

track_history do
  field :name, :before => :name_from, :after => :name_to
end

And if you don't want the reference field maintained for whatever reason:

track_history :reference => false

Adding methods to *::History

To add methods to your History classes, or create additional relationships that you may need, you can work directly in the track_history block:

track_history(:model_name => 'WorkflowChange', :reference => false) do
  annotate :object_id
  self.belongs_to :object
end

Installation (in your Gemfile)

gem 'track_history', '0.0.10'

Other options

If you need to change the name of the model, you can do something like:

track_history :model_name => 'UserAudit'
track_history :table_name => 'user_audits'

License

The MIT License (see attached)

Something went wrong with that request. Please try again.