sequel 3.21.0 → 3.28.0

data/CHANGELOG

@@ -1,3 +1,297 @@
+=== 3.28.0 (2011-10-03)
+
+* Add firebird jdbc subadapter (jeremyevans)
+
+* Add SQLTime.create method for easier creation of SQLTime instances (jeremyevans)
+
+* Make Dataset#with_pk use a qualified primary key, so it works correctly on joined datasets (jeremyevans)
+
+* Support the :limit association option when using eager_graph (jeremyevans)
+
+* Fix eager loading via eager_graph of one_to_one associations that match multiple associated objects and use order to pick the first one (jeremyevans)
+
+* Make after_load association hooks apply when using eager_graph (jeremyevans)
+
+* Make Dataset#with_sql treat a symbol as a first argument as a method name to call to get the SQL (jeremyevans)
+
+* Make Dataset #delete, #insert, #update return array of plain hashes if block not given and Dataset#returning is used (jeremyevans)
+
+* Allow Dataset #map, #to_hash, #select_map, #select_order_map, and #select_hash to take arrays of columns instead of single columns (jeremyevans)
+
+* Make Dataset #delete, #insert, #update yield plain hashes to a block if Dataset#returning is used (jeremyevans)
+
+* Add Dataset#returning for setting the columns to return in INSERT/UPDATE/DELETE statements, used by PostgreSQL 9.1 (jeremyevans)
+
+* Support WITH clause in INSERT/UPDATE/DELETE on PostgreSQL 9.1+ (jeremyevans)
+
+* Add Database#copy_table for PostgreSQL COPY support when using the postgres adapter with pg (jeremyevans)
+
+* Support CREATE TABLE IF NOT EXISTS on PostgreSQL 9.1+ (jeremyevans)
+
+* Add support for Sequel::Model.default_eager_limit_strategy to set the default :eager_limit_strategy for *_many associations (jeremyevans)
+
+* Add support for an :eager_limit_strategy => :correlated_subquery value for limiting using correlated subqueries (jeremyevans)
+
+* Allow use of a dataset that uses the emulated offset support on MSSQL and DB2 in an IN subquery by using a nested subquery (jeremyevans)
+
+* Allow use of a dataset that uses LIMIT in an IN subquery on MySQL by using a nested subquery (jeremyevans)
+
+* Work around serious ActiveSupport bug in Time.=== that breaks literalization of Time values (jeremyevans)
+
+* Speed up SQL operator methods by using module_eval instead of define_method (jeremyevans)
+
+* Support sql_(boolean,number,string) methods on ComplexExpressions, allowing you do to (x + 1).sql_string + 'a' for (x + 1) || 'a' (jeremyevans)
+
+* Don't disallow SQL expression creation based on types, leave that to the database server (jeremyevans)
+
+* Make :column [&|] 1 use an SQL bitwise [&|] expression instead of a logical (AND|OR) expression (jeremyevans)
+
+* Make :column + 'a' use an SQL string concatenation expression instead of an addition expression (jeremyevans)
+
+* Fix :time typecasting from Time to SQLTime for fractional seconds on ruby 1.9 (jeremyevans)
+
+* Have Dataset#select_append check supports_select_all_and_column? and select all from all FROM and JOIN tables if no columns selected (jeremyevans)
+
+* Add Dataset#supports_select_all_and_column? for checking if you can do SELECT *, column (jeremyevans)
+
+* Add support for an :eager_limit_strategy => :window_function value for limiting using window functions (jeremyevans)
+
+* Add support for an :eager_limit_strategy => :distinct_on value for one_to_one associations for using DISTINCT ON (jeremyevans)
+
+* Add support for an :eager_limit_strategy association option, for manual control over how limiting is done (jeremyevans)
+
+* Add Dataset#supports_ordered_distinct_on? for checking if the dataset can use distinct on while respecting order (jeremyevans)
+
+* Add support for the association :limit option when eager loading via .eager for *_many associations (jeremyevans)
+
+* Add db2 jdbc subadapter (jeremyevans)
+
+* Fix the db2 adapter so it actually works (jeremyevans)
+
+* Add ibmdb adapter for accessing DB2 (roylez, jeremyevans)
+
+* Add much better support for DB2 databases (roylez, jeremyevans)
+
+* Handle SQL::AliasedExpressions and SQL::JoinClauses in Dataset#select_all (jeremyevans)
+
+* Speed up type translation slightly in mysql, postgres, and sqlite adapters (jeremyevans)
+
+* Add Dataset#supports_cte_in_subqueries? for checking whether database supports WITH in subqueries (jeremyevans)
+
+* Allow Model.set_dataset to accept Sequel::LiteralString arguments as table names (jeremyevans)
+
+* Association :after_load hooks in lazy loading are now called after the associated objects have been cached (jeremyevans)
+ 
+* Emulate handling of extract on MSSQL, using datepart (jeremyevans)
+
+* Emulate handling of extract on SQLite, but you need to set Database#use_timestamp_timezones = false (jeremyevans)
+
+* Abstract handling of ComplexExpressionMethods#extract so that it can work on databases that don't implement extract (jeremyevans)
+
+* Emulate xor operator on SQLite (jeremyevans)
+
+* Add Dataset#supports_where_true? for checking if the database supports WHERE true (or WHERE 1 if 1 is true) (jeremyevans)
+
+* Fix eager loading via eager of one_to_one associations that match multiple associated objects and use order to pick the first one (jeremyevans)
+
+=== 3.27.0 (2011-09-01)
+
+* Add support for native prepared statements to the tinytds adapter (jeremyevans)
+
+* Add support for native prepared statements and stored procedures to the mysql2 adapter (jeremyevans)
+
+* Support dropping primary key, foreign key, and unique constraints on MySQL via the drop_constraint :type option (jeremyevans)
+
+* Add Sequel::SQLTime class for handling SQL time columns (jeremyevans)
+
+* Typecast DateTime objects to Date for date columns (jeremyevans)
+
+* When typecasting Date objects to timestamps, make the resulting objects always have no fractional date components (jeremyevans)
+
+* Add Model.dataset_module for simplifying many def_dataset_method calls (jeremyevans)
+
+* Make prepared_statements_safe plugin work on classes without datasets (jeremyevans)
+
+* Make Dataset#hash work correctly when referencing SQL::Expression instances (jeremyevans)
+
+* Handle allowed mass assignment methods correctly when including modules in classes or extending instances with modules (jeremyevans)
+
+* Fix Model#hash to work correctly with composite primary keys and with no primary key (jeremyevans)
+
+* Model#exists? now returns false without issuing a query for new model objects (jeremyevans)
+
+=== 3.26.0 (2011-08-01)
+
+* Fix bug in default connection pool if a disconnect error is raised and the disconnection_proc also raises an error (jeremyevans)
+
+* Disallow eager loading via eager of many_*_many associations with :eager_graph option (jeremyevans)
+
+* Major speedup in dataset creation (jeremyevans)
+
+* Replace internal implementation of eager_graph with much faster version (jeremyevans)
+
+* Don't treat strings with leading zeros as octal format in the default typecasting (jeremyevans)
+
+* Fix literalization of Date, Time, and DateTime values on Microsoft Access (jeremyevans)
+
+* Fix handling of nil values with the pure-Java version of nokogiri in the xml_serializer plugin (jeremyevans)
+
+* Make identity_map plugin work with standard eager loading of many_to_many and many_through_many associations (jeremyevans)
+
+* Make create_table! only attempt to drop the table if it already exists (jeremyevans)
+
+* Remove custom table_exists? implementations in the oracle and postgres adapters (jeremyevans)
+
+* Handle another type of disconnection in the postgres adapter (jeremyevans)
+
+* Handle disconnections in the ado adapter and do postgres subadapter (jeremyevans)
+
+* Recognize disconnections when issuing BEGIN/ROLLBACK/COMMIT statements (jeremyevans) (#368)
+
+=== 3.25.0 (2011-07-01)
+
+* Work with tiny_tds-0.4.5 in the tinytds adapter, older versions are no longer supported (jeremyevans)
+
+* Make association_pks plugin typecast provided values to integer if the primary key column type is integer (jeremyevans)
+ 
+* Model.set_dataset now accepts Identifier, QualifiedIdentifier, and AliasedExpression arguments (jeremyevans)
+
+* Fix handling of nil values in bound variables and prepared statement and stored procedure arguments in the jdbc adapter (jeremyevans, wei)
+
+* Allow treating Datasets as Expressions, e.g. DB[:table1].select(:column1) > DB[:table2].select(:column2) (jeremyevans)
+
+* No longer use CASCADE by default when dropping tables on PostgreSQL (jeremyevans)
+
+* Support :cascade option to #drop_table, #drop_view, #drop_column, and #drop_constraint for using CASCADE (jeremyevans)
+
+* If validation error messages are LiteralStrings, don't add the column name to them in Errors#full_messages (jeremyevans)
+
+* Fix bug loading plugins on 1.9 where ::ClassMethods, ::InstanceMethods, or ::DatasetMethods is defined (jeremyevans)
+
+* Add Dataset#exclude_where and Dataset#exclude_having methods, so you can force use of having or where clause (jeremyevans)
+
+* Allow Dataset#select_all to take table name arguments and select all columns from each given table (jeremyevans)
+
+* Add Dataset#select_group method, for selecting and grouping on the same columns (jeremyevans)
+
+* Allow Dataset#group and Dataset#group_and_count to accept a virtual row block (jeremyevans)
+
+=== 3.24.1 (2011-06-03)
+
+* Ignore index creation errors if using create_table? with the IF NOT EXISTS syntax (jeremyevans) (#362)
+
+=== 3.24.0 (2011-06-01)
+
+* Add prepared_statements_association plugin, for using prepared statements by default for regular association loading (jeremyevans)
+
+* Add prepared_statements_safe plugin, for making prepared statement use with models more safe (jeremyevans)
+
+* Add prepared_statements_with_pk plugin, for using prepared statements for dataset lookups by primary key (jeremyevans)
+
+* Fix bug in emulated prepared statement support not supporting nil or false as bound values (jeremyevans)
+
+* Add Dataset#unbind for unbinding values from a dataset, for use with creating prepared statements (jeremyevans)
+
+* Add prepared_statements plugin for using prepared statements for updates, inserts, deletes, and lookups by primary key (jeremyevans)
+
+* Make Dataset#[] for model datasets consider a single integer argument as a lookup by primary key (jeremyevans)
+
+* Add Dataset#with_pk for model datasets, for finding first record with matching primary key value (jeremyevans)
+
+* Add defaults_setter plugin for setting default values when initializing model instances (jeremyevans)
+
+* Add around hooks (e.g. around_save) to Sequel::Model (jeremyevans)
+
+* Add Model#initialize_set private method to ease extension writing (jeremyevans)
+
+* Only typecast bit fields to booleans on MSSQL, the MySQL bit type is a bitfield, not a boolean (jeremyevans)
+
+* Set SQL_AUTO_IS_NULL=0 by default when connecting to MySQL via the swift and jdbc adapters (jeremyevans)
+
+* Fix bug in multiple column IN/NOT IN emulation when a model dataset is used (jeremyevans)
+
+* Add support for filtering and excluding by association datasets (jeremyevans)
+
+* Fix literalization of boolean values in filters on SQLite and MSSQL (jeremyevans)
+
+* Add support for filtering and excluding by multiple associations (jeremyevans)
+
+* Add support for inverting some SQL::Constant instances such as TRUE, FALSE, NULL, and NOTNULL (jeremyevans)
+
+* Add support for excluding by associations to model datasets (jeremyevans)
+
+* The Sequel::Postgres.use_iso_date_format setting now only affects future Database objects (jeremyevans)
+
+* Add Sequel::Postgres::PG_NAMED_TYPES hash for extensions to register type conversions for non-standard types (jeremyevans, pvh)
+
+* Make create_table? use IF NOT EXISTS instead of using SELECT to determine existence, if supported (jeremyevans)
+
+* Fix bug in association_pks plugin when associated table has a different primary key column name (jfirebaugh)
+
+* Fix limiting rows when connecting to DB2 (semmons99)
+
+* Exclude columns from tables in the INFORMATION_SCHEMA when parsing table schema on JDBC (jeremyevans)
+
+* Fix limiting rows when connecting to Microsoft Access (jeremyevans)
+
+* Add Database#views for getting an array of symbols of view names for the database (jeremyevans, christian.michon)
+
+* Make Datbase#tables no longer include view names on MySQL (jeremyevans)
+
+* Convert Java CLOB objects to ruby strings when using the JDBC JTDS subadapter (christian.michon)
+
+* If Thread#kill is called on a thread with an open transaction, roll the transaction back on ruby 1.8 and rubinius (jeremyevans)
+
+* Split informix adapter into shared/specific parts, add JDBC informix subadapter (jeremyevans)
+
+=== 3.23.0 (2011-05-02)
+
+* Migrate issue tracker from Google Code to GitHub Issues (jeremyevans)
+
+* Add support for filtering by associations to model datasets (jeremyevans)
+
+* Don't call insert_select when saving a model that doesn't select all columns of the table (jeremyevans)
+
+* Fix bug when using :select=>[] option for a many_to_many association (jeremyevans)
+
+* Add a columns_introspection extension that attempts to skip database queries by introspecting selected columns (jeremyevans)
+
+* When combining old integer migrations and new timestamp migrations, make sure old integer migrations are all applied first (jeremyevans)
+
+* Support dynamic callbacks to customize regular association loading at query time (jeremyevans)
+
+* Support cascading of eager loading with dynamic callbacks for both eager and eager_graph (jeremyevans)
+
+* Make the xml_serializer plugin handle namespaced models by using __ instead of / as a separator (jeremyevans)
+
+* Allow the :eager_grapher association proc to accept a single hash instead of 3 arguments (jfirebaugh)
+
+* Support dynamic callbacks to customize eager loading at query time (jfirebaugh, jeremyevans)
+
+* Fix bug in the identity_map plugin for many_to_one associations when the association reflection hadn't been filled in yet (funny-falcon)
+
+* Add serialization_modification_detection plugin for detecting changes in serialized columns (jeremyevans) (#333)
+
+=== 3.22.0 (2011-04-01)
+
+* Add disconnect detection to tinytds adapter, though correct behavior may require an update to tiny_tds (cult_hero)
+
+* Add Dataset/Database#mssql_unicode_strings accessor when connecting to MSSQL to control string literalization (semmons99, jeremyevans)
+
+* Fix ODBC::Time instance handling in the odbc adapter (jeremyevans)
+
+* Use Sequel.application_timezone when connecting in the oracle adapter to set the connection's session's timezone (jmthomas)
+
+* In the ADO adapter, assume access to SQL Server if a :conn_string option is given that doesn't indicate Access/Jet (damir.si) (#332)
+
+* Use the correct class when loading instances for descendents of model classes that use single table inheritance (jeremyevans)
+
+* Support for COLLATE in column definitions (jfirebaugh)
+
+* Don't use a schema when creating a temporary table (jeremyevans)
+
+* Make migrator work correctly when a default_schema is set (jeremyevans) (#331)
+
 === 3.21.0 (2011-03-01)
 
 * Make symbol splitting (:table__column___alias) work correctly for identifiers that are not in the \w character class (authorNari)

data/README.rdoc

@@ -12,15 +12,15 @@ toolkit for Ruby.
   two-phase commit, transaction isolation, master/slave
   configurations, and database sharding.
 * Sequel currently has adapters for ADO, Amalgalite, DataObjects,
-  DB2, DBI, Firebird, Informix, JDBC, MySQL, Mysql2, ODBC, OpenBase,
-  Oracle, PostgreSQL, SQLite3, Swift, and TinyTDS.
+  DB2, DBI, Firebird, IBM_DB, Informix, JDBC, MySQL, Mysql2, ODBC,
+  OpenBase, Oracle, PostgreSQL, SQLite3, Swift, and TinyTDS.
 
 == Resources
 
 * {Website}[http://sequel.rubyforge.org]
 * {Blog}[http://sequel.heroku.com]
 * {Source code}[http://github.com/jeremyevans/sequel]
-* {Bug tracking}[http://code.google.com/p/ruby-sequel/issues/list]
+* {Bug tracking}[http://github.com/jeremyevans/sequel/issues]
 * {Google group}[http://groups.google.com/group/sequel-talk]
 * {RDoc}[http://sequel.rubyforge.org/rdoc]
 
@@ -573,7 +573,7 @@ You can execute custom code when creating, updating, or deleting records by defi
 
 Note the use of +super+ if you define your own hook methods.  Almost all <tt>Sequel::Model</tt> class and instance methods (not just hook methods) can be overridden safely, but you have to make sure to call +super+ when doing so, otherwise you risk breaking things.
 
-For the example above, you should probably use a database trigger if you can.  Hooks can be used for data integrity, but they will only enforce that integrity when you are modifying the database through model instances.  If you plan on allowing any other access to the database, it's best to use database triggers for data integrity.
+For the example above, you should probably use a database trigger if you can.  Hooks can be used for data integrity, but they will only enforce that integrity when you are modifying the database through model instances.  If you plan on allowing any other access to the database, it's best to use database triggers and constraints for data integrity.
 
 === Deleting records
 
@@ -681,9 +681,23 @@ Associations can be eagerly loaded via +eager+ and the <tt>:eager</tt> associati
   # Loads all people, their posts, their posts' tags, replies to those posts,
   # the person for each reply, the tag for each reply, and all posts and
   # replies that have that tag.  Uses a total of 8 queries.
-  Person.eager(:posts=>{:replies=>[:person, {:tags=>{:posts, :replies}}]}).all
+  Person.eager(:posts=>{:replies=>[:person, {:tags=>[:posts, :replies]}]}).all
 
-In addition to using +eager+, you can also use +eager_graph+, which will use a single query to get the object and all associated objects.  This may be necessary if you want to filter or order the result set based on columns in associated tables.  It works with cascading as well, the syntax is exactly the same.  Note that using eager_graph to eagerly load multiple *_to_many associations will cause the result set to be a cartesian product, so you should be very careful with your filters when using it in that case.
+In addition to using +eager+, you can also use +eager_graph+, which will use a single query to get the object and all associated objects.  This may be necessary if you want to filter or order the result set based on columns in associated tables.  It works with cascading as well, the API is very similar.  Note that using +eager_graph+ to eagerly load multiple <tt>*_to_many</tt> associations will cause the result set to be a cartesian product, so you should be very careful with your filters when using it in that case.
+
+You can dynamically customize the eagerly loaded dataset by using using a proc.  This proc is passed the dataset used for eager loading, and should return a modified copy of that dataset:
+
+  # Eagerly load only replies containing 'foo'
+  Post.eager(:replies=>proc{|ds| ds.filter(text.like('%foo%'))}).all
+
+This also works when using +eager_graph+, in which case the proc is called with dataset to graph into the current dataset:
+
+  Post.eager_graph(:replies=>proc{|ds| ds.filter(text.like('%foo%'))}).all
+
+You can dynamically customize eager loads for both +eager+ and +eager_graph+ while also cascading, by making the value a single entry hash with the proc as a key, and the cascaded associations as the value:
+
+  # Eagerly load only replies containing 'foo', and the person and tags for those replies
+  Post.eager(:replies=>{proc{|ds| ds.filter(text.like('%foo%'))}=>[:person, :tags]}).all
 
 === Extending the underlying dataset
 

data/Rakefile

@@ -1,11 +1,5 @@
 require "rake"
 require "rake/clean"
-require "rake/gempackagetask"
-begin
-  require "hanna/rdoctask"
-rescue LoadError
-  require "rake/rdoctask"
-end
 
 NAME = 'sequel'
 VERS = lambda do
@@ -13,8 +7,6 @@ VERS = lambda do
   Sequel.version
 end
 CLEAN.include ["**/.*.sw?", "sequel-*.gem", ".config", "rdoc", "coverage", "www/public/*.html", "www/public/rdoc*", '**/*.rbc']
-RDOC_DEFAULT_OPTS = ["--quiet", "--line-numbers", "--inline-source", '--title', 'Sequel: The Database Toolkit for Ruby']
-RDOC_OPTS = RDOC_DEFAULT_OPTS + ['--main', 'README.rdoc']
 
 # Gem Packaging and Release
 
@@ -40,7 +32,20 @@ end
 
 ### RDoc
 
-Rake::RDocTask.new do |rdoc|
+RDOC_DEFAULT_OPTS = ["--quiet", "--line-numbers", "--inline-source", '--title', 'Sequel: The Database Toolkit for Ruby']
+
+rdoc_task_class = begin
+  require "rdoc/task"
+  RDOC_DEFAULT_OPTS.concat(['-f', 'hanna'])
+  RDoc::Task
+rescue LoadError
+  require "rake/rdoctask"
+  Rake::RDocTask
+end
+
+RDOC_OPTS = RDOC_DEFAULT_OPTS + ['--main', 'README.rdoc']
+
+rdoc_task_class.new do |rdoc|
   rdoc.rdoc_dir = "rdoc"
   rdoc.options += RDOC_OPTS
   rdoc.rdoc_files.add %w"README.rdoc CHANGELOG MIT-LICENSE lib/**/*.rb doc/*.rdoc doc/release_notes/*.txt"
@@ -50,25 +55,25 @@ end
 
 desc "Make local version of website"
 task :website do
-  sh %{www/make_www.rb}
+  sh %{#{RUBY} www/make_www.rb}
 end
 
 desc "Make rdoc for website"
 task :website_rdoc=>[:website_rdoc_main, :website_rdoc_adapters, :website_rdoc_plugins]
 
-Rake::RDocTask.new(:website_rdoc_main) do |rdoc|
+rdoc_task_class.new(:website_rdoc_main) do |rdoc|
   rdoc.rdoc_dir = "www/public/rdoc"
   rdoc.options += RDOC_OPTS
   rdoc.rdoc_files.add %w"README.rdoc CHANGELOG MIT-LICENSE lib/*.rb lib/sequel/*.rb lib/sequel/{connection_pool,dataset,database,model}/*.rb doc/*.rdoc doc/release_notes/*.txt lib/sequel/extensions/migration.rb"
 end
 
-Rake::RDocTask.new(:website_rdoc_adapters) do |rdoc|
+rdoc_task_class.new(:website_rdoc_adapters) do |rdoc|
   rdoc.rdoc_dir = "www/public/rdoc-adapters"
   rdoc.options += RDOC_DEFAULT_OPTS + %w'--main Sequel'
   rdoc.rdoc_files.add %w"lib/sequel/adapters/**/*.rb"
 end
 
-Rake::RDocTask.new(:website_rdoc_plugins) do |rdoc|
+rdoc_task_class.new(:website_rdoc_plugins) do |rdoc|
   rdoc.rdoc_dir = "www/public/rdoc-plugins"
   rdoc.options += RDOC_DEFAULT_OPTS + %w'--main Sequel'
   rdoc.rdoc_files.add %w"lib/sequel/{extensions,plugins}/**/*.rb"
@@ -123,7 +128,7 @@ begin
   spec_with_cov.call("spec_plugin", Dir["spec/extensions/*_spec.rb"], "Run extension/plugin specs")
   spec_with_cov.call("spec_integration", Dir["spec/integration/*_test.rb"], "Run integration tests")
   
-  %w'postgres sqlite mysql informix oracle firebird mssql'.each do |adapter|
+  %w'postgres sqlite mysql informix oracle firebird mssql db2'.each do |adapter|
     spec_with_cov.call("spec_#{adapter}", ["spec/adapters/#{adapter}_spec.rb"] + Dir["spec/integration/*_test.rb"], "Run #{adapter} specs")
   end
 rescue LoadError
@@ -154,5 +159,5 @@ end
 
 desc "Check syntax of all .rb files"
 task :check_syntax do
-  Dir['**/*.rb'].each{|file| print `#{ENV['RUBY'] || :ruby} -c #{file} | fgrep -v "Syntax OK"`}
+  Dir['**/*.rb'].each{|file| print `#{RUBY} -c #{file} | fgrep -v "Syntax OK"`}
 end