light docstring tweaks to the pool
more pedantic DBAPI -> DB-API changes in docstrings

CHANGES for r3372

- Connection.begin() no longer accepts nested=True, a possible source of confusion as two forms of nesting are supported.  SAVEPOINT-style nesting logic is now contained soley in begin_nested().
- Docstring love for the engine package.  More is needed.

ReST docstring fix

mssql unit test fixes

One more change of preparer() to identifier_preparer

pyflakes mop-up

Use identifier_preparer instead of preparer()

Fix broken imports

docstring compile fixup

adding an "already exists" catch for CREATE DOMAIN

1. Module layout.  sql.py and related move into a package called "sql".
2. compiler names changed to be less verbose, unused classes removed.
3. Methods on Dialect which return compilers, schema generators, identifier preparers
have changed to direct class references, typically on the Dialect class itself
or optionally as attributes on an individual Dialect instance if conditional behavior is needed.
This takes away the need for Dialect subclasses to know how to instantiate these
objects, and also reduces method overhead by one call for each one.
4. as a result of 3., some internal signatures have changed for things like compiler() (now statement_compiler()), preparer(), etc., mostly in that the dialect needs to be passed explicitly as the first argument (since they are just class references now).  The compiler() method on Engine and Connection is now also named statement_compiler(), but as before does not take the dialect as an argument.

5. changed _process_row function on RowProxy to be a class reference, cuts out 50K method calls from insertspeed.py

- fixed prefixes= argument to select()
- mysql can now generate DISTINCT or ALL for queries, select(..., distinct='ALL')
- documented 'prefixes' arg to select()
- rearranged doc order for select args to mirror that of a generated statement
- went nutty and fixed wrapping and line length on most docstrings in sql.py

- modified SQL operator functions to be module-level operators, allowing
  SQL expressions to be pickleable [ticket:735]

- small adjustment to mapper class.__init__ to allow for Py2.6 object.__init__()
  behavior

- Added a "legacy" adapter to types, such that user-defined TypeEngine
  and TypeDecorator classes which define convert_bind_param()/convert_result_value()
  will continue to function.  Also supports calling the super() version of
  those methods.

add a test for dupe tables in MetaData

- added close() method to Transaction.  closes out a transaction using rollback
  if it's the outermost transaction, otherwise just ends without affecting
  the outer transaction.

- transactional and non-transactional Session integrates better with bound
  connection; a close() will ensure that connection transactional state is
  the same as that which existed on it before being bound to the Session.

transactional session rolls back bound connection

- threadlocal TLConnection, when closes for real, forces parent TLSession
to rollback/dispose of transaction

update activemapper backrefs for r3340

dont commandeer warnings into logger

- turned twophase=True on in test
- TLEngine raises notimplemented for two-phase

reinstated two_phase test.  currently it passes on PG with and without threadlocal.

merge changset [3347] into trunk

- added extra argument con_proxy to ConnectionListener interface checkout/checkin methods
- changed testing connection closer to work on _ConnectionFairy instances, resulting in
pool checkins, not actual closes
- disabled session two phase test for now, needs work
- added some two-phase support to TLEngine, not tested
- TLTransaction is now a wrapper

Merge [3345] into trunk. Unit test still TODO

Disable MSSQL unicode statements on UCS-4 platforms, ticket #731

- session transaction closing tweak for threadlocal
- connection-rollback decorator only fires on unhandled testing exceptions

added a testing decorator that mops up wayward connections

removed ridiculous LOrderedProp object

revert the _DefaultExtension thing, it added function calls

- moved test/orm/fixtures.py to testlib
- flattened mapper calls in _instance() to operate directly
through a default MapperExtension
- more tests for ScopedSession, fixed [ticket:746]
- threadlocal engine propagates **kwargs through begin()

it's a non-stop formatting fiesta

formatting fiesta

Added session.prune(), releases unused objects in strong-ref identity maps.

- fix to bind param processing such that "False" values (like blank strings)
  still get processed/encoded

new changelog with betas

bump

needed orm import

bump

added remove() coverage....

add length to str for pk usage

added support for string date passthru in sqlite

added 'inherit_foreign_keys' arg to mapper()

use threading.local if available
speed up ThreadLocal for python 2.3 [ticket:743]
clean in topo (in patch from [ticket:743])

fix hasattr typo [ticket:744]

stopgap, need a general strategy for raising readable exceptions for unicode content

-removed print statements
- removeld errant classmethod on remove()

mass has_key->__contains__ migration, [ticket:738]

- moved unicode schema ORM tests to unitofwork.py tests.  mostly
is to test mappers so limited DB support (really hard to get these unicode schemas
to work...)
- fixed [ticket:739]

- cleanup, converted unitofwork.py to standard fixtures

removed init_attr() call, which has shown to not increase performance

- merged "fasttypes" branch.  this branch changes the signature
of convert_bind_param() and convert_result_value() to callable-returning
bind_processor() and result_processor() methods.  if no callable is
returned, no pre/post processing function is called.
- hooks added throughout base/sql/defaults to optimize the calling
of bind param/result processors so that method call overhead is minimized.
special cases added for executemany() scenarios such that unneeded "last row id"
logic doesn't kick in, parameters aren't excessively traversed.
- new performance tests show a combined mass-insert/mass-select test as having 68%
fewer function calls than the same test run against 0.3.
- general performance improvement of result set iteration is around 10-20%.

cleanup

revert previous change; had misunderstood context

fudge to make SQL asserts work reliably with MSSQL

Make versioningtest.test_basic only assert when the dbapi support sane_rowcount

added sqlite/sa "unprofiled" raw time tests

added full fetching of result columns, cut overall size to 50000

a mass insert/ select benchmarking test, from
http://pyinsci.blogspot.com/2007/07/fastest-python-database-interface.html

adjustment to table_names test such that the DB can have extra tables around

removed assertion for "no tables in db"

commented out unicode foriegn keys for now, not working on mysql or postgres

attempt to get SessionTest to close transactions better

- fixed endless loop
- fixed perf imports in masseagerload

- base_mapper() becomes a plain attribute
- session.execute() and scalar() can search for a Table with which to bind
from using the given ClauseElement
- session automatically extrapolates tables from mappers with binds,
also uses base_mapper so that inheritance hierarchies bind automatically
- moved ClauseVisitor traversal back to inlined non-recursive

added engine_from_config() function for helping to create_engine()
from an .ini style config

docstirng...

added scoped session test independent of Session.mapper test

- a rudimental SessionExtension class has been added, allowing user-defined
  functionality to take place at flush(), commit(), and rollback() boundaries.

- generalized a SQLCompileTest out of select.py, installed
into dialect/mssql.py, dialect/oracle.py, sql/generative.py
- fixed oracle issues [ticket:732], [ticket:733], [ticket:734]

adjusted mysql autoload from a named schema, esp. for windows

Removed unused imports, other import adjustments per pyflakes

Centralized some `try: import foo except: import other as foo` imports in util

Added more unicode foreign key tests for [ticket:729]

auto-commit after LOAD DATA INFILE for mysql
caught a couple more uncompiled regexps

- got is_subquery() working in the case of compound selects, test for ms-sql

removed ms-sql unsupporteds

- fixed compiler bug in mssql
- marked as unsupported for mssql all two-phase and nested transcation tests
- marked as unsupported for mssql various transactional/session tests which require two connections looking at uncommitted/external data at the same time (ms-sql cant handle it)
- put better explicit closeout step in unitofwork.py tests to appease ms-sqls hard locking

Close SQLite databases before deleting file, so the lock is released, important on Windows

MSSQL: disable new 0.4 tests that cause hangs

edits

- scoped_session docs
- added remove() method to scoped_session

Fix missing import of 'operator'

added "should_commit()" hook to ExecutionContext.  dialects can override with specific tests

Bump.

typos

added a brief migration guide

two tests which assumed autoincrement=False for integer PK columns now require it
to be explicit due to r3255.

Docs.

Allow auto_increment on any pk column, not just the first.

Added an exception hierarchy shadowing DB-API exc types
No more generic SQLErrors wrappers- the shadow type matching the DB-API error is raised. [ticket:706]
SQLError is now (also) DBAPIError.
DBAPIError and subtype constructors will refuse to wrap a SystemExit or KeyboardInterrupt, returningthe original interrupt exception instead of a new instance. [ticket:689]
Added a passthroughs for SE/KI exceptions in a couple except-and-discard situations

inlined encoding of result column names

- precompiled regexp for anonymous labels
- has_key()->__contains__()

Bake the version number into the source during packaging.

- removed _calculate_correlations() methods, removed correlation_stack, select_stack;
all are merged into a single stack thats all within ansicompiler.  clause visiting cut down
significantly.

  - case_sensitive=(True|False) setting removed from schema items, since
    checking this state added a lot of method call overhead and there was
    no decent reason to ever set it to False.  Table and column names which are
    all lower case will be treated as case-insenstive (yes we adjust for
    Oracle's UPPERCASE style too).

attempting to get oracle XID to work.  not there yet.

by popular demand, mysql reflection is now a single round-trip and uses a parse of SHOW CREATE TABLE ddl [ticket:612]
the ANSI_QUOTES mode is now supported
halfway there for auto_increment on secondary columns [ticket:649]
indexes are now reflected [ticket:663]

repaired oracle savepoint implementation