ar-extensions 0.5.1

data/ChangeLog

@@ -0,0 +1,97 @@
+2007-03-13  zdennis  <zdennis@elijah>
+
+	* Added :datetime searching support for better finder support. 
+
+2007-02-11  zdennis  <zdennis@admin.aries>
+
+	* Updated to_csv and import functionality to work with Sqlite, Sqlite3, PostgreSQL and MySQL
+
+	* Updated RDOC for import, to_csv, better finders, temporary tables and foreign key support
+
+2007-01-29  zdennis  <zdennis@mktec.com>
+
+	* Added initial support for temporary tables and permanent like tables. 
+
+2007-01-24  zdennis  <zdennis@mktec.com>
+
+	* Added dependency for Mocha 0.4.0 or higher for testing
+
+	* Fixed bug for import functionality where it was never actually splitting up values correctly (thx to Mark Van Holstyn!!)
+
+2007-01-09  zdennis  <zdennis@aries>
+
+	* Added support for embedded to_csv includes
+
+2007-01-07  zdennis  <zdennis@aries>
+
+	* Added fix to init.rb to only load CSV functionality if FasterCSV
+	is available, otherwise print a message to STDERR and continue.
+
+	* Added fix to tests/boot.rb which solves fixture_path issues in
+	ActiveRecord 1.14.4 and earlier. The fix is included Rails trunk
+	and will be available in Rails 1.2.
+
+2007-01-05  zdennis  <zdennis@aries>
+
+	* Added ActiveRecord::Extensions::VERSION module which has the following constants: MAJOR, MINOR, REVISION
+
+	* Running rake tests are now smart enough to rebuild the database if they are required based on schema_info table.
+
+	* Added schema_info table for test database schemas. 
+
+2006-12-29  zdennis  <zdennis@aries>
+
+	* Updated the Rakefile to run an external ruby process when running test files rather then in the same ruby process that runs the Rakefile
+
+	* Updated the directory structure of lib/ to solve namespace issues.
+
+2006-12-22  Zach Dennis  <zdennis@silver.dennis.network>
+
+	* Added rake tasks for sqlite and sqlite3 databases
+
+	* Added "does_not_match" as a suffix to better finders when working with Regular Expressions
+
+	* Added "not_between" suffix to better finders when working with Ranges
+
+2006-12-17  zdennis  <zdennis@aries>
+
+	* Added :only and :except options to to_csv method. Forcing
+	compatibility with http://blog.integralimpressions.com/articles/2006/09/01/tocsv-plugin
+
+	* Changed to_csv option :headers take a boolean rather then an
+	array of column names.
+
+	* Added rake task db:prepare_<adapter_name> to build test
+	database. 
+
+2006-12-16  Zach Dennis  <zdennis@silver.dennis.network>
+
+	* Added more tests for better finder support
+
+	* Added to_csv support for Arrays returned by ActiveRecord::Base.find
+
+	* Refactored ActiveRecord::Extensions::Registry to use an Array instead of hash
+
+2006-12-06  Zach Dennis  <zdennis@silver.dennis.network>
+
+	* PostgreSQL has tested support for everything MySQL has except for Full Text Searching. This is not implemented.
+
+	* Refactored how import and full text searching implementation is handled, this is largely handled by duck typing certain method calls. 
+
+	* Added generic import support for any adapter that doesn't support multi-value insert statements. This provides generic support which is guaranteed to be no slower then ActiveRecord#create. 
+
+2006-11-23  Zach Dennis  <zdennis@silver.dennis.network>
+
+	* Added finder support for PostgreSQL including Regexp Searching. (No full text searching though)
+
+	* Fixed bug in finders.rb where NULL searches were not correctly being translated into IS NULL when doing { :column => nil }
+
+2006-11-20  Zach Dennis  <zach.dennis@gmail.com>
+
+	* Refactored core finder components out into ActiveRecord extensions
+
+	* Duck typing support for any object that is passed in to a conditions hash. ie: MyModel.find( :all, :conditions=>{ :name=>NameSearchObject.new } )
+
+	* Duck typing support for any object that is passed in as a condition. ie: MyModel.find( :all, :conditions=>SearchObject.new )
+	
+

data/README

@@ -0,0 +1,123 @@
+LICENSE
+----------
+This is licensed under the ruby license. 
+
+Author: Zach Dennis
+Web Site: http://www.continuousthinking.com/tags/arext
+Email: zach.dennis@gmail.com
+
+ - For How-To information see http://www.continuousthinking.com/tags/arext
+ - For project information and feedback please consult http://rubyforge.org/projects/arext/
+ - For release information please see below
+
+ActiveRecord::Extensions 0.5.0
+------------------------------
+March 13th, 2007
+ - Added Time based query support which works on ActiveRecord columns which match a type supported by :datetime
+
+ActiveRecord::Extensions 0.4.0
+------------------------------
+February 11th, 2007
+ - Added to_csv functionality
+ - Added temporary table support (MySQL)
+ - Added foreign key support (MySQL)
+ - Updated tests to keep schema information. Test database will automatically rebuild themselves if they are out of sync
+ - Added dependency for Mocha 0.4.0 or higher for tests
+
+ActiveRecord::Extensions 0.3.0
+------------------------------
+December 29th, 2006
+ - Updates to the lib/ directory structure to avoid namespace issues.
+ - Updates to the Rakefile to run an external ruby process for tests rather then the same 
+   ruby process that runs the rake tasks
+
+ActiveRecord::Extensions 0.2.0
+------------------------------
+December 22nd, 2006
+ - Updates to_csv method for arrays returned by ActiveRecord::Base.find
+ - Adds does_not_match suffix for regular expression based conditions, ie: :field_does_not_match => /regex/
+ - Adds not_between suffix for ange based conditions, ie: :id_not_between => ( 0 .. 1 )
+ - Adds SQLite and SQLite3 support for better finders.
+ - Updates rake tasks for sqlite and sqlite3.
+ - Added rake tasks to use database migrations rather then raw SQL schema files.
+
+ActiveRecord::Extensions 0.1.0
+-------------------------------
+December 16th, 2006
+ - Adds to_csv method to arrays returned by ActiveRecord::Base.find. 
+ - Fixes bug in ActiveRecord::Extensions::Registry when processing key/value pairs where
+   the order of certain Extensions was not handled correctly due to Hash usage.
+ - Refactoring of ActiveRecord::Extensions::Registry
+ - Added more tests for better finder support 
+
+ActiveRecord::Extensions 0.0.6
+------------------------------
+December 5th, 2006
+ - Added generic support for import functionality for all adapters
+ - Includes rake testing tasks for postgresql
+ - Includes postgresql support for all extensions except for full text searching (which is only mysql)
+ - Refactored directory structure of tests, import functionality and fulltext functionality
+
+
+ActiveRecord::Extensions 0.0.5
+------------------------------
+October 20th, 2006.
+ - Fixes two bugs which broke normal ActiveRecord behavior
+ - Fully complaint with Rails 1.1.0 thru 1.1.6 (and all ActiveRecord versions released with those)
+ - Inlcudes new Rakefile
+ - Includes rake task "test:mysql" which allows ActiveRecord::Extensions to be tested with mysql
+ - Includes rake test "test:activerecord:mysql" which allows ActiveRecord's tests to be tested with the
+   ActiveRecord::Extensions library
+
+
+ActiveRecord::Extensions 0.0.4
+-------------------------------
+August 26th, 2006. Released at RubyConf*MI.
+September 24th, 2006, Rubyforge release.
+ - Inlcudes "Better Finder" support for ActiveRecord
+http://blogs.mktec.com/zdennis/pages/ARE_finders
+
+
+ActiveRecord::Extensions 0.0.3
+-------------------------------
+Released.... ????
+ - the project has been named ActiveRecord::Extensions.
+
+
+ActiveRecord::Optimizations 0.0.2
+---------------------------------
+July 20th, 11:27pm, Zach Dennis
+
+This includes some of the optimizations for the ActiveRecord::Base. This release only supports the MysqlAdapter, although other adapters will be supported in upcoming releases.
+
+HOW-TO USAGE
+------------
+Require the two files in the lib/ directory and then create records using:
+  Model.create array_of_hashes
+
+Example:
+  class LogEntry < ActiveRecord::Base ; end
+  LogEntry.import [ { :log_entry_name=>"Name" }, {:log_entry_name=>"Name2"}, ... ], :optimize=>true
+
+Using the optimized create method will return the number of inserts performed, rather then an array of LogEntry objects. This currently skips model validation.
+
+
+CHANGELOG
+----------
+0.0.2
+ - add some documentation to the updated methods for ActiveRecord and MysqlAdapter
+ - renamed the create optimizatin to import. Multi-value inserts can be obtained using ActiveRecord::Base.import
+0.0.1
+ - introduced updates to ActiveRecord::Base.create to support multi-value inserts
+
+
+UPCOMING
+----------
+ - model validation on imports
+ - postgresql support for imports
+ - ability to use regular expressions for db searches
+ - ability to use db functions
+ - temporary table support
+ - memory table support
+ - complex update with on duplicate key update support
+

data/Rakefile

@@ -0,0 +1,97 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+
+DIR = File.dirname( __FILE__ )
+
+task :default => [ "test:mysql" ]
+
+task :boot do 
+  require File.join( DIR, 'lib', 'ar-extensions' )
+  require File.join( DIR, 'tests', 'connections', "native_#{ENV['ARE_DB']}", 'connection' )  
+  require File.join( DIR, 'db/migrate/version' )
+end
+
+ADAPTERS = %w( mysql postgresql sqlite sqlite3 )
+
+namespace :db do
+
+  namespace :test do
+    ADAPTERS.each do |adapter|
+      desc "builds test database for #{adapter}"
+      task "prepare_#{adapter}" do |t|
+        file2run = File.join( DIR, 'tests/prepare.rb' )
+        system( "ruby #{file2run} #{adapter}" )
+      end
+    end
+  end
+
+end
+
+namespace :test do
+  
+  ADAPTERS.each do |adapter|
+    desc "test base extensions for #{adapter}"
+    task adapter do |t|
+      ENV['ARE_DB'] = adapter
+      Rake::Task[ 'boot' ].invoke
+      
+      task = Rake::Task[ "db:test:prepare_#{adapter}" ]
+			begin
+        task = false  if SchemaInfo::VERSION == SchemaInfo.find( :first ).version
+		  rescue Exception => ex        
+      end
+      task.invoke if task
+        
+      system "ruby #{File.join( DIR, 'tests/run.rb ' )} #{adapter}" 
+    end
+  end
+  
+  namespace :activerecord do
+
+    ADAPTERS.each do |adapter|
+      desc "runs ActiveRecord unit tests for #{adapter} with ActiveRecord::Extensions"
+      task adapter.to_sym do |t|
+        activerecord_dir = ARGV[1]
+        if activerecord_dir.nil? or ! File.directory?( activerecord_dir )
+          STDERR.puts "ERROR: Pass in the path to ActiveRecord. Eg: /home/zdennis/rails_trunk/activerecord"
+          exit
+        end
+        
+        old_dir, old_env = Dir.pwd, ENV['RUBYOPT']
+        Dir.chdir( activerecord_dir )
+        ENV['RUBYOPT'] = "-r#{File.join(old_dir,'init.rb')}"
+
+        load "Rakefile"
+        Rake::Task[ "test_#{adapter}" ].invoke
+        Dir.chdir( old_dir )
+        ENV['RUBYOPT'] = old_env
+      end      
+  
+    end  
+          
+  end    
+
+  namespace :gem do
+    
+    ADAPTERS.each do |adapter|
+      desc "load ar-extensions from rubygems and test base extensions for #{adapter}"
+      task adapter do |t|
+        ENV['ARE_DB'] = adapter
+        Rake::Task[ 'boot' ].invoke
+      
+        task = Rake::Task[ "db:test:prepare_#{adapter}" ]
+        begin
+          task = false  if SchemaInfo::VERSION == SchemaInfo.find( :first ).version
+        rescue Exception => ex        
+        end
+        task.invoke if task
+        
+        system "ruby #{File.join( DIR, 'tests/run_from_gem.rb ' )} #{adapter}" 
+      end
+      
+    end
+    
+  end
+  
+end

data/config/database.yml

@@ -0,0 +1,7 @@
+development:
+  adapter: mysql
+  database: aroptests
+  username: rails
+  password:
+  port: 3306
+  host: localhost

data/config/database.yml.template

@@ -0,0 +1,7 @@
+development:
+  adapter: mysql
+  database: aroptests
+  username: rails
+  password:
+  port: 3306
+  host: localhost

data/config/mysql.schema

@@ -0,0 +1,72 @@
+
+create table test_myisam(
+  id int(11) unsigned not null auto_increment,
+  my_name varchar(20) not null,
+  description varchar(255) default '',
+  primary key (id)
+)ENGINE=MyISAM;
+
+
+create table test_innodb(
+  id int(11) unsigned not null auto_increment,
+  my_name varchar(20) not null,
+  description varchar(255) default '',
+  primary key (id)
+)ENGINE=InnoDb;
+
+
+create table test_memory(
+  id int(11) unsigned not null auto_increment,
+  my_name varchar(20) not null,
+  description varchar(255) default '',
+  primary key (id)
+)ENGINE=memory;
+
+
+create temporary table test_temp(
+  id int(11) unsigned not null auto_increment,
+  my_name varchar(20) not null,
+  description varchar(255) default '',
+  primary key (id)
+);
+
+CREATE TABLE `topics` (
+  `id` int(11) NOT NULL auto_increment,
+  `title` varchar(255) default NULL,
+  `author_name` varchar(255) default NULL,
+  `author_email_address` varchar(255) default NULL,
+  `written_on` datetime default NULL,
+  `bonus_time` time default NULL,
+  `last_read` date default NULL,
+  `content` text,
+  `approved` tinyint(1) default '1',
+  `replies_count` int(11) default '0',
+  `parent_id` int(11) default NULL,
+  `type` varchar(50) default NULL,
+  PRIMARY KEY  (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=latin1;
+
+CREATE TABLE `projects` (
+  `id` int(11) NOT NULL auto_increment,
+  `name` varchar(100) default NULL,
+  `type` varchar(255) NOT NULL,
+  PRIMARY KEY  (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=latin1;
+
+CREATE TABLE `developers` (
+  `id` int(11) NOT NULL auto_increment,
+  `name` varchar(100) default NULL,
+  `salary` int(11) default '70000',
+  `created_at` datetime default NULL,
+  `updated_at` datetime default NULL,
+  PRIMARY KEY  (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=latin1;
+
+CREATE TABLE `books` (
+  `id` int(11) NOT NULL auto_increment,
+  `title` varchar(255) NOT NULL,
+  `publisher` varchar(255) NOT NULL,
+  `author_name` varchar(255) NOT NULL,
+  PRIMARY KEY (`id`),
+  FULLTEXT( `title`, `publisher`, `author_name` )
+) ENGINE=MyISAM;

data/config/postgresql.schema

@@ -0,0 +1,39 @@
+CREATE TABLE topics (
+  id serial NOT NULL,
+  title character varying(255) default NULL,
+  author_name character varying(255) default NULL,
+  author_email_address character varying(255) default NULL,
+  written_on timestamp default NULL,
+  bonus_time time default NULL,
+  last_read date default NULL,
+  content text,
+  approved bool default TRUE,
+  replies_count integer default 0,
+  parent_id serial default NULL,
+  type character varying(50) default NULL,
+  PRIMARY KEY  (id)
+); 
+
+CREATE TABLE projects (
+  id serial NOT NULL,
+  name character varying(100) default NULL,
+  type character varying(255) NOT NULL,
+  PRIMARY KEY  (id)
+); 
+
+CREATE TABLE developers (
+  id serial NOT NULL,
+  name character varying(100) default NULL,
+  salary integer default 70000,
+  created_at timestamp default NULL,
+  updated_at timestamp default NULL,
+  PRIMARY KEY (id)
+);
+
+CREATE TABLE books (
+  id serial NOT NULL,
+  title character varying(255) NOT NULL,
+  publisher character varying(255) NOT NULL,
+  author_name character varying(255) NOT NULL,
+  PRIMARY KEY (id)
+);