diff options
author | Mike Bayer <mike_mp@zzzcomputing.com> | 2012-08-18 10:41:17 -0400 |
---|---|---|
committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2012-08-18 10:41:17 -0400 |
commit | b47c185fc4b09f0ee8f8445fb1b7ea41beafa0d7 (patch) | |
tree | e2bec32edcfa41b2304c2a0c1bd6e6940ae0b626 /lib/sqlalchemy/sql/expression.py | |
parent | 24a071921c2e8133a393284c700c106e13242cf5 (diff) | |
download | sqlalchemy-b47c185fc4b09f0ee8f8445fb1b7ea41beafa0d7.tar.gz |
tighten this up
Diffstat (limited to 'lib/sqlalchemy/sql/expression.py')
-rw-r--r-- | lib/sqlalchemy/sql/expression.py | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/lib/sqlalchemy/sql/expression.py b/lib/sqlalchemy/sql/expression.py index 969a6920b..0974b7e50 100644 --- a/lib/sqlalchemy/sql/expression.py +++ b/lib/sqlalchemy/sql/expression.py @@ -2141,21 +2141,21 @@ class _DefaultColumnComparator(operators.ColumnOperators): class ColumnElement(ClauseElement, ColumnOperators): - """Represent an element that is usable within the "column clause" portion - of a ``SELECT`` statement. + """Represent a column-oriented SQL expression suitable for usage in the + "columns" clause, WHERE clause etc. of a statement. While the most familiar kind of :class:`.ColumnElement` is the :class:`.Column` object, :class:`.ColumnElement` serves as the basis for any unit that may be present in a SQL expression, including - the columns associated with tables, aliases, and - subqueries, expressions, function calls, SQL keywords such as - ``NULL``, literals, etc. :class:`.ColumnElement` is the ultimate base - class for all such elements. + the expressions themselves, SQL functions, bound parameters, + literal expressions, keywords such as ``NULL``, etc. :class:`.ColumnElement` + is the ultimate base class for all such elements. - A :class:`.ColumnElement` provides the ability to generate new :class:`.ClauseElement` + A :class:`.ColumnElement` provides the ability to generate new + :class:`.ColumnElement` objects using Python expressions. This means that Python operators such as ``==``, ``!=`` and ``<`` are overloaded to mimic SQL operations, - and allow the construction of :class:`.ColumnElement` constructs which + and allow the instantiation of further :class:`.ColumnElement` instances which are composed from other, more fundamental :class:`.ColumnElement` objects. For example, two :class:`.ColumnClause` objects can be added together with the addition operator ``+`` to produce |