timestamped_column 0.1.1 → 0.2.0

data/README.md

@@ -1,16 +1,32 @@
-Time-stamped Column
-===================
+# timestamped_column [![Build Status](https://secure.travis-ci.org/JamesBrooks/timestamped_column.png)](http://travis-ci.org/JamesBrooks/timestamped_column>) [![Dependency Status](https://gemnasium.com/JamesBrooks/timestamped_column.png)](https://gemnasium.com/JamesBrooks/timestamped_column)
 
-Records modified time for individual columns.
+Records the modification time for specific database columns on individual records (using ActiveRecord).
 
-Usage (in a model)
-------------------
 
-`timestamped_column :email_address`
+## Compatibility
 
-Records the most recent modification time of `:email_address` to `:email_address_updated_at` (defaults to `name_updated_at`)
+Tested and works with:
 
+* Ruby: 1.8.7, 1.9.2, 1.9.3 and REE.
+* Rails: 3.0, 3.1, 3.2 and edge.
 
-`timestamped_column :email_address, :column => :email_address_changed_at`
 
-Records the most recent modification time of `:email_address` to `:email_address_changed_at`
+## Installation
+
+Add `timestamped_column` to your `Gemfile`:
+
+```
+gem 'timestamped_column'
+```
+
+
+## Usage
+
+Usage is similar to how `created_at`/`updated_at` function in Rails. All you need to start tracking attribute modification times is to add a new column to store the modification value. The column that tracks the modification value should be suffxed with either `_updated_at` or `_updated_on`.
+
+
+## Example
+
+If you have a model `User` with an attribute `name` that you want to track the modification time of you just simple add an column named `name_updated_at` (or `name_updated_on`) to the `users` table.
+
+`timestamped_column` checked for the presence of columns named like this and automatically updates these when the attributes they track are changed.

data/Rakefile

@@ -0,0 +1,29 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'TimestampedColumn'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+Bundler::GemHelper.install_tasks
+
+task :default => :spec

data/lib/timestamped_column/active_record/timestamped_column.rb

@@ -0,0 +1,57 @@
+module ActiveRecord
+  # = Active Record Column Timestamp
+  #
+  # Automatically timestamps when particular attributes (columns) have been changed
+  # if the table has fields suffixed with <tt>_updated_at/_updated_on</tt>
+  #
+  # Example: A table with a field <tt>user_name</tt> would have it's modification time
+  # recorded if a field named <tt>user_name_updated_at</tt> exists.
+  module TimestampedColumn
+  private
+    def create(*args) #:nodoc:
+      update_timestamp_attributes
+      super
+    end
+
+    def update(*args) #:nodoc:
+      update_timestamp_attributes
+      super
+    end
+
+    def update_timestamp_attributes #:nodoc:
+      current_time = current_time_from_proper_timezone
+
+      timestamped_attributes_in_model.each do |attribute, timestamp_attribute|
+        if attribute_changed?(attribute)
+          write_attribute(timestamp_attribute, current_time)
+        end
+      end
+    end
+
+    def timestamped_attributes_in_model #:nodoc:
+      {}.tap do |timestamped_attributes|
+        self.class.column_names.each do |column|
+          if attribute = timestamp_attribute_for_column(column)
+            timestamped_attributes[column] = attribute
+          end
+        end
+      end
+    end
+
+    def timestamp_attribute_for_column(column) #:nodoc:
+      self.class.column_names.detect { |c| %r{(#{possible_timestamp_attributes_for_column(column).join('|')})$} =~ c }
+    end
+
+    def possible_timestamp_attributes_for_column(column) #:nodoc:
+      column_timestamp_attribute_suffixes.map { |suffix| [ column, suffix].join }
+    end
+
+    def column_timestamp_attribute_suffixes #:nodoc:
+      ['_updated_at', '_updated_on']
+    end
+
+    def current_time_from_proper_timezone # from ActiveRecord::Timestamp
+      self.class.default_timezone == :utc ? Time.now.utc : Time.now
+    end
+  end
+end

data/lib/timestamped_column/version.rb

@@ -1,3 +1,3 @@
 module TimestampedColumn
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/timestamped_column.rb

@@ -1,2 +1,6 @@
-require 'active_support/concern'
-require 'timestamped_column/active_record'
+require "timestamped_column/version"
+require "timestamped_column/active_record/timestamped_column"
+
+module TimestampedColumn
+  ActiveRecord::Base.send :include, ActiveRecord::TimestampedColumn
+end

data/spec/dummy/Rakefile

@@ -0,0 +1,7 @@
+#!/usr/bin/env rake
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+
+Dummy::Application.load_tasks

data/spec/dummy/app/models/user.rb

@@ -0,0 +1,3 @@
+class User < ActiveRecord::Base
+  # attr_accessible :title, :body
+end

data/spec/dummy/config/application.rb

@@ -0,0 +1,12 @@
+require File.expand_path('../boot', __FILE__)
+
+require 'rails/all'
+
+Bundler.require
+require "timestamped_column"
+
+module Dummy
+  class Application < Rails::Application
+  end
+end
+

data/spec/dummy/config/boot.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+gemfile = File.expand_path('../../../../Gemfile', __FILE__)
+
+if File.exist?(gemfile)
+  ENV['BUNDLE_GEMFILE'] = gemfile
+  require 'bundler'
+  Bundler.setup
+end
+
+$:.unshift File.expand_path('../../../../lib', __FILE__)

data/spec/dummy/config/database.yml

@@ -0,0 +1,5 @@
+test:
+  adapter: sqlite3
+  database: db/test.sqlite3
+  pool: 5
+  timeout: 5000

data/spec/dummy/config/environment.rb

@@ -0,0 +1,5 @@
+# Load the rails application
+require File.expand_path('../application', __FILE__)
+
+# Initialize the rails application
+Dummy::Application.initialize!

data/spec/dummy/config/environments/test.rb

@@ -0,0 +1,12 @@
+Dummy::Application.configure do
+  config.cache_classes                              = true
+  config.serve_static_assets                        = true
+  config.static_cache_control                       = "public, max-age=3600"
+  config.whiny_nils                                 = true
+  config.consider_all_requests_local                = true
+  config.action_controller.perform_caching          = false
+  config.action_dispatch.show_exceptions            = false
+  config.action_controller.allow_forgery_protection = false
+  config.action_mailer.delivery_method              = :test
+  config.active_support.deprecation                 = :stderr
+end

data/spec/dummy/config.ru

@@ -0,0 +1,4 @@
+# This file is used by Rack-based servers to start the application.
+
+require ::File.expand_path('../config/environment',  __FILE__)
+run Dummy::Application

data/spec/dummy/db/migrate/20120507214419_create_users.rb

@@ -0,0 +1,10 @@
+class CreateUsers < ActiveRecord::Migration
+  def change
+    create_table :users do |t|
+      t.string   :name, :email, :phone
+      t.datetime :name_updated_at, :email_updated_at
+
+      t.timestamps
+    end
+  end
+end

data/spec/dummy/db/schema.rb

@@ -0,0 +1,26 @@
+# encoding: UTF-8
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# Note that this schema.rb definition is the authoritative source for your
+# database schema. If you need to create the application database on another
+# system, you should be using db:schema:load, not running all the migrations
+# from scratch. The latter is a flawed and unsustainable approach (the more migrations
+# you'll amass, the slower it'll run and the greater likelihood for issues).
+#
+# It's strongly recommended to check this file into your version control system.
+
+ActiveRecord::Schema.define(:version => 20120507214419) do
+
+  create_table "users", :force => true do |t|
+    t.string   "name"
+    t.string   "email"
+    t.string   "phone"
+    t.datetime "name_updated_at"
+    t.datetime "email_updated_at"
+    t.datetime "created_at",       :null => false
+    t.datetime "updated_at",       :null => false
+  end
+
+end

data/spec/dummy/log/test.log

@@ -0,0 +1,133 @@
+  SQL (0.2ms)   SELECT name
+ FROM sqlite_master
+ WHERE type = 'table' AND NOT name = 'sqlite_sequence'
+
+  SQL (0.5ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES ('2012-05-08 15:57:16.011480', NULL, NULL, 'Joe User', '2012-05-08 15:57:16.009622', NULL, '2012-05-08 15:57:16.011480')
+  SQL (0.5ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES ('2012-05-08 15:57:16.054429', NULL, NULL, 'Joe User', '2012-05-08 15:57:16.026902', NULL, '2012-05-08 15:57:16.054429')
+  SQL (0.4ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES ('2012-05-08 15:57:16.060055', 'joe.user@email.com', '2012-05-08 15:57:16.058203', 'Joe User', '2012-05-08 15:57:16.058203', '123-456-7890', '2012-05-08 15:57:16.060055')
+  SQL (0.4ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES ('2012-05-08 15:57:16.070242', 'joe.user@email.com', '2012-05-08 15:57:16.068367', 'Joe User', '2012-05-08 15:57:16.068367', '123-456-7890', '2012-05-08 15:57:16.070242')
+  SQL (0.4ms)  UPDATE "users" SET "phone" = '000-000-0000', "updated_at" = '2012-05-08 15:57:16.075703' WHERE ("users"."id" = 1)
+  SQL (0.4ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES ('2012-05-08 15:57:16.081214', 'joe.user@email.com', '2012-05-08 15:57:16.079271', 'Joe User', '2012-05-08 15:57:16.079271', '123-456-7890', '2012-05-08 15:57:16.081214')
+  SQL (0.4ms)  UPDATE "users" SET "phone" = '000-000-0000', "updated_at" = '2012-05-08 15:57:16.084974' WHERE ("users"."id" = 1)
+  SQL (0.4ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES ('2012-05-08 15:57:16.090262', 'joe.user@email.com', '2012-05-08 15:57:16.088239', 'Joe User', '2012-05-08 15:57:16.088239', '123-456-7890', '2012-05-08 15:57:16.090262')
+  SQL (0.4ms)  UPDATE "users" SET "name" = 'John Blogs', "name_updated_at" = '2012-05-08 16:57:16.092567', "updated_at" = '2012-05-08 16:57:16.094518' WHERE ("users"."id" = 1)
+  SQL (0.3ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES ('2012-05-08 15:57:16.100080', 'joe.user@email.com', '2012-05-08 15:57:16.098232', 'Joe User', '2012-05-08 15:57:16.098232', '123-456-7890', '2012-05-08 15:57:16.100080')
+  SQL (0.4ms)  UPDATE "users" SET "name" = 'John Blogs', "name_updated_at" = '2012-05-08 16:57:16.102151', "updated_at" = '2012-05-08 16:57:16.104267' WHERE ("users"."id" = 1)
+  SQL (0.4ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES ('2012-05-08 15:57:16.111782', 'joe.user@email.com', '2012-05-08 15:57:16.109988', 'Joe User', '2012-05-08 15:57:16.109988', '123-456-7890', '2012-05-08 15:57:16.111782')
+  SQL (0.4ms)  UPDATE "users" SET "name_updated_at" = '2012-05-07 15:57:16.113431', "updated_at" = '2012-05-08 15:57:16.118064' WHERE ("users"."id" = 1)
+   (0.5ms)  begin transaction
+   (0.1ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.1ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (9.1ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["email", nil], ["email_updated_at", nil], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["phone", nil], ["updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00]]
+   (0.1ms)  RELEASE SAVEPOINT active_record_1
+   (0.5ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  rollback transaction
+   (0.0ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.5ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["email", nil], ["email_updated_at", nil], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["phone", nil], ["updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (10.5ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.1ms)  SAVEPOINT active_record_1
+  SQL (0.6ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (2.4ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.6ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.1ms)  SAVEPOINT active_record_1
+   (0.5ms)  UPDATE "users" SET "phone" = '000-000-0000', "updated_at" = '2012-05-08 15:59:37.252409' WHERE "users"."id" = 1
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.6ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.6ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.0ms)  SAVEPOINT active_record_1
+   (0.4ms)  UPDATE "users" SET "phone" = '000-000-0000', "updated_at" = '2012-05-08 15:59:37.263297' WHERE "users"."id" = 1
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (2.8ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.1ms)  SAVEPOINT active_record_1
+  SQL (0.6ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00]]
+   (0.1ms)  RELEASE SAVEPOINT active_record_1
+   (2.7ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.6ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (3.1ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.6ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:37 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.1ms)  SAVEPOINT active_record_1
+   (0.4ms)  UPDATE "users" SET "name_updated_at" = '2012-05-07 15:59:37.289174', "updated_at" = '2012-05-08 15:59:37.293176' WHERE "users"."id" = 1
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.6ms)  rollback transaction
+   (0.5ms)  begin transaction
+   (0.1ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.1ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (5.0ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["email", nil], ["email_updated_at", nil], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["phone", nil], ["updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00]]
+   (0.1ms)  RELEASE SAVEPOINT active_record_1
+   (0.6ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.1ms)  rollback transaction
+   (0.0ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.5ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["email", nil], ["email_updated_at", nil], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["phone", nil], ["updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00]]
+   (0.1ms)  RELEASE SAVEPOINT active_record_1
+   (0.6ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.9ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00]]
+   (0.1ms)  RELEASE SAVEPOINT active_record_1
+   (0.5ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.6ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00]]
+   (0.1ms)  RELEASE SAVEPOINT active_record_1
+   (0.1ms)  SAVEPOINT active_record_1
+   (0.5ms)  UPDATE "users" SET "phone" = '000-000-0000', "updated_at" = '2012-05-08 15:59:53.987355' WHERE "users"."id" = 1
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.6ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.1ms)  SAVEPOINT active_record_1
+  SQL (0.6ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:53 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.0ms)  SAVEPOINT active_record_1
+   (0.4ms)  UPDATE "users" SET "phone" = '000-000-0000', "updated_at" = '2012-05-08 15:59:53.998711' WHERE "users"."id" = 1
+   (0.1ms)  RELEASE SAVEPOINT active_record_1
+   (0.5ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.5ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.1ms)  SAVEPOINT active_record_1
+   (0.4ms)  UPDATE "users" SET "name" = 'John Blogs', "name_updated_at" = '2012-05-08 16:59:54.006275', "updated_at" = '2012-05-08 16:59:54.008192' WHERE "users"."id" = 1
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.9ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.0ms)  SAVEPOINT active_record_1
+  SQL (0.5ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00]]
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.1ms)  SAVEPOINT active_record_1
+   (0.4ms)  UPDATE "users" SET "name" = 'John Blogs', "name_updated_at" = '2012-05-08 16:59:54.016571', "updated_at" = '2012-05-08 16:59:54.018614' WHERE "users"."id" = 1
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.6ms)  rollback transaction
+   (0.1ms)  begin transaction
+   (0.1ms)  SAVEPOINT active_record_1
+  SQL (0.8ms)  INSERT INTO "users" ("created_at", "email", "email_updated_at", "name", "name_updated_at", "phone", "updated_at") VALUES (?, ?, ?, ?, ?, ?, ?)  [["created_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["email", "joe.user@email.com"], ["email_updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["name", "Joe User"], ["name_updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00], ["phone", "123-456-7890"], ["updated_at", Tue, 08 May 2012 15:59:54 UTC +00:00]]
+   (0.1ms)  RELEASE SAVEPOINT active_record_1
+   (0.1ms)  SAVEPOINT active_record_1
+   (0.4ms)  UPDATE "users" SET "name_updated_at" = '2012-05-07 15:59:54.026696', "updated_at" = '2012-05-08 15:59:54.030661' WHERE "users"."id" = 1
+   (0.0ms)  RELEASE SAVEPOINT active_record_1
+   (0.6ms)  rollback transaction

data/spec/dummy/script/rails

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails 3 gems installed from the root of your application.
+
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require File.expand_path('../../config/boot',  __FILE__)
+require 'rails/commands'

data/spec/factories/user.rb

@@ -0,0 +1,5 @@
+FactoryGirl.define do
+  factory :user do
+    name 'Joe User'
+  end
+end

data/spec/models/user_spec.rb

@@ -0,0 +1,110 @@
+require 'spec_helper'
+
+describe 'User with timestamped columns' do
+  describe 'Sanity' do
+    before(:each) do
+      @user = FactoryGirl.build(:user)
+    end
+
+    it 'should initialize' do
+      @user.should be_a_kind_of User
+    end
+
+    it 'should have the specified factory defaults' do
+      @user.name.should match 'Joe User'
+      @user.email.should be_nil
+      @user.phone.should be_nil
+    end
+
+    it 'should persist' do
+      @user.save
+      @user.should be_persisted
+    end
+  end
+
+
+  describe 'Non-persisted models' do
+    before(:each) do
+      @user = FactoryGirl.build(:user)
+    end
+
+    it 'should not have timestamped columns set' do
+      @user.name_updated_at.should be_nil
+      @user.email_updated_at.should be_nil
+    end
+  end
+
+
+  describe 'Persisting models' do
+    before(:each) do
+      @user = FactoryGirl.build(:user)
+    end
+
+    it 'should set timestamped column values on create for attributes with set values' do
+      @user.save
+
+      @user.name_updated_at.should be_a_kind_of Time
+      @user.email_updated_at.should be_nil
+    end
+
+    it 'should set timestamped column values for multiple attributes' do
+      @user.email = 'joe.user@email.com'
+      @user.phone = '123-456-7890'
+      @user.save
+
+      @user.name_updated_at.should be_a_kind_of Time
+      @user.email_updated_at.should be_a_kind_of Time
+    end
+  end
+
+  describe 'Updating models' do
+    before(:each) do
+      @user = FactoryGirl.create(:user, {
+        :email => 'joe.user@email.com',
+        :phone => '123-456-7890'
+      })
+    end
+
+    it 'should update non-timestamped fields without updating any timestamped fields (part 1)' do
+      expect {
+        @user.phone = '000-000-0000'
+        @user.save
+      }.to_not change { @user.name_updated_at }
+    end
+
+    it 'should update non-timestamped fields without updating any timestamped fields (part 2)' do
+      expect {
+        @user.phone = '000-000-0000'
+        @user.save
+      }.to_not change { @user.email_updated_at }
+    end
+
+    it 'should update an attributes timestamped column if the attribute changes' do
+      in_the_future do
+        expect {
+          @user.name = 'John Blogs'
+          @user.save
+        }.to change { @user.name_updated_at }
+      end
+    end
+
+    it 'should not update another timestamp column if a different timestamped attribute changes' do
+      in_the_future do
+        expect {
+          @user.name = 'John Blogs'
+          @user.save
+        }.to_not change { @user.email_updated_at }
+      end
+    end
+
+    it 'should allow updating of timestamp columns without complaint' do
+      time = 1.day.ago
+
+      @user.name_updated_at = time
+      @user.name_updated_at.should equal time
+
+      @user.save
+      @user.name_updated_at.should equal time
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+ENV["RAILS_ENV"] ||= 'test'
+
+require File.expand_path("../dummy/config/environment", __FILE__)
+require 'rspec/rails'
+require 'rspec/autorun'
+require 'factory_girl_rails'
+require 'timecop'
+
+Dir[Rails.root.join("spec/support/**/*.rb")].each {|f| require f}
+
+RSpec.configure do |config|
+  config.use_transactional_fixtures = true
+  config.infer_base_class_for_anonymous_controllers = false
+end

data/spec/support/timecop.rb

@@ -0,0 +1,5 @@
+def in_the_future
+  Timecop.travel(1.hour.from_now) do
+    yield
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: timestamped_column
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,42 +9,94 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-23 00:00:00.000000000Z
+date: 2012-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &70338618301700 !ruby/object:Gem::Requirement
+  requirement: &70095850747460 !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.2'
   type: :runtime
   prerelease: false
-  version_requirements: *70338618301700
+  version_requirements: *70095850747460
 - !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: &70338618301280 !ruby/object:Gem::Requirement
+  name: sqlite3
+  requirement: &70095850746380 !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
+        version: 1.3.6
+  type: :development
+  prerelease: false
+  version_requirements: *70095850746380
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: &70095850745760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :development
+  prerelease: false
+  version_requirements: *70095850745760
+- !ruby/object:Gem::Dependency
+  name: factory_girl_rails
+  requirement: &70095850744840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :development
+  prerelease: false
+  version_requirements: *70095850744840
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: &70095850744260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.5
+  type: :development
   prerelease: false
-  version_requirements: *70338618301280
-description: Records modified time for individual columns.
+  version_requirements: *70095850744260
+description: Records modification time for specified database columns on a per-row
+  basis (ActiveRecord).
 email:
 - james@jamesbrooks.net
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/timestamped_column/active_record.rb
+- lib/timestamped_column/active_record/timestamped_column.rb
 - lib/timestamped_column/version.rb
 - lib/timestamped_column.rb
 - MIT-LICENSE
+- Rakefile
 - README.md
+- spec/dummy/app/models/user.rb
+- spec/dummy/config/application.rb
+- spec/dummy/config/boot.rb
+- spec/dummy/config/database.yml
+- spec/dummy/config/environment.rb
+- spec/dummy/config/environments/test.rb
+- spec/dummy/config.ru
+- spec/dummy/db/migrate/20120507214419_create_users.rb
+- spec/dummy/db/schema.rb
+- spec/dummy/db/test.sqlite3
+- spec/dummy/log/test.log
+- spec/dummy/Rakefile
+- spec/dummy/script/rails
+- spec/factories/user.rb
+- spec/models/user_spec.rb
+- spec/spec_helper.rb
+- spec/support/timecop.rb
 homepage: https://github.com/JamesBrooks/timestamped_column
 licenses: []
 post_install_message: 
@@ -65,8 +117,25 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.6
+rubygems_version: 1.8.17
 signing_key: 
 specification_version: 3
-summary: Records modified time for individual columns.
-test_files: []
+summary: Records column modification times.
+test_files:
+- spec/dummy/app/models/user.rb
+- spec/dummy/config/application.rb
+- spec/dummy/config/boot.rb
+- spec/dummy/config/database.yml
+- spec/dummy/config/environment.rb
+- spec/dummy/config/environments/test.rb
+- spec/dummy/config.ru
+- spec/dummy/db/migrate/20120507214419_create_users.rb
+- spec/dummy/db/schema.rb
+- spec/dummy/db/test.sqlite3
+- spec/dummy/log/test.log
+- spec/dummy/Rakefile
+- spec/dummy/script/rails
+- spec/factories/user.rb
+- spec/models/user_spec.rb
+- spec/spec_helper.rb
+- spec/support/timecop.rb

data/lib/timestamped_column/active_record.rb

@@ -1,36 +0,0 @@
-module TimestampedColumn
-  module ActiveRecord
-    extend ActiveSupport::Concern
-
-    included do
-      before_save    :update_timestamped_column_times
-      cattr_accessor :timestamped_columns
-    end
-
-    module ClassMethods
-      def timestamped_column(column, opts={})
-        timestamp_column = opts[:column] || "#{column}_updated_at"
-
-        self.timestamped_columns ||= {}
-        self.timestamped_columns[column] = timestamp_column
-      end
-    end
-
-    module InstanceMethods
-    private
-      def update_timestamped_column_times
-        if self.timestamped_columns && changes.any?
-          self.timestamped_columns.each do |column, timestamp_column|
-            if changes[column.to_s]
-              send "#{timestamp_column}=", Time.zone.now
-            end
-          end
-        end
-      end
-    end
-  end
-end
-
-class ActiveRecord::Base
-  include TimestampedColumn::ActiveRecord
-end