- try to document how to get columns from constraints.

unfortunately Sphinx refuses to work correctly for the columns
attribute so we just add a lame message to contains_column().

diff --git a/doc/build/core/constraints.rst b/doc/build/core/constraints.rst
index dfe9e9cdd6a722bf4ca07ad21ef95d75f7c108c9..197eeb8a9f3226c9a0f58d0ec4b2b9c8ab541b52 100644 (file)
--- a/doc/build/core/constraints.rst
+++ b/doc/build/core/constraints.rst
@@ -706,6 +706,13 @@ Constraints API
 .. autoclass:: Constraint
     :members:
 
+.. autoclass:: ColumnCollectionMixin
+    :members:
+
+.. autoclass:: ColumnCollectionConstraint
+    :members:
+    :inherited-members:
+
 .. autoclass:: CheckConstraint
     :members:
     :inherited-members:
@@ -728,6 +735,7 @@ Constraints API
     :members:
     :inherited-members:
 
+
 .. autofunction:: sqlalchemy.schema.conv
 
 .. _schema_indexes:

diff --git a/doc/build/core/internals.rst b/doc/build/core/internals.rst
index 81b4f1a81a3de44c7808aeb2b68460195a26e2f5..56b6162e9f750275084886ab6ba63bba667d3f96 100644 (file)
--- a/doc/build/core/internals.rst
+++ b/doc/build/core/internals.rst
@@ -7,9 +7,6 @@ Some key internal constructs are listed here.
 
 .. currentmodule: sqlalchemy
 
-.. autoclass:: sqlalchemy.schema.ColumnCollectionMixin
-    :members:
-
 .. autoclass:: sqlalchemy.engine.interfaces.Compiled
     :members:
 

diff --git a/lib/sqlalchemy/sql/schema.py b/lib/sqlalchemy/sql/schema.py
index 2120e303babee2d42c1b0dfd807f73925c6c2719..e022c57682dcbca8150267a069c71dab7896f591 100644 (file)
--- a/lib/sqlalchemy/sql/schema.py
+++ b/lib/sqlalchemy/sql/schema.py
@@ -2373,6 +2373,7 @@ def _to_schema_column_or_string(element):
 
 
 class ColumnCollectionMixin(object):
+
     columns = None
     """A :class:`.ColumnCollection` of :class:`.Column` objects.
 
@@ -2455,6 +2456,13 @@ class ColumnCollectionConstraint(ColumnCollectionMixin, Constraint):
         return self._schema_item_copy(c)
 
     def contains_column(self, col):
+        """Return True if this constraint contains the given column.
+
+        Note that this object also contains an attribute ``.columns``
+        which is a :class:`.ColumnCollection` of :class:`.Column` objects.
+
+        """
+
         return self.columns.contains_column(col)
 
     def __iter__(self):