Files
Mike Bayer 3088574414 Documentation updates for 1.4
* major additions to 1.4 migration doc; removed additional
  verbosity regarding caching methodology and reorganized the
  doc to present itself more as a "what's changed" guide

* as we now have a path for asyncio, update that doc so that
  we aren't spreading obsolete information

* updates to the 2.0 migration guide with latest info, however
  this is still an architecture doc and not a migration guide
  yet, will need further rework.

* start really talking about 1.x vs. 2.0 style everywhere.  Querying
  is most of the docs so this is going to be a prominent
  theme, start getting it to fit in

* Add introductory documentation for ORM example sections as these
  are too sparse

* new documentation for do_orm_execute(), many separate sections,
  adding deprecation notes to before_compile() and similar

* new example suites to illustrate do_orm_execute(),
  with_loader_criteria()

* modernized horizontal sharding examples and added a separate
  example to distinguish between multiple databases and single
  database w/ multiple tables use case

* introducing DEEP ALCHEMY, will use zzzeeksphinx 1.1.6

* no name for the alchemist yet however the dragon's name
  is Flambé

Change-Id: Id6b5c03b1ce9ddb7b280f66792212a0ef0a1c541
2020-08-05 22:19:46 -04:00

18 lines
555 B
Python

"""
Recipes which illustrate augmentation of ORM SELECT behavior as used by
:meth:`_orm.Session.execute` with :term:`2.0 style` use of
:func:`_sql.select`, as well as the :term:`1.x style` :class:`_orm.Query`
object.
Examples include demonstrations of the :func:`_orm.with_loader_criteria`
option as well as the :meth:`_orm.SessionEvents.do_orm_execute` hook.
As of SQLAlchemy 1.4, the :class:`_orm.Query` construct is unified
with the :class:`_expression.Select` construct, so that these two objects
are mostly the same.
.. autosource::
""" # noqa