B Wcf'@sdZddlZddlZddlmZddlmZddlmZddlmZddlmZddlm Z dd lm Z dd l m Z d Z e rdd lmZndd lmZeZGdddeZeefZGdddeZGdddeZGdddeZe dedefdZe de edZGdddeeefZeeegeeeffdddZeed7dd eeeeeed!d"d#Zeed8d dd$ee eeed%d&d'Z!eed9ee eeed)d*d+Z"d:eeeeed,d-d.Z#Gd/d0d0eZ$ee$d;eed1d2d3Z%d)r rr)rrrr__repr__+s zOutcomeException.__repr__)NT) r __module__ __qualname____doc__rrboolrr__str__ __classcell__rr)rrr s r cs:eZdZdZd ddeeeeeddfddZZS) SkippedbuiltinsNTF)_use_item_location)r rallow_module_levelr&rcs tj||d||_||_dS)N)r r)rrr'r&)rr rr'r&)rrrr;szSkipped.__init__)NTF)rrrrrr!rr#rr)rrr$6s r$c@seZdZdZdZdS)Failedz.Raised from an explicit call to pytest.fail().r%N)rrrr rrrrr(Jsr(cs0eZdZdZdeeeddfdd ZZS)Exitz=Raised for immediate program exits (no tracebacks/summaries).unknown reasonN)r returncodercs||_||_t|dS)N)r r+rr)rr r+)rrrrSsz Exit.__init__)r*N) rrrr rrintrr#rr)rrr)Ps r)_F.)Zbound_ETc@seZdZUeed<eed<dS)_WithException Exception__call__N)rrrr.__annotations__r-rrrrr/bs r/)exception_typercs ttttfdfdd }|S)N)funcrcsttttf|}|_|S)N)rr/r-r.r0)r4Zfunc_with_exception)r3rrdecoratehsz!_with_exception..decorate)r-r/r.)r3r5r)r3r_with_exceptiongsr6)r )reasonr+r rcCs\d}ddlm}|r |r |d|sN|dkr4|dtjtjddd d |}t||dS) axExit testing process. :param reason: The message to show as the reason for exiting pytest. reason has a default value only because `msg` is deprecated. :param returncode: Return code to be used when exiting pytest. :param msg: Same as ``reason``, but deprecated. Will be removed in a future version, use ``reason`` instead. Tr) UsageErrorzHcannot pass reason and msg to exit(), `msg` is deprecated, use `reason`.Nz!exit() requires a reason argumentexit)r4) stacklevel)Z_pytest.configr9warningswarnr rr))r8r+r __tracebackhide__r9rrrr:ss r:)r'r )r8r'r rcCs d}td||}t||ddS)aSkip an executing test with the given message. This function should be called only during testing (setup, call or teardown) or during collection by using the ``allow_module_level`` flag. This function can be called in doctests as well. :param reason: The message to show the user as reason for the skip. :param allow_module_level: Allows this function to be called at module level, skipping the rest of the module. Defaults to False. :param msg: Same as ``reason``, but deprecated. Will be removed in a future version, use ``reason`` instead. .. note:: It is better to use the :ref:`pytest.mark.skipif ref` marker when possible to declare a test to be skipped under certain conditions like mismatching platforms or dependencies. Similarly, use the ``# doctest: +SKIP`` directive (see :py:data:`doctest.SKIP`) to skip a doctest statically. Tskip)r r'N)_resolve_msg_to_reasonr$)r8r'r r?rrrr@s r@T)r8rr rcCs d}td||}t||ddS)aExplicitly fail an executing test with the given message. :param reason: The message to show the user as reason for the failure. :param pytrace: If False, msg represents the full failure information and no python traceback will be reported. :param msg: Same as ``reason``, but deprecated. Will be removed in a future version, use ``reason`` instead. Tfail)r rN)rAr()r8rr r?rrrrBs rB) func_namer8r rcCsJd}|dk rF|r,ddlm}|d|dtjtj|ddd |}|S) a Handles converting the deprecated msg parameter if provided into reason, raising a deprecation warning. This function will be removed when the optional msg argument is removed from here in future. :param str func_name: The name of the offending function, this is formatted into the deprecation message. :param str reason: The reason= passed into either pytest.fail() or pytest.skip() :param str msg: The msg= passed into either pytest.fail() or pytest.skip(). This will be converted into reason if it is provided to allow pytest.skip(msg=) or pytest.fail(msg=) to continue working in the interim period. :returns: The value to use as reason. TNr)r9z.Passing both ``reason`` and ``msg`` to pytest.z(...) is not permitted.)r4)r<)Zpytestr9r=r>r r)rCr8r r?r9rrrrAs rAc@seZdZdZdS)XFailedz/Raised from an explicit call to pytest.xfail().N)rrrr rrrrrEsrE)r8rcCsd}t|dS)aImperatively xfail an executing test or setup function with the given reason. This function should be called only during testing (setup, call or teardown). :param reason: The message to show the user as reason for the xfail. .. note:: It is better to use the :ref:`pytest.mark.xfail ref` marker when possible to declare a test to be xfailed under certain conditions like known bugs or missing features. TN)rE)r8r?rrrxfailsrF)modname minversionr8rc Csddl}d}t|dd|f|dy t|WnHtk r}z*|dkrbd|d|}t|dd dWdd}~XYnXWdQRXtj|}|dkr|St |d d}|dk rdd l m }|dks||||krtd |||fdd |S) avImport and return the requested module ``modname``, or skip the current test if the module cannot be imported. :param modname: The name of the module to import. :param minversion: If given, the imported module's ``__version__`` attribute must be at least this minimal version, otherwise the test is still skipped. :param reason: If given, this reason is shown as the message when the module cannot be imported. :returns: The imported module. This should be assigned to its canonical name. Example:: docutils = pytest.importorskip("docutils") rNTr7evalignorezcould not import z: )r' __version__)Versionz-module %r has __version__ %r, required is: %r) r=compilecatch_warnings simplefilter __import__ ImportErrorr$sysmodulesgetattrZpackaging.versionrL) rGrHr8r=r?excmodZverattrrLrrr importorskips.    *    rW)r7N)r7)r7TN)N)r7)NN)'r rRr=typingrrrrrrrZ_pytest.deprecatedr Z TYPE_CHECKINGZtyping_extensionsr r BaseExceptionr r0Z TEST_OUTCOMEr$r(r)objectr-r.r/r6rr,r:r!r@rBrArErFrWrrrrsN         "  #