- changelog

- The :func:`.cast` function, when given a plain literal value,
will now apply the given type to the given literal value on the
bind parameter side according
to the type given to the cast.   This essentially replaces what would
normally be the detected type of the literal value.   This only
takes effect if the auto-detected type of the literal value is either
"nulltype" (e.g. couldn't detect)
or a type that is of the same "affinity" as the cast type.
The net change here is that the :func:`.cast` function includes more
of the functionality already present in the :func:`.type_coerce` function.

this test appears to be failing with pg 9.3, not sure how to restore it

- using AssertsCompiledSQL so need __dialect__

- rework JSON expressions to be based off __getitem__ exclusively
- add support for "standalone" JSON objects; this involves getting CAST
to upgrade the given type of a bound parameter.  should add a core-only test
for this.
- add tests for "standalone" json round trips both with and without unicode
- add mechanism by which we remove psycopg2's "json" handler in order to get
the effect of using our non-native result handlers

- enhance the exclusions system to support database versions within the __only_on__ attribute

Merge branch 'issue_2581' of github.com:nathan-rice/sqlalchemy into pg_json

- for [ticket:2651], leaving CheckConstraint alone, preferring to keep
backwards compatibility.  A note about backslashing escapes is added.
Because the Text() construct now supports bind params better, the example
given in the code raises an exception now, so that should cover us.
The exception itself has been enhanced to include the key name of the
bound param.  We're backporting this to 0.8 but 0.8 doesn't have the
text->bind behavior that raises.

- An adjustment to the :func:`.subqueryload` strategy which ensures that
the query runs after the loading process has begun; this is so that
the subqueryload takes precedence over other loaders that may be
hitting the same attribute due to other eager/noload situations
at the wrong time. [ticket:2887]

- fix up the FAQ regarding the "foo_id" issue
- add session object states to the glossary

- Fixed bug when using joined table inheritance from a table to a
select/alias on the base, where the PK columns were also not same
named; the persistence system would fail to copy primary key values
from the base table to the inherited table upon INSERT.
[ticket:2885]

wrong method name

- add "force_nocheck" as a way to turn on unicode=force without even
doing the isinstance() check - currently used only by psycopg2 + native enum + py2k.
- didn't realize psycopg2 had UNICODEARRAY extension all this time; replace _PGArray
with just using UNICODEARRAY instead.
- replace unnecessary/inconsistent __import__ in _isolation_lookup.

load_on_pending is different from enable_relationship_loading and should
not be superseded.  both have a potential use.

make the error message for [ticket:2889] more accurate, as we support
composites to many-to-ones now also

- :func:`.composite` will raise an informative error message when the
columns/attribute (names) passed don't resolve to a Column or mapped
attribute (such as an erroneous tuple); previously raised an unbound
local. [ticket:2889]

- Error message when a string arg sent to :func:`.relationship` which
doesn't resolve to a class or mapper has been corrected to work
the same way as when a non-string arg is received, which indicates
the name of the relationship which had the configurational error.
[ticket:2888]

move things that are 90% behavioral improvements to that section.  the list of things
that can definitely people should be more focused.

- implement "literal binds" for the text() clause, [ticket:2882]

- The :class:`.ForeignKey` class more aggressively checks the given
column argument.   If not a string, it checks that the object is
at least a :class:`.ColumnClause`, or an object that resolves to one,
and that the ``.table`` attribute, if present, refers to a
:class:`.TableClause` or subclass, and not something like an
:class:`.Alias`.  Otherwise, a :class:`.ArgumentError` is raised.
[ticket:2883]

- The :class:`.exc.StatementError` or DBAPI-related subclass
now can accomodate additional information about the "reason" for
the exception; the :class:`.Session` now adds some detail to it
when the exception occurs within an autoflush.  This approach
is taken as opposed to combining :class:`.FlushError` with
a Python 3 style "chained exception" approach so as to maintain
compatibility both with Py2K code as well as code that already
catches ``IntegrityError`` or similar.

 sqlalchemy/dialects/postgresql/pgjson:
 - Updated documentation for JSON class

 sqlalchemy/dialects/postgresql/pgjson:
 - Added support for additional operators
 - Made return as json default (rather than text)

 sqlalchemy/dialects/postgresql/psycopg2:
 - Removed unneeded import of psycopg2.extensions

 sqlalchemy/dialects/postgresql/pgjson:
 - Fixed reference to HSTORE
 - Corrected spelling of SQLAlchemy

 sqlalchemy/dialects/postgresql/psycopg2:
 - Added psycopg2 specific wrapper type for JSON which uses inherent json deserialization facilities
 - Added code to detect and utilize the JSON wrapper if psycopg2 >= 2.5

test/dialect/postgresql/test_types:
- removed reference to use_native_hstore

- round trip test
- changelog
- some doc rearrangement

Merge branch 'tsvector' of https://bitbucket.org/nibrahim/sqlalchemy/branch/tsvector into tsvector

sqlany dialect moves to github

Adds test to verify tsvector creation.

Signed-off-by: Noufal Ibrahim <noufal@nibrahim.net.in>

Adds tsvector to ischema_names for reflection to work.

Signed-off-by: Noufal Ibrahim <noufal@nibrahim.net.in>

Updates documentation for tsvector type.

Signed-off-by: Noufal Ibrahim <noufal@nibrahim.net.in>

Implements TSVECTOR type for postgresql.

Signed-off-by: Noufal Ibrahim <noufal@nibrahim.net.in>

Merge branch 'rel_0_9' of https://github.com/nathan-rice/sqlalchemy into rel_0_9

sqlalchemy/dialects/postgresql/__init__.py:
- Added import references to JSON class

 sqlalchemy/dialects/postgresql/base.py:
 - Added visitor method for JSON class

 sqlalchemy/dialects/postgresql/pgjson (new):
 - JSON class, supports automatic serialization and deserialization of json data, as well as basic json operators.

forgot authors!!

- The :func:`.engine_from_config` function has been improved so that
we will be able to parse dialect-specific arguments from string
configuration dictionaries.  Dialect classes can now provide their
own list of parameter types and string-conversion routines.
The feature is not yet used by the built-in dialects, however.
[ticket:2875]

- documentation cleanup in ORM including [ticket:2816]

specify run as module here

- remove verbiage about "namespaces" from the dogpile example, [ticket:2862]
- fix broken py2k/py3k isms

- A DBAPI that raises an error on ``connect()`` which is not a subclass
of dbapi.Error (such as ``TypeError``, ``NotImplementedError``, etc.)
will propagate the exception unchanged.  Previously,
the error handling specific to the ``connect()`` routine would both
inappropriately run the exception through the dialect's
:meth:`.Dialect.is_disconnect` routine as well as wrap it in
a :class:`sqlalchemy.exc.DBAPIError`.  It is now propagated unchanged
in the same way as occurs within the execute process. [ticket:2881]
- add tests for this in test_parseconnect, but also add tests in test_execute
to ensure the execute() behavior as well

- restore having the connection closed before decrementing the overflow counter

- The :class:`.QueuePool` has been enhanced to not block new connection
attempts when an existing connection attempt is blocking.  Previously,
the production of new connections was serialized within the block
that monitored overflow; the overflow counter is now altered within
it's own critical section outside of the connection process itself.
[ticket:2880]

- Made a slight adjustment to the logic which waits for a pooled
connection to be available, such that for a connection pool
with no timeout specified, it will every half a second break out of
the wait to check for the so-called "abort" flag, which allows the
waiter to break out in case the whole connection pool was dumped;
normally the waiter should break out due to a notify_all() but it's
possible this notify_all() is missed in very slim cases.
This is an extension of logic first introduced in 0.8.0, and the
issue has only been observed occasionally in stress tests.

- The precedence rules for the :meth:`.ColumnOperators.collate` operator
have been modified, such that the COLLATE operator is now of lower
precedence than the comparison operators.  This has the effect that
a COLLATE applied to a comparison will not render parenthesis
around the comparison, which is not parsed by backends such as
MSSQL.  The change is backwards incompatible for those setups that
were working around the issue by applying :meth:`.Operators.collate`
to an individual element of the comparison expression,
rather than the comparison expression as a whole. [ticket:2879]

- changelog + test for pullreq #7, MSSQL dialect for DROP INDEX

Merged in dharland/sqlalchemy/patch-mssql-drop-index (pull request #7)

Fix MSSQL dialects visit_drop_index to use the correct DDL

- add a new example section for "join conditions", start putting
the primaryjoin examples there

fix underline

Fix MSSQL dialects visit_drop_index to use the correct DDL

- reflection of unique constraints backported to 0.8.4 [ticket:1443]

- The :class:`.DeferredReflection` class has been enhanced to provide
automatic reflection support for the "secondary" table referred
to by a :func:`.relationship`.   "secondary", when specified
either as a string table name, or as a :class:`.Table` object with
only a name and :class:`.MetaData` object will also be included
in the reflection process when :meth:`.DeferredReflection.prepare`
is called. [ticket:2865]
- clsregistry._resolver() now uses a stateful _class_resolver()
class in order to handle the work of mapping strings to
objects.   This is to provide for simpler extensibility, namely
a ._resolvers collection of ad-hoc name resolution functions;
the DeferredReflection class adds its own resolver here in order
to handle relationship(secondary) names which generate new
Table objects.

- Added ORA-02396 "maximum idle time" error code to list of
"is disconnect" codes with cx_oracle. [ticket:2864]

- Added new argument ``include_backrefs=True`` to the
:func:`.validates` function; when set to False, a validation event
will not be triggered if the event was initated as a backref to
an attribute operation from the other side. [ticket:1535]
- break out validation tests into an updated module test_validators

- the pronoun removal commit.   there was only one instance of a
standalone gendered pronoun with a gender-neutral subject, but also
have replaced all occurences of "his/her", "his or her", etc.  The docs have always
strived to account for both genders in any non-specific singular pronoun,
however recent controversy in the community suggests
that a zero-gendered-pronoun policy is probably best going forward.

remove whitespace

make sure thread.join() is used completely here

.tox

Merge pull request #49 from msabramo/add_note_to_README_unittests_about_tox

README.unittests.rst: Add blurb about tox

- changelog
- put list.clear() instrumentation under "if not py2k"

Merge branch 'orm-collections-list-clear' of github.com:schettino72/sqlalchemy into list_clear

not new anymore...

- move additional enum compilation tests to postgresql/test_compiler.py

- selected documentation issues
- add glossary terms

- re-document synonyms and remove warnings about "superseded"; synonyms
are still useful, just include notes that for more complex descriptor operations,
hybrids are probably preferable

- Fixed bug where values within an ENUM weren't escaped for single
quote signs.   Note that this is backwards-incompatible for existing
workarounds that manually escape the single quotes. [ticket:2878]

forgot to add this, oopsie

simplify this

convert to a list here for py3k

- add support for bindparam() called from AsFromText
- get PG dialect to work around "no nonexistent binds" rule for now,
though we might want to reconsider this behavior

- start reworking examples to include more code from the wiki.
- add the other versioning examples from the wiki
- modernize the dictlike examples

remove this

Fixed bug where in Py2K a unicode literal would not be accepted
as the string name of a class or other argument within
declarative using :func:`.relationship`.

- reduce verbiage in mutation.py regarding legacy style, place under versionadded

Fixed a syntax error in example code.

Merge pull request #45 from timka/patch-1

Fix sessionmaker.__repr__

Merge pull request #46 from vrajmohan/master

More fixes for cross references and reducing warnings (3rd wave)

more fix

fix

make generativeselect available

- New improvements to the :func:`.text` construct, including
more flexible ways to set up bound parameters and return types;
in particular, a :func:`.text` can now be turned into a full
FROM-object, embeddable in other statements as an alias or CTE
using the new method :meth:`.TextClause.columns`.
[ticket:2877]

- changelog, migration

- repair the "lockmode" functionality of load_on_ident().  slightly problematic
here is that "lockmode" is also public in Session.refresh().

- add support for specifying tables or entities for "of"
- implement Query with_for_update()
- rework docs and tests

- fix up rendering of "of"
- move out tests, dialect specific out of compiler, compiler tests use new API,
legacy API tests in test_selecatble
- add support for adaptation of ForUpdateArg, alias support in compilers

- work in progress, will squash

Merge branch 'for_update_of' of github.com:mlassnig/sqlalchemy into for_update_of

added LockmodeArgs

- add more explicit docs for relationship mixin, [ticket:2876]

- the wrapped memoized_property here was not working, as the attribute name
didn't match.  use straight memoized_props here for now, add a perf test to check it

- adjustment, the spec says: "Within the user and password field, any ":",
   "@", or "/" must be encoded." - so re-apply encoding to both password
and username, don't encode spaces as plus signs, don't encode any chars
outside of :, @, / on stringification - but we still parse for any
%XX character (is that right?)

README.unittests.rst: Add blurb about tox

orm.collection, list.clear(). remove 'before_delete()', added unit-test.

- The :func:`.create_engine` routine and the related
:func:`.make_url` function **no longer URL encode the password**.
Database passwords that include characters like spaces, plus signs
and anything else should now represent these characters directly,
without any URL escaping. [ticket:2873]

pg8000 fix for decimal return scale

-be more agnostic of quotes here

- evaulate decimal_return_scale statelessly.  Don't re-assign to self.decimal_return_scale
so that __repr__() is maintained (for alembic tests)

clean up imports

- this test only for mysql

- Some refinements to the :class:`.AliasedClass` construct with regards
to descriptors, like hybrids, synonyms, composites, user-defined
descriptors, etc.  The attribute
adaptation which goes on has been made more robust, such that if a descriptor
returns another instrumented attribute, rather than a compound SQL
expression element, the operation will still proceed.
Addtionally, the "adapted" operator will retain its class; previously,
a change in class from ``InstrumentedAttribute`` to ``QueryableAttribute``
(a superclass) would interact with Python's operator system such that
an expression like ``aliased(MyClass.x) > MyClass.x`` would reverse itself
to read ``myclass.x < myclass_1.x``.   The adapted attribute will also
refer to the new :class:`.AliasedClass` as its parent which was not
always the case before. [ticket:2872]

- The precision used when coercing a returned floating point value to
Python ``Decimal`` via string is now configurable.  The
flag ``decimal_return_scale`` is now supported by all :class:`.Numeric`
and :class:`.Float` types, which will ensure this many digits are taken
from the native floating point value when it is converted to string.
If not present, the type will make use of the value of ``.scale``, if
the type supports this setting and it is non-None.  Otherwise the original
default length of 10 is used. [ticket:2867]