o ˷e@srdZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z m Z ddZ d)d d Zd)d d Zd dZddZeejdkdZeejddZeejdkdZeejdkdZeejd dZejdvo|ejdddkZdZeeeZddZedZed Z d!dZ!zej"d"d#Z#Wn e$yd$Z%Ynwd%Z%e#&ee%d&Z'd'd(Z(dS)*aDecorators for labeling test objects. Decorators that merely return a modified version of the original function object are straightforward. Decorators that return a new function object need to use nose.tools.make_decorator(original_function)(decorator) in returning the decorator, in order to preserve metadata such as function name, setup and teardown functions and so on - see nose.tools for more information. This module provides a set of useful decorators meant to be ready to use in your own tests. See the bottom of the file for the ready-made ones, and if you find yourself writing a new one that may be of generic use, add it here. Included decorators: Lightweight testing that remains unittest-compatible. - An @as_unittest decorator can be used to tag any normal parameter-less function as a unittest TestCase. Then, both nose and normal unittest will recognize it as such. This will make it easier to migrate away from Nose if we ever need/want to while maintaining very lightweight tests. NOTE: This file contains IPython-specific decorators. Using the machinery in IPython.external.decorators, we import either numpy.testing.decorators if numpy is available, OR use equivalent code in IPython.external._decorators, which we've copied verbatim from numpy. N) import_module) decorator) ipdoctest ipdocstringcs"Gfdddtj}j|_|S)zDDecorator to make a simple function into a normal test via unittest.cseZdZfddZdS)zas_unittest..Testercs dSN)selffuncrQ/var/www/ideatree/venv/lib/python3.10/site-packages/IPython/testing/decorators.pytest7s z as_unittest..Tester.testN)__name__ __module__ __qualname__r rr rr Tester6sr)unittestTestCaser)r rrr r as_unittest4srcCs2|durd}ddl}t|tsJ|jj||dS)aMake function raise SkipTest exception if skip_condition is true Parameters ---------- skip_condition : bool or callable Flag to determine whether to skip test. If the condition is a callable, it is used at runtime to dynamically make the decision. This is useful for tests that may require costly imports, to delay the cost until the test suite is actually executed. msg : string Message to give on raising a SkipTest exception. Returns ------- decorator : function Decorator, which, when applied to a function, causes SkipTest to be raised when the skip_condition was True, and the function to be called normally otherwise. Nz#Test skipped due to test condition.rreason)pytest isinstanceboolmarkskipif)skip_conditionmsgrrrr rAs rcCs |r t|ts tdtd|S)aYDecorator factory - mark a test function for skipping from test suite. Parameters ---------- msg : string Optional message to be added. Returns ------- decorator : function Decorator, which, when applied to a function, causes SkipTest to be raised, with the optional message added. zSinvalid object passed to `@skip` decorator, did you meant `@skip()` with brackets ?T)rstr ValueErrorr)rrrr skipas r cCs t| |S)z0The reverse from skipif, see skipif for details.)r) conditionrrrr onlyifus r"cCs,z t|}d}W|Styd}Y|Sw)zCan module be imported? Returns true if module does NOT import. This is used to make a decorator to skip tests that require module to be available, but delay the 'import numpy' to test execution time. FT)r ImportError)modulemod mod_not_availrrr module_not_available|s r'win32z$This test does not run under Windowslinuxz"This test does not run under Linuxdarwinz!This test does not run under OS Xz!This test only runs under WindowszThis test only runs under Linux)r*r(DISPLAYz.Skipped under *nix when X11/XOrg not availablecCstt|d|S)NzThis test requires %s)rr')r%rrr sr-numpy matplotlibcCs|Srr)frrr r-sutmp€)prefixFTzCThis test is only applicable where we can use unicode in filenames.cGsXtjdddus Jd|D]}d|d}t|s)ddl}|jj|dSqtS)zN Decorator to skip test when at least one of `commands` is not found. IPTEST_WORKING_DIRNz#iptest deprecated since IPython 8.0z This test runs only if command 'z' is installedrr) osenvirongetshutilwhichrrr null_deco)commandscmdrrrrr onlyif_cmds_exists  r;r))__doc__r3r6systempfilerwarnings importlibrr ipunittestrrrrr r"r'platform skip_win32 startswith skip_linuxskip_osxskip_if_not_win32skip_if_not_linuxr4r5_x11_skip_cond _x11_skip_msgskip_if_no_x11 skip_withoutskipif_not_numpyskipif_not_matplotlibr8NamedTemporaryFiler0UnicodeEncodeError unicode_pathscloseonlyif_unicode_pathsr;rrrr s\