sequence/default adjustments to allow postgres 8.1 tests to function

pg formats sequence name, more quote test fixes

some tweaks to oracle casing...

- added case_sensitive argument to MetaData, Table, Column, determines
itself automatically based on if a parent schemaitem has a non-None
setting for the flag, or if not, then whether the identifier name is all lower
case or not.  when set to True, quoting is applied to identifiers with mixed or
uppercase identifiers.  quoting is also applied automatically in all cases to
identifiers that are known to be reserved words or contain other non-standard
characters. various database dialects can override all of this behavior, but
currently they are all using the default behavior.  tested with postgres, mysql,
sqlite.  needs more testing with firebird, oracle, ms-sql. part of the ongoing
work with [ticket:155]

- deregister Table from MetaData when autoload fails; [ticket:289]

- fix to using query.count() with distinct, **kwargs with SelectResults
count() [ticket:287]

- changed "invalidate" semantics with pooled connection; will
instruct the underlying connection record to reconnect the next
time its called.  "invalidate" will also automatically be called
if any error is thrown in the underlying call to connection.cursor().
this will hopefully allow the connection pool to reconnect to a
database that had been stopped and started without restarting
the connecting application [ticket:121]

[ticket:266] constraint name in PrimaryKeyConstraint

doc bug [ticket:278]

- added "timezone=True" flag to DateTime and Time types.  postgres
so far will convert this to "TIME[STAMP] (WITH|WITHOUT) TIME ZONE",
so that control over timezone presence is more controllable (psycopg2
returns datetimes with tzinfo's if available, which can create confusion
against datetimes that dont).
[ticket:275]

added "dev" tag to default setup
some extra README

fixed inaccuracies regarding "connectable" parameter sent to create/drop

TODO for oracle

added limit/offset to union queries

- cleanup on connection methods + documentation.  custom DBAPI
arguments specified in query string, 'connect_args' argument
to 'create_engine', or custom creation function via 'creator'
function to 'create_engine'.
- added "recycle" argument to Pool, is "pool_recycle" on create_engine,
defaults to 3600 seconds; connections after this age will be closed and
replaced with a new one, to handle db's that automatically close
stale connections [ticket:274]

[ticket:282]

the "check for orphans" step will cascade the delete operation to child objects.

- urls support escaped characters in passwords [ticket:281]

sqlite dialects can be created without pysqlite installed

- unit tests updated to run without any pysqlite installed; pool
test uses a mock DBAPI

working on sequence quoting support....

postgres reflection uses dialect-wide preparer

refactoring of ANSIIdentifierPreparer to be one instance per-dialect, simplified caching

- postgres reflection moved to use pg_schema tables, can be overridden
with use_information_schema=True argument to create_engine
[ticket:60], [ticket:71]
- added natural_case argument to Table, Column, semi-experimental
flag for use with table reflection to help with quoting rules
[ticket:155]

added a compile check to instances()

[ticket:280] statement execution supports using the same BindParam
object more than once in an expression; simplified handling of positional
parameters.  nice job by Bill Noon figuring out the basic idea.

- unit-of-work does a better check for "orphaned" objects that are
part of a "delete-orphan" cascade, for certain conditions where the
parent isnt available to cascade from.
- it is now invalid to declare a self-referential relationship with
"delete-orphan" (as the abovementioned check would make them impossible
to save)
- improved the check for objects being part of a session when the
unit of work seeks to flush() them as part of a relationship..

more fixes for [ticket:269], added MSMediumBlob type

commit should be outside of the try/except; else when commit fails, rollback gets called which is technically invalid (although SA transaction probably lets it slide...this should also possibly be made more strict)

if a contextual session is established via MapperExtension.get_session
(as it is using the sessioncontext plugin, etc), a lazy load operation
will use that session by default if the parent object is not
persistent with a session already.

[ticket:277] check if pg/oracle sequence exists.  checks in all cases before CREATE SEQUENCE/ DROP SEQUENCE

added "requires_quotes" step, subclasses of ANSIIdentifierPreparer can override

fixes for threadless python compiles

- eesh !  the tutorial doctest was broken for quite some time.
- add_property() method on mapper does a "compile all mappers"
step in case the given property references a non-compiled mapper
(as it did in the case of the tutorial !)

the latest...

modifcation to unitofwork to not maintain ordering within the
"new" list or within the UOWTask "objects" list; instead, new objects
are tagged with an ordering identifier as they are registered as new
with the session, and the INSERT statements are then sorted within the
mapper save_obj.  the INSERT ordering has basically been pushed allthe way
to the end of the flush cycle. that way the various sorts and
organizations occuring within UOWTask (particularly the circular task
sort) dont have to worry about maintaining order (which they werent anyway)

fix to __eq__ method in a test object

improved error message when a backref conflicts with a column-based property

added MSTinyInteger to MS-SQL [ticket:263]

fixed construction of order_by with distinct query

0.2.7 prep

some fixes to sqlite datetime organization, was improperly reflecting
the "date" type as a "datetime"

fixes to types so that database-specific types more easily used;
fixes to mysql text types to work with this methodology
[ticket:269]

[ticket:268]

refactored ANSIIdentifierPreparer to be visitor based; minimizes escaping operations
and isinstance()/duck-typing calls

turned off default case-folding rules as they wreak havoc with the current unittests,
temporary isintance() checks in ASNIIdentifierPreparer which will be replaced with visit_
methodology

added docs for ON UPDATE/DELETE, identifier quoting

 quoting facilities set up so that database-specific quoting can be
turned on for individual table, schema, and column identifiers when
used in all queries/creates/drops.  Enabled via "quote=True" in
Table or Column, as well as "quote_schema=True" in Table.  Thanks to
Aaron Spike for his excellent efforts.  [ticket:155]

comment

[ticket:251]

removed superfluous **params

SelectResults will use a subselect, when calling an aggregate (i.e.
max, min, etc.) on a SelectResults that has an ORDER BY clause
[ticket:252]

reflected 'mediumint' type

inheritance check uses issubclass() instead of direct __mro__ check
to make sure class A inherits from B, allowing mapper inheritance to more
flexibly correspond to class inheritance [ticket:271]

added "nowait" flag to Select() [ticket:270]

fixed ms-sql connect() to work with adodbapi

moved rollback catch to mysql module...

fix mysql borkage

fix mysql borkage

added __contains__ to OrderedProperties, so that rabbit is not in there

all create()/drop() calls have a keyword argument of "connectable".
"engine" is deprecated. fixes [ticket:255]

added an objectstore clear

fix to lazy loads when mapping to joins

adjusted __getstate__ on InstrumentedList to further avoid callables getting stuck in there...

fixed possible error in mysql reflection where certain versions
return an array instead of string for SHOW CREATE TABLE call

added start of a many-to-many test

fixed small pickle bug with lazy loaders [ticket:265]

improvement over previous changeset:
SingletonThreadPool has a size and does a cleanup pass, so that
only a given number of thread-local connections stay around (needed
for sqlite applications that dispose of threads en masse)

temporary workaround dispose_local() added to SingletonThreadPool
for sqlite applications that dispose of threads en masse

added reflected 'tinyint' type to MS-SQL [ticket:263]

fixed mysql reflection of default values to be PassiveDefault

adjustments to pool stemming from changes made for [ticket:224].
overflow counter should only be decremented if the connection actually
succeeded.  added a test script to attempt testing this.

oops:  committed the rest of [changeset:1759], removed print in sqlite + restored error check in Join

- better check for ambiguous join conditions in sql.Join; propigates to a
better error message in PropertyLoader (i.e. relation()/backref()) for when
the join condition can't be reasonably determined.
- sqlite creates ForeignKeyConstraint objects properly upon table
reflection.

r/m _reset method

expand explanation of Query methods

add update method

fix for when default is zero

typo fix noticed by R Munn

doc update

auto-execute delete stmts

add mappedtable.delete support

soup.engine property

PassiveDefault('?') for autoloaded sqlite defaults

(no complaints on-list so I'm checking this in...  go ahead and revert if I'm stepping on any toes here, Mike)

custom primary/secondary join conditions in a relation *will* be propigated
to backrefs by default.  specifying a backref() will override this behavior.

oracle boolean type [ticket:257]

[ticket:256] propigating url.query arguments to connect() function for all db's

removed erroneous "on_update" example for PassiveDefault

fixed anchor tag

[ticket:254]

with_labels support

fix outdated link into SA docs for Query objects

de-tabbify

ReST-ify docstring

small join api change

with_labels stuff doesn't quite work yet -- needs that select(from_obj=[join]) support -- so no doctest

fixed reflection of foreign keys to autoload the referenced table
if it was not loaded already, affected postgres, mysql, oracle.
fixes the latest in [ticket:105]

schema support for sqlsoup

fix doctests by ensuring consistent sort order via __cmp__; add join support

_selectable interface; allows sqlsoup to pass its classes to Join and have the underlying Table pulled out

fix doctest integration