801 lines
22 KiB
Python
801 lines
22 KiB
Python
# testing/requirements.py
|
|
# Copyright (C) 2005-2017 the SQLAlchemy authors and contributors
|
|
# <see AUTHORS file>
|
|
#
|
|
# This module is part of SQLAlchemy and is released under
|
|
# the MIT License: http://www.opensource.org/licenses/mit-license.php
|
|
|
|
"""Global database feature support policy.
|
|
|
|
Provides decorators to mark tests requiring specific feature support from the
|
|
target database.
|
|
|
|
External dialect test suites should subclass SuiteRequirements
|
|
to provide specific inclusion/exclusions.
|
|
|
|
"""
|
|
|
|
import sys
|
|
|
|
from . import exclusions
|
|
from .. import util
|
|
|
|
|
|
class Requirements(object):
|
|
pass
|
|
|
|
|
|
class SuiteRequirements(Requirements):
|
|
|
|
@property
|
|
def create_table(self):
|
|
"""target platform can emit basic CreateTable DDL."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def drop_table(self):
|
|
"""target platform can emit basic DropTable DDL."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def foreign_keys(self):
|
|
"""Target database must support foreign keys."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def on_update_cascade(self):
|
|
""""target database must support ON UPDATE..CASCADE behavior in
|
|
foreign keys."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def non_updating_cascade(self):
|
|
"""target database must *not* support ON UPDATE..CASCADE behavior in
|
|
foreign keys."""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def deferrable_fks(self):
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def on_update_or_deferrable_fks(self):
|
|
# TODO: exclusions should be composable,
|
|
# somehow only_if([x, y]) isn't working here, negation/conjunctions
|
|
# getting confused.
|
|
return exclusions.only_if(
|
|
lambda: self.on_update_cascade.enabled or
|
|
self.deferrable_fks.enabled
|
|
)
|
|
|
|
@property
|
|
def self_referential_foreign_keys(self):
|
|
"""Target database must support self-referential foreign keys."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def foreign_key_ddl(self):
|
|
"""Target database must support the DDL phrases for FOREIGN KEY."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def named_constraints(self):
|
|
"""target database must support names for constraints."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def subqueries(self):
|
|
"""Target database must support subqueries."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def offset(self):
|
|
"""target database can render OFFSET, or an equivalent, in a
|
|
SELECT.
|
|
"""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def bound_limit_offset(self):
|
|
"""target database can render LIMIT and/or OFFSET using a bound
|
|
parameter
|
|
"""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def parens_in_union_contained_select_w_limit_offset(self):
|
|
"""Target database must support parenthesized SELECT in UNION
|
|
when LIMIT/OFFSET is specifically present.
|
|
|
|
E.g. (SELECT ...) UNION (SELECT ..)
|
|
|
|
This is known to fail on SQLite.
|
|
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def parens_in_union_contained_select_wo_limit_offset(self):
|
|
"""Target database must support parenthesized SELECT in UNION
|
|
when OFFSET/LIMIT is specifically not present.
|
|
|
|
E.g. (SELECT ... LIMIT ..) UNION (SELECT .. OFFSET ..)
|
|
|
|
This is known to fail on SQLite. It also fails on Oracle
|
|
because without LIMIT/OFFSET, there is currently no step that
|
|
creates an additional subquery.
|
|
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def boolean_col_expressions(self):
|
|
"""Target database must support boolean expressions as columns"""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def nullsordering(self):
|
|
"""Target backends that support nulls ordering."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def standalone_binds(self):
|
|
"""target database/driver supports bound parameters as column expressions
|
|
without being in the context of a typed column.
|
|
|
|
"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def intersect(self):
|
|
"""Target database must support INTERSECT or equivalent."""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def except_(self):
|
|
"""Target database must support EXCEPT or equivalent (i.e. MINUS)."""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def window_functions(self):
|
|
"""Target database must support window functions."""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def autoincrement_insert(self):
|
|
"""target platform generates new surrogate integer primary key values
|
|
when insert() is executed, excluding the pk column."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def fetch_rows_post_commit(self):
|
|
"""target platform will allow cursor.fetchone() to proceed after a
|
|
COMMIT.
|
|
|
|
Typically this refers to an INSERT statement with RETURNING which
|
|
is invoked within "autocommit". If the row can be returned
|
|
after the autocommit, then this rule can be open.
|
|
|
|
"""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def empty_inserts(self):
|
|
"""target platform supports INSERT with no values, i.e.
|
|
INSERT DEFAULT VALUES or equivalent."""
|
|
|
|
return exclusions.only_if(
|
|
lambda config: config.db.dialect.supports_empty_insert or
|
|
config.db.dialect.supports_default_values,
|
|
"empty inserts not supported"
|
|
)
|
|
|
|
@property
|
|
def insert_from_select(self):
|
|
"""target platform supports INSERT from a SELECT."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def returning(self):
|
|
"""target platform supports RETURNING."""
|
|
|
|
return exclusions.only_if(
|
|
lambda config: config.db.dialect.implicit_returning,
|
|
"%(database)s %(does_support)s 'returning'"
|
|
)
|
|
|
|
@property
|
|
def duplicate_names_in_cursor_description(self):
|
|
"""target platform supports a SELECT statement that has
|
|
the same name repeated more than once in the columns list."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def denormalized_names(self):
|
|
"""Target database must have 'denormalized', i.e.
|
|
UPPERCASE as case insensitive names."""
|
|
|
|
return exclusions.skip_if(
|
|
lambda config: not config.db.dialect.requires_name_normalize,
|
|
"Backend does not require denormalized names."
|
|
)
|
|
|
|
@property
|
|
def multivalues_inserts(self):
|
|
"""target database must support multiple VALUES clauses in an
|
|
INSERT statement."""
|
|
|
|
return exclusions.skip_if(
|
|
lambda config: not config.db.dialect.supports_multivalues_insert,
|
|
"Backend does not support multirow inserts."
|
|
)
|
|
|
|
@property
|
|
def implements_get_lastrowid(self):
|
|
""""target dialect implements the executioncontext.get_lastrowid()
|
|
method without reliance on RETURNING.
|
|
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def emulated_lastrowid(self):
|
|
""""target dialect retrieves cursor.lastrowid, or fetches
|
|
from a database-side function after an insert() construct executes,
|
|
within the get_lastrowid() method.
|
|
|
|
Only dialects that "pre-execute", or need RETURNING to get last
|
|
inserted id, would return closed/fail/skip for this.
|
|
|
|
"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def dbapi_lastrowid(self):
|
|
""""target platform includes a 'lastrowid' accessor on the DBAPI
|
|
cursor object.
|
|
|
|
"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def views(self):
|
|
"""Target database must support VIEWs."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def schemas(self):
|
|
"""Target database must support external schemas, and have one
|
|
named 'test_schema'."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def server_side_cursors(self):
|
|
"""Target dialect must support server side cursors."""
|
|
|
|
return exclusions.only_if([
|
|
lambda config: config.db.dialect.supports_server_side_cursors
|
|
], "no server side cursors support")
|
|
|
|
@property
|
|
def sequences(self):
|
|
"""Target database must support SEQUENCEs."""
|
|
|
|
return exclusions.only_if([
|
|
lambda config: config.db.dialect.supports_sequences
|
|
], "no sequence support")
|
|
|
|
@property
|
|
def sequences_optional(self):
|
|
"""Target database supports sequences, but also optionally
|
|
as a means of generating new PK values."""
|
|
|
|
return exclusions.only_if([
|
|
lambda config: config.db.dialect.supports_sequences and
|
|
config.db.dialect.sequences_optional
|
|
], "no sequence support, or sequences not optional")
|
|
|
|
@property
|
|
def reflects_pk_names(self):
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def table_reflection(self):
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def view_column_reflection(self):
|
|
"""target database must support retrieval of the columns in a view,
|
|
similarly to how a table is inspected.
|
|
|
|
This does not include the full CREATE VIEW definition.
|
|
|
|
"""
|
|
return self.views
|
|
|
|
@property
|
|
def view_reflection(self):
|
|
"""target database must support inspection of the full CREATE VIEW definition.
|
|
"""
|
|
return self.views
|
|
|
|
@property
|
|
def schema_reflection(self):
|
|
return self.schemas
|
|
|
|
@property
|
|
def primary_key_constraint_reflection(self):
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def foreign_key_constraint_reflection(self):
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def foreign_key_constraint_option_reflection(self):
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def temp_table_reflection(self):
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def temp_table_names(self):
|
|
"""target dialect supports listing of temporary table names"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def temporary_tables(self):
|
|
"""target database supports temporary tables"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def temporary_views(self):
|
|
"""target database supports temporary views"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def index_reflection(self):
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def unique_constraint_reflection(self):
|
|
"""target dialect supports reflection of unique constraints"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def duplicate_key_raises_integrity_error(self):
|
|
"""target dialect raises IntegrityError when reporting an INSERT
|
|
with a primary key violation. (hint: it should)
|
|
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def unbounded_varchar(self):
|
|
"""Target database must support VARCHAR with no length"""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def unicode_data(self):
|
|
"""Target database/dialect must support Python unicode objects with
|
|
non-ASCII characters represented, delivered as bound parameters
|
|
as well as in result rows.
|
|
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def unicode_ddl(self):
|
|
"""Target driver must support some degree of non-ascii symbol
|
|
names.
|
|
"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def datetime_literals(self):
|
|
"""target dialect supports rendering of a date, time, or datetime as a
|
|
literal string, e.g. via the TypeEngine.literal_processor() method.
|
|
|
|
"""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def datetime(self):
|
|
"""target dialect supports representation of Python
|
|
datetime.datetime() objects."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def datetime_microseconds(self):
|
|
"""target dialect supports representation of Python
|
|
datetime.datetime() with microsecond objects."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def datetime_historic(self):
|
|
"""target dialect supports representation of Python
|
|
datetime.datetime() objects with historic (pre 1970) values."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def date(self):
|
|
"""target dialect supports representation of Python
|
|
datetime.date() objects."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def date_coerces_from_datetime(self):
|
|
"""target dialect accepts a datetime object as the target
|
|
of a date column."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def date_historic(self):
|
|
"""target dialect supports representation of Python
|
|
datetime.datetime() objects with historic (pre 1970) values."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def time(self):
|
|
"""target dialect supports representation of Python
|
|
datetime.time() objects."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def time_microseconds(self):
|
|
"""target dialect supports representation of Python
|
|
datetime.time() with microsecond objects."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def binary_comparisons(self):
|
|
"""target database/driver can allow BLOB/BINARY fields to be compared
|
|
against a bound parameter value.
|
|
"""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def binary_literals(self):
|
|
"""target backend supports simple binary literals, e.g. an
|
|
expression like::
|
|
|
|
SELECT CAST('foo' AS BINARY)
|
|
|
|
Where ``BINARY`` is the type emitted from :class:`.LargeBinary`,
|
|
e.g. it could be ``BLOB`` or similar.
|
|
|
|
Basically fails on Oracle.
|
|
|
|
"""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def json_type(self):
|
|
"""target platform implements a native JSON type."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def json_array_indexes(self):
|
|
""""target platform supports numeric array indexes
|
|
within a JSON structure"""
|
|
|
|
return self.json_type
|
|
|
|
@property
|
|
def precision_numerics_general(self):
|
|
"""target backend has general support for moderately high-precision
|
|
numerics."""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def precision_numerics_enotation_small(self):
|
|
"""target backend supports Decimal() objects using E notation
|
|
to represent very small values."""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def precision_numerics_enotation_large(self):
|
|
"""target backend supports Decimal() objects using E notation
|
|
to represent very large values."""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def precision_numerics_many_significant_digits(self):
|
|
"""target backend supports values with many digits on both sides,
|
|
such as 319438950232418390.273596, 87673.594069654243
|
|
|
|
"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def precision_numerics_retains_significant_digits(self):
|
|
"""A precision numeric type will return empty significant digits,
|
|
i.e. a value such as 10.000 will come back in Decimal form with
|
|
the .000 maintained."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def precision_generic_float_type(self):
|
|
"""target backend will return native floating point numbers with at
|
|
least seven decimal places when using the generic Float type.
|
|
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def floats_to_four_decimals(self):
|
|
"""target backend can return a floating-point number with four
|
|
significant digits (such as 15.7563) accurately
|
|
(i.e. without FP inaccuracies, such as 15.75629997253418).
|
|
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def fetch_null_from_numeric(self):
|
|
"""target backend doesn't crash when you try to select a NUMERIC
|
|
value that has a value of NULL.
|
|
|
|
Added to support Pyodbc bug #351.
|
|
"""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def text_type(self):
|
|
"""Target database must support an unbounded Text() "
|
|
"type such as TEXT or CLOB"""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def empty_strings_varchar(self):
|
|
"""target database can persist/return an empty string with a
|
|
varchar.
|
|
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def empty_strings_text(self):
|
|
"""target database can persist/return an empty string with an
|
|
unbounded text."""
|
|
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def selectone(self):
|
|
"""target driver must support the literal statement 'select 1'"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def savepoints(self):
|
|
"""Target database must support savepoints."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def two_phase_transactions(self):
|
|
"""Target database must support two-phase transactions."""
|
|
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def update_from(self):
|
|
"""Target must support UPDATE..FROM syntax"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def update_where_target_in_subquery(self):
|
|
"""Target must support UPDATE where the same table is present in a
|
|
subquery in the WHERE clause.
|
|
|
|
This is an ANSI-standard syntax that apparently MySQL can't handle,
|
|
such as:
|
|
|
|
UPDATE documents SET flag=1 WHERE documents.title IN
|
|
(SELECT max(documents.title) AS title
|
|
FROM documents GROUP BY documents.user_id
|
|
)
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def mod_operator_as_percent_sign(self):
|
|
"""target database must use a plain percent '%' as the 'modulus'
|
|
operator."""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def percent_schema_names(self):
|
|
"""target backend supports weird identifiers with percent signs
|
|
in them, e.g. 'some % column'.
|
|
|
|
this is a very weird use case but often has problems because of
|
|
DBAPIs that use python formatting. It's not a critical use
|
|
case either.
|
|
|
|
"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def order_by_label_with_expression(self):
|
|
"""target backend supports ORDER BY a column label within an
|
|
expression.
|
|
|
|
Basically this::
|
|
|
|
select data as foo from test order by foo || 'bar'
|
|
|
|
Lots of databases including PostgreSQL don't support this,
|
|
so this is off by default.
|
|
|
|
"""
|
|
return exclusions.closed()
|
|
|
|
@property
|
|
def unicode_connections(self):
|
|
"""Target driver must support non-ASCII characters being passed at
|
|
all.
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def graceful_disconnects(self):
|
|
"""Target driver must raise a DBAPI-level exception, such as
|
|
InterfaceError, when the underlying connection has been closed
|
|
and the execute() method is called.
|
|
"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def skip_mysql_on_windows(self):
|
|
"""Catchall for a large variety of MySQL on Windows failures"""
|
|
return exclusions.open()
|
|
|
|
@property
|
|
def ad_hoc_engines(self):
|
|
"""Test environment must allow ad-hoc engine/connection creation.
|
|
|
|
DBs that scale poorly for many connections, even when closed, i.e.
|
|
Oracle, may use the "--low-connections" option which flags this
|
|
requirement as not present.
|
|
|
|
"""
|
|
return exclusions.skip_if(
|
|
lambda config: config.options.low_connections)
|
|
|
|
@property
|
|
def timing_intensive(self):
|
|
return exclusions.requires_tag("timing_intensive")
|
|
|
|
@property
|
|
def memory_intensive(self):
|
|
return exclusions.requires_tag("memory_intensive")
|
|
|
|
@property
|
|
def threading_with_mock(self):
|
|
"""Mark tests that use threading and mock at the same time - stability
|
|
issues have been observed with coverage + python 3.3
|
|
|
|
"""
|
|
return exclusions.skip_if(
|
|
lambda config: util.py3k and config.options.has_coverage,
|
|
"Stability issues with coverage + py3k"
|
|
)
|
|
|
|
@property
|
|
def python2(self):
|
|
return exclusions.skip_if(
|
|
lambda: sys.version_info >= (3,),
|
|
"Python version 2.xx is required."
|
|
)
|
|
|
|
@property
|
|
def python3(self):
|
|
return exclusions.skip_if(
|
|
lambda: sys.version_info < (3,),
|
|
"Python version 3.xx is required."
|
|
)
|
|
|
|
@property
|
|
def cpython(self):
|
|
return exclusions.only_if(
|
|
lambda: util.cpython,
|
|
"cPython interpreter needed"
|
|
)
|
|
|
|
@property
|
|
def non_broken_pickle(self):
|
|
from sqlalchemy.util import pickle
|
|
return exclusions.only_if(
|
|
lambda: not util.pypy and pickle.__name__ == 'cPickle'
|
|
or sys.version_info >= (3, 2),
|
|
"Needs cPickle+cPython or newer Python 3 pickle"
|
|
)
|
|
|
|
@property
|
|
def predictable_gc(self):
|
|
"""target platform must remove all cycles unconditionally when
|
|
gc.collect() is called, as well as clean out unreferenced subclasses.
|
|
|
|
"""
|
|
return self.cpython
|
|
|
|
@property
|
|
def no_coverage(self):
|
|
"""Test should be skipped if coverage is enabled.
|
|
|
|
This is to block tests that exercise libraries that seem to be
|
|
sensitive to coverage, such as PostgreSQL notice logging.
|
|
|
|
"""
|
|
return exclusions.skip_if(
|
|
lambda config: config.options.has_coverage,
|
|
"Issues observed when coverage is enabled"
|
|
)
|
|
|
|
def _has_mysql_on_windows(self, config):
|
|
return False
|
|
|
|
def _has_mysql_fully_case_sensitive(self, config):
|
|
return False
|
|
|
|
@property
|
|
def sqlite(self):
|
|
return exclusions.skip_if(lambda: not self._has_sqlite())
|
|
|
|
@property
|
|
def cextensions(self):
|
|
return exclusions.skip_if(
|
|
lambda: not self._has_cextensions(), "C extensions not installed"
|
|
)
|
|
|
|
def _has_sqlite(self):
|
|
from sqlalchemy import create_engine
|
|
try:
|
|
create_engine('sqlite://')
|
|
return True
|
|
except ImportError:
|
|
return False
|
|
|
|
def _has_cextensions(self):
|
|
try:
|
|
from sqlalchemy import cresultproxy, cprocessors
|
|
return True
|
|
except ImportError:
|
|
return False
|