0.3 maintenance branch

  - added a check for joining from A->B using join(), along two
      different m2m tables.  this raises an error in 0.3 but is
      possible in 0.4 when aliases are used. [ticket:687]

mssql: indexes are now quoted when dropping from reflected tables [ticket:684]

mssql: added support for TIME type (simulated via DATETIME col) [ticket:679]

edits

edits

postgres cant do this particular test b.c. the default "public" schema is taken
as a blank "schema" argument on Table

hopefully resolved all the PG deadlocks occuring here

Merged lower case caching, fetching from r2955
Be sure to close rows fetched in reflection (if not autoclosed)
Fixed bind test, needed transactional storage engine for mysql

further adjustment to pool.get

assert timeout is 3 seconds, not 2

- a new mutex that was added in 0.3.9 causes the pool_timeout
feature to fail during a race condition; threads would
raise TimeoutError immediately with no delay if many threads
push the pool into overflow at the same time.  this issue has been
fixed.

Merged reference fixes from r2986

Better quoting of identifiers when manipulating schemas
Merged from r2981

info on db-specific types

- merged some more of the SessionTransaction connection-bound checks from 0.4
- _BinaryExpression.compare() checks for a base set of "commutative" operators and checks for itself in reverse if so
- added ORM-based unit test for the above, fixes [ticket:664]

 - foreign key specs can have any chararcter in their identifiers
     [ticket:667]

Properly escape table names when reflecting for mssql and sqlite [ticket:653]

bind/connectable compat, allow .bind = None
fix import for DBAPIError raise

Minor cleanups.

Be specfic when detecting "no table" exceptions.

- Added basic schema reflection coverage to main tests
- Fix stupid mysql typo (#662)
- Merged mysql osx/multibyte has_table from 0.4 (r2943)

- fixed max identifier length on postgres (63) [ticket:571]
- fixed doc typo ("in_" operator)
- misc indent stuff

- fixes for connection bound sessions, connection-bound compiled objects via metadata

fixes

fixes

spelling error

- fixed "ambiguous column" result detection, when dupe col names exist
in a result [ticket:657]

updated interval type for [ticket:595]

- added friendlier error checking for query.get() with too-short pk
- more docs

removed prints

- more docs
- got from_statement() to actually work with query, tests were not covering
- added auto-labeling of anonymous columns sent to add_column(), tests

- more docs
- some more query tests
- removed warnings from testbase to appease the buildbots

- columns can be overridden in a reflected table with a "key"
attribute different than the column's name, including for primary key
columns [ticket:650]
- more docs

- fixed unicode conversion in Oracle TEXT type

- converts cx_oracle datetime objects to Python datetime.datetime when
Python 2.3 used [ticket:542]

- mod operator '%' produces MOD [ticket:624]

- more docs
- query will unique tupled results
- fixed [ticket:605] which is for psycopg1 anyway...

more query methods, overhauliung docs for forwards 0.4 method

- test module turns warnings into exceptions so they can be tested for
- the two mapper PK tests should actually warn on the id column collision
- reverted abc_inheritance back to normal

- improved ability to get the "correct" and most minimal set of primary key
  columns from a join, equating foreign keys and otherwise equated columns.
  this is also mostly to help inheritance scenarios formulate the best
  choice of primary key columns.  [ticket:185]
- added 'bind' argument to Sequence.create()/drop(), ColumnDefault.execute()

changed password field length to 15 to fix [ticket:656]

rearrange sqlite dialect initialization to be able to warn about pysqlite1 being too old. fixes #654

Fix setup for standalone sequence test

Refinement for r2890, column names should remain unicode.

Swap imports order, removed trailing whitespace from varchar test data

- a warning is issued by Mapper when two primary key columns of the
same name are munged into a single attribute.  this happens frequently
when mapping to joins (or inheritance).

- composite primary key is represented as a non-keyed set to allow for
composite keys consisting of cols with the same name; occurs within a
Join.  helps inheritance scenarios formulate correct PK.
- ticket #185 reopened.  still need to get Join to produce a minmal PK for fk'ed columns

- Keep reflected strings in the connection encoding, not unicode.  For now.

- the various "engine" arguments, such as "engine", "connectable",
"engine_or_url", "bind_to", etc. are all present, but deprecated.
they all get replaced by the single term "bind".  you also
set the "bind" of MetaData using
metadata.bind = <engine or connection>.  this is part of 0.4
forwards compatibility where "bind" is the only keyword.
[ticket:631]

Correct error message for concurrent delete exceptions, fixes #586

dont cache reflected domains, lookup each time

- converted mapper.py unit test to 0.4's four separate mapper.py, query.py, eager_relations.py, lazy_relations.py.
tests 0.4 forwards compatibility for [ticket:631]
- fixed "reset_joinpoint()" in query to actually work, when the same table appears in two join()s it reuses that
same table as a joinpoint the way 0.4 does.

- Patch up MySQL reflection issues with old server versions, alpha drivers,
  quoting, and connection encoding.

mssql: preliminary support for using scope_identity() with pyodbc

mssql now able to reflect start and increment values for identity columns

further refinements to the previous session.expunge() fix

fixed small expunge() bug where object might not be present in session

changed "_source_column" to simpler "_distance"

more "column targeting" enhancements..columns have a "depth" from their ultimate source column so that corresponding_column() can find the column that is "closest" (i.e. fewest levels of proxying) to the requested column

Fix port option handling for mssql/pyodbc [ticket:634]

- ForeignKey to a table in a schema thats not the default schema
requires the schema to be explicit; i.e. ForeignKey('alt_schema.users.id')
- the fix in "schema" above fixes postgres reflection of foreign keys from an
alt-schema table to a public schema table

discourage usage of always_refresh

edits

oh wow, confused "implicit" with "connectionless"

edits

more edits

fixes

- rewrote dbengine doc
- some changes to metadata doc, no Bound/Dynamic metadata mentioned
- fixed --file flag in genhtml.py

Tweak docs, very minor DMD compatability tweak

- Deprecated DynamicMetaData- use ThreadLocalMetaData or MetaData instead
- Deprecated BoundMetaData- use MetaData instead
- Removed DMD and BMD from documentation

- replaced calls for mapper.props in Query with mapper.get_property(),
which resolves synonyms.  fixes [ticket:598] for join/join_to/join_via/with_parent

css tweak

removed superfluous reapplying of options to self

Merged OrderedDict fixes from r2843 (0.4)

improved handling of exceptions upon __init__(): will preserve the stack
trace of the original __init__ exception; errors raised during session.expunge() will be
reported as warnings

- adjustments to pool locking test to fail on OSX
- restored conditional locking to pool, for all conditions of max_overflow > -1

added proper cascade for deletes

- added a mutex to QueuePool's "overflow" calculation to prevent a race
condition that can bypass max_overflow; merged from 0.4 branch r2736-2738.
also made the locking logic simpler, tried to get the test to create a
failure on OSX (not successful)

- MetaData and all SchemaItems are safe to use with pickle.  slow
table reflections can be dumped into a pickled file to be reused later.
Just reconnect the engine to the metadata after unpickling. [ticket:619]

postgres:
    - added support for reflection of domains [ticket:570]
    - types which are missing during reflection resolve to Null type
      instead of raising an error
    - moved reflection/types/query unit tests specific to postgres to new
      postgres unittest module

eek!  wrong tranasctional command for like, years now....

added extra session.clear() to enable example to work

fix to "populate_existing"

- fix to the "column_prefix" flag so that the mapper does not
trip over synonyms (and others) that are named after the column's actual
"key" (since, column_prefix means "dont use the key").

some errors of droppedm mysql connections weren't being caught by the disconnect detecting logic, fixes #625

better error message for NoSuchColumnError, fix ticket #607

add missing grouping for compound selects. fixes ticket #623

fix #624, modulo operator escaping on mysql and postgres
someone should test this with oracle, firebird and sql server also

fix precedence of between (ticket #621)

- fixed precedence of operators so that parenthesis are correctly applied
[ticket:620]
- calling <column>.in_() (i.e. with no arguments) will return
"CASE WHEN (<column> IS NULL) THEN NULL ELSE 0 END = 1)", so that
NULL or False is returned in all cases, rather than throwing an error
[ticket:545]

added test for correlation of scalar subqueries to a JOIN object

- fixed "where"/"from" criterion of select() to accept a unicode string
in addition to regular string - both convert to text()

- added dialect flag "auto_convert_lobs", defaults to True; will cause any
LOB objects detected in a result set to be forced into OracleBinary
so that the LOB is read() automatically, if no typemap was present
(i.e., if a textual execute() was issued).

- added standalone distinct() function in addition to column.distinct()
[ticket:558]

- forwards-compatibility with 0.4: added one(), first(), and
all() to Query
- added selectone_by() to assignmapper

- added synchronization to the mapper() construction step, to avoid
thread collections when pre-existing mappers are compiling in a
different thread [ticket:613]

- fixed very stupid bug when deleting items with many-to-many
uselist=False relations

orig_set is a Set [ticket:614]

- finally figured out how to get setuptools version in, available
as sqlalchemy.__version__ [ticket:428]