sequel 4.36.0 → 5.61.0

data/doc/release_notes/3.12.0.txt

@@ -1,304 +0,0 @@
-= Migration Changes
-
-* A TimestampMigrator has been added to Sequel, and is
-  automatically used if any migration has a version greater than
-  20000100.  This migrator operates similarly to the default
-  ActiveRecord migrator, in that it allows missing migrations.
-  It differs from the ActiveRecord migrator in that it supports
-  migrations with the same timestamp/version as well as a wide
-  variety of timestamp formats (though the ActiveRecord default
-  of YYYYMMDDHHMMSS is recommended and should be used in
-  portable code).
-  
-  Sequel still defaults to the old migrator, but you can use the
-  new one without making changes to your old migrations.  Just
-  make sure your new migration starts with a version greater than
-  20000100, and Sequel will automatically convert the previous
-  schema table to the new format.
-
-* A new migration DSL was added:
-
-    Sequel.migration do
-      up do
-      end
-
-      down do
-      end
-    end
-
-  The old style of using a Sequel::Migration subclass is still
-  supported, but it is recommended that new code use the new DSL.
-
-* The default migrator also had significant issues fixed.  First,
-  it now saves the migration version after each migration, instead
-  of after all migrations, which means Sequel won't attempt to
-  apply already applied migrations if there was previously an error
-  when applying multiple migrations at once on a database that
-  didn't support transactional schema modification.
-
-  Second, duplicate migration versions in the default migrator now
-  raise an exception, as do missing migration versions.  Neither
-  should happen when using the default migrator, which requires
-  consecutive integer versions, similar to the old ActiveRecord
-  migrator.
-
-* Execution times for migrations are now logged to the database's
-  loggers.
-
-= New Plugins
-
-* A sharding plugin has been added that allows model objects to
-  work well with sharded databases.  When using it, model objects
-  know which shard they were retrieved from, so when you save
-  the object, it is saved back to that shard.  The sharding plugin
-  also works with associations, so associated records are retrieved
-  from the same shard the main object was retreived from.  The
-  sharding plugin also works with both methods of eager loading, and
-  provides methods that you can use to create objects on specific
-  shards.
-
-* An update_primary_key plugin has been added that allows Sequel
-  to work correctly if you modify the primary key of a model object.
-  This should not be necessary if you are using surrogate keys, but
-  if your database uses natural primary keys which can change, this
-  should be helpful.
-
-* An association_pks plugin has been added that adds association_pks
-  and association_pks= methods to model objects for both one_to_many
-  and many_to_many associations.  The association_pks method returns
-  an array of primary key values for the associated objects, and
-  the association_pks= method modifies the database to ensure that
-  the object is only associated to the objects specified by the
-  array of primary keys provided to it.
-
-* A string_stripper plugin has been added that strips all strings
-  that are assigned to attribute values.  This is useful for web
-  applications where you want to easily remove leading and trailing
-  whitespace in form entries before storing them in the database.
-
-* A skip_create_refresh plugin has been added that skips the refresh
-  of after you save a new model object.  On most databases, Sequel
-  refreshes the model object after inserting it in order to get
-  values for all of the columns.  For performance reasons, you can
-  use this plugin to skip the refresh if it isn't necessary for you.
-
-= Other New Features
-
-* Sequel::Model#set_fields and update_fields were added.  These
-  methods have a similar API to set_only and update_only, but they
-  operate differently. While set_only and update_only operate over
-  the hash, these methods operate over the array of fields,
-  so they don't raise errors if the hash contains fields not
-  in the array:
-
-    params = {:a=>1, :b=>2, :c=>3}
-    album = Album[1]
-
-    # raises Error because :a is not in the fields
-    album.set_only(params, [:b, :c])
-
-    # Just sets the value of album.b and album.c
-    album.set_fields(params, [:b, :c])
-
-  Other than handling entries in the hash that aren't in the array,
-  set_fields and update_fields also handle entries not in the hash
-  differently:
-
-    # Doesn't modify the object, since the hash is empty
-    album.set_only({}, [:b, :c])
-
-    # Sets album.b and album.c to nil, since they aren't in the hash
-    album.set_fields({}, [:b, :c])
-
-* The :eager_loader association option has a new API, though the
-  previous API still works.  Instead of accepting three arguments,
-  it can now accept a single hash argument, which will use the
-  :key_hash, :rows, and :association keys for the previous three
-  arguments.  The hash will also contain a :self key whose value
-  is the dataset doing the eager load, which was not possible to
-  determine using the old API.
-
-* Sequel::SQL::Expression#hash has been added so that the objects
-  are now safe to use as hash keys.
-
-* A Dataset#order_prepend method has been added allowing you to
-  prepend to an existing order.  This is useful if want to modify
-  a dataset's order such that it first orders by the columns you
-  provide, but for any rows where the columns you provide are
-  equal, uses the existing order to further order the dataset:
-
-    ds.order(:albums__name).order_prepend(:artists__name)
-    # ORDER BY artists.name, albums.name
-
-* When creating foreign key columns, you can now use a :deferrable
-  option to set up a foreign key constraint that is not checked
-  until the end of the transaction:
-
-    DB.create_table(:albums) do
-      primary_key :id
-      String :name
-      foreign_key :artist_id, :artists, :deferrable=>true
-    end
-
-* many_to_many associations now support a :join_table_block option
-  that is used by the add/remove/remove_all methods.  It can modify
-  the dataset to ensure that certain columns are included when
-  inserting or to add a filter so that only certain records are
-  deleted.  It's useful if you have a many_to_many association that
-  is filtered to only a subset of the matching rows in the join
-  table.
-
-* The single_table_inheritance plugin now supports :model_map and
-  :key_map options to set up a custom mapping of column values to
-  model classes.  For simple situations such as when you are mapping
-  integer values to certain classes, a :model_map hash is sufficient:
-
-    Employee.plugin :single_table_inheritance, :type_id,
-     :model_map=>{1=>:Staff, 2=>:Manager}
-   
-  Here the :model_map keys are type_id column values, and the
-  :model_map values are symbols or strings specifying class names.
-
-  For more complex conditions, you can use a pair of procs:
-
-    Employee.plugin :single_table_inheritance, :type_name,
-     :model_map=>proc{|v| v.reverse},
-     :key_map=>proc{|klass| klass.name.reverse}
-
-  Here the type_name column is a string column holding the reverse
-  of the class's name.
-
-* The single_table_inheritance plugin now correctly sets up subclass
-  filters for middle tables in a class hierarchy with more than 2
-  levels.  For example, with this code:
-
-    class Employee < Sequel::Model; end
-    Employee.plugin :single_table_inheritance, :kind
-    class Manager < Employee; end
-    class Executive < Manager; end
-
-  Sequel previously would not return Executives if you used
-  Manager.all.  It now correctly recognizes subclasses so that it
-  will return both Managers and Executives.
-
-* Sequel::Model.qualified_primary_key_hash has been added, giving
-  you a hash that can be used for filtering.  It is similar to
-  primary_key_hash, but it qualifies the keys with the model's
-  table.  It's useful if you have joined the table to another table
-  that has columns with the same name, but you want to only look
-  for a single model object in that dataset.
-
-* For consistency, you can now use Dataset#order_append as an alias
-  for order_more.
-
-= Other Improvements
-
-* Sequel now correctly removes schema entries when altering tables.
-  Previously, some adapters that had to query the existing schema
-  when altering tables resulted in the previous schema being cached.
-
-* Sequel::Model::Errors#on now always returns nil if there are no
-  errors on the attribute.  Previously, it would return an empty
-  array in certain cases.  Additionally, Sequel::Model::Errors#empty?
-  now returns true if there are no errors, where it certain cases
-  it would return false even if there were no errors.
-
-* The schema_dumper extension now works with tables specified as
-  Sequel::SQL::Identifiers.
-
-* Sequel now recognizes the timestamp(N) with(out) time zone column
-  type.
-
-* The lazy_attributes plugin no longer requires the core extensions
-  to work correctly.
-
-* DatabaseDisconnectError support has been added to the ODBC adapter,
-  allowing Sequel to detect disconnects and remove the connection
-  from the connection pool.
-
-* A leak of JDBC statement objects when using transactions was
-  fixed in the jdbc adapter.
-
-* The jdbc adapter now gives a nicer error message if you use a
-  connection string that it doesn't recognize and there is an error
-  when connecting.
-
-* Temporary table creation was fixed on Microsoft SQL Server, but
-  it is not recommended as it changes the name of the table.  If
-  you use Microsoft SQL Server, you should prefix your temporary
-  table names with # and use the regular create table method.
-
-* A large number of guides were added to Sequel to make it easier
-  for new and existing users to learn more about Sequel.  The
-  following guides were added:
-
-  * Querying in Sequel
-  * Migration and Schema Modification
-  * Model Hooks
-  * Model Validations
-  * Sequel for SQL Users
-  * Sequel for ActiveRecord Users
-
-* RDoc section support was added to Sequel::Database, making the
-  method documentation easier to read.
-
-= Backwards Compatibility
-
-* Sequel::Database now defines the indexes and tables methods, even
-  if the adapter does not implement them, similar to how connect
-  and execute are defined.  Previously, you could use respond_to? to
-  check if the adapter supported them, now they raise
-  Sequel::NotImplemented if the database adapter does not implement
-  them.
-
-* Sequel used to raise NotImplementedError in certain default
-  definitions of methods inside Sequel::Database and Sequel::Dataset,
-  when the methods were supposed to be overridden in subclasses.
-  Sequel now uses a Sequel::NotImplemented exception class for these
-  exceptions, which is a subclass of Sequel::Error.
-
-* Sequel no longer applies all association options to the dataset
-  used to remove all many_to_many associated objects.  You should
-  use the new :join_table_block option to get similar behavior if
-  you were filtering the many_to_many association based on columns
-  in the join table and you wanted remove_all to only remove the
-  related columns.
-
-* Sequel now calls certain before and after hook actions in plugins
-  in a different order than before.  This should not have an effect
-  unless you were relying on them being called in the previous order.
-  Now, when overriding before hooks in plugins, Sequel always does
-  actions before calling super, and when overriding after hooks in
-  plugins, Sequel always does actions after calling super.
-
-* The hook_class_methods plugin no longer skips later after hooks if
-  a previous after hook returns false.  That behavior now only occurs
-  for before hooks.
-
-* Sequel now only removes primary key values when updating objects if
-  you are saving the entire object and you have not modified the
-  values of the primary keys.  Previously, Sequel would remove
-  primary key values when updating even if you specified the primary
-  key column specifically or the primary key column was modified and
-  you used save_changes/update.
-
-* Sequel now uses explicit methods instead of aliases for certain
-  methods.  This should only affect you if for example you overrode
-  Dataset#group to do one thing and wanted Dataset#group_by to do
-  the default action.  Now, Dataset#group_by, and methods like it, are
-  explicit methods that just call the methods they previously
-  aliased.  This also means that if you were overriding Dataset#group
-  and explicitly aliasing group_by to it, you no longer need the
-  alias.
-
-* The single_table_inheritance plugin now uses IN instead of = for
-  subclass filters.  This could lead to poor performance if the
-  database has a very bad query planner.
-
-* The private transaction_statement_object method was removed from
-  the JDBC adapter, and Sequel will no longer check for the presence
-  of the method in the transaction code.
-
-* The Sequel::Migrator object is now a class instead of a module, and
-  has been pretty much rewritten.  If you were using any methods of
-  it besides apply and run, they no longer work.

data/doc/release_notes/3.13.0.txt

@@ -1,210 +0,0 @@
-= New Plugins
-
-* A json_serializer plugin was added that allows you to serialize
-  model instances or datasets to JSON using to_json.  It requires
-  the json library.  The API was modeled on ActiveRecord's JSON
-  serialization support.  You can use :only and :except options
-  to specify the columns included, :include to specify associations
-  to include, as well pass options to nested associations using a
-  hash.  In addition to serializing to JSON, it also adds support
-  for parsing JSON to model objects via JSON.parse or #from_json.
-  
-* An xml_serializer plugin was added that allows you to serialize
-  model instances or datasets to XML.  It requries the nokogiri
-  library.  It has a similar API to the json_serializer plugin, using
-  to_xml instead of to_json, and the from_xml class method instead
-  of JSON.parse.
-
-* A tree plugin was added that allows you to treat Sequel::Model
-  objects as being part of a tree.  It provides similar features to
-  rcte_tree, but works on databases that don't support recursive
-  common table expressions.  In addition to the standard parent
-  and children associations, it provides instance methods to get
-  the ancestors, descendants, and siblings of the given tree node,
-  and class methods to get the roots of the tree.
-
-* A list plugin was added that allows you to treat Sequel::Model
-  objects as being part of a list.  This adds instance methods to
-  get the next and prev items in the list, or to move the item
-  to a specific place in the list.  You can specify that all rows
-  in the table belong to the same list, or specify arbitrary scopes
-  so that the same table can contain many separate lists.
-
-= Other New Features
-
-* Sequel is now compatible with Ruby 1.9.2pre3.
-
-* Sequel now supports prepared transactions/two-phase commit on
-  PostgreSQL, MySQL, and H2.  You can specify that you want to
-  use prepared transactions using the :prepare option which
-  should be some transaction id string:
-  
-    DB.transaction(:prepare=>'some string') do ... end
-    
-  Assuming that no exceptions are raised in the transaction block,
-  Sequel will prepare the transaction.  You can then commit the
-  transaction later:
-  
-    DB.commit_prepared_transaction('some string')
-    
-  If you need to rollback the prepared transaction, you can do
-  so as well:
-  
-    DB.rollback_prepared_transaction('some string')
-
-* Sequel now supports customizable transaction isolation levels on
-  PostgreSQL, MySQL, and Microsoft SQL Server.  You can specify the
-  transaction isolation level to use for any transaction using the
-  :isolation option with an :uncommitted, :committed, :repeatable,
-  or :serializable value:
-  
-    DB.transaction(:isolation=>:serializable) do ... end
-    
-  You can also set the default isolation level for transactions via
-  the transaction_isolation_level Database attribute:
-  
-    DB.transaction_isolation_level = :committed
-    
-  If you are connecting to Microsoft SQL Server, it is recommended
-  that you set a default transaction isolation level if you plan
-  on using this feature.
-
-* You can specify a NULLS FIRST/LAST ordering by using the
-  :nulls=>:first/:last option to asc and desc:
-  
-    Album.filter(:release_date.desc(:nulls=>:first),
-                 :name.asc(:nulls=>:last))
-    # ORDER BY release_date DESC NULLS FIRST,
-    #          name ASC NULLS LAST
-
-  This syntax is supported by PostgreSQL 8.3+, Firebird 1.5+,
-  Oracle, and probably some other databases as well, and makes it
-  possible for the user to specify whether NULL values should sort
-  before or after other values.
-
-* Sequel::Model.find_or_create now accepts a block that is a yielded
-  a new model object to be created if an existing model object is
-  not found.  
-  
-    Node.find_or_create(:name=>'A'){|i| i.parent_id = 4}
-
-* The :frame option for windows and window functions can now be a
-  string that is used literally in the SQL.  This is necessary if you
-  want to specify a custom frame, such as one that uses a specific
-  number of rows preceding or following.
-
-* Savepoints are now supported on H2.
-
-* A :methods_module association option was added, allowing you to
-  specify the module into which association instance methods are
-  placed.  By default, it uses the module containing the column
-  accessor methods.
-
-= Other Improvements
-
-* The :encoding option for the native MySQL adapter should now work
-  correctly in all cases.  This fix was included in 3.12.1.
-
-* Sequel now handles arrays of two element arrays automatically when
-  using them as the value of a filter hash:
-  
-    DB[a].filter([:a, :b]=>[[1, 2], [3, 4]])
-    
-  Previously, you had to call .sql_array on the array in order to
-  tell Sequel that it was a value list and not a conditions
-  specifier.
-
-* Sequel no longer attempts to use class polymorphism in the
-  class_table_inheritance plugin if you don't specify a cti_key.
-
-* When using the native SQLite adapter, prepared statements are now
-  cached per connection for increased performance.  Previously,
-  Sequel prepared a new statement for every query.
-
-* tinyint(1) columns are now handled as booleans when connecting to
-  MySQL via JDBC.
-  
-* On PostgreSQL, if no :schema option is provided for
-  Database#tables, #table_exists?, or #schema, and no default_schema
-  is used,  assume all schemas except the default non-public ones.
-  Previously, it assumed the public schema for tables and
-  table_exists?, but did not assume any schema for #schema.
-  
-  This fixes issues if you use table names that overlap with table
-  names in the information_schema, such as domains.  It's still
-  recommended that you specify a default_schema if you are using a
-  schema other than public.
-
-* Unsigned integers are now handled correctly in the schema dumper.
-
-* Sequel::SQL::PlaceholderLiteralString is now a GenericExpression
-  subclass, allowing you to treat it like most other Sequel
-  expression objects:
-  
-    '(a || ?)'.lit(:b).like('Test%')
-    # ((a || b) LIKE 'Test%')
-
-* Sequel now supports the bitwise shift operators (<< and >>) on
-  Microsoft SQL Server by emulating them.
-
-* Sequel now supports most bitwise operators (&, |, ^, <<, >>) on H2
-  by emulating them.  The bitwise complement operator is not yet
-  supported.
-
-* Sequel now logs the SQL queries that are sent when connecting to
-  MySQL.
-
-* If a plugin cannot be loaded, Sequel now gives a more detailed
-  error message.
-
-= Backwards Compatibility
-
-* Array#sql_array and the Sequel::SQL::SQLArray class are now
-  considered deprecated.  Use the Array#sql_value_list and the
-  Sequel::SQL::ValueList class instead.  SQLArray is now just
-  an alias for ValueList, but it now is an Array subclass instead
-  of a Sequel::SQL::Expression subclass.
-
-* Using the ruby bitwise xor operator (^) on PostgreSQL now uses
-  PostgreSQL's bitwise xor operator (#) instead of PostgreSQL's
-  exponentiation operator (^).  If you want exponentiation, use
-  the power function.
-  
-* Using the ruby bitwise complement operator (~) on MySQL now returns
-  a signed integer instead of an unsigned integer, for better
-  compatibility with other databases.
-  
-* Using nil as a case expression value (the 2nd argument to Hash#case
-  and Array#case) will now use NULL as the case expression value,
-  instead of omitting the case expression value:
-  
-    # 3.12.0
-    {1=>2}.case(0, nil)
-    # CASE WHEN 1 THEN 2 ELSE 0 END
-    
-    # 3.13.0
-    {1=>2}.case(0, nil)
-    # CASE NULL WHEN 1 THEN 2 ELSE 0 END
-    
-  In general, you would never use nil explicitly, but the new
-  behavior makes more sense if you have a variable that might be nil:
-  
-    parent_id = Node[1].parent_id
-    {1=>2}.case(0, parent_id)
-
-  If parent_id IS NULL/nil, then previously Sequel would have
-  generated unexpected SQL.  If you don't want a case expression
-  value to be used, do not pass a second argument to #case.
-  
-* Some internal transaction methods now take an optional options
-  hash, so if you have a custom adapter, you will need to make
-  changes.
-  
-* Some internal association methods now take an optional options
-  hash.
-  
-* Some Rakefile task names were modified in the name of consistency:
-
-    spec_coverage -> spec_cov
-    integration -> spec_integration
-    integration_cov -> spec_integration_cov

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.