=============
0.7 Changelog
=============


.. changelog::
    :version: 0.7.11
    :released:

    .. change::
        :tags: bug, engine
        :tickets: 2851
        :versions: 0.8.3, 0.9.0b1

      The regexp used by the :func:`~sqlalchemy.engine.url.make_url` function now parses
      ipv6 addresses, e.g. surrounded by brackets.

    .. change::
        :tags: bug, orm
        :tickets: 2807
        :versions: 0.8.3, 0.9.0b1

      Fixed bug where list instrumentation would fail to represent a
      setslice of ``[0:0]`` correctly, which in particular could occur
      when using ``insert(0, item)`` with the association proxy.  Due
      to some quirk in Python collections, the issue was much more likely
      with Python 3 rather than 2.

    .. change::
        :tags: bug, sql
        :tickets: 2801
        :versions: 0.8.3, 0.9.0b1

      Fixed regression dating back to 0.7.9 whereby the name of a CTE might
      not be properly quoted if it was referred to in multiple FROM clauses.

    .. change::
        :tags: mysql, bug
        :tickets: 2791
        :versions: 0.8.3, 0.9.0b1

      Updates to MySQL reserved words for versions 5.5, 5.6, courtesy
      Hanno Schlichting.

    .. change::
        :tags: sql, bug, cte
        :tickets: 2783
        :versions: 0.8.3, 0.9.0b1

      Fixed bug in common table expression system where if the CTE were
      used only as an ``alias()`` construct, it would not render using the
      WITH keyword.

    .. change::
        :tags: bug, sql
        :tickets: 2784
        :versions: 0.8.3, 0.9.0b1

      Fixed bug in :class:`.CheckConstraint` DDL where the "quote" flag from a
      :class:`_schema.Column` object would not be propagated.

    .. change::
        :tags: bug, orm
        :tickets: 2699
        :versions: 0.8.1

      Fixed bug when a query of the form:
      ``query(SubClass).options(subqueryload(Baseclass.attrname))``,
      where ``SubClass`` is a joined inh of ``BaseClass``,
      would fail to apply the ``JOIN`` inside the subquery
      on the attribute load, producing a cartesian product.
      The populated results still tended to be correct as additional
      rows are just ignored, so this issue may be present as a
      performance degradation in applications that are
      otherwise working correctly.

    .. change::
        :tags: bug, orm
        :tickets: 2689
        :versions: 0.8.1

      Fixed bug in unit of work whereby a joined-inheritance
      subclass could insert the row for the "sub" table
      before the parent table, if the two tables had no
      ForeignKey constraints set up between them.

    .. change::
        :tags: feature, postgresql
        :tickets: 2676
        :versions: 0.8.0

      Added support for PostgreSQL's traditional SUBSTRING
      function syntax, renders as "SUBSTRING(x FROM y FOR z)"
      when regular ``func.substring()`` is used.
      Courtesy Gunnlaugur Þór Briem.

    .. change::
        :tags: bug, tests
        :tickets: 2669
        :pullreq: 41

      Fixed an import of "logging" in test_execute which was not
      working on some linux platforms.

    .. change::
        :tags: bug, orm
        :tickets: 2674

      Improved the error message emitted when a "backref loop" is detected,
      that is when an attribute event triggers a bidirectional
      assignment between two other attributes with no end.
      This condition can occur not just when an object of the wrong
      type is assigned, but also when an attribute is mis-configured
      to backref into an existing backref pair.

    .. change::
      :tags: bug, orm
      :tickets: 2674

      A warning is emitted when a MapperProperty is assigned to a mapper
      that replaces an existing property, if the properties in question
      aren't plain column-based properties.   Replacement of relationship
      properties is rarely (ever?) what is intended and usually refers to a
      mapper mis-configuration.   This will also warn if a backref configures
      itself on top of an existing one in an inheritance relationship
      (which is an error in 0.8).

.. changelog::
    :version: 0.7.10
    :released: Thu Feb 7 2013

    .. change::
        :tags: engine, bug
        :tickets: 2604
        :versions: 0.8.0b2

      Fixed :meth:`_schema.MetaData.reflect` to correctly use
      the given :class:`_engine.Connection`, if given, without
      opening a second connection from that connection's
      :class:`_engine.Engine`.

    .. change::
        :tags: mssql, bug
        :tickets:2607
        :versions: 0.8.0b2

      Fixed bug whereby using "key" with Column
      in conjunction with "schema" for the owning
      Table would fail to locate result rows due
      to the MSSQL dialect's "schema rendering"
      logic's failure to take .key into account.

    .. change::
        :tags: sql, mysql, gae
        :tickets: 2649

        Added a conditional import to the ``gaerdbms`` dialect which attempts
        to import rdbms_apiproxy vs. rdbms_googleapi to work
        on both dev and production platforms.  Also now honors the
        ``instance`` attribute.  Courtesy Sean Lynch.  Also backported
        enhancements to allow username/password as well as
        fixing error code interpretation from 0.8.

    .. change::
        :tags: sql, bug
        :tickets: 2594, 2584

        Backported adjustment to ``__repr__`` for
        :class:`.TypeDecorator` to 0.7, allows :class:`.PickleType`
        to produce a clean ``repr()`` to help with Alembic.

    .. change::
        :tags: sql, bug
        :tickets: 2643

        Fixed bug where :meth:`_schema.Table.tometadata` would fail if a
        :class:`_schema.Column` had both a foreign key as well as an
        alternate ".key" name for the column.

    .. change::
        :tags: mssql, bug
        :tickets: 2638

      Added a Py3K conditional around unnecessary .decode()
      call in mssql information schema, fixes reflection
      in Py3k.

    .. change::
        :tags: orm, bug
        :tickets: 2650

      Fixed potential memory leak which could occur if an
      arbitrary number of :class:`.sessionmaker` objects
      were created.   The anonymous subclass created by
      the sessionmaker, when dereferenced, would not be garbage
      collected due to remaining class-level references from the
      event package.  This issue also applies to any custom system
      that made use of ad-hoc subclasses in conjunction with
      an event dispatcher.

    .. change::
        :tags: orm, bug
        :tickets: 2640

      :meth:`_query.Query.merge_result` can now load rows from an outer join
      where an entity may be ``None`` without throwing an error.

    .. change::
        :tags: sqlite, bug
        :tickets: 2568
        :versions: 0.8.0b2

      More adjustment to this SQLite related issue which was released in
      0.7.9, to intercept legacy SQLite quoting characters when reflecting
      foreign keys.  In addition to intercepting double quotes, other
      quoting characters such as brackets, backticks, and single quotes
      are now also intercepted.

    .. change::
        :tags: sql, bug
        :tickets: 2631
        :versions: 0.8.0b2

      Fixed bug where using server_onupdate=<FetchedValue|DefaultClause>
      without passing the "for_update=True" flag would apply the default
      object to the server_default, blowing away whatever was there.
      The explicit for_update=True argument shouldn't be needed with this usage
      (especially since the documentation shows an example without it being
      used) so it is now arranged internally using a copy of the given default
      object, if the flag isn't set to what corresponds to that argument.

    .. change::
        :tags: oracle, bug
        :tickets: 2620

      The Oracle LONG type, while an unbounded text type, does not appear
      to use the cx_Oracle.LOB type when result rows are returned,
      so the dialect has been repaired to exclude LONG from
      having cx_Oracle.LOB filtering applied.

    .. change::
        :tags: oracle, bug
        :tickets: 2611

      Repaired the usage of ``.prepare()`` in conjunction with
      cx_Oracle so that a return value of ``False`` will result
      in no call to ``connection.commit()``, hence avoiding
      "no transaction" errors.   Two-phase transactions have
      now been shown to work in a rudimental fashion with
      SQLAlchemy and cx_oracle, however are subject to caveats
      observed with the driver; check the documentation
      for details.

    .. change::
        :tags: orm, bug
        :tickets: 2624

      The :class:`.MutableComposite` type did not allow for the
      :meth:`.MutableBase.coerce` method to be used, even though
      the code seemed to indicate this intent, so this now works
      and a brief example is added.  As a side-effect,
      the mechanics of this event handler have been changed so that
      new :class:`.MutableComposite` types no longer add per-type
      global event handlers.  Also in 0.8.0b2.

    .. change::
        :tags: orm, bug
        :tickets: 2583

      Fixed Session accounting bug whereby replacing
      a deleted object in the identity map with another
      object of the same primary key would raise a
      "conflicting state" error on rollback(),
      if the replaced primary key were established either
      via non-unitofwork-established INSERT statement
      or by primary key switch of another instance.

    .. change::
        :tags: oracle, bug
        :tickets: 2561

      changed the list of cx_oracle types that are
      excluded from the setinputsizes() step to only include
      STRING and UNICODE; CLOB and NCLOB are removed.  This
      is to work around cx_oracle behavior which is broken
      for the executemany() call.  In 0.8, this same change
      is applied however it is also configurable via the
      exclude_setinputsizes argument.

    .. change::
        :tags: feature, mysql
        :tickets: 2523

      Added "raise_on_warnings" flag to OurSQL
      dialect.

    .. change::
        :tags: feature, mysql
        :tickets: 2554

      Added "read_timeout" flag to MySQLdb
      dialect.

.. changelog::
    :version: 0.7.9
    :released: Mon Oct 01 2012

    .. change::
        :tags: orm, bug
        :tickets:

      Fixed bug mostly local to new
      AbstractConcreteBase helper where the "type"
      attribute from the superclass would not
      be overridden on the subclass to produce the
      "reserved for base" error message, instead placing
      a do-nothing attribute there.  This was inconsistent
      vs. using ConcreteBase as well as all the behavior
      of classical concrete mappings, where the "type"
      column from the polymorphic base would be explicitly
      disabled on subclasses, unless overridden
      explicitly.

    .. change::
        :tags: orm, bug
        :tickets:

      A warning is emitted when lazy='dynamic'
      is combined with uselist=False.  This is an
      exception raise in 0.8.

    .. change::
        :tags: orm, bug
        :tickets:

      Fixed bug whereby user error in related-object
      assignment could cause recursion overflow if the
      assignment triggered a backref of the same name
      as a bi-directional attribute on the incorrect
      class to the same target.  An informative
      error is raised now.

    .. change::
        :tags: orm, bug
        :tickets: 2539

      Fixed bug where incorrect type information
      would be passed when the ORM would bind the
      "version" column, when using the "version" feature.
      Tests courtesy Daniel Miller.

    .. change::
        :tags: orm, bug
        :tickets: 2566

      Extra logic has been added to the "flush"
      that occurs within Session.commit(), such that the
      extra state added by an after_flush() or
      after_flush_postexec() hook is also flushed in a
      subsequent flush, before the "commit" completes.
      Subsequent calls to flush() will continue until
      the after_flush hooks stop adding new state.
      An "overflow" counter of 100 is also in place,
      in the event of a broken after_flush() hook
      adding new content each time.

    .. change::
        :tags: bug, sql
        :tickets: 2571

      Fixed the DropIndex construct to support
      an Index associated with a Table in a remote
      schema.

    .. change::
        :tags: bug, sql
        :tickets: 2574

      Fixed bug in over() construct whereby
      passing an empty list for either partition_by
      or order_by, as opposed to None, would fail
      to generate correctly.
      Courtesy Gunnlaugur Þór Briem.

    .. change::
        :tags: bug, sql
        :tickets: 2521

      Fixed CTE bug whereby positional
      bound parameters present in the CTEs themselves
      would corrupt the overall ordering of
      bound parameters.  This primarily
      affected SQL Server as the platform with
      positional binds + CTE support.

    .. change::
        :tags: bug, sql
        :tickets:

      Fixed more un-intuitivenesses in CTEs
      which prevented referring to a CTE in a union
      of itself without it being aliased.
      CTEs now render uniquely
      on name, rendering the outermost CTE of a given
      name only - all other references are rendered
      just as the name.   This even includes other
      CTE/SELECTs that refer to different versions
      of the same CTE object, such as a SELECT
      or a UNION ALL of that SELECT. We are
      somewhat loosening the usual link between object
      identity and lexical identity in this case.
      A true name conflict between two unrelated
      CTEs now raises an error.

    .. change::
        :tags: bug, sql
        :tickets: 2512

      quoting is applied to the column names
      inside the WITH RECURSIVE clause of a
      common table expression according to the
      quoting rules for the originating Column.

    .. change::
        :tags: bug, sql
        :tickets: 2518

      Fixed regression introduced in 0.7.6
      whereby the FROM list of a SELECT statement
      could be incorrect in certain "clone+replace"
      scenarios.

    .. change::
        :tags: bug, sql
        :tickets: 2552

      Fixed bug whereby usage of a UNION
      or similar inside of an embedded subquery
      would interfere with result-column targeting,
      in the case that a result-column had the same
      ultimate name as a name inside the embedded
      UNION.

    .. change::
        :tags: bug, sql
        :tickets: 2558

      Fixed a regression since 0.6 regarding
      result-row targeting.   It should be possible
      to use a select() statement with string
      based columns in it, that is
      select(['id', 'name']).select_from('mytable'),
      and have this statement be targetable by
      Column objects with those names; this is the
      mechanism by which
      query(MyClass).from_statement(some_statement)
      works.  At some point the specific case of
      using select(['id']), which is equivalent to
      select([literal_column('id')]), stopped working
      here, so this has been re-instated and of
      course tested.

    .. change::
        :tags: bug, sql
        :tickets: 2544

      Added missing operators is_(), isnot()
      to the ColumnOperators base, so that these long-available
      operators are present as methods like all
      the other operators.

    .. change::
        :tags: engine, bug
        :tickets: 2522

      Fixed bug whereby
      a disconnect detect + dispose that occurs
      when the QueuePool has threads waiting
      for connections would leave those
      threads waiting for the duration of
      the timeout on the old pool (or indefinitely
      if timeout was disabled).  The fix
      now notifies those waiters with a special
      exception case and has them move onto
      the new pool.

    .. change::
        :tags: engine, feature
        :tickets: 2516

      Dramatic improvement in memory
      usage of the event system; instance-level
      collections are no longer created for a
      particular type of event until
      instance-level listeners are established
      for that event.

    .. change::
        :tags: engine, bug
        :tickets: 2529

      Added gaerdbms import to mysql/__init__.py,
      the absence of which was preventing the new
      GAE dialect from being loaded.

    .. change::
        :tags: engine, bug
        :tickets: 2553

      Fixed cextension bug whereby the
      "ambiguous column error" would fail to
      function properly if the given index were
      a Column object and not a string.
      Note there are still some column-targeting
      issues here which are fixed in 0.8.

    .. change::
        :tags: engine, bug
        :tickets:

      Fixed the repr() of Enum to include
      the "name" and "native_enum" flags.  Helps
      Alembic autogenerate.

    .. change::
        :tags: sqlite, bug
        :tickets: 2568

      Adjusted a very old bugfix which attempted
      to work around a SQLite issue that itself was
      "fixed" as of sqlite 3.6.14, regarding quotes
      surrounding a table name when using
      the "foreign_key_list" pragma.  The fix has been
      adjusted to not interfere with quotes that
      are *actually in the name* of a column or table,
      to as much a degree as possible; sqlite still
      doesn't return the correct result for foreign_key_list()
      if the target table actually has quotes surrounding
      its name, as *part* of its name (i.e. """mytable""").

    .. change::
        :tags: sqlite, bug
        :tickets: 2265

      Adjusted column default reflection code to
      convert non-string values to string, to accommodate
      old SQLite versions that don't deliver
      default info as a string.

    .. change::
        :tags: sqlite, feature
        :tickets:

      Added support for the localtimestamp()
      SQL function implemented in SQLite, courtesy
      Richard Mitchell.

    .. change::
        :tags: postgresql, bug
        :tickets: 2531

      Columns in reflected primary key constraint
      are now returned in the order in which the constraint
      itself defines them, rather than how the table
      orders them.  Courtesy Gunnlaugur Þór Briem..

    .. change::
        :tags: postgresql, bug
        :tickets: 2570

      Added 'terminating connection' to the list
      of messages we use to detect a disconnect with PG, which
      appears to be present in some versions when the server
      is restarted.

    .. change::
        :tags: bug, mysql
        :tickets:

      Updated mysqlconnector interface to use
      updated "client flag" and "charset" APIs,
      courtesy David McNelis.

    .. change::
        :tags: mssql, bug
        :tickets: 2538

      Fixed compiler bug whereby using a correlated
      subquery within an ORDER BY would fail to render correctly
      if the statement also used LIMIT/OFFSET, due to mis-rendering
      within the ROW_NUMBER() OVER clause.  Fix courtesy
      sayap

    .. change::
        :tags: mssql, bug
        :tickets: 2545

      Fixed compiler bug whereby a given
      select() would be modified if it had an "offset"
      attribute, causing the construct to not compile
      correctly a second time.

    .. change::
        :tags: mssql, bug
        :tickets:

      Fixed bug where reflection of primary key constraint
      would double up columns if the same constraint/table
      existed in multiple schemas.

.. changelog::
    :version: 0.7.8
    :released: Sat Jun 16 2012

    .. change::
        :tags: orm, bug
        :tickets: 2480

      Fixed bug whereby subqueryload() from
      a polymorphic mapping to a target would incur
      a new invocation of the query for each
      distinct class encountered in the polymorphic
      result.

    .. change::
        :tags: orm, bug
        :tickets: 2491, 1892

      Fixed bug in declarative
      whereby the precedence of columns
      in a joined-table, composite
      column (typically for id) would fail to
      be correct if the columns contained
      names distinct from their attribute
      names.  This would cause things like
      primaryjoin conditions made against the
      entity attributes to be incorrect.  Related
      to as this was supposed
      to be part of that, this is.

    .. change::
        :tags: orm, feature
        :tickets:

      The 'objects' argument to
      flush() is no longer deprecated, as some
      valid use cases have been identified.

    .. change::
        :tags: orm, bug
        :tickets: 2508

      Fixed identity_key() function which
      was not accepting a scalar argument
      for the identity. .

    .. change::
        :tags: orm, bug
        :tickets: 2497

      Fixed bug whereby populate_existing
      option would not propagate to subquery
      eager loaders. .

    .. change::
        :tags: bug, sql
        :tickets: 2499

      added BIGINT to types.__all__,
      BIGINT, BINARY, VARBINARY to sqlalchemy
      module namespace, plus test to ensure
      this breakage doesn't occur again.

    .. change::
        :tags: bug, sql
        :tickets: 2490

      Repaired common table expression
      rendering to function correctly when the
      SELECT statement contains UNION or other
      compound expressions, courtesy btbuilder.

    .. change::
        :tags: bug, sql
        :tickets: 2482

      Fixed bug whereby append_column()
      wouldn't function correctly on a cloned
      select() construct, courtesy
      Gunnlaugur Þór Briem.

    .. change::
        :tags: engine, bug
        :tickets: 2489

      Fixed memory leak in C version of
      result proxy whereby DBAPIs which don't deliver
      pure Python tuples for result rows would
      fail to decrement refcounts correctly.
      The most prominently affected DBAPI
      is pyodbc.

    .. change::
        :tags: engine, bug
        :tickets: 2503

      Fixed bug affecting Py3K whereby
      string positional parameters passed to
      engine/connection execute() would fail to be
      interpreted correctly, due to __iter__
      being present on Py3K string..

    .. change::
        :tags: postgresql, bug
        :tickets: 2510

      removed unnecessary table clause when
      reflecting enums,.  Courtesy
      Gunnlaugur Þór Briem.

    .. change::
        :tags: oracle, bug
        :tickets: 2483

      Added ROWID to oracle.*.

    .. change::
        :tags: feature, mysql
        :tickets: 2484

      Added a new dialect for Google App
      Engine.  Courtesy Richie Foreman.

.. changelog::
    :version: 0.7.7
    :released: Sat May 05 2012

    .. change::
        :tags: orm, bug
        :tickets: 2477

      Fixed issue in unit of work
      whereby setting a non-None self-referential
      many-to-one relationship to None
      would fail to persist the change if the
      former value was not already loaded..

    .. change::
        :tags: orm, feature
        :tickets: 2443

      Added prefix_with() method
      to Query, calls upon select().prefix_with()
      to allow placement of MySQL SELECT
      directives in statements.  Courtesy
      Diana Clarke

    .. change::
        :tags: orm, bug
        :tickets: 2409

      Fixed bug in 0.7.6 introduced by whereby column_mapped_collection
      used against columns that were mapped as
      joins or other indirect selectables
      would fail to function.

    .. change::
        :tags: orm, feature
        :tickets:

      Added new flag to @validates
      include_removes.  When True, collection
      remove and attribute del events
      will also be sent to the validation function,
      which accepts an additional argument
      "is_remove" when this flag is used.

    .. change::
        :tags: orm, bug
        :tickets: 2449

      Fixed bug whereby polymorphic_on
      column that's not otherwise mapped on the
      class would be incorrectly included
      in a merge() operation, raising an error.

    .. change::
        :tags: orm, bug
        :tickets: 2453

      Fixed bug in expression annotation
      mechanics which could lead to incorrect
      rendering of SELECT statements with aliases
      and joins, particularly when using
      column_property().

    .. change::
        :tags: orm, bug
        :tickets: 2454

      Fixed bug which would prevent
      OrderingList from being pickleable.  Courtesy Jeff Dairiki

    .. change::
        :tags: orm, bug
        :tickets:

      Fixed bug in relationship comparisons
      whereby calling unimplemented methods like
      SomeClass.somerelationship.like() would
      produce a recursion overflow, instead
      of NotImplementedError.

    .. change::
        :tags: bug, sql
        :tickets:

      Removed warning when Index is created
      with no columns; while this might not be what
      the user intended, it is a valid use case
      as an Index could be a placeholder for just an
      index of a certain name.

    .. change::
        :tags: feature, sql
        :tickets:

      Added new connection event
      dbapi_error(). Is called for all DBAPI-level
      errors passing the original DBAPI exception
      before SQLAlchemy modifies the state
      of the cursor.

    .. change::
        :tags: bug, sql
        :tickets:

      If conn.begin() fails when calling
      "with engine.begin()", the newly acquired
      Connection is closed explicitly before
      propagating the exception onward normally.

    .. change::
        :tags: bug, sql
        :tickets: 2474

      Add BINARY, VARBINARY to types.__all__.

    .. change::
        :tags: mssql, feature
        :tickets:

      Added interim create_engine flag
      supports_unicode_binds to PyODBC dialect,
      to force whether or not the dialect
      passes Python unicode literals to PyODBC
      or not.

    .. change::
        :tags: mssql, bug
        :tickets:

      Repaired the use_scope_identity
      create_engine() flag when using the pyodbc
      dialect.  Previously this flag would be
      ignored if set to False.  When set to False,
      you'll get "SELECT @@identity" after each
      INSERT to get at the last inserted ID,
      for those tables which have "implicit_returning"
      set to False.

    .. change::
        :tags: mssql, bug
        :tickets: 2468

      UPDATE..FROM syntax with SQL Server
      requires that the updated table be present
      in the FROM clause when an alias of that
      table is also present in the FROM clause.
      The updated table is now always present
      in the FROM, when FROM is present
      in the first place.  Courtesy sayap.

    .. change::
        :tags: postgresql, feature
        :tickets: 2445

      Added new for_update/with_lockmode()
      options for PostgreSQL: for_update="read"/
      with_lockmode("read"),
      for_update="read_nowait"/
      with_lockmode("read_nowait").
      These emit "FOR SHARE" and "FOR SHARE NOWAIT",
      respectively.  Courtesy Diana Clarke

    .. change::
        :tags: postgresql, bug
        :tickets: 2473

      removed unnecessary table clause
      when reflecting domains.

    .. change::
        :tags: bug, mysql
        :tickets: 2460

      Fixed bug whereby column name inside
      of "KEY" clause for autoincrement composite
      column with InnoDB would double quote a
      name that's a reserved word.  Courtesy Jeff
      Dairiki.

    .. change::
        :tags: bug, mysql
        :tickets:

      Fixed bug whereby get_view_names() for
      "information_schema" schema would fail
      to retrieve views marked as "SYSTEM VIEW".
      courtesy Matthew Turland.

    .. change::
        :tags: bug, mysql
        :tickets: 2467

      Fixed bug whereby if cast() is used
      on a SQL expression whose type is not supported
      by cast() and therefore CAST isn't rendered by
      the dialect, the order of evaluation could change
      if the casted expression required that it be
      grouped; grouping is now applied to those
      expressions.

    .. change::
        :tags: sqlite, feature
        :tickets: 2475

      Added SQLite execution option
      "sqlite_raw_colnames=True", will bypass
      attempts to remove "." from column names
      returned by SQLite cursor.description.

    .. change::
        :tags: sqlite, bug
        :tickets: 2525

      When the primary key column of a Table
      is replaced, such as via extend_existing,
      the "auto increment" column used by insert()
      constructs is reset.  Previously it would
      remain referring to the previous primary
      key column.

.. changelog::
    :version: 0.7.6
    :released: Wed Mar 14 2012

    .. change::
        :tags: orm, bug
        :tickets: 2424

      Fixed event registration bug
      which would primarily show up as
      events not being registered with
      sessionmaker() instances created
      after the event was associated
      with the Session class.

    .. change::
        :tags: orm, bug
        :tickets: 2425

      Fixed bug whereby a primaryjoin
      condition with a "literal" in it would
      raise an error on compile with certain
      kinds of deeply nested expressions
      which also needed to render the same
      bound parameter name more than once.

    .. change::
        :tags: orm, feature
        :tickets:

      Added "no_autoflush" context
      manager to Session, used with with:
      will temporarily disable autoflush.

    .. change::
        :tags: orm, feature
        :tickets: 1859

      Added cte() method to Query,
      invokes common table expression support
      from the Core (see below).

    .. change::
        :tags: orm, bug
        :tickets: 2403

      Removed the check for number of
      rows affected when doing a multi-delete
      against mapped objects.   If an ON DELETE
      CASCADE exists between two rows, we can't
      get an accurate rowcount from the DBAPI;
      this particular count is not supported
      on most DBAPIs in any case, MySQLdb
      is the notable case where it is.

    .. change::
        :tags: orm, bug
        :tickets: 2409

      Fixed bug whereby objects using
      attribute_mapped_collection or
      column_mapped_collection could not be
      pickled.

    .. change::
        :tags: orm, bug
        :tickets: 2406

      Fixed bug whereby MappedCollection
      would not get the appropriate collection
      instrumentation if it were only used
      in a custom subclass that used
      @collection.internally_instrumented.

    .. change::
        :tags: orm, bug
        :tickets: 2419

      Fixed bug whereby SQL adaption mechanics
      would fail in a very nested scenario involving
      joined-inheritance, joinedload(), limit(), and a
      derived function in the columns clause.

    .. change::
        :tags: orm, bug
        :tickets: 2417

      Fixed the repr() for CascadeOptions to
      include refresh-expire.  Also reworked
      CascadeOptions to be a <frozenset>.

    .. change::
        :tags: orm, feature
        :tickets: 2400

      Added the ability to query for
      Table-bound column names when using
      query(sometable).filter_by(colname=value).

    .. change::
        :tags: orm, bug
        :tickets:

      Improved the "declarative reflection"
      example to support single-table inheritance,
      multiple calls to prepare(), tables that
      are present in alternate schemas,
      establishing only a subset of classes
      as reflected.

    .. change::
        :tags: orm, bug
        :tickets: 2390

      Scaled back the test applied within
      flush() to check for UPDATE against partially
      NULL PK within one table to only actually
      happen if there's really an UPDATE to occur.

    .. change::
        :tags: orm, bug
        :tickets: 2352

      Fixed bug whereby if a method name
      conflicted with a column name, a
      TypeError would be raised when the mapper
      tried to inspect the __get__() method
      on the method object.

    .. change::
        :tags: bug, sql
        :tickets: 2427

      Fixed memory leak in core which would
      occur when C extensions were used with
      particular types of result fetches,
      in particular when orm query.count()
      were called.

    .. change::
        :tags: bug, sql
        :tickets: 2398

      Fixed issue whereby attribute-based
      column access on a row would raise
      AttributeError with non-C version,
      NoSuchColumnError with C version.  Now
      raises AttributeError in both cases.

    .. change::
        :tags: feature, sql
        :tickets: 1859

      Added support for SQL standard
      common table expressions (CTE), allowing
      SELECT objects as the CTE source (DML
      not yet supported).  This is invoked via
      the cte() method on any select() construct.

    .. change::
        :tags: bug, sql
        :tickets: 2392

      Added support for using the .key
      of a Column as a string identifier in a
      result set row.   The .key is currently
      listed as an "alternate" name for a column,
      and is superseded by the name of a column
      which has that key value as its regular name.
      For the next major release
      of SQLAlchemy we may reverse this precedence
      so that .key takes precedence, but this
      is not decided on yet.

    .. change::
        :tags: bug, sql
        :tickets: 2413

      A warning is emitted when a not-present
      column is stated in the values() clause
      of an insert() or update() construct.
      Will move to an exception in 0.8.

    .. change::
        :tags: bug, sql
        :tickets: 2396

      A significant change to how labeling
      is applied to columns in SELECT statements
      allows "truncated" labels, that is label names
      that are generated in Python which exceed
      the maximum identifier length (note this is
      configurable via label_length on create_engine()),
      to be properly referenced when rendered inside
      of a subquery, as well as to be present
      in a result set row using their original
      in-Python names.

    .. change::
        :tags: bug, sql
        :tickets: 2402

      Fixed bug in new "autoload_replace" flag
      which would fail to preserve the primary
      key constraint of the reflected table.

    .. change::
        :tags: bug, sql
        :tickets: 2380

      Index will raise when arguments passed
      cannot be interpreted as columns or expressions.
      Will warn when Index is created
      with no columns at all.

    .. change::
        :tags: engine, feature
        :tickets: 2407

      Added "no_parameters=True" execution
      option for connections.   If no parameters
      are present, will pass the statement
      as cursor.execute(statement), thereby invoking
      the DBAPIs behavior when no parameter collection
      is present; for psycopg2 and mysql-python, this
      means not interpreting % signs in the string.
      This only occurs with this option, and not
      just if the param list is blank, as otherwise
      this would produce inconsistent behavior
      of SQL expressions that normally escape percent
      signs (and while compiling, can't know ahead of
      time if parameters will be present in
      some cases).

    .. change::
        :tags: engine, bug
        :tickets:

      Added execution_options() call to
      MockConnection (i.e., that used with
      strategy="mock") which acts as a pass through
      for arguments.

    .. change::
        :tags: engine, feature
        :tickets: 2378

      Added pool_reset_on_return argument
      to create_engine, allows control over
      "connection return" behavior.  Also added
      new arguments 'rollback', 'commit', None
      to pool.reset_on_return to allow more control
      over connection return activity.

    .. change::
        :tags: engine, feature
        :tickets:

      Added some decent context managers
      to Engine, Connection::

          with engine.begin() as conn:
              # <work with conn in a transaction>
              ...

      and::

          with engine.connect() as conn:
              # <work with conn>
              ...

      Both close out the connection when done,
      commit or rollback transaction with errors
      on engine.begin().

    .. change::
        :tags: sqlite, bug
        :tickets: 2432

      Fixed bug in C extensions whereby
      string format would not be applied to a
      Numeric value returned as integer; this
      affected primarily SQLite which does
      not maintain numeric scale settings.

    .. change::
        :tags: mssql, feature
        :tickets: 2430

      Added support for MSSQL INSERT,
      UPDATE, and DELETE table hints, using
      new with_hint() method on UpdateBase.

    .. change::
        :tags: feature, mysql
        :tickets: 2386

      Added support for MySQL index and
      primary key constraint types
      (i.e. USING) via new mysql_using parameter
      to Index and PrimaryKeyConstraint,
      courtesy Diana Clarke.

    .. change::
        :tags: feature, mysql
        :tickets: 2394

      Added support for the "isolation_level"
      parameter to all MySQL dialects.  Thanks
      to mu_mind for the patch here.

    .. change::
        :tags: oracle, feature
        :tickets: 2399

      Added a new create_engine() flag
      coerce_to_decimal=False, disables the precision
      numeric handling which can add lots of overhead
      by converting all numeric values to
      Decimal.

    .. change::
        :tags: oracle, bug
        :tickets: 2401

      Added missing compilation support for
      LONG

    .. change::
        :tags: oracle, bug
        :tickets: 2435

      Added 'LEVEL' to the list of reserved
      words for Oracle.

    .. change::
        :tags: examples, bug
        :tickets:

      Altered _params_from_query() function
      in Beaker example to pull bindparams from the
      fully compiled statement, as a quick means
      to get everything including subqueries in the
      columns clause, etc.

.. changelog::
    :version: 0.7.5
    :released: Sat Jan 28 2012

    .. change::
        :tags: orm, bug
        :tickets: 2389

      Fixed issue where modified session state
      established after a failed flush would be committed
      as part of the subsequent transaction that
      begins automatically after manual call
      to rollback().   The state of the session is
      checked within rollback(), and if new state
      is present, a warning is emitted and
      restore_snapshot() is called a second time,
      discarding those changes.

    .. change::
        :tags: orm, bug
        :tickets: 2345

      Fixed regression from 0.7.4 whereby
      using an already instrumented column from a
      superclass as "polymorphic_on" failed to resolve
      the underlying Column.

    .. change::
        :tags: orm, bug
        :tickets: 2370

      Raise an exception if xyzload_all() is
      used inappropriately with two non-connected
      relationships.

    .. change::
        :tags: orm, feature
        :tickets:

      Added "class_registry" argument to
      declarative_base().  Allows two or more declarative
      bases to share the same registry of class names.

    .. change::
        :tags: orm, feature
        :tickets:

      query.filter() accepts multiple
      criteria which will join via AND, i.e.
      query.filter(x==y, z>q, ...)

    .. change::
        :tags: orm, feature
        :tickets: 2351

      Added new capability to relationship
      loader options to allow "default" loader strategies.
      Pass '*' to any of joinedload(), lazyload(),
      subqueryload(), or noload() and that becomes the
      loader strategy used for all relationships,
      except for those explicitly stated in the
      Query.  Thanks to up-and-coming contributor
      Kent Bower for an exhaustive and well
      written test suite !

    .. change::
        :tags: orm, bug
        :tickets: 2367

      Fixed bug whereby event.listen(SomeClass)
      forced an entirely unnecessary compile of the
      mapper, making events very hard to set up
      at module import time (nobody noticed this ??)

    .. change::
        :tags: orm, bug
        :tickets:

      Fixed bug whereby hybrid_property didn't
      work as a kw arg in any(), has().

    .. change::
        :tags: orm
        :tickets:

      Fixed regression from 0.6 whereby if
      "load_on_pending" relationship() flag were used
      where a non-"get()" lazy clause needed to be
      emitted on a pending object, it would fail
      to load.

    .. change::
        :tags: orm, bug
        :tickets: 2371

      ensure pickleability of all ORM exceptions
      for multiprocessing compatibility.

    .. change::
        :tags: orm, bug
        :tickets: 2353

      implemented standard "can't set attribute" /
      "can't delete attribute" AttributeError when
      setattr/delattr used on a hybrid that doesn't
      define fset or fdel.

    .. change::
        :tags: orm, bug
        :tickets: 2362

      Fixed bug where unpickled object didn't
      have enough of its state set up to work
      correctly within the unpickle() event established
      by the mutable object extension, if the object
      needed ORM attribute access within
      __eq__() or similar.

    .. change::
        :tags: orm, bug
        :tickets: 2374

      Fixed bug where "merge" cascade could
      mis-interpret an unloaded attribute, if the
      load_on_pending flag were used with
      relationship().  Thanks to Kent Bower
      for tests.

    .. change::
        :tags: orm, feature
        :tickets: 2356

      New declarative reflection example
      added, illustrates how best to mix table reflection
      with declarative as well as uses some new features
      from.

    .. change::
        :tags: feature, sql
        :tickets: 2356

      New reflection feature "autoload_replace";
      when set to False on Table, the Table can be autoloaded
      without existing columns being replaced.  Allows
      more flexible chains of Table construction/reflection
      to be constructed, including that it helps with
      combining Declarative with table reflection.
      See the new example on the wiki.

    .. change::
        :tags: bug, sql
        :tickets: 2356

      Improved the API for add_column() such that
      if the same column is added to its own table,
      an error is not raised and the constraints
      don't get doubled up.  Also helps with some
      reflection/declarative patterns.

    .. change::
        :tags: feature, sql
        :tickets:

      Added "false()" and "true()" expression
      constructs to sqlalchemy.sql namespace, though
      not part of __all__ as of yet.

    .. change::
        :tags: feature, sql
        :tickets: 2361

      Dialect-specific compilers now raise
      CompileError for all type/statement compilation
      issues, instead of InvalidRequestError or ArgumentError.
      The DDL for CREATE TABLE will re-raise
      CompileError to include table/column information
      for the problematic column.

    .. change::
        :tags: bug, sql
        :tickets: 2381

      Fixed issue where the "required" exception
      would not be raised for bindparam() with required=True,
      if the statement were given no parameters at all.

    .. change::
        :tags: engine, bug
        :tickets: 2371

      Added __reduce__ to StatementError,
      DBAPIError, column errors so that exceptions
      are pickleable, as when using multiprocessing.
      However, not
      all DBAPIs support this yet, such as
      psycopg2.

    .. change::
        :tags: engine, bug
        :tickets: 2382

      Improved error messages when a non-string
      or invalid string is passed to any of the
      date/time processors used by SQLite, including
      C and Python versions.

    .. change::
        :tags: engine, bug
        :tickets: 2377

      Fixed bug whereby a table-bound Column
      object named "<a>_<b>" which matched a column
      labeled as "<tablename>_<colname>" could match
      inappropriately when targeting in a result
      set row.

    .. change::
        :tags: engine, bug
        :tickets: 2384

      Fixed bug in "mock" strategy whereby
      correct DDL visit method wasn't called, resulting
      in "CREATE/DROP SEQUENCE" statements being
      duplicated

    .. change::
        :tags: sqlite, bug
        :tickets: 2364

      the "name" of an FK constraint in SQLite
      is reflected as "None", not "0" or other
      integer value.
      SQLite does not appear to support constraint
      naming in any case.

    .. change::
        :tags: sqlite, bug
        :tickets: 2368

      sql.false() and sql.true() compile to
      0 and 1, respectively in sqlite

    .. change::
        :tags: sqlite, bug
        :tickets:

      removed an erroneous "raise" in the
      SQLite dialect when getting table names
      and view names, where logic is in place
      to fall back to an older version of
      SQLite that doesn't have the
      "sqlite_temp_master" table.

    .. change::
        :tags: bug, mysql
        :tickets: 2376

      fixed regexp that filters out warnings
      for non-reflected "PARTITION" directives,
      thanks to George Reilly

    .. change::
        :tags: mssql, bug
        :tickets: 2340

      Adjusted the regexp used in the
      mssql.TIME type to ensure only six digits
      are received for the "microseconds" portion
      of the value, which is expected by
      Python's datetime.time().  Note that
      support for sending microseconds doesn't
      seem to be possible yet with pyodbc
      at least.

    .. change::
        :tags: mssql, bug
        :tickets: 2347

      Dropped the "30 char" limit on pymssql,
      based on reports that it's doing things
      better these days.  pymssql hasn't been
      well tested and as the DBAPI is in flux
      it's still not clear what the status
      is on this driver and how SQLAlchemy's
      implementation should adapt.

    .. change::
        :tags: oracle, bug
        :tickets: 2388

      Added ORA-03135 to the never ending
      list of oracle "connection lost" errors

    .. change::
        :tags: core, bug
        :tickets: 2379

      Changed LRUCache, used by the mapper
      to cache INSERT/UPDATE/DELETE statements,
      to use an incrementing counter instead
      of a timestamp to track entries, for greater
      reliability versus using time.time(), which
      can cause test failures on some platforms.

    .. change::
        :tags: core, bug
        :tickets: 2383

      Added a boolean check for the "finalize"
      function within the pool connection proxy's
      weakref callback before calling it, so that a
      warning isn't emitted that this function is None
      when the application is exiting and gc has
      removed the function from the module before the
      weakref callback was invoked.

    .. change::
        :tags: bug, py3k
        :tickets: 2348

      Fixed inappropriate usage of util.py3k
      flag and renamed it to util.py3k_warning, since
      this flag is intended to detect the -3 flag
      series of import restrictions only.

    .. change::
        :tags: examples, feature
        :tickets: 2313

      Simplified the versioning example
      a bit to use a declarative mixin as well
      as an event listener, instead of a metaclass +
      SessionExtension.

    .. change::
        :tags: examples, bug
        :tickets: 2346

      Fixed large_collection.py to close the
      session before dropping tables.

.. changelog::
    :version: 0.7.4
    :released: Fri Dec 09 2011

    .. change::
        :tags: orm, bug
        :tickets: 2315

      Fixed backref behavior when "popping" the
      value off of a many-to-one in response to
      a removal from a stale one-to-many - the operation
      is skipped, since the many-to-one has since
      been updated.

    .. change::
        :tags: orm, bug
        :tickets: 2264

      After some years of not doing this, added
      more granularity to the "is X a parent of Y"
      functionality, which is used when determining
      if the FK on "Y" needs to be "nulled out" as well
      as if "Y" should be deleted with delete-orphan
      cascade.   The test now takes into account the
      Python identity of the parent as well its identity
      key, to see if the last known parent of Y is
      definitely X.   If a decision
      can't be made, a StaleDataError is raised.  The
      conditions where this error is raised are fairly
      rare, requiring that the previous parent was
      garbage collected, and previously
      could very well inappropriately update/delete
      a record that's since moved onto a new parent,
      though there may be some cases where
      "silent success" occurred previously that will now
      raise in the face of ambiguity.
      Expiring "Y" resets the "parent" tracker, meaning
      X.remove(Y) could then end up deleting Y even
      if X is stale, but this is the same behavior
      as before; it's advised to expire X also in that
      case.

    .. change::
        :tags: orm, bug
        :tickets: 2310

      fixed inappropriate evaluation of user-mapped
      object in a boolean context within query.get().  Also in 0.6.9.

    .. change::
        :tags: orm, bug
        :tickets: 2304

      Added missing comma to PASSIVE_RETURN_NEVER_SET
      symbol

    .. change::
        :tags: orm, bug
        :tickets: 1776

      Cls.column.collate("some collation") now
      works.   Also in 0.6.9

    .. change::
        :tags: orm, bug
        :tickets: 2309

      the value of a composite attribute is now
      expired after an insert or update operation, instead
      of regenerated in place.  This ensures that a
      column value which is expired within a flush
      will be loaded first, before the composite
      is regenerated using that value.

    .. change::
        :tags: orm, bug
        :tickets: 2309, 2308

      The fix in also emits the
      "refresh" event when the composite value is
      loaded on access, even if all column
      values were already present, as is appropriate.
      This fixes the "mutable" extension which relies
      upon the "load" event to ensure the _parents
      dictionary is up to date, fixes.
      Thanks to Scott Torborg for the test case here.

    .. change::
        :tags: orm, bug
        :tickets: 2312

      Fixed bug whereby a subclass of a subclass
      using concrete inheritance in conjunction with
      the new ConcreteBase or AbstractConcreteBase
      would fail to apply the subclasses deeper than
      one level to the "polymorphic loader" of each
      base

    .. change::
        :tags: orm, bug
        :tickets: 2312

      Fixed bug whereby a subclass of a subclass
      using the new AbstractConcreteBase would fail
      to acquire the correct "base_mapper" attribute
      when the "base" mapper was generated, thereby
      causing failures later on.

    .. change::
        :tags: orm, bug
        :tickets: 2316

      Fixed bug whereby column_property() created
      against ORM-level column could be treated as
      a distinct entity when producing certain
      kinds of joined-inh joins.

    .. change::
        :tags: orm, bug
        :tickets: 2297

      Fixed the error formatting raised when
      a tuple is inadvertently passed to session.query().  Also in 0.6.9.

    .. change::
        :tags: orm, bug
        :tickets: 2328

      Calls to query.join() to a single-table
      inheritance subclass are now tracked, and
      are used to eliminate the additional WHERE..
      IN criterion normally tacked on with single
      table inheritance, since the join should
      accommodate it.  This allows OUTER JOIN
      to a single table subclass to produce
      the correct results, and overall will produce
      fewer WHERE criterion when dealing with
      single table inheritance joins.

    .. change::
        :tags: orm, bug
        :tickets: 2339

      __table_args__ can now be passed as
      an empty tuple as well as an empty dict..  Thanks to Fayaz Yusuf Khan
      for the patch.

    .. change::
        :tags: orm, bug
        :tickets: 2325

      Updated warning message when setting
      delete-orphan without delete to no longer
      refer to 0.6, as we never got around to
      upgrading this to an exception.  Ideally
      this might be better as an exception but
      it's not critical either way.

    .. change::
        :tags: orm, feature
        :tickets: 2345, 2238

      polymorphic_on now accepts many
      new kinds of values:

        * standalone expressions that aren't
          otherwise mapped
        * column_property() objects
        * string names of any column_property()
          or attribute name of a mapped Column

      The docs include an example using
      the case() construct, which is likely to be
      a common constructed used here. and part of

      Standalone expressions in polymorphic_on
      propagate to single-table inheritance
      subclasses so that they are used in the
      WHERE /JOIN clause to limit rows to that
      subclass as is the usual behavior.

    .. change::
        :tags: orm, feature
        :tickets: 2301

      IdentitySet supports the - operator
      as the same as difference(), handy when dealing
      with Session.dirty etc.

    .. change::
        :tags: orm, feature
        :tickets:

      Added new value for Column autoincrement
      called "ignore_fk", can be used to force autoincrement
      on a column that's still part of a ForeignKeyConstraint.
      New example in the relationship docs illustrates
      its use.

    .. change::
        :tags: orm, bug
        :tickets:

      Fixed bug in get_history() when referring
      to a composite attribute that has no value;
      added coverage for get_history() regarding
      composites which is otherwise just a userland
      function.

    .. change::
        :tags: bug, sql
        :tickets: 2316, 2261

      related to, made some
      adjustments to the change from
      regarding the "from" list on a select(). The
      _froms collection is no longer memoized, as this
      simplifies various use cases and removes the
      need for a "warning" if a column is attached
      to a table after it was already used in an
      expression - the select() construct will now
      always produce the correct expression.
      There's probably no real-world
      performance hit here; select() objects are
      almost always made ad-hoc, and systems that
      wish to optimize the reuse of a select()
      would be using the "compiled_cache" feature.
      A hit which would occur when calling select.bind
      has been reduced, but the vast majority
      of users shouldn't be using "bound metadata"
      anyway :).

    .. change::
        :tags: feature, sql
        :tickets: 2166, 1944

      The update() construct can now accommodate
      multiple tables in the WHERE clause, which will
      render an "UPDATE..FROM" construct, recognized by
      PostgreSQL and MSSQL.  When compiled on MySQL,
      will instead generate "UPDATE t1, t2, ..".  MySQL
      additionally can render against multiple tables in the
      SET clause, if Column objects are used as keys
      in the "values" parameter or generative method.

    .. change::
        :tags: feature, sql
        :tickets: 77

      Added accessor to types called "python_type",
      returns the rudimentary Python type object
      for a particular TypeEngine instance, if known,
      else raises NotImplementedError.

    .. change::
        :tags: bug, sql
        :tickets: 2261, 2319

      further tweak to the fix from,
      so that generative methods work a bit better
      off of cloned (this is almost a non-use case though).
      In particular this allows with_only_columns()
      to behave more consistently.   Added additional
      documentation to with_only_columns() to clarify
      expected behavior, which changed as a result
      of.

    .. change::
        :tags: engine, bug
        :tickets: 2317

      Fixed bug whereby transaction.rollback()
      would throw an error on an invalidated
      connection if the transaction were a
      two-phase or savepoint transaction.
      For plain transactions, rollback() is a no-op
      if the connection is invalidated, so while
      it wasn't 100% clear if it should be a no-op,
      at least now the interface is consistent.

    .. change::
        :tags: feature, schema
        :tickets:

      Added new support for remote "schemas":

    .. change::
        :tags: schema
        :tickets:

      MetaData() accepts "schema" and "quote_schema"
      arguments, which will be applied to the same-named
      arguments of a Table
      or Sequence which leaves these at their default
      of ``None``.

    .. change::
        :tags: schema
        :tickets:

      Sequence accepts "quote_schema" argument

    .. change::
        :tags: schema
        :tickets:

      tometadata() for Table will use the "schema"
      of the incoming MetaData for the new Table
      if the schema argument is explicitly "None"

    .. change::
        :tags: schema
        :tickets:

      Added CreateSchema and DropSchema DDL
      constructs - these accept just the string
      name of a schema and a "quote" flag.

    .. change::
        :tags: schema
        :tickets:

      When using default "schema" with MetaData,
      ForeignKey will also assume the "default" schema
      when locating remote table.  This allows the "schema"
      argument on MetaData to be applied to any
      set of Table objects that otherwise don't have
      a "schema".

    .. change::
        :tags: schema
        :tickets: 1679

      a "has_schema" method has been implemented
      on dialect, but only works on PostgreSQL so far.
      Courtesy Manlio Perillo.

    .. change::
        :tags: feature, schema
        :tickets: 1410

      The "extend_existing" flag on Table
      now allows for the reflection process to take
      effect for a Table object that's already been
      defined; when autoload=True and extend_existing=True
      are both set, the full set of columns will be
      reflected from the Table which will then
      *overwrite* those columns already present,
      rather than no activity occurring.  Columns that
      are present directly in the autoload run
      will be used as always, however.

    .. change::
        :tags: bug, schema
        :tickets:

      Fixed bug whereby TypeDecorator would
      return a stale value for _type_affinity, when
      using a TypeDecorator that "switches" types,
      like the CHAR/UUID type.

    .. change::
        :tags: bug, schema
        :tickets:

      Fixed bug whereby "order_by='foreign_key'"
      option to Inspector.get_table_names
      wasn't implementing the sort properly, replaced
      with the existing sort algorithm

    .. change::
        :tags: bug, schema
        :tickets: 2305

      the "name" of a column-level CHECK constraint,
      if present, is now rendered in the CREATE TABLE
      statement using "CONSTRAINT <name> CHECK <expression>".

    .. change::
        :tags: pyodbc, bug
        :tickets: 2318

      pyodbc-based dialects now parse the
      pyodbc accurately as far as observed
      pyodbc strings, including such gems
      as "py3-3.0.1-beta4"

    .. change::
        :tags: postgresql, bug
        :tickets: 2311

      PostgreSQL dialect memoizes that an ENUM of a
      particular name was processed
      during a create/drop sequence.  This allows
      a create/drop sequence to work without any
      calls to "checkfirst", and also means with
      "checkfirst" turned on it only needs to
      check for the ENUM once.

    .. change::
        :tags: postgresql, feature
        :tickets:

      Added create_type constructor argument
      to pg.ENUM.  When False, no CREATE/DROP or
      checking for the type will be performed as part
      of a table create/drop event; only the
      create()/drop)() methods called directly
      will do this.  Helps with Alembic "offline"
      scripts.

    .. change::
        :tags: mssql, feature
        :tickets: 822

      lifted the restriction on SAVEPOINT
      for SQL Server.  All tests pass using it,
      it's not known if there are deeper issues
      however.

    .. change::
        :tags: mssql, bug
        :tickets: 2336

      repaired the with_hint() feature which
      wasn't implemented correctly on MSSQL -
      usually used for the "WITH (NOLOCK)" hint
      (which you shouldn't be using anyway !
      use snapshot isolation instead :) )

    .. change::
        :tags: mssql, bug
        :tickets: 2318

      use new pyodbc version detection for
      _need_decimal_fix option.

    .. change::
        :tags: mssql, bug
        :tickets: 2343

      don't cast "table name" as NVARCHAR
      on SQL Server 2000.  Still mostly in the dark
      what incantations are needed to make PyODBC
      work fully with FreeTDS 0.91 here, however.

    .. change::
        :tags: mssql, bug
        :tickets: 2269

      Decode incoming values when retrieving
      list of index names and the names of columns
      within those indexes.

    .. change::
        :tags: bug, mysql
        :tickets:

      Unicode adjustments allow latest pymysql
      (post 0.4) to pass 100% on Python 2.

    .. change::
        :tags: ext, feature
        :tickets:

      Added an example to the hybrid docs
      of a "transformer" - a hybrid that returns a
      query-transforming callable in combination
      with a custom comparator.   Uses a new method
      on Query called with_transformation().  The use
      case here is fairly experimental, but only
      adds one line of code to Query.

    .. change::
        :tags: ext, bug
        :tickets:

      the @compiles decorator raises an
      informative error message when no "default"
      compilation handler is present, rather
      than KeyError.

    .. change::
        :tags: examples, bug
        :tickets:

      Fixed bug in history_meta.py example where
      the "unique" flag was not removed from a
      single-table-inheritance subclass which
      generates columns to put up onto the base.

.. changelog::
    :version: 0.7.3
    :released: Sun Oct 16 2011

    .. change::
        :tags: general
        :tickets: 2279

      Adjusted the "importlater" mechanism, which is
      used internally to resolve import cycles,
      such that the usage of __import__ is completed
      when the import of sqlalchemy or sqlalchemy.orm
      is done, thereby avoiding any usage of __import__
      after the application starts new threads,
      fixes.  Also in 0.6.9.

    .. change::
        :tags: orm
        :tickets: 2298

      Improved query.join() such that the "left" side
      can more flexibly be a non-ORM selectable,
      such as a subquery.   A selectable placed
      in select_from() will now be used as the left
      side, favored over implicit usage
      of a mapped entity.
      If the join still fails based on lack of
      foreign keys, the error message includes
      this detail.  Thanks to brianrhude
      on IRC for the test case.

    .. change::
        :tags: orm
        :tickets: 2241

      Added after_soft_rollback() Session event.  This
      event fires unconditionally whenever rollback()
      is called, regardless of if an actual DBAPI
      level rollback occurred.  This event
      is specifically designed to allow operations
      with the Session to proceed after a rollback
      when the Session.is_active is True.

    .. change::
        :tags: orm
        :tickets:

      added "adapt_on_names" boolean flag to orm.aliased()
      construct.  Allows an aliased() construct
      to link the ORM entity to a selectable that contains
      aggregates or other derived forms of a particular
      attribute, provided the name is the same as that
      of the entity mapped column.

    .. change::
        :tags: orm
        :tickets:

      Added new flag expire_on_flush=False to column_property(),
      marks those properties that would otherwise be considered
      to be "readonly", i.e. derived from SQL expressions,
      to retain their value after a flush has occurred, including
      if the parent object itself was involved in an update.

    .. change::
        :tags: orm
        :tickets: 2237

      Enhanced the instrumentation in the ORM to support
      Py3K's new argument style of "required kw arguments",
      i.e. fn(a, b, \*, c, d), fn(a, b, \*args, c, d).
      Argument signatures of mapped object's __init__
      method will be preserved, including required kw rules.

    .. change::
        :tags: orm
        :tickets: 2282

      Fixed bug in unit of work whereby detection of
      "cycles" among classes in highly interlinked patterns
      would not produce a deterministic
      result; thereby sometimes missing some nodes that
      should be considered cycles and causing further
      issues down the road.  Note this bug is in 0.6
      also; not backported at the moment.

    .. change::
        :tags: orm
        :tickets:

      Fixed a variety of synonym()-related regressions
      from 0.6:

          * making a synonym against a synonym now works.
          * synonyms made against a relationship() can
            be passed to query.join(), options sent
            to query.options(), passed by name
            to query.with_parent().

    .. change::
        :tags: orm
        :tickets: 2287

      Fixed bug whereby mapper.order_by attribute would
      be ignored in the "inner" query within a
      subquery eager load. .
      Also in 0.6.9.

    .. change::
        :tags: orm
        :tickets: 2267

      Identity map .discard() uses dict.pop(,None)
      internally instead of "del" to avoid KeyError/warning
      during a non-determinate gc teardown

    .. change::
        :tags: orm
        :tickets: 2253

      Fixed regression in new composite rewrite where
      deferred=True option failed due to missing
      import

    .. change::
        :tags: orm
        :tickets: 2248

      Reinstated "comparator_factory" argument to
      composite(), removed when 0.7 was released.

    .. change::
        :tags: orm
        :tickets: 2247

      Fixed bug in query.join() which would occur
      in a complex multiple-overlapping path scenario,
      where the same table could be joined to
      twice.  Thanks *much* to Dave Vitek
      for the excellent fix here.

    .. change::
        :tags: orm
        :tickets:

      Query will convert an OFFSET of zero when
      slicing into None, so that needless OFFSET
      clauses are not invoked.

    .. change::
        :tags: orm
        :tickets:

      Repaired edge case where mapper would fail
      to fully update internal state when a relationship
      on a new mapper would establish a backref on the
      first mapper.

    .. change::
        :tags: orm
        :tickets: 2260

      Fixed bug whereby if __eq__() was
      redefined, a relationship many-to-one lazyload
      would hit the __eq__() and fail.
      Does not apply to 0.6.9.

    .. change::
        :tags: orm
        :tickets: 2196

      Calling class_mapper() and passing in an object
      that is not a "type" (i.e. a class that could
      potentially be mapped) now raises an informative
      ArgumentError, rather than UnmappedClassError.

    .. change::
        :tags: orm
        :tickets:

      New event hook, MapperEvents.after_configured().
      Called after a configure() step has completed and
      mappers were in fact affected.   Theoretically this
      event is called once per application, unless new mappings
      are constructed after existing ones have been used
      already.

    .. change::
        :tags: orm
        :tickets: 2281

      When an open Session is garbage collected, the objects
      within it which remain are considered detached again
      when they are add()-ed to a new Session.
      This is accomplished by an extra check that the previous
      "session_key" doesn't actually exist among the pool
      of Sessions.

    .. change::
        :tags: orm
        :tickets: 2239

      New declarative features:

          * __declare_last__() method, establishes an event
            listener for the class method that will be called
            when mappers are completed with the final "configure"
            step.
          * __abstract__ flag.   The class will not be mapped
            at all when this flag is present on the class.
          * New helper classes ConcreteBase, AbstractConcreteBase.
            Allow concrete mappings using declarative which automatically
            set up the "polymorphic_union" when the "configure"
            mapper step is invoked.
          * The mapper itself has semi-private methods that allow
            the "with_polymorphic" selectable to be assigned
            to the mapper after it has already been configured.

    .. change::
        :tags: orm
        :tickets: 2283

      Declarative will warn when a subclass' base uses
      @declared_attr for a regular column - this attribute
      does not propagate to subclasses.

    .. change::
        :tags: orm
        :tickets: 2280

      The integer "id" used to link a mapped instance with
      its owning Session is now generated by a sequence
      generation function rather than id(Session), to
      eliminate the possibility of recycled id() values
      causing an incorrect result, no need to check that
      object actually in the session.

    .. change::
        :tags: orm
        :tickets: 2257

      Behavioral improvement: empty
      conjunctions such as and_() and or_() will be
      flattened in the context of an enclosing conjunction,
      i.e. and_(x, or_()) will produce 'X' and not 'X AND
      ()'..

    .. change::
        :tags: orm
        :tickets: 2261

      Fixed bug regarding calculation of "from" list
      for a select() element.  The "from" calc is now
      delayed, so that if the construct uses a Column
      object that is not yet attached to a Table,
      but is later associated with a Table, it generates
      SQL using the table as a FROM.   This change
      impacted fairly deeply the mechanics of how
      the FROM list as well as the "correlates" collection
      is calculated, as some "clause adaption" schemes
      (these are used very heavily in the ORM)
      were relying upon the fact that the "froms"
      collection would typically be cached before the
      adaption completed.   The rework allows it
      such that the "froms" collection can be cleared
      and re-generated at any time.

    .. change::
        :tags: orm
        :tickets: 2270

      Fixed bug whereby with_only_columns() method of
      Select would fail if a selectable were passed..  Also in 0.6.9.

    .. change::
        :tags: schema
        :tickets: 2284

      Modified Column.copy() to use _constructor(),
      which defaults to self.__class__, in order to
      create the new object.  This allows easier support
      of subclassing Column.

    .. change::
        :tags: schema
        :tickets: 2223

      Added a slightly nicer __repr__() to SchemaItem
      classes.  Note the repr here can't fully support
      the "repr is the constructor" idea since schema
      items can be very deeply nested/cyclical, have
      late initialization of some things, etc.

    .. change::
        :tags: engine
        :tickets: 2254

      The recreate() method in all pool classes uses
      self.__class__ to get at the type of pool
      to produce, in the case of subclassing.  Note
      there's no usual need to subclass pools.

    .. change::
        :tags: engine
        :tickets: 2243

      Improvement to multi-param statement logging,
      long lists of bound parameter sets will be
      compressed with an informative indicator
      of the compression taking place.  Exception
      messages use the same improved formatting.

    .. change::
        :tags: engine
        :tickets:

      Added optional "sa_pool_key" argument to
      pool.manage(dbapi).connect() so that serialization
      of args is not necessary.

    .. change::
        :tags: engine
        :tickets: 2286

      The entry point resolution supported by
      create_engine() now supports resolution of
      individual DBAPI drivers on top of a built-in
      or entry point-resolved dialect, using the
      standard '+' notation - it's converted to
      a '.' before being resolved as an entry
      point.

    .. change::
        :tags: engine
        :tickets: 2299

      Added an exception catch + warning for the
      "return unicode detection" step within connect,
      allows databases that crash on NVARCHAR to
      continue initializing, assuming no NVARCHAR
      type implemented.

    .. change::
        :tags: types
        :tickets: 2258

      Extra keyword arguments to the base Float
      type beyond "precision" and "asdecimal" are ignored;
      added a deprecation warning here and additional
      docs, related to

    .. change::
        :tags: sqlite
        :tickets:

      Ensured that the same ValueError is raised for
      illegal date/time/datetime string parsed from
      the database regardless of whether C
      extensions are in use or not.

    .. change::
        :tags: postgresql
        :tickets: 2290

      Added "postgresql_using" argument to Index(), produces
      USING clause to specify index implementation for
      PG. .  Thanks to Ryan P. Kelly for
      the patch.

    .. change::
        :tags: postgresql
        :tickets: 1839

      Added client_encoding parameter to create_engine()
      when the postgresql+psycopg2 dialect is used;
      calls the psycopg2 set_client_encoding() method
      with the value upon connect.

    .. change::
        :tags: postgresql
        :tickets: 2291, 2141

      Fixed bug related to whereby the
      same modified index behavior in PG 9 affected
      primary key reflection on a renamed column..  Also in 0.6.9.

    .. change::
        :tags: postgresql
        :tickets: 2256

      Reflection functions for Table, Sequence no longer
      case insensitive.  Names can be differ only in case
      and will be correctly distinguished.

    .. change::
        :tags: postgresql
        :tickets:

      Use an atomic counter as the "random number"
      source for server side cursor names;
      conflicts have been reported in rare cases.

    .. change::
        :tags: postgresql
        :tickets: 2249

      Narrowed the assumption made when reflecting
      a foreign-key referenced table with schema in
      the current search path; an explicit schema will
      be applied to the referenced table only if
      it actually matches that of the referencing table,
      which also has an explicit schema.   Previously
      it was assumed that "current" schema was synonymous
      with the full search_path.

    .. change::
        :tags: mysql
        :tickets: 2225

      a CREATE TABLE will put the COLLATE option
      after CHARSET, which appears to be part of
      MySQL's arbitrary rules regarding if it will actually
      work or not.   Also in 0.6.9.

    .. change::
        :tags: mysql
        :tickets: 2293

      Added mysql_length parameter to Index construct,
      specifies "length" for indexes.

    .. change::
        :tags: mssql
        :tickets: 2273

      Changes to attempt support of FreeTDS 0.91 with
      Pyodbc.  This includes that string binds are sent as
      Python unicode objects when FreeTDS 0.91 is detected,
      and a CAST(? AS NVARCHAR) is used when we detect
      for a table.   However, I'd continue
      to characterize Pyodbc + FreeTDS 0.91 behavior as
      pretty crappy, there are still many queries such
      as used in reflection which cause a core dump on
      Linux, and it is not really usable at all
      on OSX, MemoryErrors abound and just plain broken
      unicode support.

    .. change::
        :tags: mssql
        :tickets: 2277

      The behavior of =/!= when comparing a scalar select
      to a value will no longer produce IN/NOT IN as of 0.8;
      this behavior is a little too heavy handed (use ``in_()`` if
      you want to emit IN) and now emits a deprecation warning.
      To get the 0.8 behavior immediately and remove the warning,
      a compiler recipe is given at
      https://www.sqlalchemy.org/docs/07/dialects/mssql.html#scalar-select-comparisons
      to override the behavior of visit_binary().

    .. change::
        :tags: mssql
        :tickets: 2222

      "0" is accepted as an argument for limit() which
      will produce "TOP 0".

    .. change::
        :tags: oracle
        :tickets: 2272

      Fixed ReturningResultProxy for zxjdbc dialect..  Regression from 0.6.

    .. change::
        :tags: oracle
        :tickets: 2252

      The String type now generates VARCHAR2 on Oracle
      which is recommended as the default VARCHAR.
      Added an explicit VARCHAR2 and NVARCHAR2 to the Oracle
      dialect as well.   Using NVARCHAR still generates
      "NVARCHAR2" - there is no "NVARCHAR" on Oracle -
      this remains a slight breakage of the "uppercase types
      always give exactly that" policy.  VARCHAR still
      generates "VARCHAR", keeping with the policy.   If
      Oracle were to ever define "VARCHAR" as something
      different as they claim (IMHO this will never happen),
      the type would be available.

    .. change::
        :tags: ext
        :tickets: 2262

      SQLSoup will not be included in version 0.8
      of SQLAlchemy; while useful, we would like to
      keep SQLAlchemy itself focused on one ORM
      usage paradigm.  SQLSoup will hopefully
      soon be superseded by a third party
      project.

    .. change::
        :tags: ext
        :tickets: 2236

      Added local_attr, remote_attr, attr accessors
      to AssociationProxy, providing quick access
      to the proxied attributes at the class
      level.

    .. change::
        :tags: ext
        :tickets: 2275

      Changed the update() method on association proxy
      dictionary to use a duck typing approach, i.e.
      checks for "keys", to discern between update({})
      and update((a, b)).   Previously, passing a
      dictionary that had tuples as keys would be misinterpreted
      as a sequence.

    .. change::
        :tags: examples
        :tickets: 2266

      Adjusted dictlike-polymorphic.py example
      to apply the CAST such that it works on
      PG, other databases.
      Also in 0.6.9.

.. changelog::
    :version: 0.7.2
    :released: Sun Jul 31 2011

    .. change::
        :tags: orm
        :tickets: 2213

      Feature enhancement: joined and subquery
      loading will now traverse already-present related
      objects and collections in search of unpopulated
      attributes throughout the scope of the eager load
      being defined, so that the eager loading that is
      specified via mappings or query options
      unconditionally takes place for the full depth,
      populating whatever is not already populated.
      Previously, this traversal would stop if a related
      object or collection were already present leading
      to inconsistent behavior (though would save on
      loads/cycles for an already-loaded graph). For a
      subqueryload, this means that the additional
      SELECT statements emitted by subqueryload will
      invoke unconditionally, no matter how much of the
      existing graph is already present (hence the
      controversy). The previous behavior of "stopping"
      is still in effect when a query is the result of
      an attribute-initiated lazyload, as otherwise an
      "N+1" style of collection iteration can become
      needlessly expensive when the same related object
      is encountered repeatedly. There's also an
      as-yet-not-public generative Query method
      _with_invoke_all_eagers()
      which selects old/new behavior

    .. change::
        :tags: orm
        :tickets: 2195

      A rework of "replacement traversal" within
      the ORM as it alters selectables to be against
      aliases of things (i.e. clause adaption) includes
      a fix for multiply-nested any()/has() constructs
      against a joined table structure.

    .. change::
        :tags: orm
        :tickets: 2234

      Fixed bug where query.join() + aliased=True
      from a joined-inh structure to itself on
      relationship() with join condition on the child
      table would convert the lead entity into the
      joined one inappropriately.
      Also in 0.6.9.

    .. change::
        :tags: orm
        :tickets: 2205

      Fixed regression from 0.6 where Session.add()
      against an object which contained None in a
      collection would raise an internal exception.
      Reverted this to 0.6's behavior which is to
      accept the None but obviously nothing is
      persisted.  Ideally, collections with None
      present or on append() should at least emit a
      warning, which is being considered for 0.8.

    .. change::
        :tags: orm
        :tickets: 2191

      Load of a deferred() attribute on an object
      where row can't be located raises
      ObjectDeletedError instead of failing later
      on; improved the message in ObjectDeletedError
      to include other conditions besides a simple
      "delete".

    .. change::
        :tags: orm
        :tickets: 2224

      Fixed regression from 0.6 where a get history
      operation on some relationship() based attributes
      would fail when a lazyload would emit; this could
      trigger within a flush() under certain conditions.  Thanks to the user who submitted
      the great test for this.

    .. change::
        :tags: orm
        :tickets: 2228

      Fixed bug apparent only in Python 3 whereby
      sorting of persistent + pending objects during
      flush would produce an illegal comparison,
      if the persistent object primary key
      is not a single integer.
      Also in 0.6.9

    .. change::
        :tags: orm
        :tickets: 2197

      Fixed bug whereby the source clause
      used by query.join() would be inconsistent
      if against a column expression that combined
      multiple entities together.
      Also in 0.6.9

    .. change::
        :tags: orm
        :tickets: 2215

      Fixed bug whereby if a mapped class
      redefined __hash__() or __eq__() to something
      non-standard, which is a supported use case
      as SQLA should never consult these,
      the methods would be consulted if the class
      was part of a "composite" (i.e. non-single-entity)
      result set.
      Also in 0.6.9.

    .. change::
        :tags: orm
        :tickets: 2240

      Added public attribute ".validators" to
      Mapper, an immutable dictionary view of
      all attributes that have been decorated
      with the @validates decorator. courtesy Stefano Fontanelli

    .. change::
        :tags: orm
        :tickets: 2188

      Fixed subtle bug that caused SQL to blow
      up if: column_property() against subquery +
      joinedload + LIMIT + order by the column
      property() occurred. .
      Also in 0.6.9

    .. change::
        :tags: orm
        :tickets: 2207

      The join condition produced by with_parent
      as well as when using a "dynamic" relationship
      against a parent will generate unique
      bindparams, rather than incorrectly repeating
      the same bindparam. .
      Also in 0.6.9.

    .. change::
        :tags: orm
        :tickets:

      Added the same "columns-only" check to
      mapper.polymorphic_on as used when
      receiving user arguments to
      relationship.order_by, foreign_keys,
      remote_side, etc.

    .. change::
        :tags: orm
        :tickets: 2190

      Fixed bug whereby comparison of column
      expression to a Query() would not call
      as_scalar() on the underlying SELECT
      statement to produce a scalar subquery,
      in the way that occurs if you called
      it on Query().subquery().

    .. change::
        :tags: orm
        :tickets: 2194

      Fixed declarative bug where a class inheriting
      from a superclass of the same name would fail
      due to an unnecessary lookup of the name
      in the _decl_class_registry.

    .. change::
        :tags: orm
        :tickets: 2199

      Repaired the "no statement condition"
      assertion in Query which would attempt
      to raise if a generative method were called
      after from_statement() were called..  Also in 0.6.9.

    .. change::
        :tags: sql
        :tickets: 2188

      Fixed two subtle bugs involving column
      correspondence in a selectable,
      one with the same labeled subquery repeated, the other
      when the label has been "grouped" and
      loses itself.  Affects.

    .. change::
        :tags: schema
        :tickets: 2187

      New feature: with_variant() method on
      all types.  Produces an instance of Variant(),
      a special TypeDecorator which will select
      the usage of a different type based on the
      dialect in use.

    .. change::
        :tags: schema
        :tickets:

      Added an informative error message when
      ForeignKeyConstraint refers to a column name in
      the parent that is not found.  Also in 0.6.9.

    .. change::
        :tags: schema
        :tickets: 2206

      Fixed bug whereby adaptation of old append_ddl_listener()
      function was passing unexpected \**kw through
      to the Table event.   Table gets no kws, the MetaData
      event in 0.6 would get "tables=somecollection",
      this behavior is preserved.

    .. change::
        :tags: schema
        :tickets:

      Fixed bug where "autoincrement" detection on
      Table would fail if the type had no "affinity"
      value, in particular this would occur when using
      the UUID example on the site that uses TypeEngine
      as the "impl".

    .. change::
        :tags: schema
        :tickets: 2209

      Added an improved repr() to TypeEngine objects
      that will only display constructor args which
      are positional or kwargs that deviate
      from the default.

    .. change::
        :tags: engine
        :tickets:

      Context manager provided by Connection.begin()
      will issue rollback() if the commit() fails,
      not just if an exception occurs.

    .. change::
        :tags: engine
        :tickets: 1682

      Use urllib.parse_qsl() in Python 2.6 and above,
      no deprecation warning about cgi.parse_qsl()

    .. change::
        :tags: engine
        :tickets:

      Added mixin class sqlalchemy.ext.DontWrapMixin.
      User-defined exceptions of this type are never
      wrapped in StatementException when they
      occur in the context of a statement
      execution.

    .. change::
        :tags: engine
        :tickets:

      StatementException wrapping will display the
      original exception class in the message.

    .. change::
        :tags: engine
        :tickets: 2201

      Failures on connect which raise dbapi.Error
      will forward the error to dialect.is_disconnect()
      and set the "connection_invalidated" flag if
      the dialect knows this to be a potentially
      "retryable" condition.  Only Oracle ORA-01033
      implemented for now.

    .. change::
        :tags: sqlite
        :tickets: 2189

      SQLite dialect no longer strips quotes
      off of reflected default value, allowing
      a round trip CREATE TABLE to work.
      This is consistent with other dialects
      that also maintain the exact form of
      the default.

    .. change::
        :tags: postgresql
        :tickets: 2198

      Added new "postgresql_ops" argument to
      Index, allows specification of PostgreSQL
      operator classes for indexed columns.  Courtesy Filip Zyzniewski.

    .. change::
        :tags: mysql
        :tickets: 2186

      Fixed OurSQL dialect to use ansi-neutral
      quote symbol "'" for XA commands instead
      of '"'. .  Also in 0.6.9.

    .. change::
        :tags: mssql
        :tickets:

      Adjusted the pyodbc dialect such that bound
      values are passed as bytes and not unicode
      if the "Easysoft" unix drivers are detected.
      This is the same behavior as occurs with
      FreeTDS.  Easysoft appears to segfault
      if Python unicodes are passed under
      certain circumstances.

    .. change::
        :tags: oracle
        :tickets: 2200

      Added ORA-00028 to disconnect codes, use
      cx_oracle _Error.code to get at the code,.  Also in 0.6.9.

    .. change::
        :tags: oracle
        :tickets: 2201

      Added ORA-01033 to disconnect codes, which
      can be caught during a connection
      event.

    .. change::
        :tags: oracle
        :tickets: 2220

      repaired the oracle.RAW type which did not
      generate the correct DDL.
      Also in 0.6.9.

    .. change::
        :tags: oracle
        :tickets: 2212

      added CURRENT to reserved word list. Also in 0.6.9.

    .. change::
        :tags: oracle
        :tickets:

      Fixed bug in the mutable extension whereby
      if the same type were used twice in one
      mapping, the attributes beyond the first
      would not get instrumented.

    .. change::
        :tags: oracle
        :tickets:

      Fixed bug in the mutable extension whereby
      if None or a non-corresponding type were set,
      an error would be raised.  None is now accepted
      which assigns None to all attributes,
      illegal values raise ValueError.

    .. change::
        :tags: examples
        :tickets:

      Repaired the examples/versioning test runner
      to not rely upon SQLAlchemy test libs,
      nosetests must be run from within
      examples/versioning to get around setup.cfg
      breaking it.

    .. change::
        :tags: examples
        :tickets:

      Tweak to examples/versioning to pick the
      correct foreign key in a multi-level
      inheritance situation.

    .. change::
        :tags: examples
        :tickets:

      Fixed the attribute shard example to check
      for bind param callable correctly in 0.7
      style.

.. changelog::
    :version: 0.7.1
    :released: Sun Jun 05 2011

    .. change::
        :tags: general
        :tickets: 2184

      Added a workaround for Python bug 7511 where
      failure of C extension build does not
      raise an appropriate exception on Windows 64
      bit + VC express

    .. change::
        :tags: orm
        :tickets: 1912

      "delete-orphan" cascade is now allowed on
      self-referential relationships - this since
      SQLA 0.7 no longer enforces "parent with no
      child" at the ORM level; this check is left
      up to foreign key nullability.
      Related to

    .. change::
        :tags: orm
        :tickets: 2180

      Repaired new "mutable" extension to propagate
      events to subclasses correctly; don't
      create multiple event listeners for
      subclasses either.

    .. change::
        :tags: orm
        :tickets: 2170

      Modify the text of the message which occurs
      when the "identity" key isn't detected on
      flush, to include the common cause that
      the Column isn't set up to detect
      auto-increment correctly;.
      Also in 0.6.8.

    .. change::
        :tags: orm
        :tickets: 2182

      Fixed bug where transaction-level "deleted"
      collection wouldn't be cleared of expunged
      states, raising an error if they later
      became transient.
      Also in 0.6.8.

    .. change::
        :tags: sql
        :tickets:

      Fixed bug whereby metadata.reflect(bind)
      would close a Connection passed as a
      bind argument.  Regression from 0.6.

    .. change::
        :tags: sql
        :tickets:

      Streamlined the process by which a Select
      determines what's in its '.c' collection.
      Behaves identically, except that a
      raw ClauseList() passed to select([])
      (which is not a documented case anyway) will
      now be expanded into its individual column
      elements instead of being ignored.

    .. change::
        :tags: engine
        :tickets:

      Deprecate schema/SQL-oriented methods on
      Connection/Engine that were never well known
      and are redundant:  reflecttable(), create(),
      drop(), text(), engine.func

    .. change::
        :tags: engine
        :tickets: 2178

      Adjusted the __contains__() method of
      a RowProxy result row such that no exception
      throw is generated internally;
      NoSuchColumnError() also will generate its
      message regardless of whether or not the column
      construct can be coerced to a string..  Also in 0.6.8.

    .. change::
        :tags: sqlite
        :tickets: 2173

      Accept None from cursor.fetchone() when
      "PRAGMA read_uncommitted" is called to determine
      current isolation mode at connect time and
      default to SERIALIZABLE; this to support SQLite
      versions pre-3.3.0 that did not have this
      feature.

    .. change::
        :tags: postgresql
        :tickets: 2175

      Some unit test fixes regarding numeric arrays,
      MATCH operator.   A potential floating-point
      inaccuracy issue was fixed, and certain tests
      of the MATCH operator only execute within an
      EN-oriented locale for now. .
      Also in 0.6.8.

    .. change::
        :tags: mysql
        :tickets:

      Unit tests pass 100% on MySQL installed
      on windows.

    .. change::
        :tags: mysql
        :tickets: 2181

      Removed the "adjust casing" step that would
      fail when reflecting a table on MySQL
      on windows with a mixed case name.  After some
      experimenting with a windows MySQL server, it's
      been determined that this step wasn't really
      helping the situation much; MySQL does not return
      FK names with proper casing on non-windows
      platforms either, and removing the step at
      least allows the reflection to act more like
      it does on other OSes.   A warning here
      has been considered but its difficult to
      determine under what conditions such a warning
      can be raised, so punted on that for now -
      added some docs instead.

    .. change::
        :tags: mysql
        :tickets:

      supports_sane_rowcount will be set to False
      if using MySQLdb and the DBAPI doesn't provide
      the constants.CLIENT module.

.. changelog::
    :version: 0.7.0
    :released: Fri May 20 2011

    .. change::
        :tags:
        :tickets:

      This section documents those changes from 0.7b4
      to 0.7.0.  For an overview of what's new in
      SQLAlchemy 0.7, see
      https://docs.sqlalchemy.org/en/latest/changelog/migration_07.html

    .. change::
        :tags: orm
        :tickets: 2069

      Fixed regression introduced in 0.7b4 (!) whereby
      query.options(someoption("nonexistent name")) would
      fail to raise an error.  Also added additional
      error catching for cases where the option would
      try to build off a column-based element, further
      fixed up some of the error messages tailored
      in

    .. change::
        :tags: orm
        :tickets: 2162

      query.count() emits "count(*)" instead of
      "count(1)".

    .. change::
        :tags: orm
        :tickets: 2155

      Fine tuning of Query clause adaptation when
      from_self(), union(), or other "select from
      myself" operation, such that plain SQL expression
      elements added to filter(), order_by() etc.
      which are present in the nested "from myself"
      query *will* be adapted in the same way an ORM
      expression element will, since these
      elements are otherwise not easily accessible.

    .. change::
        :tags: orm
        :tickets: 2149

      Fixed bug where determination of "self referential"
      relationship would fail with no workaround
      for joined-inh subclass related to itself,
      or joined-inh subclass related to a subclass
      of that with no cols in the sub-sub class
      in the join condition.
      Also in 0.6.8.

    .. change::
        :tags: orm
        :tickets: 2153

      mapper() will ignore non-configured foreign keys
      to unrelated tables when determining inherit
      condition between parent and child class,
      but will raise as usual for unresolved
      columns and table names regarding the inherited
      table.  This is an enhanced generalization of
      behavior that was already applied to declarative
      previously.    0.6.8 has a more
      conservative version of this which doesn't
      fundamentally alter how join conditions
      are determined.

    .. change::
        :tags: orm
        :tickets: 2144

      It is an error to call query.get() when the
      given entity is not a single, full class
      entity or mapper (i.e. a column).  This is
      a deprecation warning in 0.6.8.

    .. change::
        :tags: orm
        :tickets: 2148

      Fixed a potential KeyError which under some
      circumstances could occur with the identity
      map, part of

    .. change::
        :tags: orm
        :tickets:

      added Query.with_session() method, switches
      Query to use a different session.

    .. change::
        :tags: orm
        :tickets: 2131

      horizontal shard query should use execution
      options per connection as per

    .. change::
        :tags: orm
        :tickets: 2151

      a non_primary mapper will inherit the _identity_class
      of the primary mapper.  This so that a non_primary
      established against a class that's normally in an
      inheritance mapping will produce results that are
      identity-map compatible with that of the primary
      mapper (also in 0.6.8)

    .. change::
        :tags: orm
        :tickets: 2163

      Fixed the error message emitted for "can't
      execute syncrule for destination column 'q';
      mapper 'X' does not map this column" to
      reference the correct mapper. .
      Also in 0.6.8.

    .. change::
        :tags: orm
        :tickets: 1502

      polymorphic_union() gets a "cast_nulls" option,
      disables the usage of CAST when it renders
      the labeled NULL columns.

    .. change::
        :tags: orm
        :tickets:

      polymorphic_union() renders the columns in their
      original table order, as according to the first
      table/selectable in the list of polymorphic
      unions in which they appear.  (which is itself
      an unordered mapping unless you pass an OrderedDict).

    .. change::
        :tags: orm
        :tickets: 2171

      Fixed bug whereby mapper mapped to an anonymous
      alias would fail if logging were used, due to
      unescaped % sign in the alias name.
      Also in 0.6.8.

    .. change::
        :tags: sql
        :tickets: 2167

      Fixed bug whereby nesting a label of a select()
      with another label in it would produce incorrect
      exported columns.   Among other things this would
      break an ORM column_property() mapping against
      another column_property(). .
      Also in 0.6.8

    .. change::
        :tags: sql
        :tickets:

      Changed the handling in determination of join
      conditions such that foreign key errors are
      only considered between the two given tables.
      That is, t1.join(t2) will report FK errors
      that involve 't1' or 't2', but anything
      involving 't3' will be skipped.   This affects
      join(), as well as ORM relationship and
      inherit condition logic.

    .. change::
        :tags: sql
        :tickets:

      Some improvements to error handling inside
      of the execute procedure to ensure auto-close
      connections are really closed when very
      unusual DBAPI errors occur.

    .. change::
        :tags: sql
        :tickets:

      metadata.reflect() and reflection.Inspector()
      had some reliance on GC to close connections
      which were internally procured, fixed this.

    .. change::
        :tags: sql
        :tickets: 2140

      Added explicit check for when Column .name
      is assigned as blank string

    .. change::
        :tags: sql
        :tickets: 2147

      Fixed bug whereby if FetchedValue was passed
      to column server_onupdate, it would not
      have its parent "column" assigned, added
      test coverage for all column default assignment
      patterns.   also in 0.6.8

    .. change::
        :tags: postgresql
        :tickets:

      Fixed the psycopg2_version parsing in the
      psycopg2 dialect.

    .. change::
        :tags: postgresql
        :tickets: 2141

      Fixed bug affecting PG 9 whereby index reflection
      would fail if against a column whose name
      had changed. .  Also in 0.6.8.

    .. change::
        :tags: mssql
        :tickets: 2169

      Fixed bug in MSSQL dialect whereby the aliasing
      applied to a schema-qualified table would leak
      into enclosing select statements.
      Also in 0.6.8.

    .. change::
        :tags: documentation
        :tickets: 2152

      Removed the usage of the "collections.MutableMapping"
      abc from the ext.mutable docs as it was being used
      incorrectly and makes the example more difficult
      to understand in any case.

    .. change::
        :tags: examples
        :tickets:

      removed the ancient "polymorphic association"
      examples and replaced with an updated set of
      examples that use declarative mixins,
      "generic_associations".   Each presents an alternative
      table layout.

    .. change::
        :tags: ext
        :tickets: 2143

      Fixed bugs in sqlalchemy.ext.mutable extension where
      `None` was not appropriately handled, replacement
      events were not appropriately handled.

.. changelog::
    :version: 0.7.0b4
    :released: Sun Apr 17 2011

    .. change::
        :tags: general
        :tickets:

      Changes to the format of CHANGES, this file.
      The format changes have been applied to
      the 0.7 releases.

    .. change::
        :tags: general
        :tickets:

      The "-declarative" changes will now be listed
      directly under the "-orm" section, as these
      are closely related.

    .. change::
        :tags: general
        :tickets:

      The 0.5 series changes have been moved to
      the file CHANGES_PRE_06 which replaces
      CHANGES_PRE_05.

    .. change::
        :tags: general
        :tickets:

      The changelog for 0.6.7 and subsequent within
      the 0.6 series is now listed only in the
      CHANGES file within the 0.6 branch.
      In the 0.7 CHANGES file (i.e. this file), all the
      0.6 changes are listed inline within the 0.7
      section in which they were also applied
      (since all 0.6 changes are in 0.7 as well).
      Changes that apply to an 0.6 version here
      are noted as are if any differences in
      implementation/behavior are present.

    .. change::
        :tags: orm
        :tickets: 2122

      Some fixes to "evaluate" and "fetch" evaluation
      when query.update(), query.delete() are called.
      The retrieval of records is done after autoflush
      in all cases, and before update/delete is
      emitted, guarding against unflushed data present
      as well as expired objects failing during
      the evaluation.

    .. change::
        :tags: orm
        :tickets: 2063

      Reworded the exception raised when a flush
      is attempted of a subclass that is not polymorphic
      against the supertype.

    .. change::
        :tags: orm
        :tickets:

      Still more wording adjustments when a query option
      can't find the target entity.  Explain that the
      path must be from one of the root entities.

    .. change::
        :tags: orm
        :tickets: 2123

      Some fixes to the state handling regarding
      backrefs, typically when autoflush=False, where
      the back-referenced collection wouldn't
      properly handle add/removes with no net
      change.  Thanks to Richard Murri for the
      test case + patch.
      (also in 0.6.7).

    .. change::
        :tags: orm
        :tickets: 2127

      Added checks inside the UOW to detect the unusual
      condition of being asked to UPDATE or DELETE
      on a primary key value that contains NULL
      in it.

    .. change::
        :tags: orm
        :tickets: 2127

      Some refinements to attribute history.  More
      changes are pending possibly in 0.8, but
      for now history has been modified such that
      scalar history doesn't have a "side effect"
      of populating None for a non-present value.
      This allows a slightly better ability to
      distinguish between a None set and no actual
      change, affects as well.

    .. change::
        :tags: orm
        :tickets: 2130

      a "having" clause would be copied from the
      inside to the outside query if from_self()
      were used; in particular this would break
      an 0.7 style count() query.
      (also in 0.6.7)

    .. change::
        :tags: orm
        :tickets: 2131

      the Query.execution_options() method now passes
      those options to the Connection rather than
      the SELECT statement, so that all available
      options including isolation level and
      compiled cache may be used.

    .. change::
        :tags: sql
        :tickets: 2131

      The "compiled_cache" execution option now raises
      an error when passed to a SELECT statement
      rather than a Connection.  Previously it was
      being ignored entirely.   We may look into
      having this option work on a per-statement
      level at some point.

    .. change::
        :tags: sql
        :tickets:

      Restored the "catchall" constructor on the base
      TypeEngine class, with a deprecation warning.
      This so that code which does something like
      Integer(11) still succeeds.

    .. change::
        :tags: sql
        :tickets: 2104

      Fixed regression whereby MetaData() coming
      back from unpickling did not keep track of
      new things it keeps track of now, i.e.
      collection of Sequence objects, list
      of schema names.

    .. change::
        :tags: sql
        :tickets: 2116

      The limit/offset keywords to select() as well
      as the value passed to select.limit()/offset()
      will be coerced to integer.
      (also in 0.6.7)

    .. change::
        :tags: sql
        :tickets:

      fixed bug where "from" clause gathering from an
      over() clause would be an itertools.chain() and
      not a list, causing "can only concatenate list"
      TypeError when combined with other clauses.

    .. change::
        :tags: sql
        :tickets: 2134

      Fixed incorrect usage of "," in over() clause
      being placed between the "partition" and "order by"
      clauses.

    .. change::
        :tags: sql
        :tickets: 2105

      Before/after attach events for PrimaryKeyConstraint
      now function, tests added for before/after events
      on all constraint types.

    .. change::
        :tags: sql
        :tickets: 2117

      Added explicit true()/false() constructs to expression
      lib - coercion rules will intercept "False"/"True"
      into these constructs.  In 0.6, the constructs were
      typically converted straight to string, which was
      no longer accepted in 0.7.

    .. change::
        :tags: engine
        :tickets: 2129

      The C extension is now enabled by default on CPython
      2.x with a fallback to pure python if it fails to
      compile.

    .. change::
        :tags: schema
        :tickets: 2109

      The 'useexisting' flag on Table has been superseded
      by a new pair of flags 'keep_existing' and
      'extend_existing'.   'extend_existing' is equivalent
      to 'useexisting' - the existing Table is returned,
      and additional constructor elements are added.
      With 'keep_existing', the existing Table is returned,
      but additional constructor elements are not added -
      these elements are only applied when the Table
      is newly created.

    .. change::
        :tags: types
        :tickets: 2081

      REAL has been added to the core types.  Supported
      by PostgreSQL, SQL Server, MySQL, SQLite.  Note
      that the SQL Server and MySQL versions, which
      add extra arguments, are also still available
      from those dialects.

    .. change::
        :tags: types
        :tickets: 2106

      Added @event.listens_for() decorator, given
      target + event name, applies the decorated
      function as a listener.

    .. change::
        :tags: pool
        :tickets: 2103

      AssertionPool now stores the traceback indicating
      where the currently checked out connection was
      acquired; this traceback is reported within
      the assertion raised upon a second concurrent
      checkout; courtesy Gunnlaugur Briem

    .. change::
        :tags: pool
        :tickets:

      The "pool.manage" feature doesn't use pickle
      anymore to hash the arguments for each pool.

    .. change::
        :tags: sqlite
        :tickets: 2115

      Fixed bug where reflection of foreign key
      created as "REFERENCES <tablename>" without
      col name would fail.
      (also in 0.6.7)

    .. change::
        :tags: postgresql
        :tickets:

      Psycopg2 for Python 3 is now supported.

    .. change::
        :tags: postgresql
        :tickets: 2132

      Fixed support for precision numerics when using
      pg8000.

    .. change::
        :tags: oracle
        :tickets: 2100

      Using column names that would require quotes
      for the column itself or for a name-generated
      bind parameter, such as names with special
      characters, underscores, non-ascii characters,
      now properly translate bind parameter keys when
      talking to cx_oracle.   (Also
      in 0.6.7)

    .. change::
        :tags: oracle
        :tickets: 2116

      Oracle dialect adds use_binds_for_limits=False
      create_engine() flag, will render the LIMIT/OFFSET
      values inline instead of as binds, reported to
      modify the execution plan used by Oracle. (Also in 0.6.7)

    .. change::
        :tags: documentation
        :tickets: 2029

      Documented SQLite DATE/TIME/DATETIME types. (also in 0.6.7)

    .. change::
        :tags: documentation
        :tickets: 2118

      Fixed mutable extension docs to show the
      correct type-association methods.

.. changelog::
    :version: 0.7.0b3
    :released: Sun Mar 20 2011

    .. change::
        :tags: general
        :tickets:

      Lots of fixes to unit tests when run under PyPy
      (courtesy Alex Gaynor).

    .. change::
        :tags: orm
        :tickets: 2093

      Changed the underlying approach to query.count().
      query.count() is now in all cases exactly:

          query.
              from_self(func.count(literal_column('1'))).
              scalar()

      That is, "select count(1) from (<full query>)".
      This produces a subquery in all cases, but
      vastly simplifies all the guessing count()
      tried to do previously, which would still
      fail in many scenarios particularly when
      joined table inheritance and other joins
      were involved.  If the subquery produced
      for an otherwise very simple count is really
      an issue, use query(func.count()) as an
      optimization.

    .. change::
        :tags: orm
        :tickets: 2087

      some changes to the identity map regarding
      rare weakref callbacks during iterations.
      The mutex has been removed as it apparently
      can cause a reentrant (i.e. in one thread) deadlock,
      perhaps when gc collects objects at the point of
      iteration in order to gain more memory.  It is hoped
      that "dictionary changed during iteration" will
      be exceedingly rare as iteration methods internally
      acquire the full list of objects in a single values()
      call. Note 0.6.7 has a more conservative fix here
      which still keeps the mutex in place.

    .. change::
        :tags: orm
        :tickets: 2082

      A tweak to the unit of work causes it to order
      the flush along relationship() dependencies even if
      the given objects don't have any inter-attribute
      references in memory, which was the behavior in
      0.5 and earlier, so a flush of Parent/Child with
      only foreign key/primary key set will succeed.
      This while still maintaining 0.6 and above's not
      generating a ton of useless internal dependency
      structures within the flush that don't correspond
      to state actually within the current flush.

    .. change::
        :tags: orm
        :tickets: 2069

      Improvements to the error messages emitted when
      querying against column-only entities in conjunction
      with (typically incorrectly) using loader options,
      where the parent entity is not fully present.

    .. change::
        :tags: orm
        :tickets: 2098

      Fixed bug in query.options() whereby a path
      applied to a lazyload using string keys could
      overlap a same named attribute on the wrong
      entity.  Note 0.6.7 has a more conservative fix
      to this.

    .. change::
        :tags: declarative
        :tickets: 2091

      Arguments in __mapper_args__ that aren't "hashable"
      aren't mistaken for always-hashable, possibly-column
      arguments.  (also in 0.6.7)

    .. change::
        :tags: sql
        :tickets:

      Added a fully descriptive error message for the
      case where Column is subclassed and _make_proxy()
      fails to make a copy due to TypeError on the
      constructor.   The method _constructor should
      be implemented in this case.

    .. change::
        :tags: sql
        :tickets: 2095

      Added new event "column_reflect" for Table objects.
      Receives the info dictionary about a Column before
      the object is generated within reflection, and allows
      modification to the dictionary for control over
      most aspects of the resulting Column including
      key, name, type, info dictionary.

    .. change::
        :tags: sql
        :tickets:

      To help with the "column_reflect" event being used
      with specific Table objects instead of all instances
      of Table, listeners can be added to a Table object
      inline with its construction using a new argument
      "listeners", a list of tuples of the form
      (<eventname>, <fn>), which are applied to the Table
      before the reflection process begins.

    .. change::
        :tags: sql
        :tickets: 2085

      Added new generic function "next_value()", accepts
      a Sequence object as its argument and renders the
      appropriate "next value" generation string on the
      target platform, if supported.  Also provides
      ".next_value()" method on Sequence itself.

    .. change::
        :tags: sql
        :tickets: 2084

      func.next_value() or other SQL expression can
      be embedded directly into an insert() construct,
      and if implicit or explicit "returning" is used
      in conjunction with a primary key column,
      the newly generated value will be present in
      result.inserted_primary_key.

    .. change::
        :tags: sql
        :tickets: 2089

      Added accessors to ResultProxy "returns_rows",
      "is_insert" (also in 0.6.7)

    .. change::
        :tags: engine
        :tickets: 2097

      Fixed AssertionPool regression bug.

    .. change::
        :tags: engine
        :tickets: 2060

      Changed exception raised to ArgumentError when an
      invalid dialect is specified.

    .. change::
        :tags: postgresql
        :tickets: 2092

      Added RESERVED_WORDS for postgresql dialect.
      (also in 0.6.7)

    .. change::
        :tags: postgresql
        :tickets: 2073

      Fixed the BIT type to allow a "length" parameter, "varying"
      parameter.  Reflection also fixed.
      (also in 0.6.7)

    .. change::
        :tags: mssql
        :tickets: 2071

      Rewrote the query used to get the definition of a view,
      typically when using the Inspector interface, to
      use sys.sql_modules instead of the information schema,
      thereby allowing views definitions longer than 4000
      characters to be fully returned.
      (also in 0.6.7)

    .. change::
        :tags: firebird
        :tickets: 2083

      The "implicit_returning" flag on create_engine() is
      honored if set to False.  (also in 0.6.7)

    .. change::
        :tags: informix
        :tickets: 2092

      Added RESERVED_WORDS informix dialect.
      (also in 0.6.7)

    .. change::
        :tags: ext
        :tickets: 2090

      The horizontal_shard ShardedSession class accepts the common
      Session argument "query_cls" as a constructor argument,
      to enable further subclassing of ShardedQuery. (also in 0.6.7)

    .. change::
        :tags: examples
        :tickets:

      Updated the association, association proxy examples
      to use declarative, added a new example
      dict_of_sets_with_default.py, a "pushing the envelope"
      example of association proxy.

    .. change::
        :tags: examples
        :tickets: 2090

      The Beaker caching example allows a "query_cls" argument
      to the query_callable() function.
      (also in 0.6.7)

.. changelog::
    :version: 0.7.0b2
    :released: Sat Feb 19 2011

    .. change::
        :tags: orm
        :tickets: 2053

      Fixed bug whereby Session.merge() would call the
      load() event with one too few arguments.

    .. change::
        :tags: orm
        :tickets: 2052

      Added logic which prevents the generation of
      events from a MapperExtension or SessionExtension
      from generating do-nothing events for all the methods
      not overridden.

    .. change::
        :tags: declarative
        :tickets: 2058

      Fixed regression whereby composite() with
      Column objects placed inline would fail
      to initialize.  The Column objects can now
      be inline with the composite() or external
      and pulled in via name or object ref.

    .. change::
        :tags: declarative
        :tickets: 2061

      Fix error message referencing old @classproperty
      name to reference @declared_attr
      (also in 0.6.7)

    .. change::
        :tags: declarative
        :tickets: 1468

      the dictionary at the end of the __table_args__
      tuple is now optional.

    .. change::
        :tags: sql
        :tickets: 2059

      Renamed the EngineEvents event class to
      ConnectionEvents.  As these classes are never
      accessed directly by end-user code, this strictly
      is a documentation change for end users.  Also
      simplified how events get linked to engines
      and connections internally.

    .. change::
        :tags: sql
        :tickets: 2055

      The Sequence() construct, when passed a MetaData()
      object via its 'metadata' argument, will be
      included in CREATE/DROP statements within
      metadata.create_all() and metadata.drop_all(),
      including "checkfirst" logic.

    .. change::
        :tags: sql
        :tickets: 2064

      The Column.references() method now returns True
      if it has a foreign key referencing the
      given column exactly, not just its parent
      table.

    .. change::
        :tags: postgresql
        :tickets: 2065

      Fixed regression from 0.6 where SMALLINT and
      BIGINT types would both generate SERIAL
      on an integer PK column, instead of
      SMALLINT and BIGSERIAL

    .. change::
        :tags: ext
        :tickets: 2054

      Association proxy now has correct behavior for
      any(), has(), and contains() when proxying
      a many-to-one scalar attribute to a one-to-many
      collection (i.e. the reverse of the 'typical'
      association proxy use case)

    .. change::
        :tags: examples
        :tickets:

      Beaker example now takes into account 'limit'
      and 'offset', bind params within embedded
      FROM clauses (like when you use union() or
      from_self()) when generating a cache key.

.. changelog::
    :version: 0.7.0b1
    :released: Sat Feb 12 2011

    .. change::
        :tags:
        :tickets:

      Detailed descriptions of each change below are
      described at:
      https://docs.sqlalchemy.org/en/latest/changelog/migration_07.html

    .. change::
        :tags: general
        :tickets: 1902

      New event system, supersedes all extensions, listeners,
      etc.

    .. change::
        :tags: general
        :tickets: 1926

      Logging enhancements

    .. change::
        :tags: general
        :tickets: 1949

      Setup no longer installs a Nose plugin

    .. change::
        :tags: general
        :tickets:

      The "sqlalchemy.exceptions" alias in sys.modules
      has been removed.   Base SQLA exceptions are
      available via "from sqlalchemy import exc".
      The "exceptions" alias for "exc" remains in
      "sqlalchemy" for now, it's just not patched into
      sys.modules.

    .. change::
        :tags: orm
        :tickets: 1923

      More succinct form of query.join(target, onclause)

    .. change::
        :tags: orm
        :tickets: 1903

      Hybrid Attributes, implements/supersedes synonym()

    .. change::
        :tags: orm
        :tickets: 2008

      Rewrite of composites

    .. change::
        :tags: orm
        :tickets:

      Mutation Event Extension, supersedes "mutable=True"

      .. seealso::

          :ref:`07_migration_mutation_extension`

    .. change::
        :tags: orm
        :tickets: 1980

      PickleType and ARRAY mutability turned off by default

    .. change::
        :tags: orm
        :tickets: 1895

      Simplified polymorphic_on assignment

    .. change::
        :tags: orm
        :tickets: 1912

      Flushing of Orphans that have no parent is allowed

    .. change::
        :tags: orm
        :tickets: 2041

      Adjusted flush accounting step to occur before
      the commit in the case of autocommit=True.  This allows
      autocommit=True to work appropriately with
      expire_on_commit=True, and also allows post-flush session
      hooks to operate in the same transactional context
      as when autocommit=False.

    .. change::
        :tags: orm
        :tickets: 1973

      Warnings generated when collection members, scalar referents
      not part of the flush

    .. change::
        :tags: orm
        :tickets: 1876

      Non-`Table`-derived constructs can be mapped

    .. change::
        :tags: orm
        :tickets: 1942

      Tuple label names in Query Improved

    .. change::
        :tags: orm
        :tickets: 1892

      Mapped column attributes reference the most specific
      column first

    .. change::
        :tags: orm
        :tickets: 1896

      Mapping to joins with two or more same-named columns
      requires explicit declaration

    .. change::
        :tags: orm
        :tickets: 1875

      Mapper requires that polymorphic_on column be present
      in the mapped selectable

    .. change::
        :tags: orm
        :tickets: 1966

      compile_mappers() renamed configure_mappers(), simplified
      configuration internals

    .. change::
        :tags: orm
        :tickets: 2018

      the aliased() function, if passed a SQL FromClause element
      (i.e. not a mapped class), will return element.alias()
      instead of raising an error on AliasedClass.

    .. change::
        :tags: orm
        :tickets: 2027

      Session.merge() will check the version id of the incoming
      state against that of the database, assuming the mapping
      uses version ids and incoming state has a version_id
      assigned, and raise StaleDataError if they don't
      match.

    .. change::
        :tags: orm
        :tickets: 1996

      Session.connection(), Session.execute() accept 'bind',
      to allow execute/connection operations to participate
      in the open transaction of an engine explicitly.

    .. change::
        :tags: orm
        :tickets:

      Query.join(), Query.outerjoin(), eagerload(),
      eagerload_all(), others no longer allow lists
      of attributes as arguments (i.e. option([x, y, z])
      form, deprecated since 0.5)

    .. change::
        :tags: orm
        :tickets:

      ScopedSession.mapper is removed (deprecated since 0.5).

    .. change::
        :tags: orm
        :tickets: 2031

      Horizontal shard query places 'shard_id' in
      context.attributes where it's accessible by the
      "load()" event.

    .. change::
        :tags: orm
        :tickets: 2032

      A single contains_eager() call across
      multiple entities will indicate all collections
      along that path should load, instead of requiring
      distinct contains_eager() calls for each endpoint
      (which was never correctly documented).

    .. change::
        :tags: orm
        :tickets:

      The "name" field used in orm.aliased() now renders
      in the resulting SQL statement.

    .. change::
        :tags: orm
        :tickets: 1473

      Session weak_instance_dict=False is deprecated.

    .. change::
        :tags: orm
        :tickets: 2046

      An exception is raised in the unusual case that an
      append or similar event on a collection occurs after
      the parent object has been dereferenced, which
      prevents the parent from being marked as "dirty"
      in the session.  Was a warning in 0.6.6.

    .. change::
        :tags: orm
        :tickets: 1069

      Query.distinct() now accepts column expressions
      as \*args, interpreted by the PostgreSQL dialect
      as DISTINCT ON (<expr>).

    .. change::
        :tags: orm
        :tickets: 2049

      Additional tuning to "many-to-one" relationship
      loads during a flush().   A change in version 0.6.6
      ([ticket:2002]) required that more "unnecessary" m2o
      loads during a flush could occur.   Extra loading modes have
      been added so that the SQL emitted in this
      specific use case is trimmed back, while still
      retrieving the information the flush needs in order
      to not miss anything.

    .. change::
        :tags: orm
        :tickets:

      the value of "passive" as passed to
      attributes.get_history() should be one of the
      constants defined in the attributes package.  Sending
      True or False is deprecated.

    .. change::
        :tags: orm
        :tickets: 2030

      Added a `name` argument to `Query.subquery()`, to allow
      a fixed name to be assigned to the alias object. (also in 0.6.7)

    .. change::
        :tags: orm
        :tickets: 2019

      A warning is emitted when a joined-table inheriting mapper
      has no primary keys on the locally mapped table
      (but has pks on the superclass table).
      (also in 0.6.7)

    .. change::
        :tags: orm
        :tickets: 2038

      Fixed bug where "middle" class in a polymorphic hierarchy
      would have no 'polymorphic_on' column if it didn't also
      specify a 'polymorphic_identity', leading to strange
      errors upon refresh, wrong class loaded when querying
      from that target. Also emits the correct WHERE criterion
      when using single table inheritance.
      (also in 0.6.7)

    .. change::
        :tags: orm
        :tickets: 1995

      Fixed bug where a column with a SQL or server side default
      that was excluded from a mapping with include_properties
      or exclude_properties would result in UnmappedColumnError. (also in 0.6.7)

    .. change::
        :tags: orm
        :tickets: 2046

      A warning is emitted in the unusual case that an
      append or similar event on a collection occurs after
      the parent object has been dereferenced, which
      prevents the parent from being marked as "dirty"
      in the session.  This will be an exception in 0.7. (also in 0.6.7)

    .. change::
        :tags: declarative
        :tickets: 2050

      Added an explicit check for the case that the name
      'metadata' is used for a column attribute on a
      declarative class. (also in 0.6.7)

    .. change::
        :tags: sql
        :tickets: 1844

      Added over() function, method to FunctionElement
      classes, produces the _Over() construct which
      in turn generates "window functions", i.e.
      "<window function> OVER (PARTITION BY <partition by>,
      ORDER BY <order by>)".

    .. change::
        :tags: sql
        :tickets: 805

      LIMIT/OFFSET clauses now use bind parameters

    .. change::
        :tags: sql
        :tickets: 1069

      select.distinct() now accepts column expressions
      as \*args, interpreted by the PostgreSQL dialect
      as DISTINCT ON (<expr>).  Note this was already
      available via passing a list to the `distinct`
      keyword argument to select().

    .. change::
        :tags: sql
        :tickets:

      select.prefix_with() accepts multiple expressions
      (i.e. \*expr), 'prefix' keyword argument to select()
      accepts a list or tuple.

    .. change::
        :tags: sql
        :tickets:

      Passing a string to the `distinct` keyword argument
      of `select()` for the purpose of emitting special
      MySQL keywords (DISTINCTROW etc.) is deprecated -
      use `prefix_with()` for this.

    .. change::
        :tags: sql
        :tickets: 2006, 2005

      TypeDecorator works with primary key columns

    .. change::
        :tags: sql
        :tickets: 1897

      DDL() constructs now escape percent signs

    .. change::
        :tags: sql
        :tickets: 1917, 1893

      Table.c / MetaData.tables refined a bit, don't allow direct
      mutation

    .. change::
        :tags: sql
        :tickets: 1950

      Callables passed to `bindparam()` don't get evaluated

    .. change::
        :tags: sql
        :tickets: 1870

      types.type_map is now private, types._type_map

    .. change::
        :tags: sql
        :tickets: 1982

      Non-public Pool methods underscored

    .. change::
        :tags: sql
        :tickets: 723

      Added NULLS FIRST and NULLS LAST support. It's implemented
      as an extension to the asc() and desc() operators, called
      nullsfirst() and nullslast().

    .. change::
        :tags: sql
        :tickets:

      The Index() construct can be created inline with a Table
      definition, using strings as column names, as an alternative
      to the creation of the index outside of the Table.

    .. change::
        :tags: sql
        :tickets: 2001

      execution_options() on Connection accepts
      "isolation_level" argument, sets transaction isolation
      level for that connection only until returned to the
      connection pool, for those backends which support it
      (SQLite, PostgreSQL)

    .. change::
        :tags: sql
        :tickets: 2005

      A TypeDecorator of Integer can be used with a primary key
      column, and the "autoincrement" feature of various dialects
      as well as the "sqlite_autoincrement" flag will honor
      the underlying database type as being Integer-based.

    .. change::
        :tags: sql
        :tickets: 2020, 2021

      Established consistency when server_default is present
      on an Integer PK column.  SQLA doesn't pre-fetch these,
      nor do they come back in cursor.lastrowid (DBAPI).
      Ensured all backends consistently return None
      in result.inserted_primary_key for these. Regarding
      reflection for this case, reflection of an int PK col
      with a server_default sets the "autoincrement" flag to False,
      except in the case of a PG SERIAL col where we detected a
      sequence default.

    .. change::
        :tags: sql
        :tickets: 2006

      Result-row processors are applied to pre-executed SQL
      defaults, as well as cursor.lastrowid, when determining
      the contents of result.inserted_primary_key.

    .. change::
        :tags: sql
        :tickets:

      Bind parameters present in the "columns clause" of a select
      are now auto-labeled like other "anonymous" clauses,
      which among other things allows their "type" to be meaningful
      when the row is fetched, as in result row processors.

    .. change::
        :tags: sql
        :tickets:

      TypeDecorator is present in the "sqlalchemy" import space.

    .. change::
        :tags: sql
        :tickets: 2015

      Non-DBAPI errors which occur in the scope of an `execute()`
      call are now wrapped in sqlalchemy.exc.StatementError,
      and the text of the SQL statement and repr() of params
      is included.  This makes it easier to identify statement
      executions which fail before the DBAPI becomes
      involved.

    .. change::
        :tags: sql
        :tickets: 2048

      The concept of associating a ".bind" directly with a
      ClauseElement has been explicitly moved to Executable,
      i.e. the mixin that describes ClauseElements which represent
      engine-executable constructs.  This change is an improvement
      to internal organization and is unlikely to affect any
      real-world usage.

    .. change::
        :tags: sql
        :tickets: 2028

      Column.copy(), as used in table.tometadata(), copies the
      'doc' attribute.  (also in 0.6.7)

    .. change::
        :tags: sql
        :tickets: 2023

      Added some defs to the resultproxy.c extension so that
      the extension compiles and runs on Python 2.4. (also in 0.6.7)

    .. change::
        :tags: sql
        :tickets: 2042

      The compiler extension now supports overriding the default
      compilation of expression._BindParamClause including that
      the auto-generated binds within the VALUES/SET clause
      of an insert()/update() statement will also use the new
      compilation rules. (also in 0.6.7)

    .. change::
        :tags: sql
        :tickets: 1921

      SQLite dialect now uses `NullPool` for file-based databases

    .. change::
        :tags: sql
        :tickets: 2036

      The path given as the location of a sqlite database is now
      normalized via os.path.abspath(), so that directory changes
      within the process don't affect the ultimate location
      of a relative file path.

    .. change::
        :tags: postgresql
        :tickets: 1083

      When explicit sequence execution derives the name
      of the auto-generated sequence of a SERIAL column,
      which currently only occurs if implicit_returning=False,
      now accommodates if the table + column name is greater
      than 63 characters using the same logic PostgreSQL uses. (also in 0.6.7)

    .. change::
        :tags: postgresql
        :tickets: 2044

      Added an additional libpq message to the list of "disconnect"
      exceptions, "could not receive data from server" (also in 0.6.7)

    .. change::
        :tags: mssql
        :tickets: 1833

      the String/Unicode types, and their counterparts VARCHAR/
      NVARCHAR, emit "max" as the length when no length is
      specified, so that the default length, normally '1'
      as per SQL server documentation, is instead
      'unbounded'.  This also occurs for the VARBINARY type..

      This behavior makes these types more closely compatible
      with PostgreSQL's VARCHAR type which is similarly unbounded
      when no length is specified.

    .. change::
        :tags: mysql
        :tickets: 1991

      New DBAPI support for pymysql, a pure Python port
      of MySQL-python.

    .. change::
        :tags: mysql
        :tickets: 2047

      oursql dialect accepts the same "ssl" arguments in
      create_engine() as that of MySQLdb.
      (also in 0.6.7)

    .. change::
        :tags: firebird
        :tickets: 1885

      Some adjustments so that Interbase is supported as well.
      FB/Interbase version idents are parsed into a structure
      such as (8, 1, 1, 'interbase') or (2, 1, 588, 'firebird')
      so they can be distinguished.
