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

- added experimental relation() flag to help with primaryjoins
across functions, etc., _local_remote_pairs=[tuples].
This complements a complex primaryjoin condition allowing
you to provide the individual column pairs which comprise
the relation's local and remote sides.

Pass connection to get_default_schema_name

Firebird 2 has a SUBSTRING() builtin, expose it thru a function

- re-established viewonly relation() configurations that
join across multiple tables.

Add a new 'odbc_autotranslate' engine/dburi kwd parm to the MSSQL pyodbc dialect; string kwd contents will be passed through to ODBC connection string.
[ticket:1005]

remove monetdb typo

refactor of default_paramstyle, use paramstyle argument on Dialect to change

- Avoid cProfile on 2.4 (available via lsprof?)

remove unneeded compile assertion test, doesn't work on MySQL

*headslap* those mutators cant mutate the collections except for never-generated selectables; its not worth it

- removed ancient assertion that mapped selectables require
"alias names" - the mapper creates its own alias now if
none is present.  Though in this case you need to use
the class, not the mapped selectable, as the source of
column attributes - so a warning is still issued.

some fk fixes for PG

- merged -r4458:4466 of query_columns branch
- this branch changes query.values() to immediately return an iterator, adds a new "aliased" construct which will be the primary method to get at aliased columns when using values()
- tentative ORM versions of _join and _outerjoin are not yet public, would like to integrate with Query better (work continues in the branch)
- lots of fixes to expressions regarding cloning and correlation.  Some apparent ORM bug-workarounds removed.
- to fix a recursion issue with anonymous identifiers, bind parameters generated against columns now just use the name of the column instead of the tablename_columnname label (plus the unique integer counter).  this way expensive recursive schemes aren't needed for the anon identifier logic.   This, as usual, impacted a ton of compiler unit tests which needed a search-n-replace for the new bind names.

refined "local_remote_pairs" a bit to account for the same columns repeated multiple times

- Pool listeners may now be specified as a duck-type of PoolListener or a dict of callables, your choice.

factored down exportable_columns/flatten_cols/proxy_column/oid_etc_yada down to a single, streamlined "_populate_column_collection" method called for all selectables

fixed union() bug whereby oid_column would not be available if no oid_column in embedded selects

bump

Yep.

- ReST fixes
- reverted strange jeklike symbol syntax

- changed the name to "local/remote pairs"
- added closing ' to symbol str()  (I'm assuming it's supposed to be that way)

- merged sync_simplify branch
- The methodology behind "primaryjoin"/"secondaryjoin" has
been refactored.  Behavior should be slightly more
intelligent, primarily in terms of error messages which
have been pared down to be more readable.  In a slight
number of scenarios it can better resolve the correct
foreign key than before.
- moved collections unit test from relationships.py to collection.py
- PropertyLoader now has "synchronize_pairs" and "equated_pairs"
collections which allow easy access to the source/destination
parent/child relation between columns (might change names)
- factored out ClauseSynchronizer (finally)
- added many more tests for priamryjoin/secondaryjoin
error checks

- microcleanup

- Experimental: prefer cProfile over hotspot for 2.5+
- The latest skirmish in the battle against zoomark and sanity:
  3rd party code is factored out in the function call count canary tests

A couple of usage examples for the case statement

- case() interprets the "THEN" expressions
as values by default, meaning case([(x==y, "foo")]) will
interpret "foo" as a bound value, not a SQL expression.
use text(expr) for literal SQL expressions in this case.
For the criterion itself, these may be literal strings
only if the "value" keyword is present, otherwise SA
will force explicit usage of either text() or literal().