sequel 4.36.0 → 5.61.0

data/doc/release_notes/3.46.0.txt

@@ -1,122 +0,0 @@
-= New Features
- 
-* Dataset#first! has been added.  This is identical to #first,
-  except where #first would return nil due to no row matching,
-  #first! raises a Sequel::NoMatchingRow exception.  The main
-  benefit here is that a standard exception class is now used,
-  so external libraries can deal with these exceptions appropriately
-  (such as web applications returning a 404 error).
-
-* Dataset#with_pk! has been added to model datasets.  Similar to
-  #first!, this raises a Sequel::NoMatchingRow exception instead of
-  returning nil if there is no matching row.
-
-* A drop_foreign_key method has been added to the alter_table
-  generator:
-
-    alter_table(:tab){drop_foreign_key :col}
-
-  This relies on foreign_key_list working and including the name
-  of the foreign key.  Previously, you'd have to drop the foreign key
-  constraint before dropping the column in some cases.
-
-* Column constraints can now be named using :*_constraint_name
-  options:
-
-    create_table(:tab) do
-      primary_key :id, :primary_key_constraint_name=>:pk_name
-      foriegn_key :t_id, :t, :foreign_key_constraint_name=>:fk_name,
-        :unique=>true, :unique_constraint_name=>:uk_name
-    end
-
-  This makes it easier to name constraints, which has always been
-  recommended as it makes it easier to drop such constraints in the
-  future.
-
-* On Microsoft SQL Server, Dataset#cross_apply and #outer_apply have
-  been added to use CROSS/OUTER APPLY.  These are useful if you
-  want to join a table to the output of a function that takes the
-  table as an argument.
-
-= Other Improvements
-
-* The connection pools are now faster when using the
-  :connection_handling=>:queue option.
-
-* External connection pool classes can now be loaded automatically by
-  the :pool_class option.
-
-* Database#each_server now raises if not given a block.  Previously,
-  it just leaked Database references.
-
-* On Microsoft SQL Server, ] characters are now escaped correctly in
-  identifiers.
-
-* On PostgreSQL, infinite dates are also handled when using
-  Database#convert_infinite_timestamps.  Previously, infinite dates
-  were incorrectly converted to 0000-01-01.
-
-* The associations, composition, serialization, and dirty plugins
-  now clear caches stored in the instance in some additional cases,
-  such as when saving model instances when the dataset supports
-  insert_select.
-
-* Model#validates_type in the validation_helpers plugin now handles
-  false values correctly.
-
-* The string_stripper plugin has been fixed to not change the result
-  of Model.set_dataset.
-
-* You can now drop primary key constraints on H2, using:
-
-    alter_table(:tab){drop_constraint :foo, :type=>:primary_key}
-
-* The jdbc/as400 adapter has been fixed, it was broken starting in
-  Sequel 3.44.0.
-
-* A Security guide has been added explaining various security issues
-  to think about when using Sequel.
-
-= Backwards Compatibility
-
-* The change to make associations, composition, serialization, and
-  dirty now clear caches after saving when the dataset supports
-  insert_select can break code that expected the previous behavior.
-  For example:
-
-    artist = Artist[1]
-    artist.has_albums # => false
-
-    album = Album.new(:artist=>artist)
-    def album.after_create
-      super
-      artist.update(:has_albums=>true)
-    end
-    album.save
-
-    artist.has_albums # => false
-
-  Such code should either refresh the artist after saving the album,
-  or use album.artist.has_albums.  You already had to do that if
-  the dataset did not support insert_select; the impetus for this
-  change was to make the behavior consistent.
-
-* Decimal/numeric columns are now strictly typecast by default,
-  similar to integer and real/double precision columns.  If you want
-  the previous loose typecasting to for decimal/numeric columns,
-  use the looser_typecasting extension.
-
-* External adapters that called Database.set_adapter_scheme with a
-  string should change to using a symbol.
-
-* Dataset#select_map, #select_order_map, and #get now raise an
-  exception if they are passed a plain string inside an array.  
-  If you do want to use a plain string, you now need to alias it:
-  
-    dataset.get([Sequel.as('string', :some_alias)])
-
-= Sequel 4 Implementation Planning
-
-* Sequel 4 implementation planning has begun.  If you want to view
-  and/or provide feedback on the implementation plan, see
-  https://github.com/jeremyevans/sequel-4-plans

data/doc/release_notes/3.47.0.txt

@@ -1,270 +0,0 @@
-= New Plugins
-
-* An auto_validations plugin has been added, which automatically
-  adds not null, type, and unique validations based on information
-  obtained from parsing the database schema.  If you don't
-  require customization of the validation error message per
-  column, this can significantly DRY up validation code.  Currently
-  this plugin requires the database support index parsing; that
-  restriction will be removed in Sequel 4.
-
-* An input_transformer plugin has been added, for automatically
-  running a transformation proc on all model column setter
-  input before use.  This is a generalization of the
-  string_stripper plugin, allowing arbitrary modifications
-  to the input.
-
-* An error_splitter plugin has been added, for splitting validation
-  errors applying to multiple columns into a separate validation
-  error per column.  This is useful if you want to to include such
-  errors when using Errors#on to get all errors on the column. In
-  general, only uniqueness errors apply to multiple columns, so
-  those are the only errors likely to be affected.
-
-= Other New Features
-
-* Database.extension has been added, allowing you to load an
-  extension into all future databases.  This is similar to loading a
-  plugin into Sequel::Model itself.  For example, if you want all
-  Database instances to use the query_literals extension, run the
-  following before creating your Database instances:
-
-    Sequel::Database.extension :query_literals
-
-* Database.after_initialize has been added for running a hook
-  on all new databases created.
-
-* Model.default_set_fields_options has been added, allowing you
-  to set the default options for the #set_fields and #update_fields
-  methods.  This is useful if you want to make :missing=>:raise
-  or :missing=>:skip the default behavior.
-
-* The :setter, :adder, :remover, and :clearer association options
-  have been added.  These allow you to override the default
-  implementation used to modify the association.  :setter affects
-  the *_to_one setter method, :adder the *_to_many add_* method,
-  :remover the *_to_many remove_* method, and :clearer the
-  *_to_many remove_all_* method.
-
-  Previously, you had to override a private method to get the same
-  behavior, this just offers a nicer API for that.
-
-* A :keep_reference Database option has been added.  When set to
-  false, a reference to the Database instance is not kept in
-  Sequel::DATABASES.  This is designed for Database instances
-  created by libraries, so they don't accidentally get chosen as
-  the default Sequel::Model database.
-
-* Model#modified! now accepts a column and marks that column
-  as changed.  This is useful if you plan on mutating the column
-  value as opposed to reassigning it.
-
-* Model#modified? now accepts a column and returns whether the
-  column has been changed.
-
-* The migrators now support an :allow_missing_migration_files
-  option, which makes them silently ignore errors related to
-  missing migration files.
-
-* validates_schema_types has been added to validation_helpers,
-  which validates that the column values are instances of the
-  expected ruby type for the given database schema type.  This
-  is a more robust version of the validates_not_string
-  extension, and users of validates_not_string are encouraged
-  to switch soon, as validates_not_string is going away in
-  Sequel 4.
-
-  validates_schema_type has been added to validation_class_methods,
-  which preforms the same validation, but it requires the columns
-  be listed explicitly.
-
-  validates_type in validation_helpers has been expanded to
-  accept an array of allowable classes.
-
-  Related to this is the addition of Database#schema_type_class for
-  returning the type class(es) for the given schema type symbol.
-
-* validates_not_null has been added to the validation_helpers
-  plugin.  This is similar to the validates_presence validation,
-  but only checks for nil values, allowing empty/blank strings.
-
-* In the caching plugin, when the :ignore_exceptions option is true,
-  exceptions raised when deleting an object from the cache are now
-  ignored correctly.
-
-* On PostgreSQL, Sequel now supports a :search_path Database
-  option to automatically set the client connection search_path.
-  This allows you to control which schemas do no require
-  qualification, and in which order to check schemas when
-  referencing unqualified objects.  If you were using the
-  default_schema setting, it is recommended that you switch
-  to using :search_path instead.
-
-* The pg_array extension can now register array types on a
-  per-Database basis via Database#register_array_type. Previously,
-  only global registration of array types was allowed.  Additionally,
-  when registering array types on a per-Database basis, the oids can
-  be looked up automatically, making it possible to register array
-  types with just a type name:
-
-    DB.register_array_type(:interval)
-
-* The pg_array extension now automatically creates conversion
-  procs for array types of all named types used by the
-  database.  This means that if you use the pg_array and
-  pg_hstore extensions, the hstore[] type is now handled
-  correctly.
-
-* The postgres adapter now supports :use_iso_date_format and
-  :convert_infinite_timestamps Database options.  Previously,
-  use_iso_date_format was only a global setting, and
-  convert_infinite_timestamps could only be set after
-  initialization.
-
-* Database#supports_schema_parsing? has been added to check
-  if schema parsing via the Database#schema method is
-  supported.
-
-= Other Improvements
-
-* A race condition related to prepared_sql for newly prepared
-  statements has been fixed.
-
-* Dataset#get now works correctly if given an array with multiple
-  columns if there were no returned rows.
-
-* The plugins that ship with Sequel now handle frozen model instances
-  correctly.
-
-* Freezing of model instances now works correctly for models without
-  primary keys.
-
-* Database constraints added with the constraint_validations
-  plugin now handle NULL values correctly if the :allow_nil=>true
-  setting is used.
-
-* The  pagination, pretty_table, query, schema_caching,
-  schema_dumper, and select_remove extensions can now be
-  loaded by Database#extension.  If you are loading them
-  globally via Sequel.extension, switch to using
-  Database#extension, since that will be required starting
-  in Sequel 4.
-
-* The lazy_attributes plugin no longer uses the identity_map plugin
-  internally, and eager loading lazy attributes now works correctly
-  without an active identity map.
-
-* The many_to_one_pk_lookup plugin now handles many more corner
-  cases, and should be safe to enable by default.
-
-* The static_cache plugin now has optimized implementations of
-  Model.map, .to_hash, and .to_hash_groups which work without a
-  database query.  Model.count without arguments has also been
-  optimized to not require a database query.
-
-* Fetching new records has been made faster when using the
-  update_primary_key plugin, since it was changed to cache the primary
-  key values lazily.
-
-* When using the update_primary_key plugin, if the primary key
-  changes, clear the associations cache of all non-many_to_one
-  associations (since those will likely be based on the primary
-  key).
-
-* The pg_typecast_on_load plugin no longer errors if given a
-  column that doesn't have a matching oid conversion proc.
-
-* Handling of domain types on PostgreSQL has been significantly
-  improved.  Domain type columns now have correct model
-  typecasting, and the pg_row extension correctly sets up
-  conversion procs for domain types inside composite types.
-
-* Postgres::HStoreOp#- now automatically casts string input to
-  text, so that PostgreSQL doesn't assume the string is an
-  hstore.
-
-* Postgres::PGRangeOp#starts_before and #ends_after have been
-  renamed to #ends_before and #starts_after.  The previous
-  names were misleading.  The old names are still available
-  for backwards compatibility, but they will be removed in the
-  Sequel 4.
-
-* The pg_row plugin now handles aliased tables correctly.
-
-* Model#validate in the validation_class_methods plugin no
-  longer skips validate methods in superclasses or previously
-  loaded plugins.
-
-* Loading the touch plugin into a model subclass after it has
-  been loaded into a model superclass no longer ignores
-  inherited touched associations.
-
-* Sequel no longer resets the conversion procs for the
-  Database instance when using Databaset#extension to load a
-  pg_* extension that adds global conversion procs.  Instead,
-  the global conversion procs are added to the instance-specific
-  conversion procs.  The result of this is that manually added
-  conversion procs will not be lost if an extension is loaded
-  afterward.
-
-* The jdbc adapter now references the driver class before loading
-  subadapter specific code, which can fix issues if the database
-  tries to connect on initialization (such as the jdbc/postgres
-  adapter if the pg_hstore extension is loaded previously).
-
-* A guide describing Sequel's support for advanced PostgreSQL
-  features has been added.
-
-= Backwards Compatibility
-
-* If you have already used the constraint_validations plugin to
-  create validations with the :allow_nil=>true option, you should
-  drop and regenerate those constraints to ensure they handle NULL
-  values correctly.
-
-* The change to make PostgreSQL automatically handle domain
-  types can break previous code that set up special conversions
-  and typecasts per domain type.  In the schema parsing, if you
-  want to get the domain type information, it will be contained
-  in the :db_domain_type and :domain_oid schema entries.
-
-* Sequel::Postgres.use_iso_date_format is now only defined if
-  you are using the postgres adapter.  Previously, it could
-  be defined when using other adapters with a pg_* extension,
-  even though the setting had no effect in that case.
-
-* The validation_class_methods plugin now copies validations into
-  the subclass upon inheritance, instead of recursing into the
-  superclass on validation.  This makes it more similar to how
-  all the other Sequel plugins work.  However, it also means that
-  if you add validations to a superclass after creating a
-  subclass, the subclass won't have those validations.  Additionally
-  if you skip superclass validations in a child class after creating
-  a grandchild class, the grandchild class could still have the
-  parent class's validations.
-
-* The validates_unique validation in validation_helpers no longer
-  attempts to do the uniqueness query if the underlying columns
-  have validation errors.  The reasoning behind this is that if the
-  underlying columns are not valid, the uniqueness query can cause
-  a DatabaseError.
-
-* If you were passing strings in hstore format to
-  Postgres::HStoreOp#-, you should manually cast them to hstore:
-
-    hstore_op - Sequel.cast('a=>b', :hstore)
-
-* The default validation error message for validates_type has been
-  modified.
-
-* Database#schema_column_type was made public accidently by an
-  adapter and a few extensions.  That has been fixed, but if you
-  were calling it with an explicit receiver and it happened to
-  work by accident before, you'll need to update your code.
-
-= Sequel 4 Implementation Planning
-
-* Sequel 4 implementation work will begin shortly.  All Sequel users
-  are encouraged to read about the proposed changes and provide
-  feedback on the implementation plan. For details, see
-  https://github.com/jeremyevans/sequel-4-plans.