blind_date 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Ari Epstein
+
+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.rdoc

@@ -0,0 +1,20 @@
+= blind_date
+
+Blind Date is a utility which provides a DBMS-independent API to exploit basic
+date manipulation functionality present in each database.
+
+== Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Ari Epstein. See LICENSE for details.
+

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "blind_date"
+    gem.summary = %Q{DBMS-indepedent methods to query dates in ActiveRecord}
+    gem.description = %Q{Allows you to utilize date calculation functionality of DBMS with a uniform API}
+    gem.email = "aepstein607@gmail.com"
+    gem.homepage = "http://github.com/aepstein/blind_date"
+    gem.authors = ["Ari Epstein"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_dependency "activerecord", ">= 2.3.4"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "blind_date #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/blind_date.gemspec

@@ -0,0 +1,64 @@
+# 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{blind_date}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ari Epstein"]
+  s.date = %q{2009-11-25}
+  s.description = %q{Allows you to utilize date calculation functionality of DBMS with a uniform API}
+  s.email = %q{aepstein607@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "blind_date.gemspec",
+     "lib/blind_date.rb",
+     "lib/blind_date/active_record/base.rb",
+     "lib/blind_date/active_record/connection_adapters/abstract_adapter.rb",
+     "lib/blind_date/active_record/connection_adapters/mysql_adapter.rb",
+     "lib/blind_date/active_record/connection_adapters/postgresql_adapter.rb",
+     "lib/blind_date/active_record/connection_adapters/sqlite3_adapter.rb",
+     "lib/blind_date/active_record/connection_adapters/sqlite_adapter.rb",
+     "spec/blind_date_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/aepstein/blind_date}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{DBMS-indepedent methods to query dates in ActiveRecord}
+  s.test_files = [
+    "spec/blind_date_spec.rb",
+     "spec/spec_helper.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_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_runtime_dependency(%q<activerecord>, [">= 2.3.4"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<activerecord>, [">= 2.3.4"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<activerecord>, [">= 2.3.4"])
+  end
+end
+

data/lib/blind_date/active_record/base.rb

@@ -0,0 +1,43 @@
+module BlindDate
+  module ActiveRecord
+    module Base
+
+      # Generates an sql fragement representing the sum of a date and a duration
+      # == Usage
+      #
+      # Model.date_add DateTime.now, 10.days
+      # => sqlite: DATETIME( '2009-11-25 12:01:01', '+10 DAY' )
+      # => mysql: ('2009-11-25 12:01:01' + 10 DAY)
+      # => pgsql: (TIMESTAMP '2009-11-25 12:01:01' + '10 DAY')
+      # Model.date_add 'models.starts_at', 10.days
+      # => sqlite: DATETIME( models.starts_at, '+10 DAY' )
+      # Model.date_add :starts_at, :duration, :days
+      # => sqlite: DATETIME( "models"."starts_at", '+' || "models"."duration" || ' DAY' )
+      # Model.date_add :starts_at, :duration, :days, true
+      # => sqlite: DATETIME( "models"."starts_at", '-' || "models"."duration" || ' DAY' )
+      #
+      # == Options
+      # * +date+ - Date subject to calculation, can be date, time, datetime, symbolized column, or string sql fragment
+      # * +interval+ - Duration to be added/subtracted, can be duration, number, symbolized column, or string sql fragment
+      # * +unit+ - Unit of time for duration, defaults to :seconds, and is ignored if using duration for interval
+      # * +diff+ - If true, will subtract duration from date, otherwise will add (default is false)
+      def date_add( date, interval, unit = 'SECOND', diff = false)
+        if date.is_a? Symbol
+          date = "#{connection.quote_table_name(table_name)}.#{connection.quote_column_name(date.to_s)}"
+        elsif date.acts_like?(:time) || date.acts_like?(:date)
+          date = connection.quote date
+        end
+        interval = "#{connection.quote_table_name(table_name)}.#{connection.quote_column_name(interval.to_s)}" if interval.is_a? Symbol
+        connection.class.date_add date, interval, unit, diff
+      end
+
+      # Generates a SQL fragment representing subtraction of a duration from a date
+      # Similar to date_add( date, interval, unit, +true+ )
+      def date_sub( date, interval, unit = 'SECOND' )
+        date_add date, interval, unit, true
+      end
+
+    end
+  end
+end
+

data/lib/blind_date/active_record/connection_adapters/abstract_adapter.rb

@@ -0,0 +1,56 @@
+module BlindDate
+  module ActiveRecord
+    module ConnectionAdapters
+
+      # Includes extended behaviors
+      # Each DBMS-specific module must implement the private methods or raise NotImplemented
+      # for each private method
+      module AbstractAdapter
+
+        # Performs arithmetic on string is an SQL-escaped date/time/datetime or returns a date/time/datetime
+        def date_add(date, interval, unit = 'SECOND', diff = false )
+          case interval
+          when ActiveSupport::Duration
+            interval.parts.inject( date ) do |memo, span|
+              date_add_sql_without_operator memo, span.last, span.first.to_s.singularize.upcase, diff
+            end
+          when String
+            date_add_sql date, interval, unit.to_s.singularize.upcase, ( diff ? '-' : '+' )
+          when Numeric
+            date_add_sql_without_operator date, interval, unit.to_s.singularize.upcase, diff
+          else
+            raise ArgumentError
+          end
+        end
+
+        # Returns name of adapter suitable for loading related classes
+        # Should have same output as instance method of same name
+        # TODO: Kludgy: maybe upstream could provide a class method?
+        def adapter_name
+          to_s.underscore[ /\/([^\/]+)_adapter$/, 1 ].gsub( '_', '' )
+        end
+
+        private
+
+        # Adds appropriate operator before calling adapter-specific method
+        def date_add_sql_without_operator( sql, interval, unit, diff )
+          if diff
+            date_add_sql sql, interval.abs, unit, ( interval < 0 ? '+' : '-' )
+          else
+            date_add_sql sql, interval.abs, unit, ( interval < 0 ? '-' : '+' )
+          end
+        end
+
+        # Will attempt to load the correct behavior if this is not already provided
+        def date_add_sql( sql, interval, unit, operator )
+          require "blind_date/active_record/connection_adapters/#{adapter_name}_adapter"
+          date_add_sql( sql, interval, unit, operator )
+        end
+
+      end
+    end
+  end
+end
+
+ActiveRecord::ConnectionAdapters::AbstractAdapter.extend BlindDate::ActiveRecord::ConnectionAdapters::AbstractAdapter
+

data/lib/blind_date/active_record/connection_adapters/mysql_adapter.rb

@@ -0,0 +1,16 @@
+module BlindDate
+  module ActiveRecord
+    module ConnectionAdapters
+      module MysqlAdapter
+
+        def date_add_sql( sql, interval, unit, operator )
+          "( #{sql} #{operator} INTERVAL #{interval} #{unit} )"
+        end
+
+      end
+    end
+  end
+end
+
+ActiveRecord::ConnectionAdapters::MysqlAdapter.extend BlindDate::ActiveRecord::ConnectionAdapters::MysqlAdapter
+

data/lib/blind_date/active_record/connection_adapters/postgresql_adapter.rb

@@ -0,0 +1,23 @@
+module BlindDate
+  module ActiveRecord
+    module ConnectionAdapters
+      module PostgresqlAdapter
+
+        def date_add_sql( sql, interval, unit, operator )
+          case interval
+          when Numeric
+            "( #{sql} #{operator} '#{interval} #{unit}' )"
+          when String
+            "( #{sql} #{operator} #{interval} || ' #{unit}')"
+          else
+            raise ArgumentError
+          end
+        end
+
+      end
+    end
+  end
+end
+
+ActiveRecord::ConnectionAdapters::MysqlAdapter.send :include, BlindDate::ActiveRecord::ConnectionAdapters::MysqlAdapter
+

data/lib/blind_date/active_record/connection_adapters/sqlite3_adapter.rb

@@ -0,0 +1,2 @@
+require 'blind_date/active_record/connection_adapters/sqlite_adapter'
+

data/lib/blind_date/active_record/connection_adapters/sqlite_adapter.rb

@@ -0,0 +1,23 @@
+module BlindDate
+  module ActiveRecord
+    module ConnectionAdapters
+      module SQLiteAdapter
+
+        def date_add_sql( sql, interval, unit, operator )
+          case interval
+          when Numeric
+            "DATETIME( #{sql}, '#{operator}#{interval} #{unit}' )"
+          when String
+            "DATETIME( #{sql}, '#{operator}' || #{interval} || ' #{unit}' )"
+          else
+            raise ArgumentError
+          end
+        end
+
+      end
+    end
+  end
+end
+
+ActiveRecord::ConnectionAdapters::SQLiteAdapter.extend BlindDate::ActiveRecord::ConnectionAdapters::SQLiteAdapter
+

data/lib/blind_date.rb

@@ -0,0 +1,6 @@
+require 'blind_date/active_record/base'
+require 'blind_date/active_record/connection_adapters/abstract_adapter'
+
+ActiveRecord::Base.extend BlindDate::ActiveRecord::Base
+ActiveRecord::ConnectionAdapters::AbstractAdapter.extend BlindDate::ActiveRecord::ConnectionAdapters::AbstractAdapter
+

data/spec/blind_date_spec.rb

@@ -0,0 +1,76 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "BlindDate" do
+  before(:each) do
+    @activity = Activity.create( :starts_at => DateTime.now, :duration => 60 )
+    @future = Activity.create( :starts_at => @activity.starts_at + 60.seconds, :duration => 60 )
+  end
+
+  it "should produce valid date_add output" do
+    matches = matches_for Activity.date_add( @activity.starts_at, 60.seconds )
+    matches.size.should eql 1
+    matches.should include @future
+  end
+
+  it "should produce valid date_add output with plain sql string" do
+    matches = Activity.find( :all, :conditions => [ "#{@activity.connection.quote(@future.starts_at)} = " +
+      Activity.date_add( 'activities.starts_at', 60.seconds ) ] )
+    matches.size.should eql 1
+    matches.should include @activity
+  end
+
+  it "should produce valid date_add output with multipart date" do
+    other_activity = Activity.create( :starts_at => @activity.starts_at + 2.months + 10.seconds )
+    matches = Activity.find( :all, :conditions => [ "#{@activity.connection.quote(other_activity.starts_at)} = " +
+      Activity.date_add( :starts_at, 2.months + 10.seconds ) ])
+    matches.size.should eql 1
+    matches.should include @activity
+  end
+
+  it "should produce valid date_add output with a symbol string" do
+    matches = Activity.find( :all, :conditions => [ "#{@activity.connection.quote(@future.starts_at)} = " +
+      Activity.date_add( :starts_at, 60.seconds ) ] )
+    matches.size.should eql 1
+    matches.should include @activity
+  end
+
+  it "should default to seconds with an integer interval" do
+    matches = Activity.find( :all, :conditions => [ "#{@activity.connection.quote(@future.starts_at)} = " +
+      Activity.date_add( :starts_at, 60 ) ] )
+    matches.size.should eql 1
+    matches.should include @activity
+  end
+
+  it "should accept sql fragment, unit, operator for interval" do
+    matches = Activity.find( :all, :conditions => [ "#{@activity.connection.quote(@activity.starts_at + @activity.duration.seconds)} = " +
+      Activity.date_add( :starts_at, 'activities.duration' ) ] )
+    matches.size.should eql 1
+    matches.should include @activity
+  end
+
+  it "should accept a symbol for the interval" do
+    matches = Activity.find( :all, :conditions => [ "#{@activity.connection.quote(@activity.starts_at + @activity.duration.seconds)} = " +
+      Activity.date_add( :starts_at, :duration ) ] )
+    matches.size.should eql 1
+    matches.should include @activity
+  end
+
+  it "should accept an alternative unit for a specified interval" do
+    matches = Activity.find( :all, :conditions => [ "#{@activity.connection.quote(@activity.starts_at + @activity.duration.seconds)} = " +
+      Activity.date_add( :starts_at, 1, :minutes ) ] )
+    matches.size.should eql 1
+    matches.should include @activity
+  end
+
+  it "should calculate a difference with the sub method" do
+    matches = Activity.find( :all, :conditions => [ "#{@activity.connection.quote @activity.starts_at} = " +
+      Activity.date_sub( 'activities.starts_at', 1, :minutes ) ] )
+    matches.size.should eql 1
+    matches.should include @future
+  end
+
+  def matches_for(condition)
+    Activity.find( :all, :conditions => "starts_at = #{condition}" )
+  end
+end
+

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,36 @@
+require 'rubygems'
+require 'activerecord'
+
+ENV['TZ'] = 'UTC'
+Time.zone = 'Eastern Time (US & Canada)'
+
+ActiveRecord::Base.establish_connection(:adapter => 'sqlite3', :database => ':memory:')
+ActiveRecord::Base.configurations = true
+
+ActiveRecord::Schema.verbose = false
+ActiveRecord::Schema.define(:version => 1) do
+  create_table :activities do |t|
+    t.datetime :starts_at
+    t.integer :duration
+  end
+end
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'blind_date'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  config.before(:each) do
+    class Activity < ActiveRecord::Base
+    end
+
+    Activity.destroy_all
+  end
+
+  config.after(:each) do
+    Object.send(:remove_const, :Activity)
+  end
+end
+

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: blind_date
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ari Epstein
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-25 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.4
+    version: 
+description: Allows you to utilize date calculation functionality of DBMS with a uniform API
+email: aepstein607@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- blind_date.gemspec
+- lib/blind_date.rb
+- lib/blind_date/active_record/base.rb
+- lib/blind_date/active_record/connection_adapters/abstract_adapter.rb
+- lib/blind_date/active_record/connection_adapters/mysql_adapter.rb
+- lib/blind_date/active_record/connection_adapters/postgresql_adapter.rb
+- lib/blind_date/active_record/connection_adapters/sqlite3_adapter.rb
+- lib/blind_date/active_record/connection_adapters/sqlite_adapter.rb
+- spec/blind_date_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/aepstein/blind_date
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: DBMS-indepedent methods to query dates in ActiveRecord
+test_files: 
+- spec/blind_date_spec.rb
+- spec/spec_helper.rb