Fixes: #6930

Note in docstrings that ignored kwargs are required for API conformance.

Change-Id: Icc9a8c63c0936a7c5255841ef49d10a83496763a

diff --git a/lib/sqlalchemy/dialects/postgresql/array.py b/lib/sqlalchemy/dialects/postgresql/array.py
index 1b036ac32326504cdd5c1d861220b3e2c2b4c10c..3cb60d3f3b7fd93e205994ca77bde99ae37d04a5 100644 (file)
--- a/lib/sqlalchemy/dialects/postgresql/array.py
+++ b/lib/sqlalchemy/dialects/postgresql/array.py
@@ -221,6 +221,9 @@ class ARRAY(sqltypes.ARRAY):
         def contains(self, other, **kwargs):
             """Boolean expression.  Test if elements are a superset of the
             elements of the argument array expression.
+
+            kwargs may be ignored by this operator but are required for API
+            conformance.
             """
             return self.operate(CONTAINS, other, result_type=sqltypes.Boolean)
 

diff --git a/lib/sqlalchemy/dialects/postgresql/hstore.py b/lib/sqlalchemy/dialects/postgresql/hstore.py
index 30e2d4bc276bb8197de14f6ecf093d6cd07a1227..a4090f1ac5934d662091a9e092ff98b8dae388a7 100644 (file)
--- a/lib/sqlalchemy/dialects/postgresql/hstore.py
+++ b/lib/sqlalchemy/dialects/postgresql/hstore.py
@@ -170,6 +170,9 @@ class HSTORE(sqltypes.Indexable, sqltypes.Concatenable, sqltypes.TypeEngine):
         def contains(self, other, **kwargs):
             """Boolean expression.  Test if keys (or array) are a superset
             of/contained the keys of the argument jsonb expression.
+
+            kwargs may be ignored by this operator but are required for API
+            conformance.
             """
             return self.operate(CONTAINS, other, result_type=sqltypes.Boolean)
 

diff --git a/lib/sqlalchemy/dialects/postgresql/json.py b/lib/sqlalchemy/dialects/postgresql/json.py
index 2277d3cbe0986ad3266bfc701b0cf77f2b51afd1..2acf177f539b1809ddf30c81882757d3baf0dc8c 100644 (file)
--- a/lib/sqlalchemy/dialects/postgresql/json.py
+++ b/lib/sqlalchemy/dialects/postgresql/json.py
@@ -310,6 +310,9 @@ class JSONB(JSON):
         def contains(self, other, **kwargs):
             """Boolean expression.  Test if keys (or array) are a superset
             of/contained the keys of the argument jsonb expression.
+
+            kwargs may be ignored by this operator but are required for API
+            conformance.
             """
             return self.operate(CONTAINS, other, result_type=sqltypes.Boolean)
 

diff --git a/lib/sqlalchemy/dialects/postgresql/ranges.py b/lib/sqlalchemy/dialects/postgresql/ranges.py
index f251a04bd7ed84645cfe03da35922815460c1af1..c54179c8182cef3ea93d75ebf585e9b5494e4ebe 100644 (file)
--- a/lib/sqlalchemy/dialects/postgresql/ranges.py
+++ b/lib/sqlalchemy/dialects/postgresql/ranges.py
@@ -42,6 +42,9 @@ class RangeOperators(object):
             """Boolean expression. Returns true if the right hand operand,
             which can be an element or a range, is contained within the
             column.
+
+            kwargs may be ignored by this operator but are required for API
+            conformance.
             """
             return self.expr.op("@>", is_comparison=True)(other)
 

diff --git a/lib/sqlalchemy/orm/relationships.py b/lib/sqlalchemy/orm/relationships.py
index b44a161022ef7d91c467c4cd6cd4a095cc7cddd0..35dbfc3794c72027ec9fcd93b6a7521c2c78a04a 100644 (file)
--- a/lib/sqlalchemy/orm/relationships.py
+++ b/lib/sqlalchemy/orm/relationships.py
@@ -1539,6 +1539,8 @@ class RelationshipProperty(StrategizedProperty):
             as well as :ref:`ormtutorial_joins`
             for more details on constructing outer joins.
 
+            kwargs may be ignored by this operator but are required for API
+            conformance.
             """
             if not self.property.uselist:
                 raise sa_exc.InvalidRequestError(