- the "foreign_key" attribute on Column and ColumnElement in general
    is deprecated, in favor of the "foreign_keys" list/set-based attribute,
    which takes into account multiple foreign keys on one column.
    "foreign_key" will return the first element in the "foreign_keys" list/set
    or None if the list is empty.
- added a user test to the relationships test, testing various new things this
change allows

assorted firebird fixes from Lele Gaifax

some cleanup

improved exceptions for closed connections

fix "no engine found" to raise explicit error, [ticket:326]

rollback last change until we figure out how to check for engine without exception

better error message for unconnected DynamicMetaData [ticket:326]

add compound-where example

[ticket:324]

r/m sqlsoup.NoSuchTableError (SA proper takes care of that now)
add sqlsoup.PKNotFoundError

continued cleanup

various cleanup etc.

 - "custom list classes" is now implemented via the "collection_class"
    keyword argument to relation().  the old way still works but is
    deprecated [ticket:212]

 - Function objects know what to do in a FROM clause now.  their
    behavior should be the same, except now you can also do things like
    select(['*'], from_obj=[func.my_function()]) to get multiple
    columns from the result, or even use sql.column() constructs to name the
    return columns [ticket:172].  generally only postgres understands the
    syntax (and possibly oracle).

formatting fixup, etc.

- added auto_setinputsizes=False to oracle dialect.  if true, all executions will get setinputsizes called ahead of time.
- some tweaks to the types unittest for oracle.  oracle types still need lots more work.

fixed super call

- removed "extension()" MapperOption
- TypeEngine objects can report on DBAPI types
- added set_input_sizes() to default dialect
- oracle dialect gets Timestamp type added, may need to call
set_input_sizes() to make it work with sub-second resolution [ticket:304]

- merged loader_strategies branch into trunk.
- this is a wide refactoring to "attribute loader" and "options" architectures.
ColumnProperty and PropertyLoader define their loading behaivor via switchable
"strategies", and MapperOptions no longer use mapper/property copying
in order to function; they are instead propigated via QueryContext
and SelectionContext objects at query/instnaces time.
All of the copying of mappers and properties that was used to handle
inheritance as well as options() has been removed and the structure
of mappers and properties is much simpler and more clearly laid out.

- added profiling to massave
- adjusted the formatting for per-instance loggers to limit the number
of loggers that get created in memory.

adjustment to default timeout

edits

further str() on values that may come back as unicode

[ticket:318] has a user receiving back a unicode from a SHOW CREATE TABLE for some reason

 - fixed condition that occurred during reflection when a primary key
    column was explciitly overridden, where the PrimaryKeyConstraint would
    get both the reflected and the programmatic column doubled up

long changelist, adding some formatting

- internal refactoring to mapper instances() method to use a
SelectionContext object to track state during the operation.
SLIGHT API BREAKAGE: the append_result() and populate_instances()
methods on MapperExtension have a slightly different method signature
now as a result of the change; hoping that these methods are not
in widespread use as of yet.

- doc edit
- i have no idea what a SynonymProperty was supposed to be for

- added some dependency logging
- moved the ClauseSynchronizer compile from properties to dependency where its used

remove print statement

mass saver for profiling mem usage....

[ticket:309]

tweaks for mysql

fix PK redefinition

more edits

rearrangement of docs for [ticket:310]

raise proper AttributeError

- more adjustments to the eager load table finder to work with existing mappings
against selects and query-created limit/offset subselects
- added eagertest3 to orm/alltests.py

the new eagerloading test suite mentioned in the previous commit

- added test suite to test improved from_obj/join behavior with Query/eagerloading/SelectResults
- EagerLoader looks more carefully for the correct Table/Join/FromClause to bind its outer join onto
- sqlite boolean datatype converts bind params from python booleans to integer
- took out assertion raise from 'name' property of CompoundSelect

decruftify

- pool will auto-close open cursors, or can be configured to raise an error instead
- consolidated scalar() calls into ResultProxy scalar(), fixed ResultProxy scalar() to
apply typing rules
- general de-cruftification of ClauseElement/Compiled (yes i know theres crufty things everywhere)

- specifying joins in the from_obj argument of query.select() will
replace the main table of the query, if the table is somewhere within
the given from_obj.  this makes it possible to produce custom joins and
outerjoins in queries without the main table getting added twice.
[ticket:315]
- added join_to and outerjoin_to transformative methods to SelectResults,
to build up join/outerjoin conditions based on property names. also
added select_from to explicitly set from_obj parameter.
- factored "results" arrays from the mapper test suite and into the
"tables" mapper
- added "viewonly" param to docs

- added an automatic "row switch" feature to mapping, which will
detect a pending instance/deleted instance pair with the same
identity key and convert the INSERT/DELETE to a single UPDATE
- "association" mappings simplified to take advantage of
automatic "row switch" feature
- fixes [ticket:311]

NCHAR and NVARCHAR support for MS-SQL. Patch from Kent Johnson

added "viewonly" flag to allow relations that dont affect flush()

Simplified MSSQL table reflection code
  added support for multi-column foreign keys

fix misspelled func calls

commented out open cursor check, until resolution of [ticket:312]

made echo param more doc-friendly

doc edits, moved object display in uowdumper to be hex, fixed test runner in parseconnect

- logging is now implemented via standard python "logging" module.
"echo" keyword parameters are still functional but set/unset
log levels for their respective classes/instances.  all logging
can be controlled directly through the Python API by setting
INFO and DEBUG levels for loggers in the "sqlalchemy" namespace.
class-level logging is under "sqlalchemy.<module>.<classname>",
instance-level logging under "sqlalchemy.<module>.<classname>.<hexid>".
Test suite includes "--log-info" and "--log-debug" arguments
which work independently of --verbose/--quiet.  Logging added
to orm to allow tracking of mapper configurations, row iteration
fixes [ticket:229] [ticket:79]

spelling fix

onupdate/ondelete fix

descriptive error message when an executioncontext-requiring call is called off a ResultProxy which was created via literal statement execution and therefore does not have an execution context.

added MSSQL changes

Fixes use of port for pymssql
Introduces new auto_indentity_insert option
Fixes bug #261

added scalar() to ResultProxy

mutable flag

- added "mutable" flag to PickleType, set to False to allow old (faster) behavior
- fix attribute unit test
- attributes have explicit flag for "mutable_scalars", propigated by ColumnProperty

- added "pickleable" module to test suite to have cPickle-compatible
test objects
- added copy_function, compare_function arguments to InstrumentedAttribute
- added MutableType mixin, copy_value/compare_values methods to TypeEngine,
PickleType
- ColumnProperty and DeferredProperty propigate the TypeEngine copy/compare
methods to the attribute instrumentation
- cleanup of UnitOfWork, removed unused methods
- UnitOfWork "dirty" list is calculated across the total collection of persistent
objects when called, no longer has register_dirty.
- attribute system can still report "modified" status fairly quickly, but does
extra work for InstrumentedAttributes that have detected a "mutable" type where
catching the __set__() event is not enough (i.e. PickleTypes)
- attribute tracking modified to be more intelligent about detecting
changes, particularly with mutable types.  TypeEngine objects now
take a greater role in defining how to compare two scalar instances,
including the addition of a MutableType mixin which is implemented by
PickleType.  unit-of-work now tracks the "dirty" list as an expression
of all persistent objects where the attribute manager detects changes.
The basic issue thats fixed is detecting changes on PickleType
objects, but also generalizes type handling and "modified" object
checking to be more complete and extensible.

- connection pool tracks open cursors and raises an error if connection
is returned to pool with cursors still opened.  fixes issues with MySQL,
others

- added autoincrement=True to Column; will disable schema generation
of SERIAL/AUTO_INCREMENT/identity seq for postgres/mysql/mssql if
explicitly set to False.  #303

remove delete-orphan cascade from self referential mappers

- fixed unfortunate mutating-dictionary glitch from previous checkin
- added "batch=True" flag to mapper; if False, save_obj
will fully save one object at a time including calls
to before_XXXX and after_XXXX

future log lines

fix to reset_class_managed to look at noninherited attributes only; an artifact of compilation brought this up

- fix to deferred group loading

- ForeignKey reports better error message for column not found
- change in verbiage when join conditions are figured out (and fail)

- moved selectresults test from orm to ext package
- renamed objectstore test suite to unitofwork
- added additional "eagerdegrade" tests to mapper, to test fixes from #308

- adjustments to eager loading so that its "eager chain" is
kept separate from the normal mapper setup, thereby
preventing conflicts with lazy loader operation, fixes
[ticket:308]

- BooleanExpression includes new "negate" argument to specify
the appropriate negation operator if one is available.
- calling a negation on an "IN" or "IS" clause will result in
"NOT IN", "IS NOT" (as opposed to NOT (x IN y)).

case sensitive function seems to return a string in some cases

check for mapper or class, raise exception otherwise [ticket:305]

- post_update behavior improved; does a better job at not
updating too many rows, updates only required columns
[ticket:208]

no SERIAL for smallinteger columns

no KeyError if url params not provided

- added an implicit close() on the cursor in ResultProxy
when the result closes
- added scalar() method to ComposedSQLEngine

added extract() function to sql dialect

moved "c.name" to "c.key" for processing defaults since bind params use column key

- fixed bug where Connection wouldnt lose its Transaction
after commit/rollback

removed lockmode from get_by

sqlite doesnt support FOR UPDATE

ConcurrentModificationExecption

- implemented "version check" logic in Query/Mapper, used
when version_id_col is in effect and query.with_lockmode()
is used to get() an instance thats already loaded
[ticket:292]

checks for invalid lockmode argument

- changed "for_update" parameter to accept False/True/"nowait"
and "read", the latter two of which are interpreted only by
Oracle and Mysql [ticket:292]
- added "lockmode" argument to base Query select/get functions,
including "with_lockmode" function to get a Query copy that has
a default locking mode.  Will translate "read"/"update"
arguments into a for_update argument on the select side.
[ticket:292]

removed auto-dispose on __del__, produces too much garbage exceptiongs

fixup to printing of uow

- more rearrangements of unit-of-work commit scheme to better allow
dependencies within circular flushes to work properly...updated
task traversal/logging implementation

this work is still under construction !  requires more unit tests and
new dumper needs to be finished.

forgot the tearDown step....

fixed constructor on bigint

added link

0.2.8..

- added basic 'zblog' test suite
- better error message for mapper orphan detect

restored "optimistic" behavior of hasparent.  its generally disastrous without that flag as its impossible to load all lazy loaders, deal with attributes that "noload", etc. just to check for orphan status.

- unicode fix for startswith()/endswith() [ticket:296]

update

further fixes to case sensitive logic

revised section on quoting, semanticized headings and table of content lists