a
    xˆc#T  ã                   @   sr  d Z ddlmZ ddlZddladdlZddlZdZt d¡Z	ej
dkZer\ddlZejZn ddlZddlZG dd„ deƒZdadadadadadadadZdadadadadaeƒ aeƒ a da!d	d
„ Z"dd„ Z#dd„ Z$dd„ Z%dd„ Z&dd„ Z'dd„ Z(dd„ Z)dd„ Z*dd„ Z+dd„ Z,dd „ Z-d!d"„ Z.g Z/g Z0d#d$„ Z1d%d&„ Z2e1d'd(„ ƒZ3e1d)d*„ ƒZ4e1d+d,„ ƒZ5e1d-d.„ ƒZ6e2d/d0„ ƒZ7e1d1d2„ ƒZ8e2d3d4„ ƒZ9e2d5d6„ ƒZ:d7d8„ Z;e2d9d:„ ƒZ<e2d;d<„ ƒZ=e2d=d>„ ƒZ>e2d?d@„ ƒZ?dAdB„ Z@dCdD„ ZAdEdF„ ZBdGdH„ ZCdIdJ„ ZDdKdL„ ZEdMdN„ ZFdOdP„ ZGdQdR„ ZHdSdT„ ZIdUdV„ ZJdWdX„ ZKdcdYdZ„ZLd[d\„ ZMd]d^„ ZNG d_d`„ d`eƒZOdaPdadb„ ZQdS )dzìTesting extensions.

this module is designed to work as a testing-framework-agnostic library,
created so that multiple test frameworks can be supported at once
(mostly so that we can migrate to new ones). The current target
is pytest.

é    )Úabsolute_importNFzsqlalchemy.testing.plugin_base)é   r   c                   @   s   e Zd ZejZdS )ÚABCN)Ú__name__Ú
__module__Ú__qualname__ÚabcÚABCMetaÚ__metaclass__© r   r   úh/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/sqlalchemy/testing/plugin/plugin_base.pyr   )   s   r   c                 C   s®  | ddt tdd� | ddt tdd� | ddt d	d
d� | ddtdd� | ddt ddd� | ddt ddd� | ddddd� | dddd� | ddddd� | d dd!d"d� | d#dd$d%d� | d&t d'd(d)d*� | d+t d,d-d.� | d/t d0d1� | d2dd3d4d� | d5t d6d7d.� | d8dd9d:d;d<� | d=dt td>d� | d?dd@d:dAd<� | dBdtt dCdD� | dEdtt dFdD� | dGddHd:dId<� | dJddKd:dLd<� | dMt dNdOd.� | dPt dg dQdRdS� d S )TNz
--log-infoÚcallbackz,turn on info logging for <LOG> (multiple OK))ÚactionÚtyper   Úhelpz--log-debugz-turn on debug logging for <LOG> (multiple OK)z--dbÚappendÚdbzBUse prefab database uri. Multiple OK, first one is run by default.)r   r   Údestr   z--dbszList available prefab dbs)r   Zzeroarg_callbackr   z--dburiÚdburiz8Database uri.  Multiple OK, first one is run by default.z
--dbdriverÚdbdriverz|Additional database drivers to include in tests.  These are linked to the existing database URLs by the provisioning system.z--dropfirstÚ
store_trueÚ	dropfirstz,Drop all tables in the target database first)r   r   r   z--disable-asyncioz8disable test / fixtures / provisoning running in asyncio)r   r   z--backend-onlyÚbackend_onlyz<Run only tests marked with __backend__ or __sparse_backend__z
--nomemoryÚnomemoryz Don't run memory profiling testsz--notimingintensiveÚnotimingintensivez Don't run timing intensive testsz--profile-sortZ
cumulativeÚprofilesortz*Type of sort for profiling standard output)r   Údefaultr   r   z--profile-dumpÚprofiledumpz2Filename where a single profile run will be dumped)r   r   r   z--postgresql-templatedbz^name of template database to use for PostgreSQL CREATE DATABASE (defaults to current database))r   r   z--low-connectionsÚlow_connectionsz>Use a low number of distinct connections - i.e. for Oracle TNSz--write-identsÚwrite_identszCwrite out generated follower idents to <file>, when -n<num> is usedz--reversetopÚ
reversetopFzTUse a random-ordering set implementation in the ORM (helps reveal dependency issues))r   r   r   r   z--requirementsz3requirements class for testing, overrides setup.cfgz--with-cdecimalÚcdecimalzDMonkeypatch the cdecimal library into Python 'decimal' for all testsz--include-tagzInclude tests with tag <tag>)r   r   r   r   z--exclude-tagzExclude tests with tag <tag>z--write-profilesZwrite_profilesz$Write/update failing profiling data.z--force-write-profilesZforce_write_profilesz,Unconditionally write/update profiling data.z--dump-pyannotateZdump_pyannotatez/Run pyannotate and dump json info to given filez--mypy-extra-test-pathZmypy_extra_test_pathszlAdditional test directories to add to the mypy tests. This is used only when running mypy tests. Multiple OK)r   r   r   r   r   )ÚstrÚ_logÚ	_list_dbsÚ_requirements_optÚ_include_tagÚ_exclude_tag)Úmake_optionr   r   r   Úsetup_optionsA   sF   ûûûüûû	üýüüüûüýüüûûûûûûûüúr)   c                 C   s   ddl m} | |_dS )z„Configure required state for a follower.

    This invokes in the parent process and typically includes
    database creation.

    r   ©Ú	provisionN)Úsqlalchemy.testingr+   ÚFOLLOWER_IDENT)Zfollower_identr+   r   r   r   Úconfigure_followerð   s    r.   c                 C   s   t tdœ| d< dS )aS  Store important configuration we will need to send to a follower.

    This invokes in the parent process after normal config is set up.

    This is necessary as pytest seems to not be using forking, so we
    start with nothing in memory, *but* it isn't running our argparse
    callables, so we have to just copy all of that over.

    ©Úinclude_tagsÚexclude_tagsÚmemoized_configNr/   ©Zdict_r   r   r   Ú!memoize_important_follower_configü   s    þr4   c                 C   s(   t  | d d ¡ t | d d ¡ dS )zfRestore important configuration needed by a follower.

    This invokes in the follower process.

    r2   r0   r1   N)r0   Úupdater1   r3   r   r   r   Ú!restore_important_follower_config  s    r6   c                   C   s   t  ¡ at ddg¡ d S )Nz	setup.cfgztest.cfg)ÚconfigparserÚConfigParserÚfile_configÚreadr   r   r   r   Úread_config  s    r;   c                 C   s   | a tD ]}|t tƒ qdS )z7things to set up early, before coverage might be setup.N)ÚoptionsÚpre_configurer9   )ÚoptÚfnr   r   r   Ú	pre_begin  s    r@   c                 C   s
   | t _d S ©N)r<   Zhas_coverage)Úvaluer   r   r   Úset_coverage_flag%  s    rC   c                  C   sp   t D ]} | ttƒ qddlma ddlmamama ddlm	a	m
a
ma ddlmama ddlma t
 ¡  dS )z9things to set up later, once we know coverage is running.r   ©Útesting)ÚfixturesÚenginesÚ
exclusions)Ú
assertionsÚwarningsÚ	profiling)Úconfigr+   )ÚutilN)Úpost_configurer<   r9   Ú
sqlalchemyrE   r,   rF   rG   rH   rI   rJ   rK   rL   r+   rM   Zsetup_filters©r?   r   r   r   Ú
post_begin)  s    rQ   c                 C   sR   t sdd l a t  ¡  |  d¡r2t  |¡ t j¡ n|  d¡rNt  |¡ t j¡ d S )Nr   z-infoz-debug)ÚloggingÚbasicConfigÚendswithÚ	getLoggerÚsetLevelÚINFOÚDEBUG©Úopt_strrB   Úparserr   r   r   r#   ;  s    

r#   c                  G   sB   t dƒ tt d¡ƒD ]}t d|t d|¡f ƒ qt d¡ d S )Nz0Available --db options (use --dburi to override)r   z%20s	%sr   )ÚprintÚsortedr9   r<   ÚgetÚsysÚexit)ÚargsÚmacror   r   r   r$   H  s    r$   c                 C   s   t |ƒ d S rA   )Ú_setup_requirementsrY   r   r   r   r%   O  s    r%   c                 C   s   t  | dd¡¡ d S ©Nú-Ú_)r1   ÚaddÚreplacerY   r   r   r   r'   S  s    r'   c                 C   s   t  | dd¡¡ d S rd   )r0   rg   rh   rY   r   r   r   r&   W  s    r&   c                 C   s   t  | ¡ | S rA   )r=   r   rP   r   r   r   Úpre_  s    
ri   c                 C   s   t  | ¡ | S rA   )rN   r   rP   r   r   r   Úpostd  s    
rj   c                 C   s   | a d S rA   ©r<   ©r>   r9   r   r   r   Ú_setup_optionsi  s    rm   c                 C   s   | j rt d¡ d S )NZmemory_intensive)r   r1   rg   rl   r   r   r   Ú_set_nomemoryo  s    rn   c                 C   s   | j rt d¡ d S )NZtiming_intensive)r   r1   rg   rl   r   r   r   Ú_set_notimingintensiveu  s    ro   c                 C   s   | j rdd l }|tjd< d S )Nr   Údecimal)r!   r_   Úmodules)r<   r9   r!   r   r   r   Ú_monkeypatch_cdecimal{  s    rr   c                 C   s   ddl m} tƒ |_d S ©Nr   ©rL   )r,   rL   Ú_fixture_fn_classZ_fixture_functions)r<   r9   rL   r   r   r   Ú_init_symbolsƒ  s    rv   c                 C   s    | j s
tsddlm} d|_d S )Nr   )ÚasyncioF)Zdisable_asyncioÚpy3kr,   rw   ZENABLE_ASYNCIO)r>   r9   rw   r   r   r   Ú_set_disable_asyncioŠ  s    
ry   c              	   C   sV  ddl m} ddlm} ddlm} | jr6t| jƒ}ng }| jpBg }| jr–| jD ]D}t	 
d|¡D ]2}|| d¡vr€td| ƒ‚q`| | d|¡¡ q`qP|s¬| | dd¡¡ d |_t| ||¡ƒ}	|	D ]Š}
t d	|
¡ | j�r,|j�r,t| jd
ƒ�(}| |jd |
 d ¡ W d   ƒ n1 �s"0    Y  | |
| ||j¡}|jsÆ| ||¡ qÆd S )Nr   rD   rt   r*   z[,\s]+r   z:Unknown URI specifier '%s'.  Specify --dbs for known uris.r   zAdding database URL: %sÚaú Ú
)rO   rE   r,   rL   r+   r   Úlistr   r   ÚreÚsplitr<   ÚRuntimeErrorr   r^   Ú_currentZgenerate_db_urlsÚlogÚinfor   r-   ÚopenÚwriteZsetup_configZset_as_current)r<   r9   rE   rL   r+   Zdb_urlsZextra_driversZdb_tokenr   Zexpanded_urlsZdb_urlÚfile_Úcfgr   r   r   Ú_engine_uri’  s>    

ÿÿ8
ÿrˆ   c                 C   s   |  dd¡}t|ƒ d S )NÚsqla_testingÚrequirement_cls)r^   rc   )r<   r9   rŠ   r   r   r   Ú_requirementsÀ  s    r‹   c                 C   s€   ddl m} ddlm} |jd ur&d S |  d¡\}}t|ƒ}| d¡dd … D ]}t||ƒ}qNt||ƒ}|ƒ  |_|_t	|_	d S )Nr   rt   rD   ú:Ú.é   )
r,   rL   rO   rE   Úrequirementsr   Ú
__import__ÚgetattrÚrequiresÚbootstrapped_as_sqlalchemy)ÚargumentrL   rE   ÚmodnameZclsnameÚmodÚ	componentZreq_clsr   r   r   rc   Ç  s    

rc   c                 C   s@   ddl m} | jr<ddl m} |j ¡ D ]}| ||j¡ q(d S )Nr   rt   r*   )r,   rL   r   r+   ÚConfigÚall_configsZdrop_all_schema_objectsr   )r<   r9   rL   r+   r‡   r   r   r   Ú_prep_testing_databaseÜ  s
    rš   c                 C   s   | j rddlm} |ƒ  d S )Nr   )Úrandomize_unitofwork)r    Zsqlalchemy.orm.utilr›   )r<   r9   r›   r   r   r   Ú_reverse_topologicalç  s    rœ   c                 C   s   ddl m} t|_||_d S rs   )r,   rL   r<   r9   )r>   r9   rL   r   r   r   Ú_post_setup_optionsï  s    r�   c                 C   s.   ddl m} |j| dd¡| j| jd�|_d S )Nr   )rK   r‰   Zprofile_file)ÚsortÚdump)r,   rK   ZProfileStatsFiler^   r   r   Z_profile_stats)r<   r9   rK   r   r   r   Ú_setup_profiling÷  s    
ýr    c                 C   sV   t |tjƒsdS |  d¡rdS tjjrNt|ddƒsNt|ddƒsNt|ddƒsNdS dS d S )NFrf   Ú__backend__Ú__sparse_backend__Ú__only_on__T)Ú
issubclassrF   ZTestBaseÚ
startswithrL   r<   r   r‘   )ÚnameÚclsr   r   r   Ú
want_class  s    
ÿ
þ
ý
ür¨   c                 C   sž   |j  d¡sdS |jd u rdS trXt| dƒr@t | j¡ tt	¡pVt|dƒoV|j
 tt	¡S t	rzt| dƒrzt | j¡ tt	¡S t	r–t|dƒr–|j
 tt	¡S dS d S )NZtest_FÚ__tags__Ú_sa_exclusion_extendT)r   r¥   r   r0   ÚhasattrrH   Útagsr©   Zinclude_testr1   rª   )r§   r?   r   r   r   Úwant_method  s,    

ÿþ
ÿùÿr­   c                 c   sš   t | ddƒst | ddƒr�t | ddƒ}t| |d�D ]\}| j}t dd|j¡}t dd|¡}d	| j|f }t|| f||d
œƒ}t|||ƒ |V  q0n| V  d S )Nr¡   Fr¢   )Úsparsez
[_\[\]\.]+rf   z_+$Ú z%s_%s)Ú_sa_orig_cls_nameÚ__only_on_config__)r‘   Ú_possible_configs_for_clsr   r~   Úsubr¦   r   Úsetattr)r§   Úmoduler®   r‡   Z	orig_nameZ
alpha_namer¦   Úsubclsr   r   r   Úgenerate_sub_tests-  s"    ÿý
r·   c                 C   s   t | ƒ t| ƒ d S rA   )Ú	_do_skipsÚ_setup_engine©r§   r   r   r   Ú!start_test_class_outside_fixturesG  s    r»   c                 C   s   t  | ¡ tj ¡  d S rA   )rF   Zstop_test_class_inside_fixturesrG   Útesting_reaperrº   r   r   r   Ústop_test_classL  s    
r½   c                 C   s@   t j ¡  t ttj| ¡ ztjs*t 	¡  W t
ƒ  nt
ƒ  0 d S rA   )rG   r¼   Ú stop_test_class_outside_fixturesr+   rL   r   r<   r   rI   Úglobal_cleanup_assertionsÚ_restore_enginerº   r   r   r   r¾   U  s    

r¾   c                   C   s   t jrt j t¡ d S rA   )rL   r�   ÚresetrE   r   r   r   r   rÀ   _  s    rÀ   c                   C   s   t j ¡  t ¡  tƒ  d S rA   )rG   r¼   Zfinal_cleanuprI   r¿   rÀ   r   r   r   r   Úfinal_process_cleanupd  s    
rÂ   c                 C   s<   t | dd ƒr8t| jƒ}d|d< tj|d�}tj |t¡ d S )NÚ__engine_options__ÚclassZscoperk   )	r‘   ÚdictrÃ   rG   Ztesting_enginerL   r�   Zpush_enginerE   )r§   ÚoptsZengr   r   r   r¹   j  s
    
r¹   c                 C   s*   t |d|jƒ}d|||f }t |¡ d S )Nr°   z%s.%s.%s)r‘   r   rK   Z_start_current_test)ÚtestZtest_module_nameZ
test_classZ	test_namer¦   Zid_r   r   r   Úbefore_testr  s    rÈ   c                 C   s   t  ¡  tj ¡  d S rA   )rF   Ú
after_testrG   r¼   ©rÇ   r   r   r   rÉ   ~  s    rÉ   c                 C   s   t j | ¡ d S rA   )rG   r¼   Zafter_test_outside_fixturesrÊ   r   r   r   Úafter_test_fixturesƒ  s    rË   c                 C   s²  t tj ¡ ƒ}| jr@tj| jŽ }t|ƒD ]}||ƒr(| |¡ q(t	| dd ƒr~tjt
 | j¡Ž }t|ƒD ]}||ƒsf| |¡ qft	| dd ƒr˜| | jg¡ t| dƒrútj}t|ƒD ]H}| jD ]<}t	||ƒ}| |¡}	|	rº| |¡ |d urò| |	¡  q°qºq°t| dƒ�rft ƒ }
tj}t|ƒD ]4}| jD ]&}t	||ƒ}| |¡�s$|
 |¡ �q$�q| |
¡�rf| |
¡ |�r®i }tt|dd„ d�ƒD ] }|jj}||v�r„|||< �q„| ¡ S |S )Nr£   r±   Ú__requires__Ú__prefer_requires__c                 S   s   | j j| j j| j jjfS rA   )r   r¦   ÚdriverÚdialectZserver_version_info)r‡   r   r   r   Ú<lambda>º  s    ýz+_possible_configs_for_cls.<locals>.<lambda>)Úkey)ÚsetrL   r˜   r™   Z__unsupported_on__rH   Údb_specr}   Úremover‘   rM   Úto_listr£   Úintersection_updater±   r«   r�   rÌ   Zmatching_config_reasonsÚextendrÍ   Zenabled_for_configrg   Ú
differenceÚdifference_updateÚreversedr]   r   r¦   Úvalues)r§   Úreasonsr®   r™   ÚspecÚ
config_objr�   ÚrequirementÚcheckZskip_reasonsÚnon_preferredZper_dialectr‡   r   r   r   r   r²   ‡  s^    








þÿ

r²   c                 C   sð   g }t | |ƒ}t| ddƒrFt| dƒD ] }|ƒ r$t d| j|jf ¡ q$|s‚d| jd dd„ tj ¡ D ƒ¡d |¡f }t |¡ nRt| dƒrÔt	ƒ }t
jt | j¡Ž }|D ]}||ƒs¨| |¡ q¨| |¡rÔ| |¡ tj|vrìt| ¡ | ƒ d S )	NZ__skip_if__Fz'%s' skipped by %sz.'%s' unsupported on any DB implementation %s%sz, c              	   s   s<   | ]4}d |j jd dd„ t |j ¡D ƒ¡|j jf V  qdS )z'%s(%s)+%s'r�   c                 s   s   | ]}t |ƒV  qd S rA   )r"   )Ú.0Údigr   r   r   Ú	<genexpr>Û  s   ÿz&_do_skips.<locals>.<genexpr>.<genexpr>N)r   r¦   ÚjoinrH   Z_server_versionrÎ   )râ   rÞ   r   r   r   rä   ×  s   
÷

þúÿz_do_skips.<locals>.<genexpr>Ú__prefer_backends__)r²   r‘   rL   Z	skip_testr   rå   r˜   r™   r«   rÒ   rH   rÓ   rM   rÕ   ræ   rg   rØ   rÙ   r�   Ú_setup_configÚpop)r§   rÜ   r™   ÚcÚmsgrá   rÝ   rÞ   r   r   r   r¸   É  s6    
ÿ

öò



r¸   c                 C   s   t j | t¡ d S rA   )rL   r�   ÚpushrE   )rÞ   Úctxr   r   r   rç   ó  s    rç   c                   @   sZ   e Zd Zejdd„ ƒZejdd„ ƒZejdd„ ƒZejdd„ ƒZd	d
„ Z	ejdd„ ƒZ
dS )ÚFixtureFunctionsc                 O   s
   t ƒ ‚d S rA   ©ÚNotImplementedError©ÚselfÚargÚkwr   r   r   Úskip_test_exceptionø  s    z$FixtureFunctions.skip_test_exceptionc                 O   s
   t ƒ ‚d S rA   rî   ©rñ   ra   ró   r   r   r   Úcombinationsü  s    zFixtureFunctions.combinationsc                 O   s
   t ƒ ‚d S rA   rî   rõ   r   r   r   Úparam_ident   s    zFixtureFunctions.param_identc                 O   s
   t ƒ ‚d S rA   rî   rð   r   r   r   Úfixture  s    zFixtureFunctions.fixturec                 C   s
   t ƒ ‚d S rA   rî   ©rñ   r   r   r   Úget_current_test_name  s    z&FixtureFunctions.get_current_test_namec                 C   s
   t ƒ ‚d S rA   rî   rù   r   r   r   Úmark_base_test_class  s    z%FixtureFunctions.mark_base_test_classN)r   r   r   r   Úabstractmethodrô   rö   r÷   rø   rú   rû   r   r   r   r   rí   ÷  s   



rí   c                 C   s   | a d S rA   )ru   )Zfixture_fn_classr   r   r   Úset_fixture_functions  s    rý   )NF)RÚ__doc__Ú
__future__r   r   rR   r~   r_   r“   rU   r‚   Úversion_inforx   r7   r   r8   ÚcollectionsÚcollections_abcÚobjectrF   rG   rH   rJ   rK   r+   rI   r�   rL   rE   rM   r9   rÒ   r0   r1   r<   r)   r.   r4   r6   r;   r@   rC   rQ   r#   r$   r%   r'   r&   r=   rN   ri   rj   rm   rn   ro   rr   rv   ry   rˆ   r‹   rc   rš   rœ   r�   r    r¨   r­   r·   r»   r½   r¾   rÀ   rÂ   r¹   rÈ   rÉ   rË   r²   r¸   rç   rí   ru   rý   r   r   r   r   Ú<module>   s¶   	

 0






-






	

B*