78 chars

merge

78 chars for sybase

Added tag rel_0_6_2 for changeset 7e72edc9d39966721f2731ef2dbf508ca4a03e4c

- updated obsolete docs regarding sequences, RETURNING for pg
- 78 chars for postgresql/base.py, engine/default.py

up the variance on these as the call counts are very low and
things wiggle around even between 2.6.4/2.6.5

- latest distribute
- added caveats to unittest README encountered with Py2.7 + current nose 0.11.3
- call counts for py2.7.   all tests pass for sqlite + mysql-python + psycopg2

force __doc__ to transfer over from the decorated funciton.
2.6 does this anyway, 2.4 and 2.5 do not.

merge

some prep for the 'viewcode' plugin, which works, though not sure if its helpful

some linkage

transfer docstrings from @classproperty to props

- idle 78-char adjustments

- Added support for @classproperty to provide
any kind of schema/mapping construct from a
declarative mixin, including columns with foreign
keys, relationships, column_property, deferred.
This solves all such issues on declarative mixins.
An error is raised if any MapperProperty subclass
is specified on a mixin without using @classproperty.
[ticket:1751] [ticket:1796] [ticket:1805]

- un-anglicized the declarative docs

- verbiage expressing that pool_size==0 means no limit; NullPool is
used to disable pooling. [ticket:1164]

- The 'default' compiler is automatically copied over
when overriding the compilation of a built in
clause construct, so no KeyError is raised if the
user-defined compiler is specific to certain
backends and compilation for a different backend
is invoked. [ticket:1838]

- add typing/operator converts to Float/Numeric to get Oracle tests going again,
as we have an unusually high level of dependence on SQLA typing now
- force oracle seqs to return integers

- If server_version_info is outside the usual
range of (8, ), (9, ), (10, ), a warning is emitted
which suggests checking that the FreeTDS version
configuration is using 7.0 or 8.0, not 4.2.
[ticket:1825]

keep ordering of columns with mixins constant

- Query.join() will check for a call of the
form query.join(target, clause_expression),
i.e. missing the tuple, and raise an informative
error message that this is the wrong calling form.

  - Oracle's "native decimal" metadata begins to return
    ambiguous typing information about numerics
    when columns are embedded in subqueries as well
    as when ROWNUM is consulted with subqueries, as we
    do for limit/offset.  We've added these ambiguous
    conditions to the cx_oracle "convert to Decimal()"
    handler, so that we receive numerics as Decimal
    in more cases instead of as floats.  These are
    then converted, if requested, into Integer
    or Float, or otherwise kept as the lossless
    Decimal [ticket:1840].

- An instance which is moved to "transient", has
an incomplete or missing set of primary key
attributes, and contains expired attributes, will
raise an InvalidRequestError if an expired attribute
is accessed, instead of getting a recursion overflow.

- make_transient() removes all "loader" callables from
the state being made transient, removing any
"expired" state - all unloaded attributes reset back
to undefined, None/empty on access.

replace all occurences of "closes the connection" "closes the transaction"
with explicit verbiage regarding "returns the connection to the connection
pool", "rolls back the transaction"

add make_transient

fix oracle char length test for newer descriptors

- Fixed bug that would prevent overridden clause
compilation from working for "annotated" expression
elements, which are often generated by the ORM.

- Won't generate "CREATE TYPE" / "DROP TYPE" if
using types.Enum on a PG version prior to 8.3 -
the supports_native_enum flag is fully
honored.  [ticket:1836]

fix test

- The argument to "ESCAPE" of a LIKE operator or similar
is passed through render_literal_value(), which may
implement escaping of backslashes.  [ticket:1400]
- Postgresql render_literal_value() is overridden which escapes
backslashes, currently applies to the ESCAPE clause
of LIKE and similar expressions.
Ultimately this will have to detect the value of
"standard_conforming_strings" for full behavior.
[ticket:1400]
- MySQL render_literal_value() is overridden which escapes
backslashes, currently applies to the ESCAPE clause
of LIKE and similar expressions.   This behavior
is derived from detecting the value of
NO_BACKSLASH_ESCAPES.  [ticket:1400]

- Fixed @memoized_property and @memoized_instancemethod
decorators so that Sphinx documentation picks up
these attributes and methods, such as
ResultProxy.inserted_primary_key. [ticket:1830]

- Firebird dialect adds CHAR, VARCHAR types which
accept a "charset" flag, to support Firebird
"CHARACTER SET" clause.  [ticket:1813]

- Fixed ora-8 compatibility flags such that they
don't cache a stale value from before the first
database connection actually occurs. [ticket:1819]

fix accessors, [ticket:1816]

- a mixin class can now define a column that matches
one which is present on a __table__ defined on a
subclass.  It cannot, however, define one that is
not present in the __table__, and the error message
here now works.  [ticket:1821]

- MySQL dialect doesn't emit CAST() for MySQL version
detected < 4.0.2.  This allows the unicode
check on connect to proceed. [ticket:1826]

- moved "post update" functionality from _save_obj() into
its own method, which also groups updates into executemanys.
[ticket:1831]

- cleanup of new post update, changelog

add a test for the actual feature, that multiple post updates are batched

this one is actually doing it.  removed the cruft we don't need from the old approach.
not sure if one-to-many with elaborate self-refs, etc., but we appear to be
as good as we were before.

adds some tests, refines out the m2o approach.

this approach seems to allow many-to-one post updates to occur as a single action.   for one-to-many, we
have it working the old way still. as usual the huge job is the tests.   also I am not yet certain
that post updates can always be a "full mapper" operation, i.e. are never involved in per-state dependencies,
or even if the old approach supports that.

- query.order_by() now accepts False, which cancels
any existing order_by() state on the Query, allowing
subsequent generative methods to be called which do
not support ORDER BY.  This is not the same as the
already existing feature of passing None, which
suppresses any existing order_by() settings, including
those configured on the mapper.  False will make it
as though order_by() was never called, while
None is an active setting.

fix import

add a test for query.order_by(None)

- Column.copy() takes along the "unique" attribute
among others, fixes [ticket:1829] regarding declarative
mixins

version_info is the tuple

- Can now call make_transient() on an instance that
is referenced by parent objects via many-to-one,
without the parent's foreign key value getting
temporarily set to None - this was a function
of the "detect primary key switch" flush handler.
It now ignores objects that are no longer
in the "persistent" state, and the parent's
foreign key identifier is left unaffected.

- hypothesize that newer pysqlites are also growing a warning log on non-unicdoe strings

fix variable name

- Query.statement, Query.subquery(), etc. now transfer
the values of bind parameters, i.e. those specified
by query.params(), into the resulting SQL expression.
Previously the values would not be transferred
and bind parameters would come out as None.

- Subquery-eager-loading now works with Query objects
which include params(), as well as get() Queries.

- Modified the internals of "column annotation" such that
a custom Column subclass can safely override
_constructor to return Column, for the purposes of
making "configurational" column classes that aren't
involved in proxying, etc.

- Fixed bug regarding flushes on self-referential
bi-directional many-to-many relationships, where
two objects made to mutually reference each other
in one flush would fail to insert a row for both
sides.  Regression from 0.5. [ticket:1824]

- The warning emitted by the Unicode and String types
with convert_unicode=True no longer embeds the actual
value passed.   This so that the Python warning
registry does not continue to grow in size, the warning
is emitted once as per the warning filter settings,
and large string values don't pollute the output.
[ticket:1822]

- added documentation for Inspector [ticket:1820]
- fixed "toplevel" regexp to include tokens of the form foo-bar-toplevel (i.e. multiple dashes)
- some CSS adjustment so that all API headings are in gray.

- Inspector hits bind.connect() when invoked to ensure
initialize has been called.  the internal name ".conn"
is changed to ".bind", since that's what it is.

fix the enum for MySQL after native_enum added to adaption keys

- Fixed incorrect signature in do_execute() for firebird, access, error
introduced in 0.6.1. [ticket:1823]

- Fixed bug in Enum type which blew away native_enum
flag when used with TypeDecorators or other adaption
scenarios.

- tweak to work with sphinx 1.0b2
- more open ended language for bound metadata

Added tag rel_0_6_1 for changeset 1bd54fd9c854044d8153dba0f6dd261bf6bb6bff

0.6.1

fix this test for oracle

mapper.py is entirely 79 char lines now

change the weakkeydict to be just an LRU cache.   Add tests
for the "many combinations of UPDATE keys" issue.

shorten lines to 78 char on _save_obj, _delete_obj, related.   much more to go for mapper.py

reduce the calls to execution_options and weakkeydict.setdefault

- Pool classes will reuse the same "pool_logging_name" setting
after a dispose() occurs.

- Engine gains an "execution_options" argument and
update_execution_options() method, which will apply to
all connections generated by this engine.

- Added more aggressive caching to the mapper's usage of
UPDATE, INSERT, and DELETE expressions.  Assuming the
statement has no per-object SQL expressions attached,
the expression objects are cached by the mapper after
the first create, and their compiled form is stored
persistently in a cache dictionary for the duration of
the related Engine.

- change #3 required change #1 so that we could test
a set of mappers operating over the course of many engines without
memory usage increase.

79 char lines for base.py

- Fixed concatenation of constraints when "PRIMARY KEY"
constraint gets moved to column level due to SQLite
AUTOINCREMENT keyword being rendered.  [ticket:1812]
- remove some extra space in between constraint DDL
- added alias() to binary comparison test, fixing pg + mysql failures

- Re-established support for Oracle 8 with cx_oracle,
including that use_ansi is set to False automatically,
NVARCHAR2 and NCLOB are not rendered for Unicode,
"native unicode" check doesn't fail, cx_oracle
"native unicode" mode is disabled, VARCHAR() is emitted
with bytes count instead of char count. [ticket:1808]

- FOR UPDATE is emitted in the syntactically correct position
when limit/offset is used, i.e. the ROWNUM subquery.
However, Oracle can't really handle FOR UPDATE with ORDER BY
or with subqueries, so its still not very usable, but at
least SQLA gets the SQL past the Oracle parser.
[ticket:1815]

- Columns of _Binary type (i.e. LargeBinary, BLOB, etc.)
will coerce a "basestring" on the right side into a
_Binary as well so that required DBAPI processing
takes place.

- Fixed regression introduced in 0.6.0 unit of work refactor
that broke updates for bi-directional relationship()
with post_update=True. [ticket:1807]

new link for pymssql #1810

docs on dispose

disclaimer for the "type=None" semi-feature

- Added table.add_is_dependent_on(othertable), allows manual
placement of dependency rules between two Table objects
for use within create_all(), drop_all(), sorted_tables.
[ticket:1801]

- Added internal warning in case an instance without a
full PK happened to be expired and then was asked
to refresh. [ticket:1797]

- fixed __setstate__ method of CollectionAdapter to not
fail during deserialize where parent InstanceState not
yet unserialized.  [ticket:1802]

- func.XXX() doesn't inadvertently resolve to non-Function
classes (e.g. fixes func.text()).  [ticket:1798]

some pep-8ing

- the _make_proxy() method of ColumnClause and Column now use
self.__class__ to determine the class of object to be returned
instead of hardcoding to ColumnClause/Column, making it slightly
easier to produce specific subclasses of these which work in
alias/subquery situations.

- expr.in_() now accepts a text() construct as the argument.
Grouping parenthesis are added automatically, i.e. usage
is like `col.in_(text("select id from table"))`.
[ticket:1793]

- session.merge() will not expire attributes on the returned
instance if that instance is "pending".  [ticket:1789]

- func.sysdate() emits "SYSDATE()", i.e. with the ending
parenthesis, on MySQL.  [ticket:1794]

- Added 'connection shutdown' to the list of exception strings
which indicate a dropped connection.  [ticket:1646]

add a note about native unicode mode, [ticket:1792]

- the SqlSoup constructor accepts a `base` argument which specifies
the base class to use for mapped classes, the default being
`object`.  [ticket:1783]

add more insert examples #1791

merge tip

- Fixed use_ansi=False mode, which was producing broken
WHERE clauses in pretty much all cases.  [ticket:1790]

place docs for DBAPI-agnostic transaction_isolation setting for sqlite, pg [ticket:1784]

remove docs for deprecated feature

fix some 2to3 breakage on the cx_oracle dialect

remove a few superfluous imports

- Fixed bug in connection pool cursor wrapper whereby if a
cursor threw an exception on close(), the logging of the
message would fail.  [ticket:1786]

fix sphinx reference

- oracle_xe 5 doesn't accept a Python unicode object in
its connect string in normal Python 2.x mode - so we coerce
to str() directly.  non-ascii characters aren't supported
in connect strings here since we don't know what encoding
we could use.  [ticket:1670]

changelog fix for #1781

take2 on #1781.