lazy clause generation can handle comparisons of column-containing expressions such as functions, within a limited scope

ok, TableClause should be public

reorganizing classnames a bit, flagging "private" classes in the sql package,
getting the generated docs to look a little nicer.
fixes to extensions, sqlsoup etc. to be compatible with recent API tweaks

latest markdown, added "bold link" style to doc generator

- added "column_prefix=None" argument to mapper; prepends the
given string (typically '_') to column-based attributes automatically
set up from the mapper's Table

quote function names

strings and unicodes are compared via == rather than 'is'.
TypeDecorator uses underlying impl for mutator/comparison functions by default

docstrings etc

apparently re.S makes things go b00m

tweaks...

de-cruftification

doc tweaks

dev

doc stuff regarding engine strategies

- ForeignKey(Constraint) supports "use_alter=True", to create/drop a foreign key
via ALTER.  this allows circular foreign key relationships to be set up.

fixup of the tutorial, doc tester with the new logging stuff

- a fair amount of cleanup to the schema package, removal of ambiguous
methods, methods that are no longer needed.  slightly more constrained
useage, greater emphasis on explicitness.
- table_iterator signature fixup, includes fix for [ticket:288]
- the "primary_key" attribute of Table and other selectables becomes
a setlike ColumnCollection object; is no longer ordered or numerically
indexed.  a comparison clause between two pks that are derived from the
same underlying tables (i.e. such as two Alias objects) can be generated
via table1.primary_key==table2.primary_key
- append_item() methods removed from Table and Column; preferably
construct Table/Column/related objects inline, but if needed use
append_column(), append_foreign_key(), append_constraint(), etc.
- table.create() no longer returns the Table object, instead has no
return value.  the usual case is that tables are created via metadata,
which is preferable since it will handle table dependencies.
- added UniqueConstraint (goes at Table level), CheckConstraint
(goes at Table or Column level) fixes [ticket:217]
- index=False/unique=True on Column now creates a UniqueConstraint,
index=True/unique=False creates a plain Index,
index=True/unique=True on Column creates a unique Index.  'index'
and 'unique' keyword arguments to column are now boolean only; for
explcit names and groupings of indexes or unique constraints, use the
UniqueConstraint/Index constructs explicitly.
- relationship of Metadata/Table/SchemaGenerator/Dropper has been
improved so that the schemavisitor receives the metadata object
for greater control over groupings of creates/drops.
- added "use_alter" argument to ForeignKey, ForeignKeyConstraint,
but it doesnt do anything yet.  will utilize new generator/dropper
behavior to implement.

a simplification to syncrule generation, which also allows more flexible configuration
of which columns are to be involved in the synchronization via foreignkey property.
foreignkey param is a little more important now and should have its role clarified
particularly for self-referential mappers.

make OrderedDict consructor, update more dict-like

- remove spurious semicomma from Firebird SQL statement (Lele Gaifax)

- sync checks destination column for primary key status, will not set it to None in that case
- dependency non-passively loads child items for many-to-one post update check

added 'ntext' reflected type

some cleanup submitted by Lele Galifax

added docstrings for url, added to compiled documentation

some logging tweaks....its a little squirrely

oops, double row echo removed

added debug-level row echoing to RowProxy (moved from ResultProxy)

  - ResultProxy.fetchall() internally uses DBAPI fetchall() for better efficiency,
    added to mapper iteration as well (courtesy Michael Twomey)

- fixes to Date/Time (SLDate/SLTime) types; works as good as postgres
  now [ticket:335]

_sort_tables uses local tables [ticket:322]

added PGBigInteger type

remove unused set

dont create dependency processor if viewonly=True

logging of syncrules

more adjustments to #321

add table name to save_obj log

row-switch test should be per-instance, not per table per instance

added correct insert ordering

- mapper.save_obj() now functions across all mappers in its polymorphic
series, UOWTask calls mapper appropriately in this manner
- polymorphic mappers (i.e. using inheritance) now produces INSERT
statements in order of tables across all inherited classes
[ticket:321]

more fixup to self referential composite primary key mappings

this test works better with session clears in between

- 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