sequel 3.38.0 → 3.39.0

data/CHANGELOG

@@ -1,3 +1,65 @@
+=== 3.39.0 (2012-09-01)
+
+* Fix defaults_setter to set false default values (jeremyevans)
+
+* Fix serial sequence query in Database#primary_key_sequence on PostgreSQL (jeremyevans) (#538)
+
+* Add Database#copy_into when using postgres adapter with pg driver, for very fast inserts into tables (jeremyevans)
+
+* Combine multiple alter_table operations into a single query where possible on MySQL and PostgreSQL (jeremyevans)
+
+* Handle sets of alter_table operations on MySQL and MSSQL where later operations depend on earlier ones (jeremyevans)
+
+* Add constraint_validations plugin for automatic validations of constaints defined by extension (jeremyevans)
+
+* Add constraint_validations extension for defining database constraints similar to validations (jeremyevans)
+
+* Add Database#supports_regexp? for checking for regular expression support (jeremyevans)
+
+* Add Sequel.trim for cross platform trim function (jeremyevans)
+
+* Add Sequel.char_length for cross platform char_length function (jeremyevans)
+
+* Fixing caching of MySQL server version (hannesg) (#536)
+
+* Allow overriding the convert_tinyint_to_bool setting on a per-Dataset basis in the mysql and mysql2 adapters (jeremyevans)
+
+* Make ValidationFailed and HookFailed exceptions have model method that returns the related model (jeremyevans)
+
+* Automatically wrap array arguments to most PGArrayOp methods in PGArrays (jeremyevans)
+
+* Add set_column_not_null to alter table generator for marking a column as not null (jeremyevans)
+
+* Default second argument of set_column_allow_null to true in alter table generator (jeremyevans)
+
+* Allow Dataset#count to take an argument or virtual row block (jeremyevans)
+
+* Attempt to recognize CURRENT_{DATE,TIMESTAMP} defaults and return them as Sequel::CURRENT_{DATE,TIMESTAMP} (jeremyevans)
+
+* Make dataset.insert(model) assume a single column if model uses the pg_row plugin (jeremyevans)
+
+* No longer handle model instances in plain (non-model) datasets when inserting (jeremyevans)
+
+* Use subselects for model classes as tables in join methods in model datasets if the model's dataset isn't a simple select (jeremyevans)
+
+* No longer handle model classes as tables in join/graph methods in plain (non-model) datasets (jeremyevans)
+
+* Make Time->DateTime and DateTime->Time typecasts retain fractional seconds on ruby 1.8 (jeremyevans) (#531)
+
+* Add bin/sequel -c support, for running code string instead of using an IRB prompt (jeremyevans)
+
+* Allow subclasses plugin to take a block, which is called with each subclasses created (jeremyevans)
+
+* Add :where option to validates_unique, for custom uniqueness filters (jeremyevans)
+
+* Add :connection_handling=>:disconnect option for threaded connection pools (jeremyevans)
+
+* Add Postgres::PGRowOp#* for referencing the members of the composite type as separate columns (jeremyevans)
+
+* Make identity_map plugin work with models lacking a primary key (jeremyevans)
+
+* Recognize MySQL set type and default value (jeremyevans) (#529)
+
 === 3.38.0 (2012-08-01)
 
 * Sequel now recognizes the double(x, y) and double(x, y) unsigned MySQL types (Slike9, jeremyevans) (#528)

data/README.rdoc

@@ -93,11 +93,11 @@ Since datasets retrieve records only when needed, they can be stored and later r
   
 Sequel also offers convenience methods for extracting data from Datasets, such as an extended +map+ method:
 
-  middle_east.map(:name) #=> ['Egypt', 'Greece', 'Israel', ...]
+  middle_east.map(:name) #=> ['Egypt', 'Turkey', 'Israel', ...]
   
 Or getting results as a hash via +to_hash+, with one column as key and another as value:
 
-  middle_east.to_hash(:name, :area) #=> {'Israel' => 20000, 'Greece' => 120000, ...}
+  middle_east.to_hash(:name, :area) #=> {'Israel' => 20000, 'Turkey' => 120000, ...}
 
 == Getting Started
 

data/bin/sequel

@@ -4,6 +4,7 @@ require 'rubygems'
 require 'optparse'
 require 'sequel'
 
+code = nil
 copy_databases = nil
 dump_migration = nil
 dump_schema = nil
@@ -18,7 +19,7 @@ loggers = []
 
 opts = OptionParser.new do |opts|
   opts.banner = "Sequel: The Database Toolkit for Ruby"
-  opts.define_head "Usage: sequel <uri|path> [options]"
+  opts.define_head "Usage: sequel [options] <uri|path> [file]"
   opts.separator ""
   opts.separator "Examples:"
   opts.separator "  sequel sqlite://blog.db"
@@ -34,6 +35,11 @@ opts = OptionParser.new do |opts|
     exit
   end
 
+  opts.on("-c", "--code CODE", "run the given code and exit") do  |v|
+    code = v
+    exclusive_options << :c
+  end
+  
   opts.on("-C", "--copy-databases", "copy one database to another") do 
     copy_databases = true
   end
@@ -83,7 +89,7 @@ opts = OptionParser.new do |opts|
     test = false
   end
 
-  opts.on("-r", "--require lib", "require the library, before executing your script") do |v|
+  opts.on("-r", "--require LIB", "require the library, before executing your script") do |v|
     load_dirs << [v]
   end
 
@@ -207,6 +213,10 @@ begin
     puts "Database copy finished in #{Time.now - start_time} seconds"
     exit
   end
+  if code
+    eval(code)
+    exit
+  end
 rescue => e
   raise e if backtrace
   error_proc["Error: #{e.class}: #{e.message}#{e.backtrace.first}"]

data/doc/advanced_associations.rdoc

@@ -104,7 +104,7 @@ have the following associations
   Album.many_to_one :artist
   Album.one_to_many :tracks
     
-and the following two albums in the database:
+and the following three albums in the database:
 
   album1 = Album.create(:artist_id=>3) # id: 1
   album2 = Album.create(:artist_id=>3) # id: 2

data/doc/association_basics.rdoc

@@ -607,6 +607,19 @@ To fix this, you need to specify the full model class name using the
     end
   end
 
+If both classes are in the same module, but the default class name
+used is not correct, you need to specify the full class name with the
+:class option:
+
+  module App1
+    class AlbumArtist < Sequel::Model
+      one_to_many :albums
+    end
+    class Album < Sequel::Model
+      many_to_one :artist, :class=>"App1::AlbumArtist"
+    end
+  end
+
 == Method Details
 
 In all of these methods, _association_ is replaced by the symbol you

data/doc/release_notes/3.39.0.txt

@@ -0,0 +1,237 @@
+= New Features
+
+* A constraint_validations extension and plugin have been added,
+  which allow you to define validations when creating tables,
+  which are enforced by database constraints, and have those
+  validations be automatically discovered and used by your
+  Sequel::Model classes.
+
+  The extension is designed to be used in your migrations/schema
+  modification code:
+
+    DB.extension(:constraint_validations)
+    DB.create_constraint_validations_table
+    DB.create_table(:foos) do
+      primary_key :id
+      String :name
+
+      validate do
+        min_length 5, :name
+      end
+    end
+
+  This creates a database CHECK constraint that ensures that the
+  minimum length for the column is 5 characters.  It also adds
+  metadata about the validation to the
+  sequel_constraint_validations table.
+
+  To have the model class automatically create validations, just
+  include the plugin in the model:
+
+    class Foo < Sequel::Model
+      plugin :constraint_validations
+    end
+
+  Note that MySQL does not enforce CHECK constraints (it parses
+  but ignores them), so using the extension on MySQL does not
+  actually enforce constraints at the database level, though it
+  still does support the automatic model validations if the plugin
+  is used.
+
+* Dataset#count now takes an argument or a virtual row block,
+  allowing you to do:
+
+    DB[:table].count(:column_name)
+    DB[:table].count{function_name(column1, column2)}
+
+  When count is given an argument, instead of returning the total
+  number of rows, it returns the number of rows where the
+  argument has a non-NULL value.
+
+* Database#copy_into has been added to the postgres adapter when
+  the pg driver is being used, and can be used for very fast
+  inserts into tables if you already have the input preformatted
+  in PostgreSQL text or CSV format.
+
+* set_table_not_null has been added to the alter table generator,
+  for a nicer API:
+
+    alter_table(:t){set_column_not_null :col}
+    # instead of
+    alter_table(:t){set_column_allow_null :col, false}
+
+  Additionally, set_column_allow_null now defaults the second
+  argument to true for a nicer API:
+
+    alter_table(:t){set_column_allow_null :col}
+    # instead of
+    alter_table(:t){set_column_allow_null :col, true}
+
+* Database#supports_regexp? has been added for checking if the
+  database supports Regexp in filters.  Currently, only MySQL and
+  PostgreSQL support Regexps.
+
+  Attempting to use a Regexp on a database that doesn't support it
+  now raises an error when attempting to generate the SQL, instead
+  of sending invalid SQL to the database.
+
+* Sequel.char_length has been added for a cross platform
+  char_length function (emulated when char_length is not supported
+  natively by the database).
+
+* Sequel.trim has been added for a cross platform trim function
+  (emulated when trim is not supported natively by the database).
+
+* ValidationFailed and HookFailed exceptions now have a model method
+  that returns the model instance related to the exception.  This
+  makes it possible to use Model.create inside a begin/rescue block
+  and get access to the underlying instance if there is a validation
+  or before/around hook error.
+
+* The subclasses plugin now accepts a block, which is called with
+  each model class created.  This is useful if you want to apply
+  changes to classes created in the future instead of just existing
+  classes.
+
+* The validates_unique validation in the validation_helpers plugin
+  now accepts a :where option for a custom uniqueness filter.  Among
+  other things this makes it easy to implement a case insensitive
+  uniqueness validation on a case sensitive column.
+
+* The threaded connection pools now support a
+  :connection_handling=>:disconnect option, which makes them disconnect
+  connections after use instead of returning them to the pool.  This
+  makes it possible to completely control connection lifetime using
+  Database#synchronize.
+
+* The pg_row_op extension now has support for PGRowOp#*, for referencing
+  the members of the composite type as separate columns.
+
+* MySQL's set type and default value are now recognized.
+
+* bin/sequel now accepts a -c argument for running an arbitrary
+  code string instead of using an IRB prompt.
+
+= Other Improvements
+
+* Sequel now parses current date/timestamp column defaults when
+  parsing the schema for a table.  The values will be returned
+  as Sequel::CURRENT_DATE for date columns and
+  Sequel::CURRENT_TIMESTAMP for timestamp columns.
+
+  The schema_dumper extension will work with these defaults, so
+  if you dump the schema for a table with a column that uses
+  a current timestamp default, the dumped schema will include
+  the default.
+
+  The defaults setter plugin also works with these changes, so
+  that when new model objects are instantiated, they get the
+  current Date/Time/DateTime values set.
+
+* On MySQL and PostgreSQL, Sequel will now by default attempt
+  to combine multiple alter_table operations into a single
+  query where it believes it can do so correctly.  This can
+  potentially improve performance ~N times, where N is the number
+  of alter table operations.
+
+  This can change the SQL used for old migrations (though it
+  shouldn't change the result), and is a potentially risky
+  change.  This may be disabled by default in future versions
+  if it causes problems.
+
+* The defaults_setter plugin now correctly sets false default
+  values.
+
+* The schema_dumper plugin now preserves fractional seconds
+  in timestamp column defaults when dumping.
+
+* Time->DateTime and DateTime->Time typecasts now retain
+  fractional seconds on ruby 1.8.
+
+* Array arguments passed to most PGArrayOp methods are now
+  automatically wrapped in a PGArray.  If you want to use this
+  support, you need to make sure to load both the pg_array
+  and pg_array_op extensions.
+
+* Sequel now does a better job of finding the sequence for a
+  given table on PostgreSQL, handling more corner cases.  A small
+  side effect of this is sometimes sequence names will be quoted.
+
+* Some potential thread-safety issues when using Sequel with
+  PostgreSQL on a non-GVL ruby implementation have been fixed.
+
+* Sequel now correctly caches the server version query on MySQL.
+
+* Sets of alter_table operations on MySQL and Microsoft SQL Server
+  that require parsing the current database schema, where later
+  alter_table operations depend on earlier ones, should now work
+  correctly.
+
+* You can now drop check constraints on tables on SQLite, though
+  doing so drops all check constraints on the table, not only the
+  specific check constraint given.
+
+* The identity_map plugin no longer breaks if used with a model
+  without a primary key.
+
+* Sequel::SQL::NegativeBooleanConstant now inherits from Constant
+  instead of BooleanConstant.  This means that
+
+    Sequel::NULL == Sequel::NOTNULL
+
+  is now false instead of true.
+
+* You can now override the convert_tinyint_to_bool settings on a
+  per-Dataset basis in the mysql and mysql2 adapters, though
+  the overriding is different depending on the adapter.  Check the
+  commit log for details.
+
+* timestamp(N) types are now recognized as datetime, which should
+  fix certain cases on Oracle.
+
+* Dataset#insert now handles a single model instance argument
+  as a single value if the model uses the pg_row plugin.
+
+* When joining a model dataset using a model class as the table
+  argument, a subselect is used unless the model is a simple select
+  from the underlying table.
+
+* The specs now cleanup after themselves, dropping the tables that
+  they create for testing.
+
+= Backwards Compatibility
+
+* The defaults_setter plugin's behavior changed due to the 
+  current date/timestamp support.  Previously, it would not set
+  a value for the column, since the default wasn't recognized.
+  Therefore, the database would use the default value on insert,
+  which would be the database's current timestamp.
+
+  Now, the value is set to the current Date/Time/DateTime on
+  model object instantiation, so the database wouldn't use the
+  column default.  Instead of the database's current timestamp
+  on insert, the column value will be the application's
+  current timestamp on model instantiation.
+
+  Users who don't want this behavior can remove the default values
+  in the model:
+
+    Model.default_values.delete(:column_name)
+
+* Plain (non-model) datasets no longer allow insert to accept
+  a single model instance argument.  Also, they no longer call
+  values on a single argument if the object responds to it.
+
+* Plain (non-model) datasets no longer accept model classes as
+  tables in the join/graph methods.  Also, they no longer call
+  table_name on the argument if the object responds to it.
+
+* The schema_dumper extension now requires the eval_inspect
+  extension, which changes inspect output for
+  Sequel::SQL::Expression objects.
+
+* Custom adapters that override Database#alter_table_sql_list now
+  need to make sure it returns an already flattened array.
+
+* The identity_map_key method in the identity_map plugin now returns
+  nil instead of a random string if the given pk is nil.

data/doc/schema_modification.rdoc

@@ -532,14 +532,14 @@ the first argument is the current name, and the second is the new name:
 <tt>create_table!</tt> drops the table if it exists
 before attempting to create it, so:
 
-  create_table!(:artists)
+  create_table!(:artists) do
     primary_key :id
   end
 
 is the same as:
 
   drop_table?(:artists)
-  create_table(:artists)
+  create_table(:artists) do
     primary_key :id
   end
 
@@ -551,14 +551,14 @@ mess up the migration.
 <tt>create_table?</tt> only creates the table if it does
 not already exist, so:
 
-  create_table?(:artists)
+  create_table?(:artists) do
     primary_key :id
   end
 
 is the same as:
 
   unless table_exists?(:artists)
-    create_table(:artists)
+    create_table(:artists) do
       primary_key :id
     end 
   end

data/lib/sequel/adapters/jdbc/derby.rb

@@ -171,6 +171,7 @@ module Sequel
         BOOL_TRUE = 'TRUE'.freeze
         BOOL_FALSE = 'FALSE'.freeze
         SELECT_CLAUSE_METHODS = clause_methods(:select, %w'select distinct columns from join where group having compounds order limit lock')
+        EMULATED_FUNCTION_MAP = {:char_length=>'length'.freeze}
 
         # Derby doesn't support an expression between CASE and WHEN,
         # so emulate it by using an equality statement for all of the

data/lib/sequel/adapters/mock.rb

@@ -61,6 +61,11 @@ module Sequel
               :id
             end
           end)
+        end,
+        'oracle' => lambda do |db|
+          db.instance_eval do
+            @primary_key_sequences = {}
+          end
         end
       }