- Determine the basic collection interface dynamically when adapting a collection to an interable

added info on foreign_keys attribute

- lazy loader can now handle a join condition where the "bound"
column (i.e. the one that gets the parent id sent as a bind
parameter) appears more than once in the join condition.
Specifically this allows the common task of a relation()
which contains a parent-correlated subquery, such as "select
only the most recent child item". [ticket:946]
- col_is_part_of_mappings made more strict, seems to be OK
with tests
- memusage will dump out the size list in an assertion fail

heisenbug in aisle 3

(when db.dispose is called in unitofwork test with sqlite, the first test that runs in memusage grows by two gc'ed objects on every iteration; then the problem vanishes.  doesnt matter what test runs in memusage.  doing a dispose() in memusage solves the problem also.  screwing wiht the mechanics of engine.dispose() only fix it when both the pool.dispose() *and* the pool.ressurect() are disabled.  its just a subtle python/pysqlite bug afaict)

- added generative where(<criterion>) method to delete()
and update() constructs which return a new object with
criterion joined to existing criterion via AND, just
like select().where().
- compile assertions use assertEquals()

- Added deferrability support to constraints

- psycopg2 can raise un-str()able exceptions; don't croak when trying to log them

Fix: deletes with schemas on MSSQL 2000 [ticket:967]

test for session close efficiency

Fix some mssql unit tests

Strip schema from access tables

Avoid using common keywords as field names: the test executes literal selects

check for unicode first before encoding

unit-of-work flush didn't close the failed transaction when the session was not in a transaction and commiting the transaction failed.

- Some more reST docstring corrections

- clean up the print version of the docs a bit [ticket:745]

- A few quick docstring typo fixes, including [ticket:766]

C-u 66 C-x f M-q

ChangeLog for r4115

- Enabled schema support on SQLite, added the temporary table namespace to table name reflection
- TODO: add sqlite to the standard alternate schema tests. a little tricky, because unlike CREATE SCHEMA, an ATTACH DATABASE won't survive a pool dispose...

- doc edits- thanks asmodai! [ticket:906]

better that it doesn't get a scalar loader callable

expire with synonyms [ticket:964]

- Autodetect mysql's ANSI_QUOTES mode, sometimes. [ticket:845]
  The dialect needs a hook run on first pool connect to detect this most of
  the time, and a refactor with Dialect-per-Connection to get it right all of
  the time. (It's a connection-session scoped setting with dialect-modifying
  behavior)

hmmm.

- Added free-form `DDL` statements, can be executed standalone or tied to the DDL create/drop lifecycle of Tables and MetaData. [ticket:903]
- Added DDL event hooks, triggers callables before and after create / drop.

*more* tweaks to avoid DEFAULT VALUES on sqlite

lock in replacing '%' with '%%'

- add dummy column to appease older SQLite verisons in unicode.py
- add test "escape_literal_column" comiler method to start addressing literal '%' character

- ColumnDefault callables can now be any kind of compliant callable, previously only actual functions were allowed.

forcibly clean out _sessions, _mapper_registry at test start to eliminate leftovers from other unit tests (from other test scripts) still stored in memory

add some extra assertions to ensure all mappers are gone after clear_mappers() (for [ticket:963])

- fixed reflection of Time columns on sqlite

- some consolidation of tests in select.py, moved
other tests to more specific modules
- added "now()" as a generic function; on SQLite and
Oracle compiles as "CURRENT_TIMESTAMP"; "now()"
on all others [ticket:943]

- Workaround for datetime quirk, LHS comparisons to SA expressions now work.

- Friendlier exception messages for unbound, implicit execution
- Implicit binding failures now raise UnboundExecutionError

- added "autocommit=True" kwarg to select() and text(),
as well as generative autocommit() method on select();
for statements which modify the database through some
user-defined means other than the usual INSERT/UPDATE/
DELETE etc., this flag will enable "autocommit" behavior
during execution if no transaction is in progress
[ticket:915]

- implemented RowProxy.__ne__ [ticket:945], thanks knutroy
- test coverage for same

- the startswith(), endswith(), and contains() operators
now concatenate the wildcard operator with the given
operand in SQL, i.e. "'%' || <bindparam>" in all cases,
accept text('something') operands properly [ticket:962]

- cast() accepts text('something') and other non-literal
operands properly [ticket:962]

escapedefaultstest passes on everything

moved default escaping test to its own test so oracle gets it

- Oracle and others properly encode SQL used for defaults
like sequences, etc., even if no unicode idents are used
since identifier preparer may return a cached unicode
identifier.

docstring fix

- next release will be 0.4.3
- fixed merge() collection-doubling bug when merging
transient entities with backref'ed collections.
[ticket:961]
- merge(dont_load=True) does not accept transient
entities, this is in continuation with the fact that
merge(dont_load=True) does not accept any "dirty"
objects either.

- "Passive defaults" and other "inline" defaults can now
be loaded during a flush() call if needed; in particular,
this allows constructing relations() where a foreign key
column references a server-side-generated, non-primary-key
column. [ticket:954]

- Added a simple @future test marker.

- Fixed little think-o in fails_if

- Fixed bug in polymorphic inheritance where incorrect
exception is raised when base polymorphic_on
column does not correspond to any columns within
the local selectable of an inheriting mapper more
than one level deep

encourage usage of union() and other composites as module-level

- added standalone "query" class attribute generated
by a scoped_session.  This provides MyClass.query
without using Session.mapper.  Use via:

MyClass.query = Session.query_property()

- Ignore jython debris

- Flipped join order of __radd__ on association proxied lists.

- IdentitySet binops no longer accept plain sets.

A little clarity tweak to r4093

Corrected behavior of get_cls_kwargs and friends

added an intro for the code sample so that its not construed as a "synopsis"

- query.join() can also accept tuples of attribute
name/some selectable as arguments.  This allows
construction of joins *from* subclasses of a
polymorphic relation, i.e.:

query(Company).\
join(
  [('employees', people.join(engineer)), Engineer.name]
)

Added notes about 2.3 improvements

Edits

whups, args in wrong order

more descriptive error message for m2m concurrency error

more capability added to reduce_columns

- Migrated zoomark to profiling.function_call_count(), tightened up the numbers.  Is there variation by platform too?  Buildbots will tell...

rein in r3840 find and replace rampage

- 2.3 fixup part three: 100% on postgres, mysql

- Removed some test bogosity

- Cover 2.3 Decimal fallback

- 2.3 fixup, part two: 100% passing for sqlite
  - added 2.4-style binops to util.Set on 2.3
  - OrderedSets pickle on 2.3
  - more lib/sqlalchemy set vs Set corrections
  - fixed InstrumentedSet.discard for 2.3
  - set, sorted compatibility for test suite
- added testing.fails_if decorator

clean up a little close() silliness

factor create_row_adapter into sql.util.row_adapter

further clarification on transaction state

fix rollback behavior with transaction context manager and failed two phase transactions

example of using try-catch to do transaction commit/rollback was wrong in the docs

- parent transactions weren't started on the connection when adding a connection to a nested session transaction.
- session.transaction now always refers to the innermost active transaction, even when commit/rollback are called directly on the session transaction object.
- when preparing a two-phase transaction fails on one connection all the connections are rolled back.
- two phase transactions can now be prepared.
- session.close() didn't close all transactions when nested transactions were used.
- rollback() previously erroneously set the current transaction directly to the parent of the transaction that could be rolled back to.
- autoflush for commit() wasn't flushing for simple subtransactions.

- Restored 2.3 compat. in lib/sqlalchemy
- Part one of test suite fixes to run on 2.3
  Lots of failures still around sets; sets.Set differs from __builtin__.set
  particularly in the binops. We depend on set extensively now and may need to
  provide a corrected sets.Set subclass on 2.3.

- Added source transformation framework for non-2.4 parser implementations
- test/clone.py can create and update (transformed) copies of the test suite
- Added Python 2.4 decorator -> 2.3 source transform

- Oracle assembles the correct columns in the result set
  column mapping when generating a LIMIT/OFFSET subquery,
  allows columns to map properly to result sets even
  if long-name truncation kicks in [ticket:941]

- some expression fixup:
- the '.c.' attribute on a selectable now gets an
entry for every column expression in its columns
clause; previously, "unnamed" columns like functions
and CASE statements weren't getting put there.  Now
they will, using their full string representation
if no 'name' is available.
- The anonymous 'label' generated for otherwise
unlabeled functions and expressions now propagates
outwards at compile time for expressions like
select([select([func.foo()])])
- a CompositeSelect, i.e. any union(), union_all(),
intersect(), etc. now asserts that each selectable
contains the same number of columns.  This conforms
to the corresponding SQL requirement.
- building on the above ideas, CompositeSelects
now build up their ".c." collection based on
the names present in the first selectable only;
corresponding_column() now works fully for all
embedded selectables.

check for session is none, [ticket:940]

Updated bit about coverage.py

- dynamic relations, when referenced, create a strong
reference to the parent object so that the query
still has a parent to call against even if the
parent is only created (and otherwise dereferenced)
within the scope of a single expression [ticket:938]

- default the root logger level only if unset

maintain the ordering of the given collection of columns when reducing so that primary key collections remain
ordered the same as in the mapped table

avoid unnecessary mapper.extension copy

finally, a really straightforward reduce() method which reduces cols
to the minimal set for every test case I can come up with, and
now replaces all the cruft in Mapper._compile_pks() as well as
Join.__init_primary_key().  mappers can now handle aliased selects
and figure out the correct PKs pretty well [ticket:933]

- select_table mapper turns straight join into aliased select + custom PK, to allow
joins onto select_table mappers
- starting a generalized reduce_columns func

added more (failing) tests to query, will need to fix [ticket:932] [ticket:933]

- query.join() can now accept class-mapped attributes
as arguments, which can be used in place or in any
combination with strings.  In particular this allows
construction of joins to subclasses on a polymorphic
relation, i.e.
query(Company).join(['employees', Engineer.name]),
etc.

- applying some refined versions of the ideas in the smarter_polymorphic
branch
- slowly moving Query towards a central "aliasing" paradigm which merges
the aliasing of polymorphic mappers to aliasing against arbitrary select_from(),
to the eventual goal of polymorphic mappers which can also eagerload other
relations
- supports many more join() scenarios involving polymorphic mappers in
most configurations
- PropertyAliasedClauses doesn't need "path", EagerLoader doesn't need to
guess about "towrap"

- _get_equivalents() converted into a lazy-initializing property; Query was calling it
for polymorphic loads which is really expensive
- surrogate_mapper adapts the given order_by, so that order_by can be against the mapped
table and is usable for sub-mappers as well.  Query properly calls select_mapper.order_by.

- testbase is gone, replaced by testenv
- Importing testenv has no side effects- explicit functions provide similar behavior to the old immediate behavior of testbase
- testing.db has the configured db
- Fixed up the perf/* scripts

- Undeclared SAWarnings are now fatal to tests as well.
- Fixed typo that was killing runs of individual named tests.

fixed NOT ILIKE

- added "ilike()" operator to column operations.
compiles to ILIKE on postgres, lower(x) LIKE lower(y)
on all others [ticket:727]

Reverted to False Firebird's supports_sane_rowcount
Slipped in: even if it seems it could be set to True, I'm still testing the rowcount affair

Try to reflect also the Sequence on the PK under Firebird

- Warnings are now issued as SAWarning instead of RuntimeWarning; util.warn() wraps this up.
- SADeprecationWarning has moved to exceptions. An alias remains in logging until 0.5.

Include column name in length-less String warning (more [ticket:912])

- unit test for r4048

- added a mapper() flag "eager_defaults"; when set to
True, defaults that are generated during an INSERT
or UPDATE operation are post-fetched immediately,
instead of being deferred until later.  This mimics
the old 0.3 behavior.