sequel 4.26.0 → 5.37.0

data/doc/release_notes/3.14.0.txt

@@ -1,118 +0,0 @@
-= New Features
-
-* Dataset#grep now accepts :all_patterns, :all_columns, and
-  :case_insensitive options.  Previously, grep would use a case
-  sensitive search where it would match if any pattern matched any
-  column.  These three options give you more control over how the
-  pattern matching will work:
-  
-    dataset.grep([:a, :b], %w'%test% foo')
-    # WHERE ((a LIKE '%test%') OR (a LIKE 'foo')
-    #    OR (b LIKE '%test%') OR (b LIKE 'foo'))
-
-    dataset.grep([:a, :b], %w'%foo% %bar%', :all_patterns=>true)
-    # WHERE (((a LIKE '%foo%') OR (b LIKE '%foo%'))
-    #   AND ((a LIKE '%bar%') OR (b LIKE '%bar%')))
-
-    dataset.grep([:a, :b], %w'%foo% %bar%', :all_columns=>true)
-    # WHERE (((a LIKE '%foo%') OR (a LIKE '%bar%'))
-    #   AND ((b LIKE '%foo%') OR (b LIKE '%bar%')))
-
-    dataset.grep([:a, :b], %w'%foo% %bar%',
-                 :all_patterns=>true,:all_columns=>true)
-    # WHERE ((a LIKE '%foo%') AND (b LIKE '%foo%')
-    #   AND (a LIKE '%bar%') AND (b LIKE '%bar%'))
-    
-    dataset.grep([:a, :b], %w'%test% foo', :case_insensitive=>true)
-    # WHERE ((a ILIKE '%test%') OR (a ILIKE 'foo')
-    #    OR (b ILIKE '%test%') OR (b ILIKE 'foo')) 
-
-* When using the schema plugin, you can now provide a block to the
-  create_table methods to set the schema and create the table
-  in the same call:
-  
-    class Artist < Sequel::Model
-      create_table do
-        primary_key :id
-        String :name
-      end
-    end
-
-* The tree plugin now accepts a :single_root option, which uses a
-  before_save hook to attempt to ensure that there is only a single
-  root in the tree.  It also adds a Model.root method to get the
-  single root of the tree.
-  
-* The tree plugin now adds a Model#root? instance method to check
-  if the current node is a root of the tree.
-
-* Model#save now takes a :raise_on_failure option which will
-  override the object's raise_on_save_failure setting.  This makes
-  it easier to get the desired behavior (raise or just return false)
-  in library code without using a begin/ensure block.
-  
-* The Database#adapter_scheme instance method was added, which
-  operates the same as the class method.
-  
-* Sequel now handles the literalization of OCI8::CLOB objects in
-  the Oracle adapter.
-
-= Other Improvements
-
-* When using the timezone support, Sequel will now correctly load
-  times and datetimes in standard time when the current timezone is
-  in daylight time, or vice versa.  Previously, if you tried to
-  to load a time or datetime in December when in July in a timezone
-  that used daylight time, it would be off by an hour.
-
-* The rcte_tree plugin now works correctly when a :conditions option
-  is used.
-
-* The single_table_inheritance plugin now works correctly when the
-  class discriminator column has the same name as an existing ruby
-  method (such as type).
-
-* Database#each_server now works correctly when a connection string
-  is used to connect, instead of an options hash.
-  
-* Model#destroy now respects the object's use_transactions setting,
-  instead of always using a transaction.
-  
-* Model#exists? now uses a simpler and faster query.
-
-* Sequel now handles the aggregate methods such as count and sum
-  correctly on Microsoft SQL Server when using an ordered dataset
-  with a clause such as DISTINCT or GROUP and without a limit.
-  
-* Sequel now handles rename_table correctly on Microsoft SQL Server
-  when using a case sensitive collation, or when qualifying the
-  table with a schema.
-
-* Sequel now parses the schema correctly on Oracle when the same
-  table name is used in multiple schemas.
-
-* Sequel now handles OCIInvalidHandle errors when disconnecting
-  in the Oracle adapter.
-  
-* Sequel now raises a Sequel::Error instead of an ArgumentError
-  if the current or target migration version does not exist.
-  
-* When a mismatched number of composite keys are used in
-  associations, Sequel now uses a more detailed error message.
-
-* Significant improvements were made to the Dataset and Model
-  RDoc documentation.
-
-= Backwards Compatibility
-
-* Model#valid? now must accept an optional options hash.
-
-* The Model#save_failure private method was renamed to
-  raise_hook_failure.
-  
-* The LOCAL_DATETIME_OFFSET_SECS and LOCAL_DATETIME_OFFSET constants
-  have been removed from the Sequel module.
-  
-* Sequel now uses obj.to_json instead of JSON.generate(obj).  This
-  shouldn't affect backwards compatibility, but did fix a bug in
-  certain cases.

data/doc/release_notes/3.15.0.txt

@@ -1,78 +0,0 @@
-= Performance Enhancements
-
-* A mysql2 adapter was added to Sequel.  It offers a large (2-6x)
-  performance increase over the standard mysql adapter. In order to
-  use it, you need to install mysql2, and change your connection
-  strings to use mysql2:// instead of mysql://.
-  
-* Support for sequel_pg was added to the native postgres adapter,
-  when pg is being used as the backend.  sequel_pg also offers a
-  large (2-6x) performance increase over the default row fetching
-  code that the Sequel postgres adapter uses.  In order to use it,
-  you just need to install sequel_pg, and the postgres adapter will
-  pick it up automatically.
-  
-* Mass assignment has been made about 10x faster by caching the
-  allowed setter methods in the model.
-
-= Other Improvements
-
-* The following construct is now safe to use in environments that
-  reload code without unloading existing constants:
-  
-    class MyModel < Sequel::Model(DB[:table])
-    end
-    
-  Previously, this would raise a superclass mismatch TypeError.
-
-* Sequel now handles the case where both an implicit and an explicit
-  table alias are given to join_table, preferring the explicit alias.
-  This can happen if you are using models with aliased table names
-  and eager graphing them.  Previously, this would result in invalid
-  SQL, with both aliases being used.
-
-* You can use use an aliased table for the :join_table option
-  of a many_to_many association.
-
-* The active_model plugin now supports the final release of
-  ActiveModel 3.0.0.
-  
-* Typecasting now works correctly for attributes loaded lazily
-  when using the lazy_attributes plugin.
-  
-* The class_table_inheritance plugin now works with non-integer
-  primary keys on SQLite.
-
-* Temporary tables are now ignored when parsing the schema on
-  PostgreSQL.
-
-* On MySQL, an :auto_increment key with a true value is added to
-  the Database#schema output hash if the related column is
-  auto incrementing.
-
-* The mysql adapter now handles Mysql::Error exceptions raised when
-  disconnecting.
-
-* On SQLite, emulated alter_table commands that require dropping
-  the table now preserve the foreign key information, if SQLite
-  foreign key support is enabled (it is by default).
-
-* DSN-less connections now work correctly in more cases in the
-  ODBC adapter.
-
-* A workaround has been added for a bug in the Microsoft SQL
-  Server JDBC Driver 3.0, involving it incorrectly returning a
-  smallint instead of a char type for the IS_AUTOINCREMENT
-  metadata value.
-
-* An bug in the error handling when connecting to PostgreSQL using
-  the do (DataObjects) adapter has been fixed.
-
-= Backwards Compatibility
-
-* The caching of allowed mass assignment methods can result in the
-  incorrect exception class being raised if you manually undefine
-  instance setter methods in the model class.  If you do this, you
-  need to clear the setter methods cache manually:
-  
-    MyModel.clear_setter_methods_cache

data/doc/release_notes/3.16.0.txt

@@ -1,45 +0,0 @@
-= New Adapter
-
-* A swift adapter was added to Sequel.  Swift is a relatively new
-  ruby database library, built on top of a relatively new backend
-  called dbic++.  While not yet considered production ready, it is
-  very fast.  The swift adapter is about 33% faster and 40% more
-  memory efficient for selects than the postgres adapter using pg
-  with sequel_pg, though it is slower and less memory efficient
-  for inserts and updates.
-
-  Sequel's swift adapter currently supports only PostgreSQL and
-  MySQL, but support for other databases will probably be added in
-  the future.
-
-= Other Improvements
-
-* Sequel now correctly literalizes DateTime objects on ruby 1.9 for
-  databases that support fractional seconds.
-
-* The identity_map plugin now handles composite keys in many_to_one
-  associations.
-
-* The rcte_tree plugin now works when the model's dataset does not
-  select all columns.  This can happen when using the lazy_attributes
-  plugin on the same model.
-
-* Sequel now supports INTERSECT and EXCEPT on Microsoft SQL Server
-  2005+.
-
-* The Database#create_language method in the shared PostgreSQL
-  adapter now accepts a :replace option to replace the currently
-  loaded procedural language if it already exists.  This option
-  is ignored for PostgreSQL versions before 9.0.
-
-* The identity_map plugin now handles cases where the plugin is
-  loaded separately by two different models.
-
-= Backwards Compatibility
-
-* While not technically backwards compatibility related, it was
-  discovered that the identity_map plugin is incompatible with
-  the standard eager loading of many_to_many and many_through_many
-  associations.  If you want to eagerly load those associations and
-  use the identity_map plugin, you should use eager_graph instead
-  of eager.

data/doc/release_notes/3.17.0.txt

@@ -1,58 +0,0 @@
-= New Features
-
-* You can now change the level at which Sequel logs SQL statements,
-  by calling Database#sql_log_level= with the method name symbol.
-  The default is still :info for backwards compatibility. Previously,
-  you had to use a proxy logger to get similar capability.
-
-* You can now specify graph aliases where the alias would be the same
-  as the table column name using just the table name symbol, instead
-  having to repeat the alias as the second element of an array.  More
-  clearly:
-
-    # < 3.17.0:
-    DB[:a].graph(:b, :a_id=>:id).
-      set_graph_aliases(:c=>[:a, :c], :d=>[:b, :d])
-    # >= 3.17.0:
-    DB[:a].graph(:b, :a_id=>:id).set_graph_aliases(:c=>:a, :d=>:b)
-    
-  Both of these now yield the SQL:
-  
-    SELECT a.c, b.d FROM a LEFT OUTER JOIN b ON (b.a_id = a.id)
-
-* You should now be able to connect to MySQL over SSL in the native
-  MySQL adapter using the :sslca, :sslkey, and related options.
-
-* Database#views and Database#view_exists? methods were added to the
-  Oracle adapter, allowing you to get a an array of view name symbols
-  and to check whether a given view exists.
-
-= Other Improvements
-
-* The nested_attributes plugin now avoids unnecessary update calls
-  when deleting associated objects, resulting in better performance.
-
-* The optimistic_locking plugin now increments the lock column if no
-  other columns were modified but the Model#modified! was called. This
-  means it now works correctly with the nested_attributes plugin when
-  no changes to the main model object are made.
-
-* The xml_serializer plugin can now round-trip nil values correctly.
-  Previously, nil values would be converted into empty strings.  This
-  is accomplished by including a nil attribute in the xml tag.
-  
-* Database#each_server now works correctly when using the jdbc and do
-  adapters and a connection string without a separate :adapter option.
-  
-* You can now clone many_through_many associations.
-
-* The default wait_timeout used by the mysql and mysql2 adapters was
-  decreased slightly so that it works correctly with MySQL database
-  servers that run on Windows.
-  
-* Many improvements were made to the AS400 jdbc subadapter.
-
-* Many improvements were made to the swift adapter and subadapters.
-
-* Dataset#ungraphed now removes any cached graph aliases set with
-  set_graph_aliases or add_graph_aliases.

data/doc/release_notes/3.18.0.txt

@@ -1,120 +0,0 @@
-= New Features
-
-* Reversible migration support has been added:
-
-    Sequel.migration do
-      change do
-        create_table(:artists) do
-          primary_key :id
-          String :name, :null=>false
-        end
-      end
-    end
-
-  The change block acts the same way as an up block, except that
-  it automatically creates a down block that reverses the changes.
-  So the above is equivalent to:
-
-    Sequel.migration do
-      up do
-        create_table(:artists) do
-          primary_key :id
-          String :name, :null=>false
-        end
-      end
-      down do
-        drop_table :artists
-      end
-    end
-
-  The following methods are supported in a change block:
- 
-  * create_table
-  * add_column
-  * add_index
-  * rename_column
-  * rename_table
-  * alter_table (supporting the following methods):
-    * add_column
-    * add_constraint
-    * add_foreign_key (with a symbol, not an array)
-    * add_primary_key (with a symbol, not an array)
-    * add_index
-    * add_full_text_index
-    * add_spatial_index
-    * rename_column
-
-  Use of an other method in a change block will result in the
-  creation of a down block that raises an exception.
-
-* A to_dot extension has been added that adds a Dataset#to_dot
-  method, which returns a string that can be used as input to
-  the graphviz dot program in order to create visualizations
-  of the dataset's abstract syntax tree.  Examples:
-
-  * http://sequel.jeremyevans.net/images/to_dot_simple.gif
-  * http://sequel.jeremyevans.net/images/to_dot_complex.gif
-
-  Both the to_dot extension and reversible migrations support
-  were inspired by Aaron Patterson's recent work on ActiveRecord
-  and ARel.
-
-* The user can now control how the connection pool handles attempts
-  to access shards that haven't been configured.  The default is
-  still to assume the :default shard.  However, you can specify a
-  different shard using the :servers_hash option when connecting
-  to the database:
-
-    DB = Sequel.connect(..., :servers_hash=>Hash.new(:some_shard))
-
-  You can also use this feature to raise an exception if an
-  unconfigured shard is used:
-
-    DB = Sequel.connect(..., :servers_hash=>Hash.new{raise ...})
-
-* The mysql and mysql2 adapters now both support the :read_timeout
-  and :connect_timeout options.  read_timeout is the timeout in
-  seconds for reading back results of a query, and connect_timeout
-  is the timeout in seconds before a connection attempt is abandoned.
-
-= Other Improvements
-
-* The json_serializer plugin will now typecast column values for
-  columns with unrestricted setter methods when parsing JSON into
-  model objects.  It now also calls the getter method when creating
-  the JSON, instead of directly taking the values from the underlying
-  hash.
-
-* When parsing the schema for a model with an aliased table name,
-  the unaliased table name is now used.
-
-* The SQLite adapter has been updated to not rely on the native
-  type_translation support, since that will be removed in the next
-  major version of sqlite3-ruby.  Sequel now implements it's own
-  type translation in the sqlite adapter, similarly to how the mysql
-  and postgres adapters handle type translation.
-
-* On SQLite, when emulating natively unsupported schema methods such
-  as drop_column, Sequel will now attempt to recreate applicable
-  indexes on the underlying table.
-
-* A more informative error message is now used when connecting fails
-  when using the jdbc adapter.
-
-* method_missing is no longer removed from Sequel::BasicObject on
-  ruby 1.8.  This should improve compatibility in some cases with
-  Rubinius.
-
-= Backwards Compatibility
-
-* On SQLite, Sequel no longer assumes that a plain integer in a
-  datetime or timestamp field represents a unix epoch time.
-
-* Previously, saving a model object that used the instance_hooks
-  plugin removed all instance hooks.  Now, only the applicable hooks
-  are removed.  So if you save a new object, the update instance
-  hooks won't be removed.  And if you save an existing object, delete
-  instance hooks won't be removed.
-
-* The private Dataset#identifier_list method has been moved into the
-  SQLite adapter, since that is the only place it was used.

data/doc/release_notes/3.19.0.txt

@@ -1,67 +0,0 @@
-= New Features
-
-* The add_* association methods now accept a primary key, and
-  associates the receiver to the associated model object with that
-  primary key:
-  
-    artist.add_album(42)
-    # equivalent to: artist.add_album(Album[42])
-
-* The validation_class_methods plugin now has the ability to
-  reflect on validations:
-  
-    Album.plugin :validation_class_methods
-    Album.validates_acceptance_of(:a)
-    Album.validation_reflections
-    # => {:a=>[[:acceptance, {:tag=>:acceptance, :allow_nil=>true,
-                :message=>"is not accepted", :accept=>"1"}]]}
-
-= Other Improvements
-
-* In the postgres, mysql, and sqlite adapters, typecasting now uses
-  methods instead of procs.  Since methods aren't closures (while
-  procs are), this makes typecasting faster (up to 15%).
-
-* When typecasting model column values, the classes of the new and
-  existing values are checked in addition to the values themselves.
-  Previously, if the new and existing values were equal (i.e. 1.0
-  and 1), it wouldn't update the value.  Now, if the classes are
-  different, it always updates the value.
-
-* Date and DateTime objects are now handled correctly when using
-  prepared statements/bound variables in the jdbc adapter.
-  
-* Date, DateTime, Time, true, false, and SQL::Blob objects are now
-  handled correctly when using prepared statements/bound variables
-  in the sqlite adapter.
-
-* Sequel now uses varbinary(max) instead of image for the generic
-  File (blob) type on Microsoft SQL Server.  This makes it possible
-  to use an SQL::Blob object as a prepared statement argument.
-  
-* Sequel now handles blobs better in the Amalgalite adapter.
-
-* When disconnecting a connection using the sqlite adapter, all
-  open prepared statements are now closed first.  Previously,
-  attempting to disconnect a connection with open prepared statements
-  resulted in an error.
-
-* The license file has been renamed from COPYING to MIT-LICENSE, to
-  make it easier to determine at a glance which license is used.
-
-= Backwards Compatibility
-
-* Because Sequel switched the generic File type from image to
-  varbinary(max) on Microsoft SQL Server, any migrations/schema
-  modification methods that used the File type will now result in a
-  different column type than before.
-
-* The MYSQL_TYPE_PROCS, PG_TYPE_PROCS, and SQLITE_TYPE_PROCS
-  constants have been removed from the mysql, postgres, and sqlite
-  adapters, respectively.  The UNIX_EPOCH_TIME_FORMAT and
-  FALSE_VALUES constants have also been removed from the sqlite
-  adapter.
-
-* Typecasting in the sqlite adapters now uses to_i and to_f instead
-  of Integer() and Float() with rescues.  If you put non-numeric
-  data in numeric columns on SQLite, this could cause problems.