U
    x^O                     @   s0  d Z ddlmZ ddlZddlZddlZejdkZerFd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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 Z,d!d" Z-d#d$ Z.e-d%d& Z/e-d'd( Z0e-d)d* Z1e.d+d, Z2e.d-d. Z3e.d/d0 Z4d1d2 Z5e.d3d4 Z6e.d5d6 Z7e.d7d8 Z8e.d9d: Z9d;d< Z:d=d> Z;d?d@ Z<dAdB Z=dCdD Z>dEdF Z?dGdH Z@dIdJ ZAdKdL ZBdMdN ZCdZdPdQZDdRdS ZEdTdU ZFG dVdW dWe	ZGdaHdXdY ZIdS )[zTesting 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 py.test.

    )absolute_importN)   r   c                   @   s   e Zd ZejZdS )ABCN)__name__
__module____qualname__abcABCMeta__metaclass__ r   r   M/tmp/pip-install-dq5v43_d/SQLAlchemy/sqlalchemy/testing/plugin/plugin_base.pyr   "   s   r   c                 C   s8  | dddt dd | dddt dd | dd	d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!dd"d#d | d$dd%d&d' | d(dd)d*d+d, | d-ddtd.d | d/dd0d*d1d, | d2dtdd3d4 | d5dtdd6d4 | d7dd8d*d9d, | d:dd;d*d<d, d S )=Nz
--log-infocallbackstringz,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--dropfirst
store_true	dropfirstz,Drop all tables in the target database first)r   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--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 used)r   r   r   z--reversetop
reversetopFzTUse a random-ordering set implementation in the ORM (helps reveal dependency issues))r   r   defaultr   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.)_log	_list_dbs_requirements_opt_include_tag_exclude_tag)make_optionr   r   r   setup_options:   s    r%   c                 C   s   ddl m} | |_dS )zConfigure 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 )aT  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 py.test 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    r0   c                 C   s(   t | d d  t| d d  dS )zfRestore important configuration needed by a follower.

    This invokes in the follower process.

    r.   r,   r-   N)r,   updater-   r/   r   r   r   !restore_important_follower_config   s    r2   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    r7   c                 C   s   | a tD ]}|t t qdS )z7things to set up early, before coverage might be setup.N)optionspre_configurer5   )optfnr   r   r   	pre_begin   s    r<   c                 C   s
   | t _d S N)r8   Zhas_coverage)valuer   r   r   set_coverage_flag   s    r?   c                  C   sl   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 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config)utilN)post_configurer8   r5   
sqlalchemyrA   r(   rB   rC   rD   rE   rF   rG   rI   rJ   Zsetup_filtersr;   r   r   r   
post_begin   s    rN   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_strr>   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sortedr5   r8   getsysexit)argsmacror   r   r   r      s    r    c                 C   s   t | d S r=   )_setup_requirementsrV   r   r   r   r!     s    r!   c                 C   s   t |dd d S N-_)r-   addreplacerV   r   r   r   r#     s    r#   c                 C   s   t |dd d S ra   )r,   rd   re   rV   r   r   r   r"      s    r"   c                 C   s   t |  | S r=   )r9   r   rM   r   r   r   pre(  s    
rf   c                 C   s   t |  | S r=   )rK   r   rM   r   r   r   post-  s    
rg   c                 C   s   | a d S r=   r8   r:   r5   r   r   r   _setup_options2  s    rj   c                 C   s   | j rtd d S )NZmemory_intensive)r   r-   rd   ri   r   r   r   _set_nomemory8  s    rk   c                 C   s   | j rdd l }|tjd< d S )Nr   decimal)r   r\   modules)r8   r5   r   r   r   r   _monkeypatch_cdecimal>  s    rn   c                 C   s   ddl m} t |_d S Nr   rH   )r(   rI   _fixture_fn_classZ_fixture_functions)r8   r5   rI   r   r   r   _init_symbolsF  s    rq   c              
   C   s  ddl m} ddlm} ddl m} | jr6t| j}ng }| jr| jD ]D}t	d|D ]2}||
dkrvtd| qV||d| qVqF|s||dd d |_|D ]d}| jr|jrt| jd	}	|	|jd
 | d  W 5 Q R X ||| ||j}
|js|
|
| qd S )Nr   rH   r@   r&   z[,\s]+r   z:Unknown URI specifier '%s'.  Specify --dbs for known uris.r   a 
)r(   rI   rL   rA   r'   r   listr   resplitr8   RuntimeErrorr   r[   _currentr   r)   openwriteZsetup_configZset_as_current)r8   r5   rI   rA   r'   Zdb_urlsZdb_tokenr   Zdb_urlfile_cfgr   r   r   _engine_uriM  s>    
"   r~   c                 C   s   | dd}t| d S )Nsqla_testingrequirement_cls)r[   r`   )r8   r5   r   r   r   r   _requirementsu  s    r   c                 C   sz   ddl m} ddlm} |jd k	r&d S | d\}}t|}|ddd  D ]}t||}qNt||}|  |_|_d S )Nr   rH   r@   :.   )	r(   rI   rL   rA   requirementsrw   
__import__getattrrequires)argumentrI   rA   modnameZclsnamemod	componentZreq_clsr   r   r   r`   |  s    

r`   c                 C   sv  ddl m}m} ddlm} ddlm}m} | jrr|j	
 D ]0}|j}||}	z|	 }
W n tk
rr   Y n(X |
D ] }|||||  qx|jj|rz|	jdd}
W n tk
r   Y n,X |
D ]$}|||j|| dd q|||	 |jj|r&|j||	|jd ||dr>ddlm} |	d	D ](}|||j|d
 |d d qFq>d S )Nr   )rI   rJ   )against)schemainspecttest_schema)r   
postgresql)r   *namer   )r   r   )r(   rI   rJ   Zsqlalchemy.testing.exclusionsr   rL   r   r   r   Configall_configsr   Zget_view_namesNotImplementedErrorexecuteZ	_DropViewZTableZMetaDatar   Zschemasenabled_for_configZdrop_all_tablesr   Zsqlalchemy.dialectsr   Z	get_enumsZDropEnumTypeZENUM)r8   r5   rI   rJ   r   r   r   r}   eZ	inspectorZ
view_namesZvnamer   enumr   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   )r8   r5   r   r   r   r   _reverse_topological  s    r   c                 C   s   ddl m} t|_||_d S ro   )r(   rI   r8   r5   )r:   r5   rI   r   r   r   _post_setup_options  s    r   c                 C   s$   ddl m} ||dd|_d S )Nr   )rG   r   Zprofile_file)r(   rG   ZProfileStatsFiler[   Z_profile_stats)r8   r5   rG   r   r   r   _setup_profiling  s    
r   c                 C   sJ   t |tjsdS | drdS tjjrBt|ddsBt|ddsBdS dS d S )NFrc   __backend____sparse_backend__T)
issubclassrB   ZTestBase
startswithrI   r8   r   r   )r   clsr   r   r   
want_class  s    


r   c                 C   s   |j dsdS |jd k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	rt|dr|j
tt	S dS d S )NZtest_F__tags___sa_exclusion_extendT)r   r   r   r,   hasattrrD   tagsr   Zinclude_testr-   r   )r   r;   r   r   r   want_method  s2    

 
  r   c                 c   s   t | ddst | ddrt | 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
[_\[\]\.]+rc   z_+$ z%s_%s)_sa_orig_cls_name__only_on_config__)r   _possible_configs_for_clsr   rv   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 r=   )	_do_skips_setup_enginer   r   r   r   start_test_class%  s    r   c                 C   s*   t j  ztjst  W 5 t  X d S r=   )rC   testing_reaperZ_stop_test_ctx_restore_enginer8   r   rE   global_cleanup_assertionsr   r   r   r   stop_test_class*  s
    
r   c                   C   s   t jt d S r=   )rI   ry   resetrA   r   r   r   r   r   5  s    r   c                   C   s   t j  t  t  d S r=   )rC   r   Z_stop_test_ctx_aggressiverE   r   r   r   r   r   r   final_process_cleanup9  s    
r   c                 C   s,   t | dd r(tj| jd}tj|t d S )N__engine_options__rh   )r   rC   Ztesting_enginer   rI   ry   Zpush_enginerA   )r   Zengr   r   r   r   ?  s    r   c                 C   s&   t |d|j}d|||f }|t_d S )Nr   z%s.%s.%s)r   r   rG   Z_current_test)testZtest_module_nameZ
test_classZ	test_namer   Zid_r   r   r   before_testE  s    r   c                 C   s   t j  d S r=   )rC   r   Z_after_test_ctx)r   r   r   r   
after_testQ  s    r   Fc                 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rtj}t|D ]H}| jD ]<}t	||}||}	|	r|| |d k	r||	  qqqt| drft  }
tj}t|D ]4}| jD ]&}t	||}||s$|
| q$q||
rf||
 |ri }tt|dd dD ] }|jj}||kr|||< q| S |S )N__only_on__r   __requires____prefer_requires__c                 S   s   | j j| j jjfS r=   )r   r   dialectZserver_version_info)r}   r   r   r   <lambda>  s    z+_possible_configs_for_cls.<locals>.<lambda>)key)setrI   r   r   Z__unsupported_on__rD   db_specru   remover   rJ   to_listr   intersection_updater   r   r   r   Zmatching_config_reasonsextendr   r   rd   
differencedifference_updatereversedrZ   r   r   values)r   reasonsr   r   spec
config_objr   requirementcheckZskip_reasonsnon_preferredZper_dialectr}   r   r   r   r   r   U  s^    








	
r   c                 C   s   g }t | |}t| ddrFt| dD ] }| r$td| j|jf  q$|sd| jddd tj D d|f }t| nRt| drt	 }t
jt| j }|D ]}||s|| q||r|| tj|krt| |  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 r=   )str).0digr   r   r   	<genexpr>  s   z&_do_skips.<locals>.<genexpr>.<genexpr>N)r   r   joinrD   Z_server_versionZdriver)r   r   r   r   r   r     s   


z_do_skips.<locals>.<genexpr>__prefer_backends__)r   r   rI   Z	skip_testr   r   r   r   r   r   rD   r   rJ   r   r   rd   r   r   ry   _setup_configpop)r   r   r   cmsgr   r   r   r   r   r   r     s6    






r   c                 C   s   t j| t d S r=   )rI   ry   pushrA   )r   ctxr   r   r   r     s    r   c                   @   sL   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	dS )FixtureFunctionsc                 O   s
   t  d S r=   r   selfargkwr   r   r   skip_test_exception  s    z$FixtureFunctions.skip_test_exceptionc                 O   s
   t  d S r=   r   r   r^   r   r   r   r   combinations  s    zFixtureFunctions.combinationsc                 O   s
   t  d S r=   r   r   r   r   r   param_ident  s    zFixtureFunctions.param_identc                 O   s
   t  d S r=   r   r   r   r   r   fixture  s    zFixtureFunctions.fixturec                 C   s
   t  d S r=   r   )r   r   r   r   get_current_test_name  s    z&FixtureFunctions.get_current_test_nameN)
r   r   r   r   abstractmethodr   r   r   r   r   r   r   r   r   r     s   



r   c                 C   s   | a d S r=   )rp   )Zfixture_fn_classr   r   r   set_fixture_functions  s    r   )NF)J__doc__
__future__r   r   rv   r\   version_infoZpy3kr3   r   r4   collectionsZcollections_abcobjectrB   rC   rD   rF   rG   rE   r   rI   rA   rJ   r5   rO   r   r,   r-   r8   r%   r*   r0   r2   r7   r<   r?   rN   r   r    r!   r#   r"   r9   rK   rf   rg   rj   rk   rn   rq   r~   r   r`   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rp   r   r   r   r   r   <module>   s   	





'

8



A*