sequel 5.29.0 → 5.34.0

data/doc/release_notes/4.36.0.txt

@@ -1,116 +0,0 @@
-= New Features
-
-* Sequel::Model::Model() has been added, which allows for
-  Sequel::Model() like behavior where the base class used is a
-  subclass of Sequel::Model.  To make it easier to use,
-  Sequel::Model.def_Model has also been added, which takes a module
-  and adds a Model() method to the module that calls Model() on the
-  receiver.
-
-  A :class_namespace association option has been added to make it
-  possible to set a default namespace for the :class option if given
-  as a symbol or string.
-
-  Sequel::Model.Model.cache_anonymous_models has been added and
-  controls whether to cache anonymous model subclasses created by
-  Sequel::Model::Model() on a per-class basis.
-
-  These changes are designed to make it easier to use namespaced
-  models, for example:
-
-    module Foo
-       Model = Class.new(Sequel::Model)
-       Model.def_Model(self)
-       DB = Model.db = Sequel.connect(ENV['FOO_DATABASE_URL'])
-       Model.plugin :prepared_statements
-       Model.default_association_options[:class_namespace] = 'Foo'
-
-       class Bar < Model
-         # Uses Foo::DB[:bars] as dataset
-
-         # Implicitly uses Foo::Baz as associated class
-         one_to_many :bazes
-
-         # Uses Foo::Baz due to :class_namespace option
-         one_to_many :oldest_bazes, :class=>:Baz, :order=>:id
-       end
-
-       class Baz < Model(:my_baz)
-         # Uses Foo::DB[:my_baz] as dataset
-
-         # Implicitly uses Foo::Bar as associated class
-         one_to_many :bars
-
-         # Uses Foo::Bar due to :class_namespace option
-         one_to_many :oldest_bars, :class=>:Bar, :order=>:id
-       end
-     end
-
-* A string_agg extension has been added for aggregate string
-  concatentation support on PostgreSQL 9+, SQLAnywhere 12+,
-  Oracle11g+, DB 9.7+, MySQL, HSQLDB, H2, and CUBRID:
-
-    DB.extension :string_agg
-    ds = DB[:table]
-    ds.get(Sequel.string_agg(:c))             # ',' default separator
-    ds.get(Sequel.string_agg(:c, ' - '))      # custom separator
-    ds.get(Sequel.string_agg(:c).order(:bar)) # force order
-    ds.get(Sequel.string_agg(:c).distinct)    # remove duplicates
-
-* A connection_expiration extension has been added, for automatically
-  removing connections from the connection pool after they have been
-  open for a given amount of time (4 hours by default).
-
-* Support for <, <=, >, and >= operator validations when using integer
-  and string arguments has been added to the constraint_validations
-  extension and plugin.
-
-* Sequel::SQL::Function#order has been added to support ordered
-  aggregate functions:
-
-    Sequel.function(:foo, :bar).order(:baz)
-    # foo(bar ORDER BY baz)
-
-= Other Improvements
-
-* The validates_operator validation in validation_helpers now
-  considers nil values as invalid unless :allow_nil or a similar
-  option is used.  Previously, using validates_operator with a nil
-  value would probably raise a NoMethodError.  This makes
-  validates_operator more similar to other validations.
-
-* The threaded connection pools no longer hold the pool mutex when
-  disconnecting connections, which is useful if the driver blocks
-  when disconnecting connections.
-
-* The connection_validator extension no longer holds a reference
-  to connections that have been disconnected.
-
-* The connection_validator extension no longer overwrites the
-  connection_validation_timeout if loaded a second time.
-
-* Sequel now closes cursors as soon as it is done using them in the
-  oracle adapter, instead of waiting for GC to clean them up.
-
-* Sequel now handles disconnect errors that occur when literalizing
-  strings in the mysql2 and postgres adapters.
-
-= Backwards Compatibility
-
-* Using the Bignum class as a generic type is now deprecated.  As
-  announced in the 4.35.0 release notes, ruby 2.4 is unifying the
-  Fixnum and Bignum classes into Integer, which results in the
-  behavior of the Bignum class changing.  4.35.0 added support for
-  using the :Bignum symbol as a generic 64-bit integer type, and
-  Sequel users now need to switch to that to avoid the deprecation
-  warning.
-
-  Sequel 4.41.0 (to be released in December), will drop support
-  for using the Bignum class as a generic type.  This is being done
-  before the release of ruby 2.4 to hopefully make it unlikely that
-  users will be subject to a behavior changes when upgrading ruby
-  versions.
-
-  Related to this change, external adapters need to switch from
-  overriding Database#type_literal_generic_bignum to 
-  Database#type_literal_generic_bignum_symbol.

data/doc/release_notes/4.37.0.txt

@@ -1,50 +0,0 @@
-= New Features
-
-* Database#values has been added on SQLite#3.8.3+, operating similarly
-  to the support on PostgreSQL:
-
-    DB.values([[1, 2], [3, 4]]).select_map([:column1, :column2])
-    # => [[1, 2], [3, 4]]
-
-* Regular expressions in dataset filters are now supported on Oracle
-  10g+:
-
-    DB[:t].where(:c=>/re/)
-    # SELECT * FROM "T" WHERE REGEXP_LIKE("C",'re')
-
-= Other Improvements
-
-* Sequel now supports the use of native prepared statements and bound
-  variables in the mysql2 adapter, when mysql2 0.4+ is used.
-  Previously, the mysql2 adapter supported database prepared
-  statements, but variables were always literalized.  That is still
-  supported when mysql2 <0.4 is used.
-
-* The connection pool now removes connections if it detects a
-  disconnect error that is not raised as a
-  Sequel::DatabaseDisconnectError.  Such exceptions are reraised
-  without converted them to Sequel::DatabaseDisconnectError, but the
-  related connection is now removed from the pool.
-
-* The reversible migration support now handles add_constraint with an
-  options hash as the first argument.
-
-* ASTTransformer now handles Sequel.extract, allowing Dataset#qualify
-  and other uses of ASTTransformer to work with such values.
-
-* The create_view :columns option is now suppported on SQLite 3.9.0+.
-
-* An additional disconnect error is now recognized in the postgres
-  adapter.
-
-* A frozen string literal issue has been fixed when multiple different 
-  database connection approaches have failed in the jdbc adapter.
-
-= Backwards Compatibility
-
-* External database adapters need to make sure that
-  Database#database_error_classes returns a valid result if called
-  during Database#initialize.  If you have an external adapter where
-  one of the error classes depends on an argument given when
-  connecting (such as the connection string), you may have to make
-  some changes.

data/doc/release_notes/4.38.0.txt

@@ -1,67 +0,0 @@
-= New Features
-
-* Sequel::SQL::NumericMethods#coerce has been added, which adds
-  support for ruby's coercion protocol when performing numeric
-  operations.  Previously, Sequel supported code like:
-
-    Sequel.expr{a - 1}
-
-  This is because a in this case returns a Sequel::SQL::Indentifier,
-  which defines #- to return a Sequel::SQL::NumericExpression.  By
-  supporting #coerce, the following code now also works:
-
-    Sequel.expr{1 - a}
-
-  This is because Integer#- calls #coerce on the argument if it is
-  defined (ruby's coercion protocol).  Previously, you had to handle
-  this differently, using something like:
-
-    Sequel.expr(1) - a
-    # or
-    Sequel.-(1, a)
-
-* Sequel now supports the ** operator for exponentiation on
-  expressions, similar to the +, -, *, and / operators.  Sequel uses
-  the database power function to implement this by default on the
-  databases that support it (most of them).  On Access, it uses the ^
-  operator, on Derby it is emulated using a combination of exp/ln
-  (with some loss of precision).  SQLite doesn't support a power
-  function at all, but Sequel emulates it using multiplication for
-  known integer exponents.
-
-* Sequel::SQLTime.date= has been added, which allows you to set the
-  date used for Sequel::SQLTime instances.  Sequel::SQLTime is a
-  subclass of Time that is literalized using only the time components,
-  and is the ruby class used to store values of database time columns
-  on most adapters.  Sequel::SQLTime defaults to using the current
-  date, but you can now set a specific date, for more consistency with
-  some drivers (Mysql2 uses 2000-01-01, tiny_tds uses 1900-01-01).
-
-* The postgres adapter now supports a :driver_options option when
-  using the pg driver, which is passed directly to pg.  This can be
-  used to specify a client SSL certificate or to specify the
-  certificate authority root certificate when using
-  :sslmode=>'verify-full'.
-
-= Other Improvements
-
-* Sequel no longer uses after_commit/rollback database hooks by
-  default if the after_commit/after_rollback model methods are not
-  overridden. This provides a performance speedup, but the main
-  benefit is that it no longer causes memory issues when saving a
-  large number of model instances in a single transaction, and it
-  also works with prepared transactions/2 phase commit.  You can
-  still set use_after_commit_rollback= manually to force the
-  after_commit/rollback setting.
-
-  Note that Sequel 5 will move after_commit/rollback model hooks to
-  a plugin, and the default and recommended approach will be to use
-  the database after_commit/rollback hooks in the after_save or
-  similar model hooks.
-
-= Backwards Compatibility
-
-* The Sequel::Model use_after_commit_rollback class and instance
-  methods now return nil by default instead of true.  nil now
-  indicates the default behavior of checking whether the appropriate
-  model hook has been defined, and only adding a database hook if so.

data/doc/release_notes/4.39.0.txt

@@ -1,127 +0,0 @@
-= New Features
-
-* Sequel.[] has been added as an alias to Sequel.expr. This makes it
-  a little easier to get Sequel-specific objects:
-
-    Sequel[:table].*                  # "table".*
-    Sequel[:table__column].as(:alias) # "table"."column" AS "alias"
-    Sequel[:column] + 1               # ("column" + 1)
-
-* The timestamps plugin now supports an :allow_manual_update option.
-  If this option is used, the timestamps plugin will not override the 
-  update timestamp when saving if the user has modified it since
-  retrieving the object.
-
-* The touch plugin now also touches associations on create in addition
-  to update and delete.
-
-* The IntegerMigrator now supports a :relative option, which will
-  migrate that many migrations up (for positive numbers) or down (for
-  negative numbers).
-
-* Database#rollback_checker has been added, which returns a callable
-  that can be called later to determine whether the transaction ended
-  up committing or rolling back.  So if you may need to check
-  transaction status at some future point, and don't need immediate
-  action on rollback/commit, it is better to use a rollback checker
-  than to add an after commit/rollback hook.
-
-    rbc = nil
-    DB.transaction do
-      rbc = DB.rollback_checker
-      rbc.call #=> nil
-    end
-    rbc.call # => false
-
-    DB.transaction(:rollback=>:always) do
-      rbc = DB.rollback_checker
-    end
-    rbc.call # => true
-
-* The add_column schema method now supports an :if_not_exists option
-  on PostgreSQL 9.6+, which will only add the column if it does not
-  already exist:
-
-    DB.add_column :t, :c, Integer, :if_not_exists=>true
-    # ALTER TABLE "t" ADD COLUMN IF NOT EXISTS "c" integer
-
-* The add_column schema method now supports an :after and :first
-  option on MySQL to add the column after an existing column or as
-  the first column:
-
-    DB.add_column :t, :c, Integer, :first=>true
-    # ALTER TABLE `t` ADD COLUMN `c` integer FIRST
-    DB.add_column :t, :c1, Integer, :after=>:c2
-    # ALTER TABLE `t` ADD COLUMN `c1` integer AFTER `c2`
-
-* JSONBOp#insert has been added to the pg_json_ops extension, which
-  supports the new jsonb_insert function added in PostgreSQL 9.6+:
-
-    Sequel.pg_jsonb_op(:c).insert(%w'0 a', 'a'=>1)
-    # jsonb_insert("c", ARRAY['0','a'], '{"a":1}'::jsonb, false)
-
-* Dataset#full_text_search on PostgreSQL now supports a
-  :to_tsquery=>:phrase option, to enable the native phrase searching
-  added in PostgreSQL 9.6+:
-
-    DB[:t].full_text_search(:c, 'foo bar', :to_tsquery=>:phrase)
-    # SELECT * FROM "t"
-    # WHERE
-    #   (to_tsvector(CAST('simple' AS regconfig), (COALESCE("c", '')))
-    #   @@ phraseto_tsquery(CAST('simple' AS regconfig), 'foo bar'))
-
-* Sequel::Database.set_shared_adapter_scheme has been added, allowing
-  external adapters to add support for Sequel's mock adapter.
-  External adapters should have a shared adapter requirable at
-  sequel/adapters/shared/adapter_name, that uses the following
-  format:
-
-    # in sequel/adapters/shared/mydb
-    module Sequel::MyDB
-      Sequel::Database.set_shared_adapter_scheme :mydb, self
-
-      def self.mock_adapter_setup(db)
-        # Any mock-adapter specific setup to perform on the
-        # given Database instance
-      end
-
-      module DatabaseMethods
-        # methods for all Database objects using this adapter
-      end
-
-      module DatasetMethods
-        # methods for all Dataset objects using this adapter
-      end
-    end
-
-
-= Other Improvements
-
-* The hook_class_methods plugin only adds a Database transaction
-  hook if one of the after commit/rollback hook class methods is
-  actually used.  This means that loading the plugin no longer
-  keeps all saved/deleted objects in memory until transaction
-  commit.
-
-* The active_model plugin now uses a rollback checker instead of
-  an after_rollback hook, so models that use the active_model plugin
-  no longer store all saved model instances in memory until
-  transaction commit.
-
-* When using the IntegerMigrator, attempting to migrate to a
-  migration number above the maximum will now migrate to the lastest
-  version, and attempting to migrate to a migration number below 0
-  will now migrate all the way down.
-
-* The pg_interval extension now supports ActiveSupport::Duration
-  objects that use week and hour parts (new in ActiveSupport 5).
-
-= Backwards Compatibility
-
-* The change to the touch plugin to touch associations on create could
-  possibly affect existing behavior, so if you are using this plugin,
-  you should test that this does not cause any problems.
-
-* External adapters that tried to add support for the mock adapter
-  now need to update their code to use the new
-  Sequel::Database.set_shared_adapter_scheme method.

data/doc/release_notes/4.4.0.txt

@@ -1,92 +0,0 @@
-= New Features
-
-* Sequel now supports Sybase SQLAnywhere, via the sqlanywhere and
-  jdbc/sqlanywhere adapters.
-
-* The filter by associations support now handles cases where the
-  association has :conditions or a block (as long as the block
-  does not rely on instance-specific behavior).  This allows
-  you to handle the following:
-
-    Album.many_to_many :popular_tags, :class=>:Tag do |ds|
-      ds.where{tags__popularity > 9000}
-    end
-    Album.where(:popular_tags=>[Tag[1], Tag[2]])
-
-  This will return all albums whose popular_tags would include
-  at least one of those two tags.  Previously, the block would
-  be ignored, returning albums containing one those tags even if
-  the tags weren't popular.
-
-* A table_select plugin has been added that changes the default
-  selection for models from * to table.*.  This is useful for
-  people who want ActiveRecord-like behavior instead of SQL-like
-  behavior, where joining tables doesn't automatically include
-  columns in the other table.
-
-  This can fix issues where joining another table that has columns
-  with the same name as columns in the model table without
-  specifying an explicit selection results in model objects being
-  returned where the values in the model object are the values
-  from the joined table instead of the model table.
-
-* Dataset#offset has been added, for specifying offset separately
-  from limit.  Previous this was possible via:
-
-    ds.limit(nil, offset)
-
-  but this is a friendlier API.
-
-* The jdbc adapter now has support for foreign key parsing.  This
-  is used if there is no specific support for the underlying
-  database.
-
-* Foreign key parsing is now supported on Oracle.
-
-= Other Improvements
-
-* Association add_*/remove_*/remove_all_* methods for
-  pg_array_to_many associations now work on unsaved model objects.
-
-* In the constraint_validations extension, deletes from the
-  metadata table are now processed before inserts, so that dropping
-  an existing constraint and readding a constraint with the same
-  name now works correctly.
-
-* Cloning an association now copies the :eager_block option
-  correctly from the source association if it was passed as
-  the block to the source association method.
-
-* Cloning a cloned association now copies the block for the
-  association.
-
-* The descendants method in the tree plugin no longer modifies an
-  array it is iterating over.
-
-* The jdbc/postgresql adapter now supports PostgreSQL-specific types,
-  with pretty much the same support as the postgres adapter.  When
-  using the pg_* extensions, the dataset will now handle the
-  PostgreSQL types correctly and return instances of the correct
-  Ruby classes (e.g. hstore is returned as Sequel::Postgres::HStore).
-
-  You should no longer need to use the typecast_on_load or
-  pg_typecast_on_load plugins when using model objects that use these
-  types when using the jdbc/postgresql adapter.
-
-* Offset emulation on Oracle now handles cases where selected
-  columns can't be ordered.
-
-* Offset emulation on DB2 no longer automatically orders on all
-  columns if the dataset itself is unordered.
-
-* Types containing spaces are now returning correctly when
-  parsing the schema in the oracle adapter.
-
-* Database#tables no longer returns tables in the recycle bin on
-  Oracle.
-
-* add_foreign_key now works correctly on HSQLDB, by splitting the
-  column addition and constraint addition into two separate
-  statements.
-
-* add_primary_key now works correctly on H2.