sequel 3.21.0 → 3.31.0

data/CHANGELOG

@@ -1,3 +1,485 @@
+=== 3.31.0 (2012-01-03)
+
+* Dataset#from no longer handles :a__b__c___d as a.b.c AS d (jeremyevans)
+
+* Support many_to_one associations with the same name as their column, using the :key_column option (jeremyevans)
+
+* Add Model.def_column_alias for defining alias methods for columns (jeremyevans)
+
+* Support :server option in Dataset#import and #multi_insert (jeremyevans)
+
+* Respect existing RETURNING/OUTPUT clauses in #import/#multi_insert on PostgreSQL/MSSQL (jeremyevans)
+
+* Support :return=>:primary_key option to Dataset#import and #multi_insert (jeremyevans)
+
+* Correctly handle return value for Dataset#insert with column array and value array on PostgreSQL <8.2 (jeremyevans)
+
+* Dataset#insert_multiple now returns an array of inserted primary keys (jeremyevans) (#408)
+
+* Support RETURNING with DELETE and UPDATE on PostgreSQL 8.2+ (funny-falcon)
+
+* Raise error if tables from two separate schema are detected when parsing the schema for a single table on PostgreSQL (jeremyevans)
+
+* Handle clob types as string instead of blob on H2 (jeremyevans)
+
+* Add database type support to the mock adapter, e.g. mock://postgres (jeremyevans)
+
+* Allow creation of full text indexes on Microsoft SQL Server, but you need to provide a :key_index option (jeremyevans)
+
+* Allow Dataset#full_text_search usage with prepared statements (jeremyevans)
+
+* Make Dataset#exists use a PlaceholderLiteralString so it works with prepared statements (jeremyevans)
+
+* Fix Dataset#empty? for datasets with offsets when offset support is emulated (jeremyevans)
+
+* Add Dataset#group_rollup and #group_cube methods for GROUP BY ROLLUP and CUBE support (jeremyevans)
+
+* Add support for custom serialization formats to the serialization plugin (jeremyevans)
+
+* Support a :login_timeout option in the jdbc adapter (glebpom) (#406)
+
+=== 3.30.0 (2011-12-01)
+
+* Handle usage of on_duplicate_key_update in MySQL prepared statements (jeremyevans) (#404)
+
+* Make after_commit and after_rollback respect :server option (jeremyevans) (#401)
+
+* Respect :connect_timeout option in the postgres adapter when using pg (glebpom, jeremyevans) (#402)
+
+* Make Dataset#destroy for model datasets respect dataset shard when using a transaction (jeremyevans)
+
+* Make :server option to Model#save set the shard to use (jeremyevans)
+
+* Move Model#set_server from the sharding plugin to the base plugin (jeremyevans)
+
+* Add :graph_alias_base association option for setting base name to use for table aliases when eager graphing (jeremyevans)
+
+* Make ILIKE work correctly on Microsoft SQL Server if database/column collation is case sensitive (jfirebaugh) (#398)
+
+* When starting a new dataset graph, assume existing selection is the columns to select from the current table (jeremyevans)
+
+* Allow specifying nanoseconds and offsets when converting a hash or array to a timestamp (jeremyevans, jfirebaugh) (#395)
+
+* Improve performance when converting Java types to ruby types in the jdbc adapter (jeremyevans, jfirebaugh) (#395)
+
+* Fix tinytds adapter if DB.identifier_output_method = nil (jeremyevans)
+
+* Explicitly order by the row number column when emulating offsets (jfirebaugh) (#393)
+
+* Fix Dataset#graph and #eager_graph modifying the receiver if the receiver is already graphed (jeremyevans) (#392)
+
+* Change dataset literalization to an append-only-all-the-way-down design (jeremyevans)
+
+=== 3.29.0 (2011-11-01)
+
+* Allow Model.dataset_module to take a Module instance (jeremyevans)
+
+* Apply Model.[] optimization in more cases (jeremyevans)
+
+* Fix Model.[] optimization when dataset uses identifier_input_method different than database (jeremyevans)
+
+* Work around pragma bug on jdbc/sqlite when emulating alter table support (jeremyevans)
+
+* Database#<< and Dataset#<< now return self so they can be safely chained (jeremyevans)
+
+* Fully support using an aliased table name as the :join_table option for a many_to_many association (jeremyevans)
+
+* Make like case sensitive on SQLite and Microsoft SQL Server (use ilike for case insensitive matching) (jeremyevans)
+
+* Add Database#extend_datasets for the equivalent of extending of the Database object's datasets with a module (jeremyevans)
+
+* Speed up Dataset #map, #to_hash, and related methods if an array of symbols is given (jeremyevans)
+
+* Add Database#dataset_class for modifying the class used for datasets for a single Database object (jeremyevans)
+
+* Plugins that override Model.load should be modified to override Model.call instead (jeremyevans)
+
+* Speed up loading model objects from the database by up to 7-16% (jeremyevans)
+
+* Create accessor methods for all columns in a model's table, even if the dataset doesn't select the columns (jeremyevans)
+
+* Add mock adapter for better mocking of a database connection (jeremyevans)
+
+* Have models pass their dataset instead of table name to Database#schema (jeremyevans)
+
+* Allow Database#schema to take a dataset as the table argument, and use its identifier input/output methods (jeremyevans)
+
+* Significant improvements to the db2 adapter (jeremyevans)
+
+* Handle methods with names that can't be called directly in Model.def_dataset_method (jeremyevans)
+
+* Add dataset_associations plugin for making dataset methods that return datasets of associated objects (jeremyevans)
+
+* Don't allow Model.def_dataset_method to override private model methods (jeremyevans)
+
+* Parsing primary key information from system tables in the shared MSSQL adapter (jeremyevans)
+
+* Fix handling of composite primary keys when emulating alter table operations on SQLite (jeremyevans)
+
+* Emulate add_constraint and drop_constraint alter table operations on SQLite (jeremyevans)
+
+* Apply the correct pragmas when connecting to SQLite via the Amalgalite and Swift adapters (jeremyevans)
+
+* Fix bound variable usage for some types (e.g. Date) when used outside of prepared statements on SQLite (jeremyevans)
+
+* Work around SQLite column naming bug when using subselects (jeremyevans)
+
+* Make prepared_statements plugin work with adapters that require type specifiers for variable placeholders, such as oracle (jeremyevans)
+
+* Add savepoint support to the generic JDBC transaction support (used by 6 jdbc subadapters) (jeremyevans)
+
+* Add native prepared statement support to the oracle adapter (jeremyevans)
+
+* Support sharding correctly by default when using transactions in model saving/destroying (jeremyevans)
+
+* Add Database#in_transaction? method for checking if you are already in a transaction (jeremyevans)
+
+* Add after_commit, after_rollback, after_destroy_commit, and after_destroy_rollback hooks to Model objects (jeremyevans)
+
+* Add after_commit and after_rollback hooks to Database objects (jeremyevans) (#383)
+
+* Support savepoints inside prepared transactions on MySQL (jeremyevans)
+
+* Support opening transactions to multiple shards of the same Database object in the same Thread (jeremyevans)
+
+* Add Sequel.transaction for running transactions on multiple databases at the same time (jeremyevans)
+
+* Support :rollback => :always option in Database#transaction to always rollback the transaction (jeremyevans)
+
+* Support :rollback => :reraise option in Database#transaction to reraise the Sequel::Rollback exception (jeremyevans)
+
+* Add support for connecting to Apache Derby databases using the jdbc adapter (jeremyevans)
+
+* Add support for connecting to HSQLDB databases using the jdbc adapter (jeremyevans)
+
+* Fix inserting all default values into a table on DB2 (jeremyevans)
+
+* Add :qualify option to many_to_one associations for whether to qualify the primary key column with the associated table (jeremyevans)
+
+* Modify rcte_tree plugin to use column aliases if recursive CTEs require them (jeremyevans)
+
+* Add Dataset#recursive_cte_requires_column_aliases? method to check if you must provide an argument list for a recursive CTE (jeremyevans)
+
+* Much better support for Oracle in both the oci8-based oracle adapter and the jdbc oracle subadapter (jeremyevans)
+
+* Handle CTEs in subselects in more places on databases that don't natively support CTEs in subselects (jeremyevans)
+
+* Change Dataset#to_hash to not call the row_proc if 2 arguments are given (jeremyevans)
+
+* Change Dataset#map to not call the row_proc if an argument is given (jeremyevans)
+
+* Make Dataset#select_map and #select_order_map return an array of single element arrays if given an array with a single symbol (jeremyevans)
+
+* Make Dataset#columns work correctly on jdbc, odbc, ado, and dbi adapters when using an emulated offset on MSSQL and DB2 (jeremyevans)
+
+* Add Database#listen and #notify to the postgres adapter, for LISTEN and NOTIFY support (jeremyevans)
+
+* Emulate the bitwise compliment operator on h2 (jeremyevans)
+
+* Fix improper handling of emulated bitwise operators with more than two arguments (jeremyevans)
+
+* Allow convert_invalid_date_time to be set on a per-Database basis in the mysql adapter (jeremyevans)
+
+* Allow convert_tinyint_to_bool to be set on a per-Database basis in the mysql and mysql2 adapters (jeremyevans)
+
+* Allow per-Database override of the typeconversion procs on the mysql, sqlite, and ibmdb adapters (jeremyevans)
+
+* Add Database#timezone accessor, for overriding Sequel.database_timezone per Database object (jeremyevans)
+
+=== 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) (#376)
+
+* Add much better support for DB2 databases (roylez, jeremyevans) (#376)
+
+* 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)
@@ -2954,9 +3436,9 @@
 
 === 0.1.9.3 (2007-08-10)
 
-* Added support for specifying field size in schema definitions (thanks Florian Aßmann.)
+* Added support for specifying field size in schema definitions (thanks Florian Assmann.)
 
-* Added migration code based on work by Florian Aßmann.
+* Added migration code based on work by Florian Assmann.
 
 * Reintroduced metaid dependency. No need to keep a local copy of it.
 
@@ -3034,7 +3516,7 @@
 
 * Fixed Dataset#first to include a LIMIT clause for a single record.
 
-* Small fix to Postgres driver to return a primary_key value for the inserted record if it is specified in the insertion values (thanks Florian Aßmann and Pedro Gutierrez).
+* Small fix to Postgres driver to return a primary_key value for the inserted record if it is specified in the insertion values (thanks Florian Assmann and Pedro Gutierrez).
 
 * Fixed Symbol#DESC to support qualified notation (thanks Pedro Gutierrez).
 

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