Support Firebird 2.0+ RETURNING

Whitespace

- renamed query.slice_() to query.slice()
- pulled out DeclarativeMeta.__init__ into its own function, added instrument_declarative()
which will do the "declarative" thing to any class independent of its lineage (for ctheune)
- added "cls" kwarg to declarative_base() allowing user-defined base class for declarative base [ticket:1042]

- LIMIT/OFFSET of zero is detected within compiler and is counted
- Query.__getitem__ now returns list/scalar in all cases, not generative (#1035)
- added Query.slice_() which provides the simple "limit/offset from a positive range" operation,
we can rename this to range_()/section()/_something_private_because_users_shouldnt_do_this() as needed

- fixed propagation of operate() for aliased relation descriptors
- ColumnEntity gets a selectable

Removed declared_synonym(), pep-8 clean ups.

Removed: all legacy users migrated.

- Reworked test/orm/mapper
- Exposed some uncovered (and broken) functionality
- Fixed [ticket:1038]

Tag PKs with `test_needs_autoincrement` on a few test

Support for  under Firebird

Tag some tests that fail under Firebird

scaled back the equivalents determined in _equivalent_columns to just current polymorphic_union
 behavior, fixes [ticket:1041]

- clause adaption hits _raw_columns of a select() (though no ORM tests need this feature currently)
- broke up adapter chaining in eagerload, erroneous "wrapping" in row_decorator.  column_property() subqueries are now affected only by the ORMAdapter for that mapper.  fixes [ticket:1037], and may possibly impact some of [ticket:949]

Check for the presence of the Firebird generator, when creating/dropping a sequence

Add another exception case to Firebird' is_disconnect()

Typo

Tagged two tests that fail under Firebird

Use a BLOB when asked for a [VAR]CHAR without a length under Firebird

Added explicit sequences on a few primary keys and minor fixes wrt Firebird

tweak

another approach

cant reproduce buildbot's memory profiling, random fix attempt

added blurb on session.rollback()

py2.4 seems to have different memory behavior than 2.5, test for both "adjusting down" as well as "flatline"

- removed all the order by's that no longer apply.
- realized about declarative that foobar: relation("SomeFutureClass") is not very useful for collections since
we can't set "order_by" there.

correcting dataload profiles for various tests

bizarre duplicate keyword seems to not raise in py2.5

merged r4720 from 04 branch for [ticket:1036]

Fix typo in the ORM tutorial

Reworked & stripped.

order by doc

edits

removed deprecated plugins docs

backref() function uses primaryjoin/secondaryjoin of the parent relation() if not otherwise specified, removing the frequently annoying need to specify primaryjoin twice.

Chipping away at remaining cruft.

- fixed a fairly critical bug in clause adaption/corresponding column in conjunction with annotations
- implicit order by is removed, modified many tests to explicitly set ordering, probably many more to go
once it hits the buildbot.

add target_fullname as a public property for _get_colspec

Test suite modernization in progress.  Big changes:
 - @unsupported now only accepts a single target and demands a reason
   for not running the test.
 - @exclude also demands an exclusion reason
 - Greatly expanded @testing.requires.<feature>, eliminating many
   decorators in the suite and signficantly easing integration of
   multi-driver support.
 - New ORM test base class, and a featureful base for mapped tests
 - Usage of 'global' for shared setup going away, * imports as well

more order bys...

some tweaks to help MySQL

- more portable tests for eager/inheritance joins
- bumped 2.4 call count for profile test_select
- don't need initialize_properties() during reentrant compile() call (for now)

MSText no longer implicitly creates TEXT for string with no length
(this actually allows CAST (foo, VARCHAR) to render too)

added query.subquery() as shorthand for query.statement.alias()

identified case where pending upon commit() is needed; since attribute rollback functionality is gone its safe to revert to this

move the definition of sessions public methods closer to the source

added "add", "add_all", "expire_all" to SS

tweak

need delete-orphan

- warnings about Query invalid operations become InvalidRequestErrors
- __no_criterion() checks for more pre-existing conditions
- helpful note in 0.5 svn readme

r4695 merged to trunk; trunk now becomes 0.5.
0.4 development continues at /sqlalchemy/branches/rel_0_4

doc update on quote

remove **kwargs from execute(), scalar(), connection(), and get_bind().  document all args, [ticket:1028]

- backported 0.5's contains_eager() behavior such that rendering of eager clauses are disabled.  workaround here is compatible with 0.5 but not compatible with the little-known "decorator" argument to contains_eager() (which was also removed in 0.5).  Doesn't remove any existing 0.4 functionality.

- added an example dynamic_dict/dynamic_dict.py, illustrating
a simple way to place dictionary behavior on top of
a dynamic_loader.

- Fixed "concatenate tuple" bug which could occur with
Query.order_by() if clause adaption had taken place.
[ticket:1027]

Query.select() wont call filter() if arg is None

fix foreign_keys example

Added missing argument check on CheckConstraint

- _Label adds itself to the proxy collection so that it works in correspoinding column.  fixes some eager load with column_property bugs.
- this partially fixes some issues in [ticket:1022] but leaving the "unlabeled" fix for 0.5 for now

- added "after_begin()" hook to Session
- Session.rollback() will rollback on a prepared session

Tidy.

Fix typo

Adjusted inplace-binops on set-based collections and association proxies to
more closely follow builtin (2.4+) set semantics.  Formerly any set duck-type
was accepted, now only types or subtypes of set, frozenset or the collection
type itself are accepted.

failing case

Fixed duplicate append event emission on repeated instrumented set.add() operations.

Update for r4643

Renamed rollback_returned to reset_on_return.  Future, dialect-aware pools can do better than rollback for this function.

- same as [ticket:1019] but repaired the non-labeled use case
      [ticket:1022]

- added "rollback_returned" option to Pool which will
      disable the rollback() issued when connections are
      returned.  This flag is only safe to use with a database
      which does not support transactions (i.e. MySQL/MyISAM).

  - Column.copy() respects the value of "autoincrement",
      fixes usage with Migrate [ticket:1021]

- fixes to the "exists" function involving inheritance (any(), has(),
~contains()); the full target join will be rendered into the
EXISTS clause for relations that link to subclasses.

- The collection instrumentation sweep now skips over descriptors that raise AttributeError.

- fixed reentrant mapper compile hang when
a declared attribute is used within ForeignKey,
ie. ForeignKey(MyOtherClass.someattribute)

- Backported attribute sweep removal (instrumentation) and r4493 from 0.5

one-off workaround for mssql + odbc options, user patch

- an unfortunate naming conflict
- needed sql import on and()

- factored out the logic used by Join to create its join condition
- With declarative, joined table inheritance mappers use a slightly relaxed
function to create the "inherit condition" to the parent
table, so that other foreign keys to not-yet-declared
Table objects don't trigger an error.

added some reference tests for the any() situation

- Fix 2.3 regression from 4598

- added a feature to eager loading whereby subqueries set
as column_property() with explicit label names (which is not
necessary, btw) will have the label anonymized when
the instance is part of the eager join, to prevent
conflicts with a subquery or column of the same name
on the parent object.  [ticket:1019]

And a copy.copy() test for the proxy cache.

- Refresh the cached proxy if the cache was built for a different instance.

added multi-level concrete inheritance test (testing with_polymorphic mapper argument)

more declarative doc updates

fix docs for declarative

Savepoints are supported under Firebird

fix order by for MySQL environment

- improved behavior of text() expressions when used as
FROM clauses, such as select().select_from(text("sometext"))
[ticket:1014]
- removed _TextFromClause; _TextClause just adds necessary FromClause descriptors
at the class level

- refined mapper._save_obj() which was unnecessarily calling
__ne__() on scalar values during flush [ticket:1015]

Expanded --noncomparable to cover all comparision ops

typo

Update docstring [ticket:873]

Explicit test of .autoflush(False) to avoid issues with save_on_init=True [ticket:869]

flush(objects=[]) is a no-op [ticket:928]

- fixed Class.collection==None for m2m relationships
      [ticket:4213]

- restored usage of append_result() extension method for primary
query rows, when the extension is present and only a single-
entity result is being returned.

Added 'odbc_options' keyword to the MSSQL dialect. Allows a partial ODBC connection string to be passed through to the connection string generator.

- Support for COLLATE: collate(expr, col) and expr.collate(col)

- simplified __create_lazy_clause to make better usage of the new local/remote pairs collection
- corrected the direction of local/remote pairs for manytoone
- added new tests which demonstrate lazyloading working when the bind param is embedded inside of a SQL function,
when _local_remote_pairs argument is used; fixes the viewonly version of [ticket:610]
- removed needless kwargs check from visitors.traverse

added info about _local_remote_pairs to error message