a 4jv@s2dZddlmZmZmZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z ddlmZddlmZddlmZddlmZmZmZmZmZdd lmZe jrddlZnddlZGd d d e Z!Gd d d e"Z#Gddde$Z%ej&ddZ'ej&dddZ(ddZ)Gddde$Z*Gddde*Z+dS)zT This module provides Runner class to run behave feature files (or model elements). )absolute_importprint_functionwith_statementN) ExceptionUtil)CaptureController) ConfigError)make_formatters)collect_feature_locationsparse_features exec_fileload_step_modules PathManager)registryc@s eZdZdS) CleanupErrorN)__name__ __module__ __qualname__rr3E:\soccer\ml_env\Lib\site-packages\behave/runner.pyr src@seZdZdZdS)ContextMaskWarninga0Raised if a context variable is being overwritten in some situations. If the variable was originally set by user code then this will be raised if *behave* overwites the value. If the variable was originally set by *behave* then this will be raised if user code overwites the value. N)rrr__doc__rrrrr$src@seZdZdZdZdZdZddZeddZ ed d Z d d Z d,ddZ ddZ ddZddZddZddZddZd-ddZd d!Zd"d#Zd$d%Zd&d'Zd(d)Zd*d+Zd S).ContextaHold contextual information during the running of tests. This object is a place to store information related to the tests you're running. You may add arbitrary attributes to it of whatever value you need. During the running of your tests the object will have additional layers of namespace added and removed automatically. There is a "root" namespace and additional namespaces for features and scenarios. Certain names are used by *behave*; be wary of using them yourself as *behave* may overwrite the value you set. These names are: .. attribute:: feature This is set when we start testing a new feature and holds a :class:`~behave.model.Feature`. It will not be present outside of a feature (i.e. within the scope of the environment before_all and after_all). .. attribute:: scenario This is set when we start testing a new scenario (including the individual scenarios of a scenario outline) and holds a :class:`~behave.model.Scenario`. It will not be present outside of the scope of a scenario. .. attribute:: tags The current set of active tags (as a Python set containing instances of :class:`~behave.model.Tag` which are basically just glorified strings) combined from the feature and scenario. This attribute will not be present outside of a feature scope. .. attribute:: aborted This is set to true in the root namespace when the user aborts a test run (:exc:`KeyboardInterrupt` exception). Initially: False. .. attribute:: failed This is set to true in the root namespace as soon as a step fails. Initially: False. .. attribute:: table This is set at the step level and holds any :class:`~behave.model.Table` associated with the step. .. attribute:: text This is set at the step level and holds any multiline text associated with the step. .. attribute:: config The configuration of *behave* as determined by configuration files and command-line options. The attributes of this object are the same as the `configuration file section names`_. .. attribute:: active_outline This is set for each scenario in a scenario outline and references the :class:`~behave.model.Row` that is active for the current scenario. It is present mostly for debugging, but may be useful otherwise. .. attribute:: log_capture If logging capture is enabled then this attribute contains the captured logging as an instance of :class:`~behave.log_capture.LoggingCapture`. It is not present if logging is not being captured. .. attribute:: stdout_capture If stdout capture is enabled then this attribute contains the captured output as a StringIO instance. It is not present if stdout is not being captured. .. attribute:: stderr_capture If stderr capture is enabled then this attribute contains the captured output as a StringIO instance. It is not present if stderr is not being captured. If an attempt made by user code to overwrite one of these variables, or indeed by *behave* to overwite a user-set variable, then a :class:`behave.runner.ContextMaskWarning` warning will be raised. You may use the "in" operator to test whether a certain value has been set on the context, for example: "feature" in context checks whether there is a "feature" value in the context. Values may be deleted from the context using "del" but only at the level they are set. You can't delete a value set by a feature at a scenario level but you can delete a value set for a scenario in that scenario. .. _`configuration file section names`: behave.html#configuration-files ZbehaveuserTcCs|t||_|j|_dd|jddgdd}|_|g|_i|_i|_|j |_ d|_ d|_ d|_ d|_d|_d|_|j|_dS)NFrZtestrun)abortedfailedconfigZactive_outlinecleanup_errors @cleanups@layer)weakrefproxy_runnerr_config_root_stack_record_originBEHAVE_modefeaturetexttableZstdout_captureZstderr_captureZ log_captureFAIL_ON_CLEANUP_ERRORSfail_on_cleanup_errors)selfrunnerdrrr__init__s*  zContext.__init__cCsdSNr)context cleanup_func exceptionrrrignore_cleanup_errorszContext.ignore_cleanup_errorcCs@t|dd}|sd|}td||jj|ftjtjddS)Nrz%rzCLEANUP-ERROR in %s: %s: %s)file)getattrprint __class__r traceback print_excsysstdout)r3r4r5Zcleanup_func_namerrrprint_cleanup_errors  zContext.print_cleanup_errorc Cs|jsJd|jd}|dg}t|d|j}|}g}t|D]`}z |WqBty}z8|jdd7<|t ||||WYd}~qBd}~00qB|j r|r|d}~t j |dS)a$Execute optional cleanup functions when stack frame is popped. A user can add a user-specified handler for cleanup errors. .. code-block:: python # -- FILE: features/environment.py def cleanup_database(database): pass def handle_cleanup_error(context, cleanup_func, exception): pass def before_all(context): context.on_cleanup_error = handle_cleanup_error context.add_cleanup(cleanup_database, the_database) zREQUIRE: Non-empty stackrron_cleanup_errorrN) r$getr8r?reversed Exceptionr#appendr=exc_infor-sixreraise) r.Z current_layerZ cleanup_funcsr@r3rr4eZfirst_cleanup_erro_inforrr _do_cleanupss&    $ zContext._do_cleanupsNcCs&dgi}|r||d<|jd|dS)zPush a new layer on the context stack. HINT: Use layer_name values: "scenario", "feature", "testrun". :param layer_name: Layer name to use (or None). rrrN)r$insert)r. layer_nameZ initial_datarrr_pushsz Context._pushc Cs,z|W|jdn|jd0dS)zxPop the current layer from the context stack. Performs any pending cleanups, registered for this layer. rN)rJr$popr.rrr_pops z Context._popcCs t|tjS)z@Provides a context manager for using the context in BEHAVE mode.)use_context_with_moderr'rOrrr_use_with_behave_modeszContext._use_with_behave_modecCs t|tjS)z>Provides a context manager for using the context in USER mode.)rQrUSERrOrrruse_with_user_modeszContext.use_with_user_modecCstjdtdd|S)Nz"Use 'use_with_user_mode()' instead stacklevel)warningswarnPendingDeprecationWarningrTrOrrr user_modeszContext.user_modecCs|jdD]P}||jdurq ||vr |jd|}||d|d|dd}|||q ||jd|<||jvr|j|j|<dS)Nr$r#r%rrAattrfilenamelinefunction)__dict__ _emit_warningr&r()r.r^valueframerecordparamsrrr_set_root_attribute s zContext._set_root_attributecCstd}|j|jur&|j||jur&d}n.|j|jurT|j||jurHd}n |jjrTd}|rp||}tj|tdddS)Nzlbehave runner is masking context attribute '%(attr)s' originally set in %(function)s (%(filename)s:%(line)s)zJuser code is masking context attribute '%(attr)s' originally set by behavezWuser code is masking context attribute '%(attr)s'; see the tutorial for what this meansr\rV) r(r'r&rSr"verboserXrYr)r.r^rgmsgrrrrcs zContext._emit_warningF cCsjt|jD]Z\}}td||f|rTt|D]}||}td|||fq2q t|t|q dS)Nz %sLevel %dz%s %-15s = %r) enumerater$r9sortedkeysrepr)r.prettyprefixlevelrenamerdrrr_dump/sz Context._dumpcCsV|ddkr|j|S|jD]}||vr||Sqd}||jj|}t|dS)Nr_z#'{0}' object has no attribute '{1}')rbr$formatr:rAttributeErrorr.r^rerkrrr __getattr__9s   zContext.__getattr__cCs|ddkr||j|<dS|jddD]<}||vr(|j|}||d|d|dd}|||q(d}tjrx|d7}tj|dd}||j|<|jd}|||<||jvr|j |j|<dS)NrrvrAr\r]rU)limit) rbr$r%rcrGPY2r; extract_stackr&r()r.r^rdrerfrgZ stack_limitZ stack_framerrr __setattr__Cs*      zContext.__setattr__cCsB|jd}||vr"||=|j|=nd}||jj|}t|dS)Nrz8'{0}' object has no attribute '{1}' at the current level)r$r%rwr:rrxryrrr __delattr__]s  zContext.__delattr__cCs4|ddkr||jvS|jD]}||vrdSqdS)NrrvTF)rbr$)r.r^rerrr __contains__gs    zContext.__contains__c Cs t|tjsJd|js"tdt|dd}t|dd}d|jj_|jj|}| |D]|}|j |j ddd }|s`d |j |j f}d |jj |f}|jr|d |j7}|d 7}|dt|j7}ds`J|q`||_||_Wdn1s0YdS)aOThe steps identified in the "steps" text string will be parsed and executed in turn just as though they were defined in a feature file. If the execute_steps call fails (either through error or failure assertion) then the step invoking it will need to catch the resulting exceptions. :param steps_text: Text with the Gherkin steps to execute (as string). :returns: True, if the steps executed successfully. :raises: AssertionError, if a step failure occurs. :raises: ValueError, if invoked without a feature context. zSteps must be unicode.z)execute_steps() called outside of featurer+Nr*stepsTF)quietcapturez%s %sz%s SUB-STEP: %sz Substep info: %s zTraceback (of failed substep): ri) isinstancerG text_typer) ValueErrorr8parservariantZ parse_stepsrRrunr!keywordrtstatusupper error_messagejoinr; format_tb exc_tracebackr+r*) r.Z steps_textZoriginal_tableZ original_textrstepZpassedZ step_linemessagerrr execute_stepsos.     $zContext.execute_stepscs`tsJd|jsJs"r4fdd}n}|jd}|dvr\|d|dS)aIAdds a cleanup function that is called when :meth:`Context._pop()` is called. This is intended for user-cleanups. :param cleanup_func: Callable function :param args: Args for cleanup_func() call (optional). :param kwargs: Kwargs for cleanup_func() call (optional). z REQUIRES: callable(cleanup_func)csidSr2rrargsr4kwargsrrinternal_cleanup_funcsz2Context.add_cleanup..internal_cleanup_funcrrN)callabler$rE)r.r4rrr current_framerrr add_cleanups    zContext.add_cleanup)N)Frl)rrrrr'rSr,r1 staticmethodr6r?rJrMrPrRrTr[rhrcrurzr~rrrrrrrrr0s0e  (     ,rccs>|tjtjfvsJ|j}z||_dVW||_n||_0dS)aSwitch context to BEHAVE or USER mode. Provides a context manager for switching between the two context modes. .. sourcecode:: python context = Context() with use_context_with_mode(context, Context.BEHAVE): ... # Do something # -- POSTCONDITION: Original context._mode is restored. :param context: Context object to use. :param mode: Mode to apply to context object. N)rr'rSr()r3modeZ current_moderrrrQs rQccs,z|||VW|n |0dS)zProvides context manager for context layer (push/do-something/pop cycle). .. code-block:: with scoped_context_layer(context): the_fixture = use_fixture(foo, context, name="foo_42") N)rMrP)r3rLrrrscoped_context_layers  rcCs(tj|\}}|r |tjjStjjS)a* Extract rootdir from path in a platform independent way. POSIX-PATH EXAMPLE: rootdir = path_getrootdir("/foo/bar/one.feature") assert rootdir == "/" WINDOWS-PATH EXAMPLE: rootdir = path_getrootdir("D:\foo\bar\one.feature") assert rootdir == r"D:" )ospath splitdrivesep)rdrivervrrrpath_getrootdirs  rc@sreZdZdZdddZddZddZeeed d Zd d Z d dZ ddZ ddZ ddZ dddZddZdS) ModelRunnera} Test runner for a behave model (features). Provides the core functionality of a test runner and the functional API needed by model elements. .. attribute:: aborted This is set to true when the user aborts a test run (:exc:`KeyboardInterrupt` exception). Initially: False. Stored as derived attribute in :attr:`Context.aborted`. NcCsH||_|p g|_i|_g|_g|_||_t||_d|_d|_ d|_ dS)Nr) rfeatureshooks formattersundefined_steps step_registryrcapture_controllerr3r) hook_failures)r.rrrrrrr1s  zModelRunner.__init__cCsd}|jr|jj}|S)NF)r3rr.rdrrr _get_abortedszModelRunner._get_abortedcCs*|jsJd|j|jdt|dS)Nz REQUIRE: context, but context=%rr)r3rhboolrrrr _set_abortedszModelRunner._set_abortedz/Indicates that test run is aborted by the user.)docc GsV|jjsR||jvrRzB|&|j||g|RWdn1sL0YWntyP}zd}|jjrd}t|d}d|vrd|d}t|| }d|||f}t ||j d7_ d|vrt |d |j } nd |vrd|_d} n|d} | r|g|j_|t kr\|jt dS)NzSupplied path:z, css|]}d|VqdS)z"%s"Nr).0rrrr z%Runner.setup_paths..rr_@rAz0Primary path is to a file so using its directoryzUsing default path "./features"rzTrying base directory:zQERROR: Could not find "%s" directory. Please specify where to find your features.z@ERROR: Could not find "%s" directory in your specified path "%s"zNo %s directory in %rcSsg|]}|dr|qS)z.feature)endswith)rfnrrr rz&Runner.setup_paths..z]ERROR: Could not find any ".feature" files. Please specify where to find your features.zLERROR: Could not find any ".feature" files in your specified path "%s"zNo feature files in %r)rpathsrjr9rhasattrr_ startswithfeature_locationsrrdirnameabspathisfiler steps_direnvironment_fileisdirrrwalkraddgetcwd) r.Z first_pathrZfile_locationsroot_dirZ new_base_dirrrrdirpathdirnames filenamesrrr setup_pathss                      zRunner.setup_pathscCs|jdS)z Default implementation for :func:`before_all()` hook. Setup the logging subsystem based on the configuration data. N)r setup_logging)r.r3rrrbefore_all_default_hookszRunner.before_all_default_hookNcCsN|p |jj}tj|j|}tj|r4t||jd|jvrJ|j |jd<dS)Nr) rrrrrrexistsr rr)r.r_Z hooks_pathrrr load_hooks s     zRunner.load_hookscCs:|dur g}tj|j|jj}|gt|}t|dSr2)rrrrrrlistr )r.Zextra_step_pathsrZ step_pathsrrrload_step_definitionss zRunner.load_step_definitionscCs t|jjSr2)r rrrOrrrrszRunner.feature_locationscCs:|j ||WdS1s,0YdSr2)rrrun_with_pathsrOrrrr!sz Runner.runcsjt_fddD}t|jjd}j |jj }t j|_ S)Ncsg|]}j|s|qSr)rexclude)rr_rOrrr0s z)Runner.run_with_paths..)language)rr3rrrr rlangrextendoutputsrrr)r.rrZstream_openersrrOrr&s  zRunner.run_with_paths)N)N) rrrrr1rrrrrrr __classcell__rrrrrs U r)N),r __future__rrr contextlibos.pathrr=rXrrGZ behave._typesrZbehave.capturerZbehave.configurationrZbehave.formatter._registryrZbehave.runner_utilr r r r r Zbehave.step_registryrrr|Z traceback2r; RuntimeErrorr UserWarningrobjectrcontextmanagerrQrrrrrrrrs<         /