Merged from main tip, and resolved conflicts in mxodbc dialect and connector.

Setting default bindmethod to BIND_USING_SQLTYPE, since this should provide better type conversion performance.

Added decimalformat binding ( I thought this was committed earlier)

- pyodbc can do *some* unicode with sybase, python-sybase not at all.
Since python-sybase source code seems to be all from 2001 with no updates,
making pyodbc the default driver.

- added pyodbc for sybase driver.
- generalized the "freetds" / "unicode statements" behavior of MS-SQL/pyodbc
into the base Pyodbc connector, as this seems to apply to Sybase as well.
- generalized the python-sybase "use autocommit for DDL" into the pyodbc
connector.  With pyodbc, the "autocommit" flag on connection is used,
as Pyodbc seems to have more database conversation than python-sybase that
can't otherwise be suppressed.
- Some platforms will now interpret certain literal values
as non-bind parameters, rendered literally into the SQL
statement.   This to support strict SQL-92 rules that are
enforced by some platforms including MS-SQL and Sybase.
In this model, bind parameters aren't allowed in the
columns clause of a SELECT, nor are certain ambiguous
expressions like "?=?".  When this mode is enabled, the base
compiler will render the binds as inline literals, but only across
strings and numeric values.  Other types such as dates
will raise an error, unless the dialect subclass defines
a literal rendering function for those.  The bind parameter
must have an embedded literal value already or an error
is raised (i.e. won't work with straight bindparam('x')).
Dialects can also expand upon the areas where binds are not
accepted, such as within argument lists of functions
(which don't work on MS-SQL when native SQL binding is used).

- basic sybase+pyodbc support.  in particular this will impact freetds detection for MS-SQL as well.

Changed OurSQL to use supports_unicode_binds and supports_unicode_statements.

- mxodbc can use default execute() call
- modified SQLCompiler to support rendering of bind parameters as literal
inline strings for specific sections, if specified by the compiler
subclass, using either literal_binds=True passed to process() or any visit
method, or by setting to False the "binds_in_columns_clause" flag for SQL-92
compatible columns clauses..  The compiler subclass is responsible for
implementing the literal quoting function which should make use of the DBAPI's native
capabilities.
- SQLCompiler now passes **kw to most process() methods (should be all,
ideally) so that literal_binds is propagated.
- added some rudimentary tests for mxodbc.

corrected import statements forgotten on prior commit

Disabling tests for mssql+mxodbc where mxODBC cursor.execute chokes on invalid placement of bind parameter "?" within the SQL statement.

Fixes to pass numeric tests; now by default, the mxodbc connector natively returns Python Decimal data types from columns of type SQL.NUMERIC or SQL.DECIMAL

Added module docstring for mxodbc connector

- The except_() method now renders as MINUS on Oracle,
which is more or less equivalent on that platform.
[ticket:1712]

- Fixed bug which caused "row switch" logic, that is an
INSERT and DELETE replaced by an UPDATE, to fail when
version_id_col was in use. [ticket:1692]

- Added "version_id_generator" argument to Mapper, this is a
callable that, given the current value of the "version_id_col",
returns the next version number.  Can be used for alternate
versioning schemes such as uuid, timestamps.  [ticket:1692]

- added test for #1737
- the fix from r502f1a4f92d5 broke another rare use case, one-to-one on a PK/FK combo which apparently enables use_get.
 fortunate that another test waiting in trac reveals this.

removed junk pdb.set_trace()

Removed custom do_execute which called cursor.executedirect, after discussion with eGenix and zzzeek. Even though more tests pass with executedirect, it is not appropriate for default usage because it does not issue prepare statements to the db, and it forces Python type binding. The executedirect method should only be called when the API user specifically requests it for special case performance reasons.

adjust mxodbc imports to dialect level

merged mainline default branch

using executemany instead of executedirect, which passes more tests than with plain execute. Later we need to define logic to determine when to call the normal execute.

- The visit_pool() method of Dialect is removed, and replaced with
on_connect().  This method returns a callable which receives
the raw DBAPI connection after each one is created.   The callable
is assembled into a first_connect/connect pool listener by the
connection strategy if non-None.   Provides a simpler interface
for dialects.

whitespace fixes to improve readability (shortened excessively long lines, and one 5-space indentation block corrected to 4 spaces).

fix failing test due to sybase paramstyle

- name all the "sub" dialect components <DB><component>_<dialectname>, [ticket:1738]

- many incantations to get the tests to run reasonably
- executemany() for some reason uses some tiny buffer, overriding it
- we need to use the IDENTITY_INSERT thing

- initial working version of sybase, with modifications to the transactional
model to accomodate Sybase's default mode of "no ddl in transactions".
- identity insert not working yet.  it seems the default here might be the
opposite of that of MSSQL.
- reflection will be a full rewrite
- default DBAPI is python-sybase, well documented and nicely DBAPI compliant
except for the bind parameter situation, where we have a straightforward workaround
- full Sybase docs at: http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.help.ase_15.0/title.htm

starting to add notes for sybase

merge of the "database chart" diff

- Fixed bug in 0.6-reworked "many-to-one" optimizations
such that a many-to-one that is against a non-primary key
column on the remote table (i.e. foreign key against a
UNIQUE column) will pull the "old" value in from the
database during a change, since if it's in the session
we will need it for proper history/backref accounting,
and we can't pull from the local identity map on a
non-primary key column. [ticket:1737] (test is pending)

ongoing typos

gr and pysqlite

update link for sqlite3

the big table of all the DBAPIs

working dialect support into a chart

- further checks when running in WITH_UNICODE
- When WITH_UNICODE
mode is used in Python 2.xx, a large and scary warning
is emitted asking that the user seriously consider
the usage of this difficult mode of operation.
[ticket:1670]

callcount...

arg, oracle, bah

ensure with_unicode flag is false for cx_oracle < 5

merge tip

- Added "logging_name" argument to create_engine(), Pool() constructor
as well as "pool_logging_name" argument to create_engine() which
filters down to that of Pool.   Issues the given string name
within the "name" field of logging messages instead of the default
hex identifier string.  [ticket:1555]

adjust per a couple zxjdbc failures

only enable WITH_UNICODE when >= cx_Oracle v5

- query.get() now returns None if queried for an identifier
that is present in the identity map with a different class
than the one requested, i.e. when using polymorphic loading.
[ticket:1727]

merge tip

fix the timeout test once and for all

tweak to take advantage of returning support in executemany

disable interval tests on oracle+zxjdbc for now, and also test_fk_nonpassive

fix extending of a tuple

move the initial connect out of the profile zone so we don't get a method call hit on that

further refinement

merging master...

consolidate unicode/CLOB handling

adjust to allow mock DBAPIs

oursql doesn't like the cursor being reused without fetch being finished

merge from oracle WITH_UNICODE branch

- Added preliminary support for Oracle's WITH_UNICODE
mode.  At the very least this establishes initial
support for cx_Oracle with Python 3.
[ticket:1670]

Merged latest changes from the mainline (default branch)

these pass on +zxjdbc, seemingly because it lacks a sane rowcount

- introduce an optimizing type _NativeUnicodeMixin to oracle plus supporting
changes to Enum/SchemaType to re-support adaptation of string types.
This approach can be adapted by "conditional" unicode returning dialects
(i.e. pyodbc and possibly mxodbc) to remove the overhead
of isinstance(value, unicode) calls when the dialect returned type is
of dbapi.UNICODE, dbapi.NVARCHAR, etc.

think I came across a syntactical weirdism there

refine that a bit

adding windows-appropriate levels of pain to unicode handling

merge tds changes

add a third state to converts_unicode_strings - "conditional".  at the moment
this will have us do a check.  i.e. for MSSQL where NVARCHAR is unicode and VARCHAR is not.

Added a non-freetds specific exclusion for pyodbc

formatting

- query.scalar() now raises an exception if more than one
row is returned.  All other behavior remains the same.
[ticket:1735]

- Calling query.order_by() or query.distinct() before calling
query.select_from(), query.with_polymorphic(), or
query.from_statement() raises an exception now instead of
silently dropping those criterion. [ticket:1736]

Added decorators to suppress unwanted warning messages during testing (not working yet, but committed for review purposes).

Now using pyodbc execution context once again (to pass the test involving insert to trigger table)

comments explaining temporary hack for using executedirect

Converted mxODBC's raised Warning exceptions into normal Python warnings.

this resolves the returning failures from #1733

re-enable these tests

added better typing for integer expressions, since integer is implementing _DateAffinity

force an oracle test to pass.  this is as usual an extremely fringy test for a feature nobody should be using normally.

these fail for unknown reasons.  Seems to be potentially VARCHAR used with RETURNING, or out params, not sure.

fix this test for oracle so all types return datetime.date

this test requires a length for the varchar in mysql/oracle

- fix the sqlalchemy.test.schema.Column function to work with copies
- add sequences to new associationproxy tests
- test/ext passes 100% on oracle here

merged default tip

add autoincrement flags to decls

- the copy() method of Column now copies over uninitialized
"on table attach" events.  Helps with the new declarative
"mixin" capability.

- mark tests unsupported by sqlite unsupported by oracle as well

- fixed internal error which would occur if calling has()
or similar complex expression on a single-table inheritance
relation(). [ticket:1731]

merged latest commits from default branch on server

- Oracle 'DATE' now does not perform any result processing,
as the DATE type in Oracle stores full date+time objects,
that's what you'll get.  Note that the generic types.Date
type *will* still call value.date() on incoming values,
however.  When reflecting a table, the reflected type
will be 'DATE'.

- emphasized query.join() in ORM tutorial as per [ticket:1708]
- cleaned up tutorial w.r.t. eagerload, added a section for contains_eager as this function
is equally important
- added better linkages in sqlalchemy.orm reference documentation, updated antiquated
docs for contains_eager(), got aliased()/AliasedClass documented as well as Sphinx will
allow us

fixed up docs for execution_options() across all three locations.

- moved the logic within _BindParamClause which decides about coercing the bind's type
based on the compared type into AbstractType.   The new method is called _coerce_compared_value()
and receives the operator and the raw python value to be coerced.    TypeDecorator
overrides this to provude the "old" 0.5 behavior of coercing the other side of the expression
unconditonally.
- added docs to TypeDecorator attempting to explain this though they are a little verbose.
- added caveats to Interval, which in "non-native" mode can't really handle proper expression behavior.  the "typing" would have to move into the compiler, such that on a DB like SQLite we're actually wrapping left/right side into its epoch functions, etc., its a big job.  current infrastructure, as powerful as it is, still isn't at that level.

meaningless change

base tests pass

almost there, some tests failing still.

Improved the docstring of test_fetchid_trigger

merge latest tip.  practicing on mercurial.

still thinking about stuff here

Added docstring & comments explaining test_fetchid_trigger

working on getting operators/left hand type awareness into the "bind" coercion.  this system has to be figured out somehow

Temporary kludge to fix InterfaceError, in places where cursor.executedirect is needed instead of cursor.execute.

fix last commit