column_timestamps 0.1.0 → 0.1.1

data/.gitignore

@@ -19,3 +19,4 @@ rdoc
 pkg
 
 ## PROJECT::SPECIFIC
+.ginger

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009 Myron Marston
+Copyright (c) 2009-2010 Myron Marston
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.rdoc

@@ -4,21 +4,33 @@ ActiveRecord manages your updated_at columns for you, updating the timestamp whe
 This gem provides similar, but more granular functionality: in addition to a table-wide updated_at column,
 you can have additional timestamp columns that track when specific columns change.
 
+== Hompage
+
+http://github.com/myronmarston/column_timestamps
+
+== Installation
+
+  gem install column_timestamps
+
+== Usage
+
+Load the gem using Rails' 2.1+ gem support.  In environment.rb:
+
+  config.gem 'column_timestamps'
+
 Usage is pretty simple:
 - Create a new datetime column using the naming convention <column>_updated_at.
 - Include ColumnTimestamps in your model.
 
 Example:
 
-    # schema definition...
-    ActiveRecord::Schema.define do
-      create_table :users, :force => true do |t|
-        t.string    :email_address
-        t.string    :name
-        t.string    :state
-        t.datetime  :state_updated_at
-        t.timestamps
-      end
+    # in a migration...
+    create_table :users, :force => true do |t|
+      t.string    :email_address
+      t.string    :name
+      t.string    :state
+      t.datetime  :state_updated_at
+      t.timestamps
     end
 
     # Model...
@@ -28,6 +40,12 @@ Example:
 
 Anytime the state attribute of a user record is changed, the state_updated_at timestamp will be updated to reflect that.
 
+== Version Compatibility
+
+column_timestamps relies upon the dirty attributes functionality introduced to ActiveRecord in version 2.1.  It works on
+any version since 2.1, including 3.0.0.beta.  It works on ruby {1.8.6}[[http://integrity186.heroku.com/column-timestamps]],
+{1.8.7}[http://integrity187.heroku.com/column-timestamps] and {1.9.1}[http://integrity191.heroku.com/column-timestamps].
+
 == Note on Patches/Pull Requests
  
 * Fork the project.
@@ -40,4 +58,4 @@ Anytime the state attribute of a user record is changed, the state_updated_at ti
 
 == Copyright
 
-Copyright (c) 2009 Myron Marston. See LICENSE for details.
+Copyright (c) 2009-2010 Myron Marston. See LICENSE for details.

data/Rakefile

@@ -10,11 +10,11 @@ begin
     gem.email = "myron.marston@gmail.com"
     gem.homepage = "http://github.com/myronmarston/column_timestamps"
     gem.authors = ["Myron Marston"]
-    gem.add_dependency 'activerecord'
-    gem.add_development_dependency 'sqlite3-ruby'
+    gem.add_dependency 'activerecord', '>= 2.1.0'
+    gem.add_development_dependency 'sqlite3-ruby', '>= 1.2.5'
     gem.add_development_dependency "rspec", ">= 1.2.9"
-    gem.add_development_dependency "rr", ">= 0.10.4"
 
+    gem.files.exclude 'vendor/ginger'
     # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
   Jeweler::GemcutterTasks.new
@@ -61,7 +61,15 @@ rescue LoadError
   end
 end
 
-task :default => :spec
+desc 'Run ginger tests'
+task :ginger do
+  $LOAD_PATH << File.join(*%w[vendor ginger lib])
+  ARGV.clear
+  ARGV << 'spec'
+  load File.join(*%w[vendor ginger bin ginger])
+end
+
+task :default => :ginger
 
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rdoc|

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/column_timestamps.gemspec

@@ -0,0 +1,66 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{column_timestamps}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Myron Marston"]
+  s.date = %q{2010-03-25}
+  s.description = %q{Works "automagically" like updated_at...just add a column named <column>_updated_at, and when your column changes, the timestamp will be updated. }
+  s.email = %q{myron.marston@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "column_timestamps.gemspec",
+     "ginger_scenarios.rb",
+     "lib/column_timestamps.rb",
+     "spec/fixtures/models.rb",
+     "spec/fixtures/schema.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/user_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/myronmarston/column_timestamps}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Keeps track of when a specific column in an ActiveRecord model changed.}
+  s.test_files = [
+    "spec/fixtures/models.rb",
+     "spec/fixtures/schema.rb",
+     "spec/spec_helper.rb",
+     "spec/user_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activerecord>, [">= 2.1.0"])
+      s.add_development_dependency(%q<sqlite3-ruby>, [">= 1.2.5"])
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<activerecord>, [">= 2.1.0"])
+      s.add_dependency(%q<sqlite3-ruby>, [">= 1.2.5"])
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<activerecord>, [">= 2.1.0"])
+    s.add_dependency(%q<sqlite3-ruby>, [">= 1.2.5"])
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/ginger_scenarios.rb

@@ -0,0 +1,23 @@
+require 'ginger'
+
+def create_scenario(version)
+  scenario = Ginger::Scenario.new("Rails #{version}")
+  scenario[/^active_?record$/] = version
+  scenario[/^active_?support$/] = version
+  scenario
+end
+ 
+Ginger.configure do |config|
+  config.aliases["active_record"] = "activerecord"
+  config.aliases["active_support"] = "activesupport"
+
+  versions = []
+
+  versions << '3.0.0.beta' unless RUBY_VERSION == '1.8.6'
+  versions += %w( 2.3.5 2.3.4 2.3.3 2.3.2 )
+  versions += %w( 2.2.3 2.2.2 2.1.2 2.1.1 2.1.0 ) if RUBY_VERSION =~ /^1\.8/
+
+  versions.each do |version|
+    config.scenarios << create_scenario(version)
+  end
+end

data/lib/column_timestamps.rb

@@ -1,4 +1,4 @@
-require 'activerecord'
+require 'active_record'
 
 module ColumnTimestamps
   def self.included(klass)
@@ -17,7 +17,9 @@ module ColumnTimestamps
   def update_column_timestamps
     current_time = self.class.default_timezone == :utc ? Time.now.utc : Time.now
     self.class.timestamped_column_names.each do |column_name|
-      self.send("#{column_name}_updated_at=", current_time) if self.send("#{column_name}_changed?")
+      if self.send(:"#{column_name}_changed?") || (!self.send(column_name).blank? && new_record?)
+        self.send(:"#{column_name}_updated_at=", current_time)
+      end
     end
     true
   end

data/spec/fixtures/schema.rb

@@ -1,10 +1,14 @@
-ActiveRecord::Schema.define do
-  create_table :users, :force => true do |t|
-    t.string    :email_address
-    t.string    :name
-    t.string    :state
-    t.datetime  :name_updated_at
-    t.datetime  :state_updated_at
-    t.timestamps
+silence_stream(STDOUT) do
+  ActiveRecord::Schema.define do
+    create_table :users, :force => true do |t|
+      t.string    :email_address
+      t.string    :name
+      t.string    :state
+      t.string    :role, :default => 'user'
+      t.datetime  :name_updated_at
+      t.datetime  :state_updated_at
+      t.datetime  :role_updated_at
+      t.timestamps
+    end
   end
-end
+end

data/spec/spec.opts

@@ -1 +1,2 @@
 --color
+--format nested

data/spec/spec_helper.rb

@@ -1,6 +1,6 @@
 require 'rubygems'
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH << File.join(File.dirname(__FILE__), *%w[.. vendor ginger lib])
+require 'ginger'
 require 'column_timestamps'
 require 'spec'
 require 'spec/autorun'
@@ -10,5 +10,4 @@ require 'fixtures/schema.rb'
 require 'fixtures/models.rb'
 
 Spec::Runner.configure do |config|
-  config.mock_with :rr
 end

data/spec/user_spec.rb

@@ -2,25 +2,34 @@ require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 
 describe User do
   it "should return the timestamped_column_names from #timestamped_column_names" do
-    User.timestamped_column_names.sort.should == %w( name state )
+    User.timestamped_column_names.should =~ %w( name role state )
   end
 
   it "should initially have nil values for the column timestamps" do
     @user = User.new
     @user.name_updated_at.should be_nil
     @user.state_updated_at.should be_nil
+    @user.role_updated_at.should be_nil
   end
 
-  it "should not set the the column timestamps when saved with name or state values" do
-    @user = User.create!
+  it "should not set the the column timestamps when saved without name or state values" do
+    @user = User.create!; @user.reload
     @user.name_updated_at.should be_nil
     @user.state_updated_at.should be_nil
   end
 
+  it "should set a timestamp on creation for columns that have a default" do
+    @now = Time.now
+    Time.stub!(:now).and_return(@now)
+    @user = User.create!
+    @user.reload
+    @user.role_updated_at.to_s.should == @now.to_s
+  end
+
   describe "saving the record with a name value" do
     before(:each) do
       @now = @now1 = Time.now
-      stub(Time).now { @now }
+      Time.stub!(:now).and_return { @now }
       @user = User.create!(:name => 'David')
       @user.reload
     end

metadata

@@ -1,7 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: column_timestamps
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - Myron Marston
@@ -9,49 +14,51 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-19 00:00:00 -07:00
+date: 2010-03-25 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: activerecord
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: "0"
-    version: 
+        segments: 
+        - 2
+        - 1
+        - 0
+        version: 2.1.0
+  type: :runtime
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: sqlite3-ruby
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: "0"
-    version: 
+        segments: 
+        - 1
+        - 2
+        - 5
+        version: 1.2.5
+  type: :development
+  version_requirements: *id002
 - !ruby/object:Gem::Dependency 
   name: rspec
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
         version: 1.2.9
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: rr
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.10.4
-    version: 
+  version_requirements: *id003
 description: "Works \"automagically\" like updated_at...just add a column named <column>_updated_at, and when your column changes, the timestamp will be updated. "
 email: myron.marston@gmail.com
 executables: []
@@ -68,6 +75,8 @@ files:
 - README.rdoc
 - Rakefile
 - VERSION
+- column_timestamps.gemspec
+- ginger_scenarios.rb
 - lib/column_timestamps.rb
 - spec/fixtures/models.rb
 - spec/fixtures/schema.rb
@@ -87,18 +96,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: Keeps track of when a specific column in an ActiveRecord model changed.