OwlCyberSecurity - MANAGER
Edit File: requirements.cpython-312.pyc
� E��g�� � � � d Z ddlmZ ddlZddlmZ ddlmZ ddlmZ dd lm Z dd lm Z dd l m Z G d � d � Z G d� de � Zy)z�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. � )� annotationsN� )�asyncio)� exclusions��only_on� �� create_engine)�util)� QueuePoolc � � e Zd Zy)� RequirementsN)�__name__� __module__� __qualname__� � �P/opt/hc_python/lib64/python3.12/site-packages/sqlalchemy/testing/requirements.pyr r s � �r r c � � e Zd Zed� � Zed� � Zed� � Zed� � Zed� � Zed� � Z ed� � Z ed� � Z ed � � Z ed � � Z ed � � Zed � � Zed � � Zed� � Zed� � Zed� � Zed� � Zed� � Zed� � Zed� � Zed� � Zed� � Zed� � Zed� � Zed� � Z ed� � Z ed� � Z ed � � Z ed � � Z ed � � Z!ed � � Z"ed � � Z#ed!� � Z$ed"� � Z%ed#� � Z&ed$� � Z'ed%� � Z(ed&� � Z)ed'� � Z*ed(� � Z+ed)� � Z,ed*� � Z-ed+� � Z.ed,� � Z/ed-� � Z0ed.� � Z1ed/� � Z2ed0� � Z3ed1� � Z4ed2� � Z5ed3� � Z6ed4� � Z7ed5� � Z8ed6� � Z9ed7� � Z:ed8� � Z;ed9� � Z<ed:� � Z=ed;� � Z>ed<� � Z?ed=� � Z@ed>� � ZAed?� � ZBed@� � ZCedA� � ZDedB� � ZEedC� � ZFedD� � ZGedE� � ZHedF� � ZIedG� � ZJedH� � ZKedI� � ZLedJ� � ZMedK� � ZNedL� � ZOedM� � ZPedN� � ZQedO� � ZRedP� � ZSedQ� � ZTedR� � ZUedS� � ZVedT� � ZWedU� � ZXedV� � ZYedW� � ZZedX� � Z[edY� � Z\edZ� � Z]ed[� � Z^ed\� � Z_ed]� � Z`ed^� � Zaed_� � Zbed`� � Zceda� � Zdedb� � Zeedc� � Zfedd� � Zgede� � Zhedf� � Ziedg� � Zjedh� � Zkedi� � Zledj� � Zmedk� � Znedl� � Zoedm� � Zpedn� � Zqedo� � Zredp� � Zsedq� � Ztedr� � Zueds� � Zvedt� � Zwedu� � Zxedv� � Zyedw� � Zzedx� � Z{edy� � Z|edz� � Z}ed{� � Z~ed|� � Zed}� � Z�ed~� � Z�ed� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�d�� Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�d�� Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�d�� Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed�� � Z�ed � Z�edÄ � Z�edĄ � Z�edń � Z�edƄ � Z�dDŽ Z�dȄ Z�edɄ � Z�edʄ � Z�d˄ Z�ed̄ � Z�ed̈́ � Z�ed΄ � Z�edτ � Z�edЄ � Z�edф � Z�ed҄ � Z�edӄ � Z�edԄ � Z�edՄ � Z�edք � Z�edׄ � Z�ed � Z�edل � Z�edڄ � Z�edۄ � Z�ed܄ � Z�ed݄ � Z�edބ � Z�ed߄ � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�ed� � Z�y�)��SuiteRequirementsc �* � t j � S )z/target platform can emit basic CreateTable DDL.�r �open��selfs r � create_tablez SuiteRequirements.create_table% � � � ��� � r c �* � t j � S )z-target platform can emit basic DropTable DDL.r r s r � drop_tablez SuiteRequirements.drop_table+ r r c �* � t j � S )z>target platform supports IF NOT EXISTS / IF EXISTS for tables.�r �closedr s r �table_ddl_if_existsz%SuiteRequirements.table_ddl_if_exists1 � � � � � �"�"r c �* � t j � S )z?target platform supports IF NOT EXISTS / IF EXISTS for indexes.r" r s r �index_ddl_if_existsz%SuiteRequirements.index_ddl_if_exists7 r% r c �* � t j � S )z0Return databases that support the UUID datatype.r" r s r �uuid_data_typez SuiteRequirements.uuid_data_type= r% r c �* � t j � S )z*Target database must support foreign keys.r r s r � foreign_keysz SuiteRequirements.foreign_keysC r r c �* � t j � S )zKTarget database creates an index that's reflected for foreign keys.r" r s r � foreign_keys_reflect_as_indexz/SuiteRequirements.foreign_keys_reflect_as_indexI � � � � � �"�"r c �* � t j � S )z=Target database reflects unique indexes as unique constrains.r" r s r �*unique_index_reflect_as_unique_constraintsz<SuiteRequirements.unique_index_reflect_as_unique_constraintsP r% r c �* � t j � S )z7Target database reflects unique constraints as indexes.r" r s r �#unique_constraints_reflect_as_indexz5SuiteRequirements.unique_constraints_reflect_as_indexV r% r c �* � t j � S )z�Database / dialect supports a query like: .. sourcecode:: sql SELECT * FROM VALUES ( (c1, c2), (c1, c2), ...) AS some_table(col1, col2) SQLAlchemy generates this with the :func:`_sql.values` function. r" r s r �table_value_constructorz)SuiteRequirements.table_value_constructor\ s � � � � �"�"r c �* � t j � S )a� Target database passes SQL-92 style statements to cursor.execute() when a statement like select() or insert() is run. A very small portion of dialect-level tests will ensure that certain conditions are present in SQL strings, and these tests use very basic SQL that will work on any SQL-like platform in order to assert results. It's normally a given for any pep-249 DBAPI that a statement like "SELECT id, name FROM table WHERE some_table.id=5" will work. However, there are dialects that don't actually produce SQL Strings and instead may work with symbolic objects instead, or dialects that aren't working with SQL, so for those this requirement can be marked as excluded. r r s r �standard_cursor_sqlz%SuiteRequirements.standard_cursor_sqlj s � �$ ��� � r c �* � t j � S )zQtarget database must support ON UPDATE..CASCADE behavior in foreign keys.r r s r �on_update_cascadez#SuiteRequirements.on_update_cascade~ � � � ��� � r c �* � t j � S )zWtarget database must *not* support ON UPDATE..CASCADE behavior in foreign keys.r" r s r �non_updating_cascadez&SuiteRequirements.non_updating_cascade� r% r c �* � t j � S �Nr" r s r �deferrable_fksz SuiteRequirements.deferrable_fks� � � �� � �"�"r c �4 � � t j � fd�� S )Nc �` �� � j j xs � j j S r= )r8 �enabledr> r s �r �<lambda>z?SuiteRequirements.on_update_or_deferrable_fks.<locals>.<lambda>� s* �� �D�*�*�2�2� +��"�"�*�*�+r �r �only_ifr s `r �on_update_or_deferrable_fksz-SuiteRequirements.on_update_or_deferrable_fks� s �� � �!�!� +� � r c �2 � d� }t j |� S )z"target database is using QueuePoolc �J � t | j j t � S r= )� isinstance�db�poolr ��configs r �goz(SuiteRequirements.queue_pool.<locals>.go� s � � �f�i�i�n�n�i�8� 8r rD �r rN s r � queue_poolz SuiteRequirements.queue_pool� s � � 9� �!�!�"�%�%r c �* � t j � S )z;Target database must support self-referential foreign keys.r r s r � self_referential_foreign_keysz/SuiteRequirements.self_referential_foreign_keys� r r c �* � t j � S )z=Target database must support the DDL phrases for FOREIGN KEY.r r s r �foreign_key_ddlz!SuiteRequirements.foreign_key_ddl� r r c �* � t j � S )z3target database must support names for constraints.r r s r �named_constraintsz#SuiteRequirements.named_constraints� r r c �* � t j � S )z8target database must apply names to unnamed constraints.r r s r � implicitly_named_constraintsz.SuiteRequirements.implicitly_named_constraints� r r c �* � t j � S )a target database allows column names that have unusual characters in them, such as dots, spaces, slashes, or percent signs. The column names are as always in such a case quoted, however the DB still needs to support those characters in the name somehow. r r s r � unusual_column_name_charactersz0SuiteRequirements.unusual_column_name_characters� s � � ��� � r c �* � t j � S )z(Target database must support subqueries.r r s r � subqueriesz SuiteRequirements.subqueries� r r c �* � t j � S )zRtarget database can render OFFSET, or an equivalent, in a SELECT. r r s r �offsetzSuiteRequirements.offset� � � � ��� � r c �* � t j � S )zWtarget database can render LIMIT and/or OFFSET using a bound parameter r r s r �bound_limit_offsetz$SuiteRequirements.bound_limit_offset� r_ r c �* � t j � S )z�target database can render LIMIT and/or OFFSET with a complete SQL expression, such as one that uses the addition operator. parameter r r s r �sql_expression_limit_offsetz-SuiteRequirements.sql_expression_limit_offset� � � � ��� � r c �* � t j � S )z�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. r r s r �/parens_in_union_contained_select_w_limit_offsetzASuiteRequirements.parens_in_union_contained_select_w_limit_offset� � � � ��� � r c �* � t j � S )al 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. r r s r �0parens_in_union_contained_select_wo_limit_offsetzBSuiteRequirements.parens_in_union_contained_select_wo_limit_offset� � � � ��� � r c �* � t j � S )z;Target database must support boolean expressions as columnsr" r s r �boolean_col_expressionsz)SuiteRequirements.boolean_col_expressions� r% r c �* � t j � S )z5Target database allows boolean columns to store NULL.r r s r �nullable_booleansz#SuiteRequirements.nullable_booleans r r c �* � t j � S )z,Target backends that support nulls ordering.r" r s r � nullsorderingz SuiteRequirements.nullsordering r% r c �* � t j � S )z�target database/driver supports bound parameters as column expressions without being in the context of a typed column. r r s r �standalone_bindsz"SuiteRequirements.standalone_binds r9 r c �* � t j � S )z�target database/driver supports bound parameters with NULL in the WHERE clause, in situations where it has to be typed. r r s r �!standalone_null_binds_whereclausez3SuiteRequirements.standalone_null_binds_whereclause r_ r c �* � t j � S )z5Target database must support INTERSECT or equivalent.r" r s r � intersectzSuiteRequirements.intersect � � � � � �"�"r c �* � t j � S )z?Target database must support EXCEPT or equivalent (i.e. MINUS).r" r s r �except_zSuiteRequirements.except_$ rw r c �* � t j � S )z.Target database must support window functions.r" r s r �window_functionsz"SuiteRequirements.window_functions) rw r c �* � t j � S )z Target database supports CTEsr" r s r �cteszSuiteRequirements.ctes. r% r c �* � t j � S )z�target database supports CTES that ride on top of a normal UPDATE or DELETE statement which refers to the CTE in a correlated subquery. r" r s r �ctes_with_update_deletez)SuiteRequirements.ctes_with_update_delete4 � � � � � �"�"r c �* � t j � S )z}target database supports CTES which consist of INSERT, UPDATE or DELETE *within* the CTE, e.g. WITH x AS (UPDATE....)r" r s r � ctes_on_dmlz SuiteRequirements.ctes_on_dml= r. r c �* � t j � S )z~target platform generates new surrogate integer primary key values when insert() is executed, excluding the pk column.r r s r �autoincrement_insertz&SuiteRequirements.autoincrement_insertD r9 r c �* � t j � S )a# 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. r r s r �fetch_rows_post_commitz(SuiteRequirements.fetch_rows_post_commitK s � � ��� � r c �* � t j � S )z�target platform supports SQL expressions in GROUP BY e.g. SELECT x + y AS somelabel FROM table GROUP BY x + y r r s r �group_by_complex_expressionz-SuiteRequirements.group_by_complex_expressionX rg r c �0 � t j d� d� S )Nc �D � | j j j S r= )rJ �dialect�supports_sane_rowcountrL s r rC z1SuiteRequirements.sane_rowcount.<locals>.<lambda>g s � �v�y�y� 0� 0� G� G�Gr z&driver doesn't support 'sane' rowcount�r �skip_ifr s r � sane_rowcountz SuiteRequirements.sane_rowcountd s � ��!�!� G� 4� � r c �0 � t j d� d� S )Nc �D � | j j j S r= )rJ r� � supports_sane_multi_rowcountrL s r rC z7SuiteRequirements.sane_multi_rowcount.<locals>.<lambda>n s � �v�y�y� 0� 0� M� M�Mr z;driver %(driver)s %(doesnt_support)s 'sane' multi row count�r �fails_ifr s r �sane_multi_rowcountz%SuiteRequirements.sane_multi_rowcountk s � ��"�"� M� I� � r c �0 � t j d� d� S )Nc �D � | j j j S r= )rJ r� � supports_sane_rowcount_returningrL s r rC z=SuiteRequirements.sane_rowcount_w_returning.<locals>.<lambda>u s � �� � �!�!�B�B� r z;driver doesn't support 'sane' rowcount when returning is onr� r s r �sane_rowcount_w_returningz+SuiteRequirements.sane_rowcount_w_returningr s � ��"�"� � J� � r c �0 � t j d� d� S )zatarget platform supports INSERT with no values, i.e. INSERT DEFAULT VALUES or equivalent.c �� � | j j j xsB | j j j xs | j j j S r= )rJ r� �supports_empty_insert�supports_default_values�supports_default_metavaluerL s r rC z1SuiteRequirements.empty_inserts.<locals>.<lambda>� sI � �6�9�9�,�,�B�B� <��y�y� � �8�8� <��y�y� � �;�;� <r zempty inserts not supportedrD r s r � empty_insertsz SuiteRequirements.empty_inserts{ s! � � �!�!� <� *� � r c � � | j S )zvtarget platform supports INSERT with no values, i.e. INSERT DEFAULT VALUES or equivalent, within executemany())r� r s r �empty_inserts_executemanyz+SuiteRequirements.empty_inserts_executemany� s � � �!�!�!r c �* � t j � S )z.target platform supports INSERT from a SELECT.r r s r �insert_from_selectz$SuiteRequirements.insert_from_select� r r c �0 � t j d� d� S )z.target platform supports DELETE ... RETURNING.c �B � | j j j S r= )rJ r� �delete_returningrL s r rC z4SuiteRequirements.delete_returning.<locals>.<lambda>� � � �6�9�9�,�,�=�=r z4%(database)s %(does_support)s 'DELETE ... RETURNING'rD r s r r� z"SuiteRequirements.delete_returning� � � � �!�!� =� B� � r c �0 � t j d� d� S )z.target platform supports INSERT ... RETURNING.c �B � | j j j S r= )rJ r� �insert_returningrL s r rC z4SuiteRequirements.insert_returning.<locals>.<lambda>� r� r z4%(database)s %(does_support)s 'INSERT ... RETURNING'rD r s r r� z"SuiteRequirements.insert_returning� r� r c �0 � t j d� d� S )z.target platform supports UPDATE ... RETURNING.c �B � | j j j S r= )rJ r� �update_returningrL s r rC z4SuiteRequirements.update_returning.<locals>.<lambda>� r� r z4%(database)s %(does_support)s 'UPDATE ... RETURNING'rD r s r r� z"SuiteRequirements.update_returning� r� r c �0 � t j d� d� S )z�target platform supports RETURNING when INSERT is used with executemany(), e.g. multiple parameter sets, indicating as many rows come back as do parameter sets were passed. c �B � | j j j S r= )rJ r� � insert_executemany_returningrL s r rC z@SuiteRequirements.insert_executemany_returning.<locals>.<lambda>� s � �6�9�9�,�,�I�Ir zR%(database)s %(does_support)s 'RETURNING of multiple rows with INSERT executemany'rD r s r r� z.SuiteRequirements.insert_executemany_returning� s � � �!�!� I� 5� � r c �0 � t j d� d� S )Nc �� � | j j j xrB | j j j xr | j j j S r= )rJ r� �supports_multivalues_insertr� �use_insertmanyvaluesrL s r rC z4SuiteRequirements.insertmanyvalues.<locals>.<lambda>� sI � �6�9�9�,�,�H�H� 7�� � �!�!�2�2� 7�� � �!�!�6�6� 7r z=%(database)s %(does_support)s 'insertmanyvalues functionalityrD r s r �insertmanyvaluesz"SuiteRequirements.insertmanyvalues� s � ��!�!� 7� L� � r c �* � t j � S )zZTarget platform supports the syntax "(x, y) IN ((x1, y1), (x2, y2), ...)" r" r s r �tuple_inzSuiteRequirements.tuple_in� � � � � � �"�"r c � � | j S )z%Target platform tuple IN w/ empty set)r� r s r �tuple_in_w_emptyz"SuiteRequirements.tuple_in_w_empty� s � � �}�}� r c �* � t j � S )zwtarget platform supports a SELECT statement that has the same name repeated more than once in the columns list.r r s r �%duplicate_names_in_cursor_descriptionz7SuiteRequirements.duplicate_names_in_cursor_description� r9 r c �0 � t j d� d� S )z[Target database must have 'denormalized', i.e. UPPERCASE as case insensitive names.c �D � | j j j S r= )rJ r� �requires_name_normalizerL s r rC z6SuiteRequirements.denormalized_names.<locals>.<lambda>� s � �v�y�y� 0� 0� H� H�Hr z,Backend does not require denormalized names.r� r s r �denormalized_namesz$SuiteRequirements.denormalized_names� s � � �!�!� H� :� � r c �0 � t j d� d� S )zTtarget database must support multiple VALUES clauses in an INSERT statement.c �D � | j j j S r= )rJ r� r� rL s r rC z7SuiteRequirements.multivalues_inserts.<locals>.<lambda>� s � �v�y�y� 0� 0� L� L�Lr z*Backend does not support multirow inserts.r� r s r �multivalues_insertsz%SuiteRequirements.multivalues_inserts� s � � �!�!� L� 8� � r c �* � t j � S )zvtarget dialect implements the executioncontext.get_lastrowid() method without reliance on RETURNING. r r s r �implements_get_lastrowidz*SuiteRequirements.implements_get_lastrowid� r_ r c �* � t j � S )zLdialect includes the required pep-249 attribute ``cursor.arraysize``r r s r � arraysizezSuiteRequirements.arraysize� r9 r c �* � t j � S )a< 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. r" r s r �emulated_lastrowidz$SuiteRequirements.emulated_lastrowid� � � � � � �"�"r c �* � t j � S )z�target dialect retrieves cursor.lastrowid or an equivalent after an insert() construct executes, even if the table has a Sequence on it. r" r s r �&emulated_lastrowid_even_with_sequencesz8SuiteRequirements.emulated_lastrowid_even_with_sequences r� r c �* � t j � S )z]target platform includes a 'lastrowid' accessor on the DBAPI cursor object. r" r s r �dbapi_lastrowidz!SuiteRequirements.dbapi_lastrowid r� r c �* � t j � S )z#Target database must support VIEWs.r" r s r �viewszSuiteRequirements.views r% r c � � t d� � S )zXTarget database must support external schemas, and have one named 'test_schema'.c �B � | j j j S r= )rJ r� �supports_schemasrL s r rC z+SuiteRequirements.schemas.<locals>.<lambda>% s � �f�i�i�&7�&7�&H�&Hr r r s r �schemaszSuiteRequirements.schemas s � � �H�I�Ir c �* � t j � S )zJtarget system must support reflection of inter-schema foreign keysr" r s r �cross_schema_fk_reflectionz,SuiteRequirements.cross_schema_fk_reflection' r% r c �* � t j � S )a Target supports reflection of FOREIGN KEY constraints and will return the name of the constraint that was used in the "CONSTRAINT <name> FOREIGN KEY" DDL. MySQL prior to version 8 and MariaDB prior to version 10.5 don't support this. r" r s r �&foreign_key_constraint_name_reflectionz8SuiteRequirements.foreign_key_constraint_name_reflection- r� r c �* � t j � S )z�target system has a strong concept of 'default' schema that can be referred to implicitly. basically, PostgreSQL. r" r s r �implicit_default_schemaz)SuiteRequirements.implicit_default_schema9 � � � � � �"�"r c �* � t j � S )z`target dialect implements provisioning module including set_default_schema_on_connectionr" r s r �default_schema_name_switchz,SuiteRequirements.default_schema_name_switchC r. r c �2 � t j d� gd� S )z0Target dialect must support server side cursors.c �B � | j j j S r= )rJ r� � supports_server_side_cursorsrL s r rC z7SuiteRequirements.server_side_cursors.<locals>.<lambda>O s � �F�I�I� -� -� J� Jr z no server side cursors supportrD r s r �server_side_cursorsz%SuiteRequirements.server_side_cursorsJ s � � �!�!� J� K� ,� � r c �2 � t j d� gd� S )z'Target database must support SEQUENCEs.c �B � | j j j S r= )rJ r� �supports_sequencesrL s r rC z-SuiteRequirements.sequences.<locals>.<lambda>X s � �F�I�I� -� -� @� @r zno sequence supportrD r s r � sequenceszSuiteRequirements.sequencesS s � � �!�!� @� A� !� � r c �@ � t j | j � S )zJthe opposite of "sequences", DB does not support sequences at all.)r � NotPredicater� r s r � no_sequencesz SuiteRequirements.no_sequences\ s � � �&�&�t�~�~�6�6r c �2 � t j d� gd� S )zgTarget database supports sequences, but also optionally as a means of generating new PK values.c � � | j j j xr | j j j S r= )rJ r� r� �sequences_optionalrL s r rC z6SuiteRequirements.sequences_optional.<locals>.<lambda>j s1 � �v�y�y� 0� 0� C� C� 9��I�I�%�%�8�8� 9r z.no sequence support, or sequences not optionalrD r s r r� z$SuiteRequirements.sequences_optionalc s& � � �!�!�9� � =� � r c �0 � t j d� g� S )a target database / driver supports cursor.lastrowid as a means of retrieving the last inserted primary key value. note that if the target DB supports sequences also, this is still assumed to work. This is a new use case brought on by MariaDB 10.3. c �B � | j j j S r= �rJ r� �postfetch_lastrowidrL s r rC z6SuiteRequirements.supports_lastrowid.<locals>.<lambda>z s � �F�I�I� -� -� A� Ar rD r s r �supports_lastrowidz$SuiteRequirements.supports_lastrowidp s � � �!�!� A� B� � r c �0 � t j d� g� S )z"the opposite of supports_lastrowidc �D � | j j j S r= r� rL s r rC z8SuiteRequirements.no_lastrowid_support.<locals>.<lambda>� s � �� � � 1� 1� E� E� Er rD r s r �no_lastrowid_supportz&SuiteRequirements.no_lastrowid_support} s � � �!�!� E� F� � r c �* � t j � S r= r" r s r �reflects_pk_namesz#SuiteRequirements.reflects_pk_names� r? r c �* � t j � S )z8target database has general support for table reflectionr r s r �table_reflectionz"SuiteRequirements.table_reflection� � � � ��� � r c �* � t j � S )z�target database supports creation and reflection of tables with no columns, or at least tables that seem to have no columns.r" r s r �reflect_tables_no_columnsz+SuiteRequirements.reflect_tables_no_columns� r. r c �* � t j � S )z:Indicates if the database support table comment reflectionr" r s r �comment_reflectionz$SuiteRequirements.comment_reflection� rw r c �* � t j � S )z{Indicates if the database support table comment reflection in the full unicode range, including emoji etc. r" r s r � comment_reflection_full_unicodez1SuiteRequirements.comment_reflection_full_unicode� r. r c �* � t j � S )zVindicates if the database support comments on constraints and their reflectionr" r s r � constraint_comment_reflectionz/SuiteRequirements.constraint_comment_reflection� r% r c � � | j S )z�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. �r� r s r �view_column_reflectionz(SuiteRequirements.view_column_reflection� s � � �z�z�r c � � | j S )zStarget database must support inspection of the full CREATE VIEW definition.r r s r �view_reflectionz!SuiteRequirements.view_reflection� s � � �z�z�r c � � | j S r= )r� r s r �schema_reflectionz#SuiteRequirements.schema_reflection� s � ��|�|�r c �* � t j � S )zatarget database supports schema create and dropped with 'CREATE SCHEMA' and 'DROP SCHEMA'r" r s r �schema_create_deletez&SuiteRequirements.schema_create_delete� r% r c �* � t j � S r= r r s r �!primary_key_constraint_reflectionz3SuiteRequirements.primary_key_constraint_reflection� � � ���� � r c �* � t j � S r= r r s r �!foreign_key_constraint_reflectionz3SuiteRequirements.foreign_key_constraint_reflection� r r c �* � t j � S r= r" r s r �1foreign_key_constraint_option_reflection_ondeletezCSuiteRequirements.foreign_key_constraint_option_reflection_ondelete� r? r c �* � t j � S r= r" r s r �1fk_constraint_option_reflection_ondelete_restrictzCSuiteRequirements.fk_constraint_option_reflection_ondelete_restrict� r? r c �* � t j � S r= r" r s r �1fk_constraint_option_reflection_ondelete_noactionzCSuiteRequirements.fk_constraint_option_reflection_ondelete_noaction� r? r c �* � t j � S r= r" r s r �1foreign_key_constraint_option_reflection_onupdatezCSuiteRequirements.foreign_key_constraint_option_reflection_onupdate� r? r c �* � t j � S r= r" r s r �1fk_constraint_option_reflection_onupdate_restrictzCSuiteRequirements.fk_constraint_option_reflection_onupdate_restrict� r? r c �* � t j � S r= r r s r �temp_table_reflectionz'SuiteRequirements.temp_table_reflection� r r c � � | j S r= )r r s r �temp_table_reflect_indexesz,SuiteRequirements.temp_table_reflect_indexes� s � ��)�)�)r c �* � t j � S )z8target dialect supports listing of temporary table namesr" r s r �temp_table_namesz"SuiteRequirements.temp_table_names� rw r c �* � t j � S )z9target dialect supports checking a single temp table namer" r s r �has_temp_tablez SuiteRequirements.has_temp_table� rw r c �* � t j � S )z)target database supports temporary tablesr r s r �temporary_tablesz"SuiteRequirements.temporary_tables� r� r c �* � t j � S )z(target database supports temporary viewsr" r s r �temporary_viewsz!SuiteRequirements.temporary_views� rw r c �* � t j � S r= r r s r �index_reflectionz"SuiteRequirements.index_reflection� r r c �* � t j � S r= r" r s r � index_reflects_included_columnsz1SuiteRequirements.index_reflects_included_columns� r? r c �* � t j � S )z?target database supports CREATE INDEX with per-column ASC/DESC.r r s r �indexes_with_ascdescz&SuiteRequirements.indexes_with_ascdesc r� r c �* � t j � S )zKtarget database supports reflecting INDEX with per-column ASC/DESC.r r s r � reflect_indexes_with_ascdescz.SuiteRequirements.reflect_indexes_with_ascdesc r r c �* � t j � S )zztarget database supports reflecting INDEX with per-column ASC/DESC but reflects them as expressions (like oracle).r" r s r �*reflect_indexes_with_ascdesc_as_expressionz<SuiteRequirements.reflect_indexes_with_ascdesc_as_expression r% r c �* � t j � S )z>target database supports CREATE INDEX against SQL expressions.r" r s r �indexes_with_expressionsz*SuiteRequirements.indexes_with_expressions rw r c �* � t j � S )zLtarget database supports reflection of indexes with SQL expressions.r" r s r � reflect_indexes_with_expressionsz2SuiteRequirements.reflect_indexes_with_expressions r% r c �* � t j � S )z8target dialect supports reflection of unique constraintsr r s r � unique_constraint_reflectionz.SuiteRequirements.unique_constraint_reflection r� r c �* � t j � S )z>target dialect supports reflection of inline check constraintsr" r s r �"inline_check_constraint_reflectionz4SuiteRequirements.inline_check_constraint_reflection! rw r c �* � t j � S )z7target dialect supports reflection of check constraintsr" r s r �check_constraint_reflectionz-SuiteRequirements.check_constraint_reflection& rw r c �* � t j � S )z�target dialect raises IntegrityError when reporting an INSERT with a primary key violation. (hint: it should) r r s r �$duplicate_key_raises_integrity_errorz6SuiteRequirements.duplicate_key_raises_integrity_error+ r_ r c �* � t j � S )z3Target database must support VARCHAR with no lengthr r s r �unbounded_varcharz#SuiteRequirements.unbounded_varchar3 r r c �* � t j � S )z�Target database/dialect can receive / deliver / compare data with non-ASCII characters in plain VARCHAR, TEXT columns, without the need for special "national" datatypes like NVARCHAR or similar. r r s r � unicode_data_no_special_typesz/SuiteRequirements.unicode_data_no_special_types9 rd r c �* � t j � S )z�Target database/dialect must support Python unicode objects with non-ASCII characters represented, delivered as bound parameters as well as in result rows. r r s r � unicode_dataz SuiteRequirements.unicode_dataB rd r c �* � t j � S )zRTarget driver must support some degree of non-ascii symbol names. r" r s r � unicode_ddlz SuiteRequirements.unicode_ddlK r. r c �* � t j � S )z?Target driver can create tables with a name like 'some " table'r r s r �symbol_names_w_double_quotez-SuiteRequirements.symbol_names_w_double_quoteR r� r c �* � t j � S )z�target dialect supports rendering of a datetime.timedelta as a literal string, e.g. via the TypeEngine.literal_processor() method. r" r s r �datetime_intervalz#SuiteRequirements.datetime_intervalW r� r c �* � t j � S )z�target dialect supports rendering of a date, time, or datetime as a literal string, e.g. via the TypeEngine.literal_processor() method. r" r s r �datetime_literalsz#SuiteRequirements.datetime_literals_ r� r c �* � t j � S )zUtarget dialect supports representation of Python datetime.datetime() objects.r r s r �datetimezSuiteRequirements.datetimeh r9 r c �* � t j � S )zvtarget dialect supports representation of Python datetime.datetime() with tzinfo with DateTime(timezone=True).r" r s r �datetime_timezonez#SuiteRequirements.datetime_timezoneo r. r c �* � t j � S )zntarget dialect supports representation of Python datetime.time() with tzinfo with Time(timezone=True).r" r s r � time_timezonez SuiteRequirements.time_timezonev r. r c �* � t j � S )z�target dialect when given a date object will bind it such that the database server knows the object is a date, and not a plain string. r r s r �date_implicit_boundz%SuiteRequirements.date_implicit_bound} rd r c �* � t j � S )z�target dialect when given a time object will bind it such that the database server knows the object is a time, and not a plain string. r r s r �time_implicit_boundz%SuiteRequirements.time_implicit_bound� rd r c �* � t j � S )z�target dialect when given a datetime object will bind it such that the database server knows the object is a datetime, and not a plain string. r r s r �datetime_implicit_boundz)SuiteRequirements.datetime_implicit_bound� rd r c �* � t j � S )zftarget dialect supports representation of Python datetime.datetime() with microsecond objects.r r s r �datetime_microsecondsz'SuiteRequirements.datetime_microseconds� r9 r c �* � t j � S )z�target dialect supports representation of Python datetime.datetime() with microsecond objects but only if TIMESTAMP is used.r" r s r �timestamp_microsecondsz(SuiteRequirements.timestamp_microseconds� r. r c � � | j S )a target dialect when given a datetime object which also includes a microseconds portion when using the TIMESTAMP data type will bind it such that the database server knows the object is a datetime with microseconds, and not a plain string. )rY r s r �%timestamp_microseconds_implicit_boundz7SuiteRequirements.timestamp_microseconds_implicit_bound� s � � �*�*�*r c �* � t j � S �zutarget dialect supports representation of Python datetime.datetime() objects with historic (pre 1970) values.r" r s r �datetime_historicz#SuiteRequirements.datetime_historic� r. r c �* � t j � S )zQtarget dialect supports representation of Python datetime.date() objects.r r s r �datezSuiteRequirements.date� r9 r c �* � t j � S )zPtarget dialect accepts a datetime object as the target of a date column.r r s r �date_coerces_from_datetimez,SuiteRequirements.date_coerces_from_datetime� r9 r c �* � t j � S r] r" r s r � date_historicz SuiteRequirements.date_historic� r. r c �* � t j � S )zQtarget dialect supports representation of Python datetime.time() objects.r r s r �timezSuiteRequirements.time� r9 r c �* � t j � S )zbtarget dialect supports representation of Python datetime.time() with microsecond objects.r r s r �time_microsecondsz#SuiteRequirements.time_microseconds� r9 r c �* � t j � S )zttarget database/driver can allow BLOB/BINARY fields to be compared against a bound parameter value. r r s r �binary_comparisonsz$SuiteRequirements.binary_comparisons� r_ r c �* � t j � S )a= target backend supports simple binary literals, e.g. an expression like: .. sourcecode:: sql 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. r r s r �binary_literalsz!SuiteRequirements.binary_literals� � � � ��� � r c �* � t j � S )z:target dialect supports 'AUTOCOMMIT' as an isolation_levelr" r s r � autocommitz SuiteRequirements.autocommit� rw r c �* � t j � S )z�target dialect supports general isolation level settings. Note that this requirement, when enabled, also requires that the get_isolation_levels() method be implemented. r" r s r �isolation_levelz!SuiteRequirements.isolation_level� r� r c �" � |j j � 5 } |j j |j j � }|j j |d�cddd� S # t $ r Y ddd� yw xY w# 1 sw Y yxY w)a� Return a structure of supported isolation levels for the current testing dialect. The structure indicates to the testing suite what the expected "default" isolation should be, as well as the other values that are accepted. The dictionary has two keys, "default" and "supported". The "supported" key refers to a list of all supported levels and it should include AUTOCOMMIT if the dialect supports it. If the :meth:`.DefaultRequirements.isolation_level` requirement is not open, then this method has no return value. E.g.:: >>> testing.requirements.get_isolation_levels() { "default": "READ_COMMITTED", "supported": [ "SERIALIZABLE", "READ UNCOMMITTED", "READ COMMITTED", "REPEATABLE READ", "AUTOCOMMIT" ] } )�default� supportedN)rJ �connectr� �get_isolation_level_values� connection�dbapi_connection�default_isolation_level�NotImplementedError)r rM �connrt s r �get_isolation_levelsz&SuiteRequirements.get_isolation_levels s� � �2 �Y�Y� � � �D� � �L�L� C� C��O�O�4�4� � � $�|�|� C� C�!*�� !� �� '� �� !� � �� !� �s. �B�/A.� B�. B�7B�B�B�Bc �2 � d� }t j |� S )z�target dialect supports the :meth:`_engine.Dialect.get_isolation_level_values` method added in SQLAlchemy 2.0. c �� � | j j � 5 } |j j |j j � d d d � y# t $ r Y d d d � yw xY w# 1 sw Y y xY w)NTF)rJ ru r� rv rw rx rz )rM r{ s r rN z8SuiteRequirements.get_isolation_level_values.<locals>.go1 sj � ����"�"�$�� ��L�L�;�;� ���8�8�� � %�$�� +� !� � %�$� !�� %�$�s. �A-�/A� A-� A*� A-�)A*�*A-�-A6rD rO s r rv z,SuiteRequirements.get_isolation_level_values) s � � � �!�!�"�%�%r c �2 � d� }t j |� S )zctest that the dialect allows the 'isolation_level' argument to be handled by DefaultDialectc � � t | j j d�� }|j j dk( S # Y yxY w)NzREAD COMMITTED)rq F)r rJ �urlr� �_on_connect_isolation_level)rM �es r rN zASuiteRequirements.dialect_level_isolation_level_param.<locals>.goC sC � � �!��I�I�M�M�3C��� �I�I�9�9�=M�M��� � �s �!< �A rD rO s r �#dialect_level_isolation_level_paramz5SuiteRequirements.dialect_level_isolation_level_param> s � � � �!�!�"�%�%r c �* � t j � S )z.Target platform implements a native ARRAY typer" r s r � array_typez SuiteRequirements.array_typeQ rw r c �* � t j � S )z.target platform implements a native JSON type.r" r s r � json_typezSuiteRequirements.json_typeV r% r c � � | j S )zNtarget platform supports numeric array indexes within a JSON structure)r� r s r �json_array_indexesz$SuiteRequirements.json_array_indexes\ s � � �~�~� r c �* � t j � S r= r r s r �(json_index_supplementary_unicode_elementz:SuiteRequirements.json_index_supplementary_unicode_elementc r r c �* � t j � S )z�Backend has a JSON_EXTRACT or similar function that returns a valid JSON string in all cases. Used to test a legacy feature and is not needed. r" r s r �!legacy_unconditional_json_extractz3SuiteRequirements.legacy_unconditional_json_extractg r� r c �* � t j � S )zRtarget backend has general support for moderately high-precision numerics.r r s r �precision_numerics_generalz,SuiteRequirements.precision_numerics_generalq r r c �* � t j � S )zbtarget backend supports Decimal() objects using E notation to represent very small values.r" r s r �"precision_numerics_enotation_smallz4SuiteRequirements.precision_numerics_enotation_smallw r% r c �* � t j � S )zbtarget backend supports Decimal() objects using E notation to represent very large values.r r s r �"precision_numerics_enotation_largez4SuiteRequirements.precision_numerics_enotation_large} r r c �* � t j � S )z�target backend supports values with many digits on both sides, such as 319438950232418390.273596, 87673.594069654243 r" r s r �*precision_numerics_many_significant_digitsz<SuiteRequirements.precision_numerics_many_significant_digits� r� r c � � | j S )z}same as precision_numerics_many_significant_digits but within the context of a CAST statement (hello MySQL) )r� r s r �/cast_precision_numerics_many_significant_digitszASuiteRequirements.cast_precision_numerics_many_significant_digits� s � � �>�>�>r c �* � t j � S )a target backend will return a selected Decimal as a Decimal, not a string. e.g.:: expr = decimal.Decimal("15.7563") value = e.scalar(select(literal(expr))) assert value == expr See :ticket:`4036` r r s r �implicit_decimal_bindsz(SuiteRequirements.implicit_decimal_binds� s � �" ��� � r c �* � t j � S )aF target backend will return result columns that are explicitly against NUMERIC or similar precision-numeric datatypes (not including FLOAT or INT types) as Python Decimal objects, and not as floats or ints, including when no SQLAlchemy-side typing information is associated with the statement (e.g. such as a raw SQL string). This should be enabled if either the DBAPI itself returns Decimal objects, or if the dialect has set up DBAPI-specific return type handlers such that Decimal objects come back automatically. r r s r �#numeric_received_as_decimal_untypedz5SuiteRequirements.numeric_received_as_decimal_untyped� s � � ��� � r c �* � t j � S )zhtarget database can select an aggregate from a subquery that's also using an aggregate r r s r �nested_aggregatesz#SuiteRequirements.nested_aggregates� r_ r c �* � t j � S )zbtarget database must support ON DELETE CASCADE on a self-referential foreign key r r s r �recursive_fk_cascadez&SuiteRequirements.recursive_fk_cascade� r_ r c �* � t j � S )z�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.r" r s r �-precision_numerics_retains_significant_digitsz?SuiteRequirements.precision_numerics_retains_significant_digits� r� r c �* � t j � S )z@The Float type can persist and load float('inf'), float('-inf').r" r s r �infinity_floatsz!SuiteRequirements.infinity_floats� r% r c �* � t j � S r= r" r s r �-float_or_double_precision_behaves_genericallyz?SuiteRequirements.float_or_double_precision_behaves_generically� r? r c �* � t j � S )z�target backend will return native floating point numbers with at least seven decimal places when using the generic Float type. r r s r � precision_generic_float_typez.SuiteRequirements.precision_generic_float_type� r_ r c �* � t j � S )z�target backend will return the exact float value 15.7563 with only four significant digits from this statement: SELECT :param where :param is the Python float 15.7563 i.e. it does not return 15.75629997253418 r r s r �literal_float_coercionz(SuiteRequirements.literal_float_coercion� rj r c �* � t j � S )z�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). r r s r �floats_to_four_decimalsz)SuiteRequirements.floats_to_four_decimals� rd r c �* � t j � S )z�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. r r s r �fetch_null_from_numericz)SuiteRequirements.fetch_null_from_numeric� s � � ��� � r c �* � t j � S )z*target backend uses Numeric for Float/Dualr r s r �float_is_numericz"SuiteRequirements.float_is_numeric r r c �* � t j � S )zUTarget database must support an unbounded Text() " "type such as TEXT or CLOBr r s r � text_typezSuiteRequirements.text_type r9 r c �* � t j � S )zTtarget database can persist/return an empty string with a varchar. r r s r �empty_strings_varcharz'SuiteRequirements.empty_strings_varchar r_ r c �* � t j � S )zRtarget database can persist/return an empty string with an unbounded text.r r s r �empty_strings_textz$SuiteRequirements.empty_strings_text r9 r c �* � t j � S )zUtarget database supports use of an unbounded textual field in a WHERE clause.r r s r �"expressions_against_unbounded_textz4SuiteRequirements.expressions_against_unbounded_text r9 r c �* � t j � S )z;target driver must support the literal statement 'select 1'r r s r � selectonezSuiteRequirements.selectone# r� r c �* � t j � S )z(Target database must support savepoints.r" r s r � savepointsz SuiteRequirements.savepoints( r% r c �* � t j � S )z4Target database must support two-phase transactions.r" r s r �two_phase_transactionsz(SuiteRequirements.two_phase_transactions. r% r c �* � t j � S )z'Target must support UPDATE..FROM syntaxr" r s r � update_fromz SuiteRequirements.update_from4 rw r c �* � t j � S )z=Target must support DELETE FROM..FROM or DELETE..USING syntaxr" r s r � delete_fromz SuiteRequirements.delete_from9 rw r c �* � t j � S )a� Target must support UPDATE (or DELETE) 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: .. sourcecode:: sql UPDATE documents SET flag=1 WHERE documents.title IN (SELECT max(documents.title) AS title FROM documents GROUP BY documents.user_id ) r r s r � update_where_target_in_subqueryz1SuiteRequirements.update_where_target_in_subquery> rm r c �* � t j � S )zOtarget database must use a plain percent '%' as the 'modulus' operator.r" r s r � mod_operator_as_percent_signz.SuiteRequirements.mod_operator_as_percent_signP r% r c �* � t j � S )a 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. r" r s r �percent_schema_namesz&SuiteRequirements.percent_schema_namesV r� r c �* � t j � S )z�target database supports ordering by a column from a SELECT inside of a UNION E.g.: .. sourcecode:: sql (SELECT id, ...) UNION (SELECT id, ...) ORDER BY id r r s r �order_by_col_from_unionz)SuiteRequirements.order_by_col_from_unionb rj r c �* � t j � S )a4 target backend supports ORDER BY a column label within an expression. Basically this: .. sourcecode:: sql 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. r" r s r � order_by_label_with_expressionz0SuiteRequirements.order_by_label_with_expressionp s � � � � �"�"r c �8 � � � fd�}t j |� S )Nc �H �� �j | � y# t $ r Y yw xY w)NFT)�get_order_by_collationrz )rM r s �r �checkz3SuiteRequirements.order_by_collation.<locals>.check� s+ �� � ��+�+�F�3� ��&� �� �s � � !�!r� �r r� s ` r �order_by_collationz$SuiteRequirements.order_by_collation� s �� � � �!�!�%�(�(r c � � t � �r= )rz �r rM s r r� z(SuiteRequirements.get_order_by_collation� s � �!�#�#r c �* � t j � S )zUTarget driver must support non-ASCII characters being passed at all. r r s r �unicode_connectionsz%SuiteRequirements.unicode_connections� r9 r c �* � t j � S )z�Target driver must raise a DBAPI-level exception, such as InterfaceError, when the underlying connection has been closed and the execute() method is called. r r s r �graceful_disconnectsz&SuiteRequirements.graceful_disconnects� r_ r c �* � t j � S )zU Target must support simultaneous, independent database connections. r r s r �independent_connectionsz)SuiteRequirements.independent_connections� r9 r c �* � t j � S )z� Target must support simultaneous, independent database connections that will be used in a readonly fashion. r r s r � independent_readonly_connectionsz2SuiteRequirements.independent_readonly_connections� rd r c �* � t j � S )z9Catchall for a large variety of MySQL on Windows failuresr r s r �skip_mysql_on_windowsz'SuiteRequirements.skip_mysql_on_windows� r� r c �. � t j d� � S )a 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. c �. � | j j S r= )�options�low_connectionsrL s r rC z2SuiteRequirements.ad_hoc_engines.<locals>.<lambda>� s � �6�>�>�9�9r r� r s r �ad_hoc_enginesz SuiteRequirements.ad_hoc_engines� s � � �!�!� 9� � r c �H � t j | j � � S r= )r r� �_running_on_windowsr s r � no_windowsz SuiteRequirements.no_windows� s � ��!�!�$�":�":�"<�=�=r c �2 � t j d� d�� S )Nc �0 � t j � dk( S )N�Windows)�platform�systemr r r rC z7SuiteRequirements._running_on_windows.<locals>.<lambda>� s � �H�O�O�%��2r zrunning on Windows)� description)r �LambdaPredicater s r r� z%SuiteRequirements._running_on_windows� s � ��)�)� 2�,� � r c �: � ddl m} |j j S �Nr rL )� rM � add_to_marker�timing_intensiver� s r r� z"SuiteRequirements.timing_intensive� � � � ��#�#�4�4�4r c �: � ddl m} |j j S r� )r� rM r� �memory_intensiver� s r r� z"SuiteRequirements.memory_intensive� r� r c �0 � t j d� d� S )z}Mark tests that use threading and mock at the same time - stability issues have been observed with coverage c �. � | j j S r= �r� � has_coveragerL s r rC z7SuiteRequirements.threading_with_mock.<locals>.<lambda>� � � �6�>�>�6�6r z Stability issues with coverager� r s r �threading_with_mockz%SuiteRequirements.threading_with_mock� s � � �!�!� 6� ,� � r c �2 � d� }t j |� S )Nc �: � t d� y# t $ r Y yw xY w�Nzsqlalchemy-stubs.ext.mypyTF�� __import__� ImportErrorrL s r r� z2SuiteRequirements.sqlalchemy2_stubs.<locals>.check� �) � � ��6�7� �� � � � �� � � �rD r� s r �sqlalchemy2_stubsz#SuiteRequirements.sqlalchemy2_stubs� � � � � �!�!�%�(�(r c �2 � d� }t j |� S )Nc �: � t d� y# t $ r Y yw xY wr� r� rL s r r� z5SuiteRequirements.no_sqlalchemy2_stubs.<locals>.check� r r r� r� s r �no_sqlalchemy2_stubsz&SuiteRequirements.no_sqlalchemy2_stubs� r r c �0 � t j d� d� S )Nc �" � t j S r= )r �py38r r r rC z,SuiteRequirements.python38.<locals>.<lambda>� � � �D�I�Ir z Python 3.8 or above requiredrD r s r �python38zSuiteRequirements.python38� � � ��!�!� � =� � r c �0 � t j d� d� S )Nc �" � t j S r= )r �py39r r r rC z,SuiteRequirements.python39.<locals>.<lambda> r r z Python 3.9 or above requiredrD r s r �python39zSuiteRequirements.python39� r r c �0 � t j d� d� S )Nc �" � t j S r= )r �py310r r r rC z-SuiteRequirements.python310.<locals>.<lambda> � � �D�J�Jr z Python 3.10 or above requiredrD r s r � python310zSuiteRequirements.python310 � � ��!�!� � ?� � r c �0 � t j d� d� S )Nc �" � t j S r= )r �py311r r r rC z-SuiteRequirements.python311.<locals>.<lambda> r r z Python 3.11 or above requiredrD r s r � python311zSuiteRequirements.python311 r r c �0 � t j d� d� S )Nc �" � t j S r= )r �py312r r r rC z-SuiteRequirements.python312.<locals>.<lambda> r r z Python 3.12 or above requiredrD r s r � python312zSuiteRequirements.python312 r r c �0 � t j d� d� S )Nc �" � t j S r= )r �cpythonr r r rC z+SuiteRequirements.cpython.<locals>.<lambda> s � �D�L�Lr zcPython interpreter neededrD r s r r# zSuiteRequirements.cpython s � ��!�!� �">� � r c �0 � t j d� d� S )Nc �" � t j S r= )r �is64bitr r r rC z+SuiteRequirements.is64bit.<locals>.<lambda> s � �$�,�,r z64bit requiredrD r s r r& zSuiteRequirements.is64bit s � ��!�!�"6�8H�I�Ir c �4 � d� }t j |d� S )Nc �: � t d� y# t $ r Y yw xY w)N�patchTFr� r r r � check_libz2SuiteRequirements.patch_library.<locals>.check_lib# s( � � ��7�#� �� � � � �r zpatch library neededrD )r r* s r � patch_libraryz SuiteRequirements.patch_library! s � � � �!�!�)�-C�D�Dr c � � | j S )z�target platform must remove all cycles unconditionally when gc.collect() is called, as well as clean out unreferenced subclasses. )r# r s r �predictable_gcz SuiteRequirements.predictable_gc- s � � �|�|�r c �0 � t j d� d� S )z�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. c �. � | j j S r= r� rL s r rC z/SuiteRequirements.no_coverage.<locals>.<lambda>> r� r z(Issues observed when coverage is enabledr� r s r � no_coveragez SuiteRequirements.no_coverage5 s � � �!�!� 6� 6� � r c � � y�NFr r� s r �_has_mysql_on_windowsz'SuiteRequirements._has_mysql_on_windowsB � � �r c � � yr2 r r� s r � _has_mysql_fully_case_sensitivez1SuiteRequirements._has_mysql_fully_case_sensitiveE r4 r c �4 � � t j � fd�� S )Nc �& �� � j � S r= )� _has_sqliter s �r rC z*SuiteRequirements.sqlite.<locals>.<lambda>J s �� �d�.>�.>�.@�*@r r� r s `r �sqlitezSuiteRequirements.sqliteH s �� ��!�!�"@�A�Ar c �0 � t j d� d� S )Nc �, � t j � S r= )r �has_compiled_extr r r rC z/SuiteRequirements.cextensions.<locals>.<lambda>O s � ��-�-�/�/r z Cython extensions not installedr� r s r � cextensionsz SuiteRequirements.cextensionsL s � ��!�!� /� -� � r c �@ � ddl m} |d� y# t $ r Y yw xY w)Nr r z sqlite://TF)� sqlalchemyr r )r r s r r9 z SuiteRequirements._has_sqliteS s' � �,� � �+� &���� �� �s � � � c �* � t j � S )z@dialect makes use of await_() to invoke operations on the DBAPI.r" r s r � async_dialectz SuiteRequirements.async_dialect\ r% r c � � | j S r= )�greenletr s r r zSuiteRequirements.asynciob s � ��}�}� r c �2 � d� }t j |� S )Nc �, � dd l }y# t $ r Y yw xY w)Nr FT)rD r �rM rD s r rN z)SuiteRequirements.no_greenlet.<locals>.goh s# � � � � �� � �� �s � � �rD rO s r � no_greenletz SuiteRequirements.no_greenletf s � � � �!�!�"�%�%r c �2 � d� }t j |� S )Nc �N � t j sy dd l}y# t $ r Y yw xY w)NFr T)� _test_asyncio�ENABLE_ASYNCIOrD r rG s r rN z&SuiteRequirements.greenlet.<locals>.got s/ � � �/�/� � � � �� � � � �s � � $�$rD rO s r rD zSuiteRequirements.greenletr s � � � �!�!�"�%�%r c �* � t j � S )zSupports computed columnsr" r s r �computed_columnsz"SuiteRequirements.computed_columns� rw r c �* � t j � S )z/Supports computed columns with `persisted=True`r" r s r �computed_columns_storedz)SuiteRequirements.computed_columns_stored� rw r c �* � t j � S )z0Supports computed columns with `persisted=False`r" r s r �computed_columns_virtualz*SuiteRequirements.computed_columns_virtual� rw r c �* � t j � S )zSIf the default persistence is virtual or stored when `persisted` is omittedr" r s r �"computed_columns_default_persistedz4SuiteRequirements.computed_columns_default_persisted� r% r c �* � t j � S )zTIf persistence information is returned by the reflection of computed columnsr" r s r �"computed_columns_reflect_persistedz4SuiteRequirements.computed_columns_reflect_persisted� r% r c �* � t j � S )z1If a backend supports the DISTINCT ON in a selectr" r s r �supports_distinct_onz&SuiteRequirements.supports_distinct_on� rw r c �0 � t j d� d� S )a Supports some form of "x IS [NOT] DISTINCT FROM y" construct. Different dialects will implement their own flavour, e.g., sqlite will emit "x IS NOT y" instead of "x IS DISTINCT FROM y". .. seealso:: :meth:`.ColumnOperators.is_distinct_from` c �D � | j j j S r= )rJ r� �supports_is_distinct_fromrL s r rC z=SuiteRequirements.supports_is_distinct_from.<locals>.<lambda>� s � �v�y�y� 0� 0� J� J�Jr z4driver doesn't support an IS DISTINCT FROM constructr� r s r r[ z+SuiteRequirements.supports_is_distinct_from� s � � �!�!� J� B� � r c �* � t j � S )zKIf a backend supports GENERATED { ALWAYS | BY DEFAULT } AS IDENTITYr" r s r �identity_columnsz"SuiteRequirements.identity_columns� r% r c �* � t j � S )z�If a backend supports GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY with a standard syntax. This is mainly to exclude MSSql. r" r s r �identity_columns_standardz+SuiteRequirements.identity_columns_standard� r� r c �* � t j � S )z+backend supports the regexp_match operator.r" r s r � regexp_matchz SuiteRequirements.regexp_match� rw r c �* � t j � S )z-backend supports the regexp_replace operator.r" r s r �regexp_replacez SuiteRequirements.regexp_replace� rw r c �* � t j � S )z(backend supports the fetch first clause.r" r s r � fetch_firstz SuiteRequirements.fetch_first� rw r c �* � t j � S )z5backend supports the fetch first clause with percent.r" r s r � fetch_percentz SuiteRequirements.fetch_percent� rw r c �* � t j � S )z2backend supports the fetch first clause with ties.r" r s r � fetch_tiesz SuiteRequirements.fetch_ties� rw r c �* � t j � S )z1backend supports the fetch first without order byr" r s r �fetch_no_order_byz#SuiteRequirements.fetch_no_order_by� rw r c �* � t j � S )zwbackend supports the offset when using fetch first with percent or ties. basically this is "not mssql" r" r s r �fetch_offset_with_optionsz+SuiteRequirements.fetch_offset_with_options� r. r c �* � t j � S )z�backend supports fetch / offset with expression in them, like SELECT * FROM some_table OFFSET 1 + 1 ROWS FETCH FIRST 1 + 1 ROWS ONLY r" r s r �fetch_expressionz"SuiteRequirements.fetch_expression� r� r c �* � t j � S )zIf autoincrement=True on a column does not require an explicit sequence. This should be false only for oracle. r r s r � autoincrement_without_sequencez0SuiteRequirements.autoincrement_without_sequence� r9 r c �* � t j � S )z=If X[Y] can be implemented with ``__class_getitem__``. py3.7+r r s r �generic_classesz!SuiteRequirements.generic_classes� r� r c �* � t j � S )z@indicates if the json_deserializer function is called with bytesr" r s r �json_deserializer_binaryz*SuiteRequirements.json_deserializer_binary� rw r c �* � t j � S )z6Target database must support reflecting table_options.r" r s r �reflect_table_optionsz'SuiteRequirements.reflect_table_options� rw r c �* � t j � S )z0Target database must support MATERIALIZED VIEWs.r" r s r �materialized_viewsz$SuiteRequirements.materialized_views rw r c �* � t j � S )z/Target database reflect MATERIALIZED VIEWs pks.r" r s r � materialized_views_reflect_pkz/SuiteRequirements.materialized_views_reflect_pk rw r c �* � t j � S )z#Target database supports bitwise orr" r s r �supports_bitwise_orz%SuiteRequirements.supports_bitwise_or rw r c �* � t j � S )z$Target database supports bitwise andr" r s r �supports_bitwise_andz&SuiteRequirements.supports_bitwise_and rw r c �* � t j � S )z$Target database supports bitwise notr" r s r �supports_bitwise_notz&SuiteRequirements.supports_bitwise_not rw r c �* � t j � S )z$Target database supports bitwise xorr" r s r �supports_bitwise_xorz&SuiteRequirements.supports_bitwise_xor rw r c �* � t j � S )z4Target database supports bitwise left or right shiftr" r s r �supports_bitwise_shiftz(SuiteRequirements.supports_bitwise_shift! rw r c �* � t j � S )zNTarget backend supports custom ESCAPE characters with LIKE comparisonsr r s r � like_escapesz SuiteRequirements.like_escapes& r r N)�r r r �propertyr r r$ r' r) r+ r- r0 r2 r4 r6 r8 r; r> rF rP rR rT rV rX rZ r\ r^ ra rc rf ri rl rn rp rr rt rv ry r{ r} r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r r r r r r r r r! r# r% r' r) r+ r- r/ r1 r3 r5 r7 r9 r; r= r? rA rC rE rG rI rK rM rO rQ rS rU rW rY r[ r^ r` rb rd rf rh rj rl ro rq r| rv r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r# r& r+ r- r0 r3 r6 r: r> r9 rB r rH rD rN rP rR rT rV rX r[ r] r_ ra rc re rg ri rk rm ro rq rs ru rw ry r{ r} r r� r� r� r� r r r r r $ s � � �!� �!� �!� �!� �#� �#� �#� �#� �#� �#� �!� �!� �#� �#� �#� �#� �#� �#� � #� � #� �!� �!�& �!� �!� �#� �#� �#� �#� � � � � �&� �&� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� � !� � !� � !� � !� �#� �#� �!� �!� �#� �#� �!� �!� �!� �!� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �!� �!� � !� � !� � !� � !� � � � � � � � � � � � � � � � � �"� �"� �!� �!� � � � � � � � � � � � � � � � � � � � � �#� �#� � � � � �!� �!� � � � � � � � � �!� �!� �!� �!� � #� � #� �#� �#� �#� �#� �#� �#� �J� �J� �#� �#� � #� � #� �#� �#� �#� �#� � � � � � � � � �7� �7� � � � � � � � � � � � � �#� �#� �!� �!� �#� �#� �#� �#� �#� �#� �#� �#� �� �� �� �� � � � � �#� �#� �!� �!� �!� �!� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �!� �!� �*� �*� �#� �#� �#� �#� �!� �!� �#� �#� �!� �!� �#� �#� �!� �!� �!� �!� �#� �#� �#� �#� �#� �#� �!� �!� �#� �#� �#� �#� �!� �!� �!� �!� �!� �!� �!� �!� �#� �#� �!� �!� �#� �#� �#� �#� �!� �!� �#� �#� �#� �#� �!� �!� �!� �!� �!� �!� �!� �!� �#� �#� �+� �+� �#� �#� �!� �!� �!� �!� �#� �#� �!� �!� �!� �!� �!� �!� �!� �!�" �#� �#� �#� �#�$�L �&� �&�( �&� �&�$ �#� �#� �#� �#� � � � � �!� �!� �#� �#� �!� �!� �#� �#� �!� �!� �#� �#� �?� �?� �!� �!�$ � !� � !� �!� �!� �!� �!� �#� �#� �#� �#� �#� �#� �!� �!� � !� � !� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� �#� �#� �#� �#� �#� �#� �#� �#� �!� �!�" �#� �#� � #� � #� � !� � !� �#� �#� �)� �)�$� �!� �!� �!� �!� �!� �!� �!� �!� �!� �!� � � � � �>� �>� � �5� �5� �5� �5� � � � � � )� � )� � )� � )� � � � � � � � � � � � � � � � � � � � � � � � � �J� �J� � E� � E� � � � � � � � ��� �B� �B� � � � � � �#� �#� � � � � � &� � &� � &� � &� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� � � � � �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �!� �!� �!� �!� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �#� �!� �!r r )�__doc__� __future__r r� r� r rK r r r r rK r r r r r r �<module>r� s< ��� #� � &� � � � � � � �F !� � F !r