From: Mike Bayer Date: Mon, 2 Nov 2020 19:34:16 +0000 (-0500) Subject: changelog edits and improvements X-Git-Tag: rel_1_4_0b1~5 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b279f2933643f3eb01f6d98dd212e5bf5fb4b8df;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git changelog edits and improvements added new categories and applied better organization to elements, repaired a few that are already out of date. Change-Id: I02c619c99237c1e66e932543c4ee95fd119d665d --- diff --git a/doc/build/changelog/changelog_14.rst b/doc/build/changelog/changelog_14.rst index f1358c1ade..060e63c7d7 100644 --- a/doc/build/changelog/changelog_14.rst +++ b/doc/build/changelog/changelog_14.rst @@ -2,6 +2,11 @@ 1.4 Changelog ============= +This document details individual issue-level changes made throughout +1.4 releases. For a narrative overview of what's new in 1.4, see +:ref:`migration_14_toplevel`. + + .. changelog_imports:: .. include:: changelog_13.rst diff --git a/doc/build/changelog/unreleased_14/1390.rst b/doc/build/changelog/unreleased_14/1390.rst index 85fc189e05..0915a8ee1c 100644 --- a/doc/build/changelog/unreleased_14/1390.rst +++ b/doc/build/changelog/unreleased_14/1390.rst @@ -1,5 +1,5 @@ .. change:: - :tags: usecase, sql + :tags: feature, sql :tickets: 1390 Add support for regular expression on supported backends. diff --git a/doc/build/changelog/unreleased_14/2056.rst b/doc/build/changelog/unreleased_14/2056.rst index 6c26afe6a3..41f1f4337f 100644 --- a/doc/build/changelog/unreleased_14/2056.rst +++ b/doc/build/changelog/unreleased_14/2056.rst @@ -1,5 +1,5 @@ .. change:: - :tags: reflection, usecase + :tags: engine, feature :tickets: 2056 Added new reflection method :meth:`.Inspector.get_sequence_names` which diff --git a/doc/build/changelog/unreleased_14/4212.rst b/doc/build/changelog/unreleased_14/4212.rst index bdf9a67434..36fc664694 100644 --- a/doc/build/changelog/unreleased_14/4212.rst +++ b/doc/build/changelog/unreleased_14/4212.rst @@ -1,9 +1,9 @@ .. change:: - :tags: bug, easy, inheritance, orm + :tags: bug, inheritance, orm :tickets: 4212 - An :class:`.ArgumentError` is now raised if both the selectable and flat - parameters are set to True in :func:`.orm.with_polymorphic`. - The selectable name is already aliased and applying flat=True - overrides the selectable name with an anonymous name that would've - previously caused the code to break. Pull request courtesy Ramon Williams. + An :class:`.ArgumentError` is now raised if both the ``selectable`` and + ``flat`` parameters are set to True in :func:`.orm.with_polymorphic`. The + selectable name is already aliased and applying flat=True overrides the + selectable name with an anonymous name that would've previously caused the + code to break. Pull request courtesy Ramon Williams. diff --git a/doc/build/changelog/unreleased_14/4235.rst b/doc/build/changelog/unreleased_14/4235.rst index acd1ff1ce0..d0b430a47f 100644 --- a/doc/build/changelog/unreleased_14/4235.rst +++ b/doc/build/changelog/unreleased_14/4235.rst @@ -1,5 +1,5 @@ .. change:: - :tags: sql, mssql + :tags: mssql, feature :tickets: 4235, 4633 Added support for "CREATE SEQUENCE" and full :class:`.Sequence` support for diff --git a/doc/build/changelog/unreleased_14/4262.rst b/doc/build/changelog/unreleased_14/4262.rst index 8377daca0e..b91e1d8d53 100644 --- a/doc/build/changelog/unreleased_14/4262.rst +++ b/doc/build/changelog/unreleased_14/4262.rst @@ -1,5 +1,5 @@ .. change:: - :tags: bug, types + :tags: bug, schema :tickets: 4262 Cleaned up the internal ``str()`` for datatypes so that all types produce a diff --git a/doc/build/changelog/unreleased_14/4524.rst b/doc/build/changelog/unreleased_14/4524.rst index 409fd198e4..5e9e5648e8 100644 --- a/doc/build/changelog/unreleased_14/4524.rst +++ b/doc/build/changelog/unreleased_14/4524.rst @@ -1,5 +1,5 @@ .. change:: - :tags: feature, pool + :tags: performance, engine :tickets: 4524 The pool "pre-ping" feature has been refined to not invoke for a DBAPI diff --git a/doc/build/changelog/unreleased_14/4617_scalar.rst b/doc/build/changelog/unreleased_14/4617_scalar.rst index 3486fe3bcf..52b1d79cc1 100644 --- a/doc/build/changelog/unreleased_14/4617_scalar.rst +++ b/doc/build/changelog/unreleased_14/4617_scalar.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, sql + :tags: renamed, sql :tickets: 4617 The :meth:`_expression.SelectBase.as_scalar` and :meth:`_query.Query.as_scalar` methods have diff --git a/doc/build/changelog/unreleased_14/4632.rst b/doc/build/changelog/unreleased_14/4632.rst index e1dc23b0b9..c3a74b69c5 100644 --- a/doc/build/changelog/unreleased_14/4632.rst +++ b/doc/build/changelog/unreleased_14/4632.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, sql + :tags: removed, sql :tickets: 4632 The "threadlocal" execution strategy, deprecated in 1.3, has been diff --git a/doc/build/changelog/unreleased_14/4634.rst b/doc/build/changelog/unreleased_14/4634.rst index 2beaae8341..aa58aa1697 100644 --- a/doc/build/changelog/unreleased_14/4634.rst +++ b/doc/build/changelog/unreleased_14/4634.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, engine + :tags: deprecated, engine :tickets: 4634 The :paramref:`_schema.MetaData.bind` argument as well as the overall @@ -15,7 +15,7 @@ .. change:: - :tags: change, ext + :tags: change, extensions :tickets: 5142 Added new parameter :paramref:`_automap.AutomapBase.prepare.autoload_with` diff --git a/doc/build/changelog/unreleased_14/4638.rst b/doc/build/changelog/unreleased_14/4638.rst index cc1cd5dd6e..6578933f2b 100644 --- a/doc/build/changelog/unreleased_14/4638.rst +++ b/doc/build/changelog/unreleased_14/4638.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, general + :tags: orm, removed :tickets: 4638 All long-deprecated "extension" classes have been removed, including diff --git a/doc/build/changelog/unreleased_14/4639.rst b/doc/build/changelog/unreleased_14/4639.rst index 51255fa22f..7558f365f8 100644 --- a/doc/build/changelog/unreleased_14/4639.rst +++ b/doc/build/changelog/unreleased_14/4639.rst @@ -1,5 +1,5 @@ .. change:: - :tags: feature, performance + :tags: performance, sql :tickets: 4639 An all-encompassing reorganization and refactoring of Core and ORM diff --git a/doc/build/changelog/unreleased_14/4642.rst b/doc/build/changelog/unreleased_14/4642.rst index cefdabbba4..10b57c2307 100644 --- a/doc/build/changelog/unreleased_14/4642.rst +++ b/doc/build/changelog/unreleased_14/4642.rst @@ -1,5 +1,5 @@ .. change:: - :tags: orm + :tags: orm, removed :tickets: 4642 Remove the deprecated loader options ``joinedload_all``, ``subqueryload_all``, diff --git a/doc/build/changelog/unreleased_14/4643.rst b/doc/build/changelog/unreleased_14/4643.rst index 8910c2559b..81ae88ad38 100644 --- a/doc/build/changelog/unreleased_14/4643.rst +++ b/doc/build/changelog/unreleased_14/4643.rst @@ -1,20 +1,20 @@ .. change:: - :tags: change, engine + :tags: engine, removed :tickets: 4643 - Remove deprecated method ``get_primary_keys` in the :class:`.Dialect` and + Remove deprecated method ``get_primary_keys`` in the :class:`.Dialect` and :class:`_reflection.Inspector` classes. Please refer to the :meth:`.Dialect.get_pk_constraint` and :meth:`_reflection.Inspector.get_primary_keys` methods. Remove deprecated event ``dbapi_error`` and the method - ``ConnectionEvents.dbapi_error`. Please refer to the + ``ConnectionEvents.dbapi_error``. Please refer to the :meth:`_events.ConnectionEvents.handle_error` event. - This chance also removes the attributes ``ExecutionContext.is_disconnect`` - and ``ExecutionContext.exception`` + This change also removes the attributes ``ExecutionContext.is_disconnect`` + and ``ExecutionContext.exception``. .. change:: - :tags: change, postgresql + :tags: removed, postgresql :tickets: 4643 Remove support for deprecated engine URLs of the form ``postgres://``; @@ -22,7 +22,7 @@ using ``postgresql://``. .. change:: - :tags: change, mysql + :tags: removed, mysql :tickets: 4643 Remove deprecated dialect ``mysql+gaerdbms`` that has been deprecated @@ -33,7 +33,7 @@ enum or the set are quoted by SQLAlchemy when needed automatically. .. change:: - :tags: change, orm + :tags: removed, orm :tickets: 4643 Remove deprecated function ``comparable_property``. Please refer to the @@ -56,18 +56,18 @@ Remove deprecated parameter ``mapper.order_by``. Use :meth:`_query.Query.order_by` to determine the ordering of a result set. - Remove deprecated parameter ``Session._enable_transaction_accounting`. + Remove deprecated parameter ``Session._enable_transaction_accounting``. Remove deprecated parameter ``Session.is_modified.passive``. .. change:: - :tags: change, types + :tags: removed, schema :tickets: 4643 Remove deprecated class ``Binary``. Please use :class:`.LargeBinary`. .. change:: - :tags: change, sql, core + :tags: removed, sql :tickets: 4643 Remove deprecated methods ``Compiled.compile``, ``ClauseElement.__and__`` and @@ -78,7 +78,7 @@ :attr:`.func` namespace. .. change:: - :tags: change, sql + :tags: removed, sql :tickets: 4643 Remove deprecated parameters ``text.bindparams`` and ``text.typemap``. diff --git a/doc/build/changelog/unreleased_14/4644.rst b/doc/build/changelog/unreleased_14/4644.rst index 8550b8cbc4..736bddb2d5 100644 --- a/doc/build/changelog/unreleased_14/4644.rst +++ b/doc/build/changelog/unreleased_14/4644.rst @@ -2,9 +2,10 @@ :tags: feature, engine, alchemy2 :tickets: 4644 - Implemented the SQLAlchemy 2 :func:`_future.create_engine` function which - is used for forwards compatibility with SQLAlchemy 2. This engine - features always-transactional behavior with autobegin. + Implemented the :paramref:`_sa.create_engine.future` parameter which + enables forwards compatibility with SQLAlchemy 2. is used for forwards + compatibility with SQLAlchemy 2. This engine features + always-transactional behavior with autobegin. .. seealso:: diff --git a/doc/build/changelog/unreleased_14/4705.rst b/doc/build/changelog/unreleased_14/4705.rst index bfd7c1719b..f9722849c7 100644 --- a/doc/build/changelog/unreleased_14/4705.rst +++ b/doc/build/changelog/unreleased_14/4705.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, orm + :tags: deprecated, orm :tickets: 4705, 5202 Using strings to represent relationship names in ORM operations such as diff --git a/doc/build/changelog/unreleased_14/4719.rst b/doc/build/changelog/unreleased_14/4719.rst index eb173b6b10..4da36dbe62 100644 --- a/doc/build/changelog/unreleased_14/4719.rst +++ b/doc/build/changelog/unreleased_14/4719.rst @@ -1,5 +1,5 @@ .. change:: - :tags: bug, orm + :tags: deprecated, orm :tickets: 4719 Calling the :meth:`_query.Query.instances` method without passing a diff --git a/doc/build/changelog/unreleased_14/4753.rst b/doc/build/changelog/unreleased_14/4753.rst index 53735bd927..ab3e0b6b73 100644 --- a/doc/build/changelog/unreleased_14/4753.rst +++ b/doc/build/changelog/unreleased_14/4753.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change,engine + :tags: feature, sql :tickets: 4753 The :func:`_expression.select` construct and related constructs now allow for diff --git a/doc/build/changelog/unreleased_14/4755.rst b/doc/build/changelog/unreleased_14/4755.rst index b25eb64c90..d8dec255e9 100644 --- a/doc/build/changelog/unreleased_14/4755.rst +++ b/doc/build/changelog/unreleased_14/4755.rst @@ -1,5 +1,5 @@ .. change:: - :tags: changed, engine + :tags: deprecated, engine :tickets: 4755 Deprecated remaining engine-level introspection and utility methods @@ -9,7 +9,7 @@ introspection tasks are suited by the :class:`_reflection.Inspector` object. .. change:: - :tags: changed, engine + :tags: removed, engine :tickets: 4755 The internal dialect method ``Dialect.reflecttable`` has been removed. A @@ -20,7 +20,7 @@ .. change:: - :tags: changed, engine + :tags: removed, engine :tickets: 4755 The long-deprecated ``Inspector.get_table_names.order_by`` parameter has diff --git a/doc/build/changelog/unreleased_14/4789.rst b/doc/build/changelog/unreleased_14/4789.rst index 0d7e1855ac..1d7d8a8b70 100644 --- a/doc/build/changelog/unreleased_14/4789.rst +++ b/doc/build/changelog/unreleased_14/4789.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, tests + :tags: change, general :tickets: 4789 "python setup.py test" is no longer a test runner, as this is deprecated by diff --git a/doc/build/changelog/unreleased_14/4829.rst b/doc/build/changelog/unreleased_14/4829.rst index 10af26af58..aacefdf737 100644 --- a/doc/build/changelog/unreleased_14/4829.rst +++ b/doc/build/changelog/unreleased_14/4829.rst @@ -2,11 +2,12 @@ :tags: bug, orm :tickets: 4829 - Added new entity-targeting capabilities to the :class:`_query.Query` object to + Added new entity-targeting capabilities to the ORM query context help with the case where the :class:`.Session` is using a bind dictionary against mapped classes, rather than a single bind, and the :class:`_query.Query` is against a Core statement that was ultimately generated from a method - such as :meth:`_query.Query.subquery`; a deep search is performed to locate - any ORM entity related to the query in order to locate a mapper if - one is not otherwise present. + such as :meth:`_query.Query.subquery`. First implemented using a deep + search, the current approach leverages the unified :func:`_sql.select` + construct to keep track of the first mapper that is part of + the construct. diff --git a/doc/build/changelog/unreleased_14/4846.rst b/doc/build/changelog/unreleased_14/4846.rst index b534f02d22..fda25fd9b9 100644 --- a/doc/build/changelog/unreleased_14/4846.rst +++ b/doc/build/changelog/unreleased_14/4846.rst @@ -1,5 +1,5 @@ .. change:: - :tags: engine + :tags: deprecated, engine :tickets: 4846 "Implicit autocommit", which is the COMMIT that occurs when a DML or DDL diff --git a/doc/build/changelog/unreleased_14/4877.rst b/doc/build/changelog/unreleased_14/4877.rst index d0f79cea2d..843888fe3d 100644 --- a/doc/build/changelog/unreleased_14/4877.rst +++ b/doc/build/changelog/unreleased_14/4877.rst @@ -1,5 +1,5 @@ .. change:: - :tags: bug, engine + :tags: deprecated, engine :tickets: 4877 Deprecated the behavior by which a :class:`_schema.Column` can be used as the key diff --git a/doc/build/changelog/unreleased_14/4878.rst b/doc/build/changelog/unreleased_14/4878.rst index 2dbd8c23a5..23764757b6 100644 --- a/doc/build/changelog/unreleased_14/4878.rst +++ b/doc/build/changelog/unreleased_14/4878.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, engine + :tags: deprecated, engine :tickets: 4878 The :paramref:`.case_sensitive` flag on :func:`_sa.create_engine` is diff --git a/doc/build/changelog/unreleased_14/4887.rst b/doc/build/changelog/unreleased_14/4887.rst index ffff57f470..c0b410f1f1 100644 --- a/doc/build/changelog/unreleased_14/4887.rst +++ b/doc/build/changelog/unreleased_14/4887.rst @@ -15,7 +15,7 @@ .. change:: - :tags: usecase, ext + :tags: usecase, extensions :tickets: 4887 Custom compiler constructs created using the :mod:`sqlalchemy.ext.compiled` diff --git a/doc/build/changelog/unreleased_14/5010.rst b/doc/build/changelog/unreleased_14/5010.rst index 31976974d6..6b5c155d3b 100644 --- a/doc/build/changelog/unreleased_14/5010.rst +++ b/doc/build/changelog/unreleased_14/5010.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, sql + :tags: deprecated, sql :tickets: 5010 The :meth:`_sql.Join.alias` method is deprecated and will be removed in diff --git a/doc/build/changelog/unreleased_14/5027.rst b/doc/build/changelog/unreleased_14/5027.rst index fba8c6ba3b..d5663b651f 100644 --- a/doc/build/changelog/unreleased_14/5027.rst +++ b/doc/build/changelog/unreleased_14/5027.rst @@ -1,5 +1,5 @@ .. change:: - :tags: usecase, orm + :tags: feature, orm :tickets: 5027 Added support for direct mapping of Python classes that are defined using diff --git a/doc/build/changelog/unreleased_14/5094.rst b/doc/build/changelog/unreleased_14/5094.rst index cecdba38c9..21cd2caee4 100644 --- a/doc/build/changelog/unreleased_14/5094.rst +++ b/doc/build/changelog/unreleased_14/5094.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, platform + :tags: removed, platform :tickets: 5094 Removed all dialect code related to support for Jython and zxJDBC. Jython diff --git a/doc/build/changelog/unreleased_14/5131.rst b/doc/build/changelog/unreleased_14/5131.rst index 3243007579..9430437cac 100644 --- a/doc/build/changelog/unreleased_14/5131.rst +++ b/doc/build/changelog/unreleased_14/5131.rst @@ -1,5 +1,5 @@ .. change:: - :tags: usecase, engine + :tags: deprecated, engine :tickets: 5131 The :meth:`_engine.Connection.connect` method is deprecated as is the concept of diff --git a/doc/build/changelog/unreleased_14/5134.rst b/doc/build/changelog/unreleased_14/5134.rst index c7b0e8398e..3376d65ba8 100644 --- a/doc/build/changelog/unreleased_14/5134.rst +++ b/doc/build/changelog/unreleased_14/5134.rst @@ -1,5 +1,5 @@ .. change:: - :tags: orm, bug + :tags: orm, deprecated :tickets: 5134 Deprecated logic in :meth:`_query.Query.distinct` that automatically adds diff --git a/doc/build/changelog/unreleased_14/5159.rst b/doc/build/changelog/unreleased_14/5159.rst new file mode 100644 index 0000000000..faff0e2725 --- /dev/null +++ b/doc/build/changelog/unreleased_14/5159.rst @@ -0,0 +1,19 @@ +.. change:: + :tags: feature, orm + :tickets: 5159 + + The ORM can now generate queries previously only available when using + :class:`_orm.Query` using the :func:`_sql.select` construct directly. + A new system by which ORM "plugins" may establish themselves within a + Core :class:`_sql.Select` allow the majority of query building logic + previously inside of :class:`_orm.Query` to now take place within + a compilation-level extension for :class:`_sql.Select`. Similar changes + have been made for the :class:`_sql.Update` and :class:`_sql.Delete` + constructs as well. The constructs when invoked using :meth:`_orm.Session.execute` + now do ORM-related work within the method. For :class:`_sql.Select`, + the :class:`_engine.Result` object returned now contains ORM-level + entities and results. + + .. seealso:: + + :ref:`change_5159` \ No newline at end of file diff --git a/doc/build/changelog/unreleased_14/5189.rst b/doc/build/changelog/unreleased_14/5189.rst index 3a2c4bf8f6..11dc609ba9 100644 --- a/doc/build/changelog/unreleased_14/5189.rst +++ b/doc/build/changelog/unreleased_14/5189.rst @@ -1,10 +1,32 @@ .. change:: - :tags: dialects, deprecations + :tags: firebird, deprecated :tickets: 5189 - Deprecate unsupported dialects and dbapi - - Deprecate dialects firefis and sybase. - - Deprecate DBAPI - - adodbapi and mxODBC for mssql - - oursql for mysql - - pygresql and py-postgresql for postgresql + The Firebird dialect is deprecated, as there is now a 3rd party + dialect that supports this database. + +.. change:: + :tags: misc, deprecated + :tickets: 5189 + + The Sybase dialect is deprecated. + + +.. change:: + :tags: mssql, deprecated + :tickets: 5189 + + The adodbapi and mxODBC dialects are deprecated. + + +.. change:: + :tags: mysql, deprecated + :tickets: 5189 + + The OurSQL dialect is deprecated. + +.. change:: + :tags: postgresql, deprecated + :tickets: 5189 + + The pygresql and py-postgresql dialects are deprecated. diff --git a/doc/build/changelog/unreleased_14/5192.rst b/doc/build/changelog/unreleased_14/5192.rst index ac49c49569..f71d6026a4 100644 --- a/doc/build/changelog/unreleased_14/5192.rst +++ b/doc/build/changelog/unreleased_14/5192.rst @@ -1,5 +1,5 @@ .. change:: - :tags: orm + :tags: orm, deprecated :tickets: 5192 The :func:`.eagerload` and :func:`.relation` were old aliases and are diff --git a/doc/build/changelog/unreleased_14/5244.rst b/doc/build/changelog/unreleased_14/5244.rst index e2e97d0a2c..4ffb330174 100644 --- a/doc/build/changelog/unreleased_14/5244.rst +++ b/doc/build/changelog/unreleased_14/5244.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, reflection + :tags: renamed, engine :tickets: 5244 The :meth:`_reflection.Inspector.reflecttable` was renamed to diff --git a/doc/build/changelog/unreleased_14/5367.rst b/doc/build/changelog/unreleased_14/5367.rst index c2d6f0cbff..084e22ca3a 100644 --- a/doc/build/changelog/unreleased_14/5367.rst +++ b/doc/build/changelog/unreleased_14/5367.rst @@ -1,5 +1,5 @@ .. change:: - :tags: bug, schema + :tags: change, schema :tickets: 5367 The :paramref:`.Enum.create_constraint` and diff --git a/doc/build/changelog/unreleased_14/5380.rst b/doc/build/changelog/unreleased_14/5380.rst index d1f7e02d18..09eab78ada 100644 --- a/doc/build/changelog/unreleased_14/5380.rst +++ b/doc/build/changelog/unreleased_14/5380.rst @@ -1,5 +1,5 @@ .. change:: - :tags: feature, performance + :tags: feature, sql :tickets: 5380 Along with the new transparent statement caching feature introduced as part diff --git a/doc/build/changelog/unreleased_14/5400.rst b/doc/build/changelog/unreleased_14/5400.rst index 8583b951cf..dbf295518b 100644 --- a/doc/build/changelog/unreleased_14/5400.rst +++ b/doc/build/changelog/unreleased_14/5400.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, installation + :tags: change, platform :tickets: 5400 The ``importlib_metadata`` library is used to scan for setuptools diff --git a/doc/build/changelog/unreleased_14/5404.rst b/doc/build/changelog/unreleased_14/5404.rst index c252fea2ee..cad62bc4a1 100644 --- a/doc/build/changelog/unreleased_14/5404.rst +++ b/doc/build/changelog/unreleased_14/5404.rst @@ -1,5 +1,5 @@ .. change:: - :tags: installation + :tags: change, platform :tickets: 5404 Installation has been modernized to use setup.cfg for most package diff --git a/doc/build/changelog/unreleased_14/5413.rst b/doc/build/changelog/unreleased_14/5413.rst index 8be68eb746..d980380e54 100644 --- a/doc/build/changelog/unreleased_14/5413.rst +++ b/doc/build/changelog/unreleased_14/5413.rst @@ -1,5 +1,5 @@ .. change:: - :tags: deprecations, schema + :tags: renamed, schema :tickets: 5413 Renamed the :meth:`_schema.Table.tometadata` method to diff --git a/doc/build/changelog/unreleased_14/5429.rst b/doc/build/changelog/unreleased_14/5429.rst deleted file mode 100644 index 2ff7e2416c..0000000000 --- a/doc/build/changelog/unreleased_14/5429.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. change:: - :tags: change, sql - :tickets: 5429 - - Several operators are renamed to achieve more consistent naming across - SQLAlchemy. - - The operator changes are: - - * `isnot` is now `is_not` - * `not_in_` is now `not_in` - - Because these are core operators, the internal migration strategy for this - change is to support legacy terms for an extended period of time -- if not - indefinitely -- but update all documentation, tutorials, and internal usage - to the new terms. The new terms are used to define the functions, and - the legacy terms have been deprecated into aliases of the new terms. diff --git a/doc/build/changelog/unreleased_14/5435.rst b/doc/build/changelog/unreleased_14/5435.rst index 618926eaf9..a4950d42e5 100644 --- a/doc/build/changelog/unreleased_14/5435.rst +++ b/doc/build/changelog/unreleased_14/5435.rst @@ -1,27 +1,31 @@ .. change:: - :tags: change, sql - :tickets: 5435 + :tags: renamed, sql + :tickets: 5435, 5429 Several operators are renamed to achieve more consistent naming across SQLAlchemy. The operator changes are: - * `isfalse` is now `is_false` - * `isnot_distinct_from` is now `is_not_distinct_from` - * `istrue` is now `is_true` - * `notbetween` is now `not_between` - * `notcontains` is now `not_contains` - * `notendswith` is now `not_endswith` - * `notilike` is now `not_ilike` - * `notlike` is now `not_like` - * `notmatch` is now `not_match` - * `notstartswith` is now `not_startswith` - * `nullsfirst` is now `nulls_first` - * `nullslast` is now `nulls_last` + * ``isfalse`` is now ``is_false`` + * ``isnot_distinct_from`` is now ``is_not_distinct_from`` + * ``istrue`` is now ``is_true`` + * ``notbetween`` is now ``not_between`` + * ``notcontains`` is now ``not_contains`` + * ``notendswith`` is now ``not_endswith`` + * ``notilike`` is now ``not_ilike`` + * ``notlike`` is now ``not_like`` + * ``notmatch`` is now ``not_match`` + * ``notstartswith`` is now ``not_startswith`` + * ``nullsfirst`` is now ``nulls_first`` + * ``nullslast`` is now ``nulls_last`` + * ``isnot`` is now ``is_not`` + * ``not_in_`` is now ``not_in`` Because these are core operators, the internal migration strategy for this change is to support legacy terms for an extended period of time -- if not indefinitely -- but update all documentation, tutorials, and internal usage to the new terms. The new terms are used to define the functions, and the legacy terms have been deprecated into aliases of the new terms. + + diff --git a/doc/build/changelog/unreleased_14/5459.rst b/doc/build/changelog/unreleased_14/5459.rst index c892943442..e5c22ab665 100644 --- a/doc/build/changelog/unreleased_14/5459.rst +++ b/doc/build/changelog/unreleased_14/5459.rst @@ -1,5 +1,5 @@ .. change:: - :tags: engine, change + :tags: mysql, feature :tickets: 5459 Added support for MariaDB Connector/Python to the mysql dialect. Original diff --git a/doc/build/changelog/unreleased_14/5497.rst b/doc/build/changelog/unreleased_14/5497.rst index 0f414a3793..0cc639c5e7 100644 --- a/doc/build/changelog/unreleased_14/5497.rst +++ b/doc/build/changelog/unreleased_14/5497.rst @@ -1,5 +1,5 @@ .. change:: - :tags: engine, change + :tags: engine, bug :tickets: 5497 Adjusted the dialect initialization process such that the diff --git a/doc/build/changelog/unreleased_14/5508.rst b/doc/build/changelog/unreleased_14/5508.rst index d1304c7370..1398035d33 100644 --- a/doc/build/changelog/unreleased_14/5508.rst +++ b/doc/build/changelog/unreleased_14/5508.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, orm + :tags: feature, orm :tickets: 5508 The ORM Declarative system is now unified into the ORM itself, with new diff --git a/doc/build/changelog/unreleased_14/5526.rst b/doc/build/changelog/unreleased_14/5526.rst index 34793565f8..0d72ac4452 100644 --- a/doc/build/changelog/unreleased_14/5526.rst +++ b/doc/build/changelog/unreleased_14/5526.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, engine + :tags: deprecated, engine :tickets: 5526 The :class:`_engine.URL` object is now an immutable named tuple. To modify diff --git a/doc/build/changelog/unreleased_14/5573.rst b/doc/build/changelog/unreleased_14/5573.rst index 491dad80c8..9367c55919 100644 --- a/doc/build/changelog/unreleased_14/5573.rst +++ b/doc/build/changelog/unreleased_14/5573.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, orm + :tags: deprecated, orm :tickets: 5573 Passing keyword arguments to methods such as :meth:`_orm.Session.execute` diff --git a/doc/build/changelog/unreleased_14/5606.rst b/doc/build/changelog/unreleased_14/5606.rst index 0ce9ebd5fd..da974fb5a3 100644 --- a/doc/build/changelog/unreleased_14/5606.rst +++ b/doc/build/changelog/unreleased_14/5606.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, orm + :tags: deprecated, orm :tickets: 5606 The "slice index" feature used by :class:`_orm.Query` as well as by the diff --git a/doc/build/changelog/unreleased_14/5634.rst b/doc/build/changelog/unreleased_14/5634.rst index e37601fd21..7f4cda3161 100644 --- a/doc/build/changelog/unreleased_14/5634.rst +++ b/doc/build/changelog/unreleased_14/5634.rst @@ -1,9 +1,9 @@ .. change:: - :tags: change + :tags: removed, platform :tickets: 5634 - Dropped support for python 3.5 that has reached EOL. SQLAlchemy 1.4 series - requires python 2.7 or 3.6+. + Dropped support for python 3.4 and 3.5 that has reached EOL. SQLAlchemy 1.4 + series requires python 2.7 or 3.6+. .. seealso:: diff --git a/doc/build/changelog/unreleased_14/5649.rst b/doc/build/changelog/unreleased_14/5649.rst index 20e69c4c3d..3b5648c51b 100644 --- a/doc/build/changelog/unreleased_14/5649.rst +++ b/doc/build/changelog/unreleased_14/5649.rst @@ -1,5 +1,5 @@ .. change:: - :tags: bug, engine, pyodbc + :tags: feature, engine, pyodbc :tickets: 5649 Reworked the "setinputsizes()" set of dialect hooks to be correctly diff --git a/doc/build/changelog/unreleased_14/bind_removed_from_compiler.rst b/doc/build/changelog/unreleased_14/bind_removed_from_compiler.rst index 066baf5167..f453a7e2a5 100644 --- a/doc/build/changelog/unreleased_14/bind_removed_from_compiler.rst +++ b/doc/build/changelog/unreleased_14/bind_removed_from_compiler.rst @@ -1,8 +1,9 @@ .. change:: - :tags: change, engine + :tags: removed, sql Removed the concept of a bound engine from the :class:`.Compiler` object, - and removed the ``.execute()`` and ``.scalar()`` methods from :class:`.Compiler`. - These were essentially forgotten methods from over a decade ago and had no - practical use, and it's not appropriate for the :class:`.Compiler` object - itself to be maintaining a reference to an :class:`_engine.Engine`. + and removed the ``.execute()`` and ``.scalar()`` methods from + :class:`.Compiler`. These were essentially forgotten methods from over a + decade ago and had no practical use, and it's not appropriate for the + :class:`.Compiler` object itself to be maintaining a reference to an + :class:`_engine.Engine`. diff --git a/doc/build/changelog/unreleased_14/drop_python34.rst b/doc/build/changelog/unreleased_14/drop_python34.rst deleted file mode 100644 index 6956393138..0000000000 --- a/doc/build/changelog/unreleased_14/drop_python34.rst +++ /dev/null @@ -1,5 +0,0 @@ -.. change:: - :tags: change - - Python 3.4 has reached EOL and its support has been dropped from - SQLAlchemy. diff --git a/doc/build/changelog/unreleased_14/pg8000.rst b/doc/build/changelog/unreleased_14/pg8000.rst index 17c0a9d1c7..4dd2b8acd3 100644 --- a/doc/build/changelog/unreleased_14/pg8000.rst +++ b/doc/build/changelog/unreleased_14/pg8000.rst @@ -5,14 +5,14 @@ version of the pg8000 driver for PostgreSQL. Changes to the dialect include: - * All data types are now sent as text rather than binary. + * All data types are now sent as text rather than binary. - * Using adapters, custom types can be plugged in to pg8000. + * Using adapters, custom types can be plugged in to pg8000. - * Previously, named prepared statements were used for all statements. - Now unnamed prepared statements are used by default, and named - prepared statements can be used explicitly by calling the - Connection.prepare() method, which returns a PreparedStatement - object. + * Previously, named prepared statements were used for all statements. + Now unnamed prepared statements are used by default, and named + prepared statements can be used explicitly by calling the + Connection.prepare() method, which returns a PreparedStatement + object. Pull request courtesy Tony Locke. diff --git a/doc/build/changelog/unreleased_14/removed_depthfirst.rst b/doc/build/changelog/unreleased_14/removed_depthfirst.rst index 147b2c9d20..a06f55480c 100644 --- a/doc/build/changelog/unreleased_14/removed_depthfirst.rst +++ b/doc/build/changelog/unreleased_14/removed_depthfirst.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, sql + :tags: removed, sql Removed the ``sqlalchemy.sql.visitors.iterate_depthfirst`` and ``sqlalchemy.sql.visitors.traverse_depthfirst`` functions. These functions diff --git a/doc/build/changelog/unreleased_14/result.rst b/doc/build/changelog/unreleased_14/result.rst index 8d0004709c..ec639fedd8 100644 --- a/doc/build/changelog/unreleased_14/result.rst +++ b/doc/build/changelog/unreleased_14/result.rst @@ -1,5 +1,5 @@ .. change:: - :tags: feature, core + :tags: feature, engine :tickets: 5087, 4395, 4959 Implemented an all-new :class:`_result.Result` object that replaces the previous diff --git a/doc/build/changelog/unreleased_14/sscursor.rst b/doc/build/changelog/unreleased_14/sscursor.rst index 8f5040bce7..625db8d234 100644 --- a/doc/build/changelog/unreleased_14/sscursor.rst +++ b/doc/build/changelog/unreleased_14/sscursor.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, engine + :tags: deprecated, engine The ``server_side_cursors`` engine-wide parameter is deprecated and will be removed in a future release. For unbuffered cursors, the diff --git a/doc/build/changelog/unreleased_14/table_mustexist.rst b/doc/build/changelog/unreleased_14/table_mustexist.rst index ef8b439251..be4097abcf 100644 --- a/doc/build/changelog/unreleased_14/table_mustexist.rst +++ b/doc/build/changelog/unreleased_14/table_mustexist.rst @@ -1,5 +1,5 @@ .. change:: - :tags: change, sql + :tags: renamed, sql :class:`_schema.Table` parameter ``mustexist`` has been renamed to :paramref:`_schema.Table.must_exist` and will now warn when used. diff --git a/doc/build/changelog/unreleased_14/table_no_dupe_cols.rst b/doc/build/changelog/unreleased_14/table_no_dupe_cols.rst index 7e1e488acc..6068beeca9 100644 --- a/doc/build/changelog/unreleased_14/table_no_dupe_cols.rst +++ b/doc/build/changelog/unreleased_14/table_no_dupe_cols.rst @@ -1,6 +1,5 @@ .. change:: - :tags: change, sql - :tickets: 5526 + :tags: deprecated, sql The :class:`_schema.Table` class now raises a deprecation warning when columns with the same name are defined. To replace a column a new diff --git a/doc/build/conf.py b/doc/build/conf.py index b15d625fb8..912fb633d9 100644 --- a/doc/build/conf.py +++ b/doc/build/conf.py @@ -53,6 +53,7 @@ source_suffix = ".rst" # section names used by the changelog extension. changelog_sections = [ "general", + "platform", "orm", "orm declarative", "orm querying", @@ -60,6 +61,7 @@ changelog_sections = [ "engine", "sql", "schema", + "extensions", "postgresql", "mysql", "sqlite", @@ -70,10 +72,14 @@ changelog_sections = [ # tags to sort on inside of sections changelog_inner_tag_sort = [ "feature", - "changed", "usecase", - "removed", + "change", + "changed", + "performance", "bug", + "deprecated", + "removed", + "renamed", "moved", ]