o oÇ h—Gã @sTdZddlZddlZddlZddlZddlZddlmZddlm Z m Z m Z zddl Z Wne yDGdd„deƒZGdd„dƒZ Ynwdd lmZe d ¡e d d ¡fZd ZGdd„dƒZe d¡Zejdejfdd„ƒZde ede efdd„Zde ede e ede ede efdd„Zdedefdd„Zdddœd d!„Zd"d#„ZdS)$a¾Backwards compatible functions for running tests from SymPy using pytest. SymPy historically had its own testing framework that aimed to: - be compatible with pytest; - operate similarly (or identically) to pytest; - not require any external dependencies; - have all the functionality in one file only; - have no magic, just import the test file and execute the test functions; and - be portable. To reduce the maintence burden of developing an independent testing framework and to leverage the benefits of existing Python testing infrastructure, SymPy now uses pytest (and various of its plugins) to run the test suite. To maintain backwards compatibility with the legacy testing interface of SymPy, which implemented functions that allowed users to run the tests on their installed version of SymPy, the functions in this module are implemented to match the existing API while thinly wrapping pytest. These two key functions are `test` and `doctest`. éN)Úfnmatch)ÚListÚOptionalÚTuplec@seZdZdZdS)Ú NoPytestErrorzBRaise when an internal test helper function is called with pytest.N)Ú__name__Ú __module__Ú __qualname__Ú__doc__©r r úq/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/sympy/testing/runtests_pytest.pyr$src@seZdZdZedd„ƒZdS)Úpytestz@Shadow to support pytest features when pytest can't be imported.cOs d}t|ƒ‚)Nz7pytest must be installed to run tests via this function)r)ÚargsÚkwargsÚmsgr r r Úmain*sz pytest.mainN)rrr r Ú staticmethodrr r r r r 'sr )ÚtestÚsympyÚdocÚsrc)z%sympy/integrals/rubi/rubi_tests/testsc@s²eZdZUdZdZeed<dZeed<dZeed<dZ eed <d Z eed <e j d e fd d„ƒZe j d e fdd„ƒZe j d e fdd„ƒZe j d e fdd„ƒZe j d e fdd„ƒZdS)ÚPytestPluginManagerz.Module names for pytest plugins used by SymPy.r ÚPYTESTÚpytest_randomlyÚRANDOMLYÚ pytest_splitÚSPLITÚpytest_timeoutÚTIMEOUTÚxdistÚXDISTÚreturncCóttj |j¡ƒS©N)ÚboolÚ importlibÚutilÚ find_specr©Úselfr r r Ú has_pytestCózPytestPluginManager.has_pytestcCr"r#)r$r%r&r'rr(r r r Ú has_randomlyGr+z PytestPluginManager.has_randomlycCr"r#)r$r%r&r'rr(r r r Ú has_splitKr+zPytestPluginManager.has_splitcCr"r#)r$r%r&r'rr(r r r Ú has_timeoutOr+zPytestPluginManager.has_timeoutcCr"r#)r$r%r&r'r r(r r r Ú has_xdistSr+zPytestPluginManager.has_xdistN)rrr r rÚstrÚ__annotations__rrrr Ú functoolsÚcached_propertyr$r*r,r-r.r/r r r r r;s"      rz([1-9][0-9]*)/([1-9][0-9]*)r!cCst t¡jdS)z!Returns the root SymPy directory.é)ÚpathlibÚPathÚ__file__Úparentsr r r r Ú sympy_dir[sr9rcCs| dttƒƒg¡|S)a!Adds `--rootdir` and path to the args `list` passed to `pytest.main`. This is required to ensure that pytest is able to find the SymPy tests in instances where it gets confused determining the root directory, e.g. when running with Pyodide (e.g. `bin/test_pyodide.mjs`). z --rootdir)Úextendr0r9)rr r r Úupdate_args_with_rootdirasr;ÚpathsÚkeywordscsp‡fdd„}dtdtfdd„}dd„}g‰tD]}t tƒ|¡}| ¡r+ˆ t|ƒ¡qg}|rag} g} |D]} t | ¡ ¡rL|  tt tƒ| ¡ƒ¡q6|  | ¡q6|| ƒ} | | ¡| | ¡n| ˆ¡|d ur±|d kr±g} |D]7} || ƒrƒ||| ƒ}|  |¡qrt   | ¡D] \}}}|D]}tt ||¡ƒ}||ƒr§|||ƒ}|  |¡qqˆqr| | ¡|S| |¡|S) a¨Appends valid paths and flags to the args `list` passed to `pytest.main`. The are three different types of "path" that a user may pass to the `paths` positional arguments, all of which need to be handled slightly differently: 1. Nothing is passed The paths to the `testpaths` defined in `pytest.ini` need to be appended to the arguments list. 2. Full, valid paths are passed These paths need to be validated but can then be directly appended to the arguments list. 3. Partial paths are passed. The `testpaths` defined in `pytest.ini` need to be recursed and any matches be appended to the arguments list. c sZg}|D]W}t|ƒdkr|dd…dk}|dd…dk}nt|ƒdkr.d}|dd…dk}nd}d}|r<|r<| |¡q|rG| |›d¡q|rR| d|›¡q| d|›d¡qg}ˆD]J}tj|d d D]@\}}} t||ƒ} | D]3\}} t|d |›d ƒr“| tt |¡ƒ¡g|dd…<qu| D]} t| | ƒr§| tt || ¡ƒ¡q•quqiq`|S) Néréýÿÿÿú.pyéFz*.pyztest*T)ÚtopdownÚ*) ÚlenÚappendÚosÚwalkÚziprr0r5r6) Ú partial_pathsÚpartial_path_file_patternsÚ partial_pathÚhas_test_prefixÚ has_py_suffixÚmatchesÚtestpathÚpathÚdirsÚfilesÚzippedÚpartial_path_fileÚfile©Úvalid_testpaths_defaultr r Úfind_paths_matching_partialƒsB      €þûþ z;update_args_with_paths..find_paths_matching_partialÚfilepathr!cSs<t |¡}| ¡s dS|jd d¡sdS|jdksdSdS)NFéÿÿÿÿÚtest_r@T)r5r6Úis_fileÚpartsÚ startswithÚsuffix)rYrPr r r Ú is_tests_file¥s  z-update_args_with_paths..is_tests_filec Ss¨g}t|ddB}| ¡}| ¡D]0}| ¡ d¡rA|D]$}| ¡ | ¡¡dkr@| d¡d d¡d}|d |}| |¡qqWdƒ|S1sMwY|S) Nzutf-8)Úencodingzdef rZú éú(rz::) ÚopenÚreadÚ splitlinesÚlstripr^ÚlowerÚfindÚsplitrE) r=rYrNÚ tests_fileÚsourceÚlineÚkwÚ test_nameÚfull_test_pathr r r Úfind_tests_matching_keywords¯s    €ú þ ÷ z.find_tests_matching_keywordsNr ) r0r$ÚTESTPATHS_DEFAULTr5r6r9ÚexistsrEr:rFrG)r<r=rrXr`rrrOÚabsolute_testpathÚcandidate_pathsÚ full_pathsrIrPÚ matched_pathsrNÚ test_matchesÚrootÚdirnamesÚ filenamesÚfilenameÚabsolute_filepathr rVr Úupdate_args_with_pathsmsV "  €      þ €ùÿ  þrrKcCsHdtdtfdd„}||ƒsdt|ƒ›d}t|ƒ‚tt tƒ|¡ƒ}|S)a€Convert a partial path to an absolute path. A path such a `sympy/core` might be needed. However, absolute paths should be used in the arguments to pytest in all cases as it avoids errors that arise from nonexistent paths. This function assumes that partial_paths will be passed in such that they begin with the explicit `sympy` directory, i.e. `sympy/...`. rKr!cSst |¡jddkS)z@Assumption that partial paths are defined from the `sympy` root.rr)r5r6r])rKr r r Úis_valid_partial_pathôsz1make_absolute_path..is_valid_partial_pathz Partial path z] is invalid, partial paths are expected to be defined with the `sympy` directory as the root.)r0r$ÚdirÚ ValueErrorr5r6r9)rKr€rÚ absolute_pathr r r Úmake_absolute_pathès ÿr„T©Ú subprocessÚreruncOs| dd¡r-| dd¡| dd¡| dd¡| d¡dur#d|d<t|ddd œ|¤ŽStƒ}|js7t ¡g}t|ƒ}| d d¡rH| d ¡| d ¡}rV|  d |g¡| d¡r`| d¡| dd¡sm|  ddg¡| d¡}r†|j s}d}t |ƒ‚|  dt |ƒg¡| dd¡r•|j r•| d¡n| dd¡s¤|j s¤d}t |ƒ‚| dd¡} rÀ|j sµd}t |ƒ‚|  dt t| ƒƒg¡| dd¡rÎ|  ddg¡n|  ddg¡| d¡} dur|jsèd }t |ƒ‚t | ¡} | sõd!}t|ƒ‚tt |  ¡ƒ\} } |  d"| d#| g¡| | krd$| ›d%| ›d&}t|ƒ‚| d't¡}r1|D] }|  d(t|ƒg¡q$| dd¡rI|jsBd)}t |ƒ‚|  d*d+g¡| dd¡r_|jsZd,}t |ƒ‚| d-¡| d.¡}durstd/d0„|Dƒƒ}nd1}t|||ƒ}t |¡}|S)2aêInterface to run tests via pytest compatible with SymPy's test runner. Explanation =========== Note that a `pytest.ExitCode`, which is an `enum`, is returned. This is different to the legacy SymPy test runner which would return a `bool`. If all tests sucessfully pass the `pytest.ExitCode.OK` with value `0` is returned, whereas the legacy SymPy test runner would return `True`. In any other scenario, a non-zero `enum` value is returned, whereas the legacy SymPy test runner would return `False`. Users need to, therefore, be careful if treating the pytest exit codes as booleans because `bool(pytest.ExitCode.OK)` evaluates to `False`, the opposite of legacy behaviour. Examples ======== >>> import sympy # doctest: +SKIP Run one file: >>> sympy.test('sympy/core/tests/test_basic.py') # doctest: +SKIP >>> sympy.test('_basic') # doctest: +SKIP Run all tests in sympy/functions/ and some particular file: >>> sympy.test("sympy/core/tests/test_basic.py", ... "sympy/functions") # doctest: +SKIP Run all tests in sympy/core and sympy/utilities: >>> sympy.test("/core", "/util") # doctest: +SKIP Run specific test from a file: >>> sympy.test("sympy/core/tests/test_basic.py", ... kw="test_equality") # doctest: +SKIP Run specific test from any file: >>> sympy.test(kw="subs") # doctest: +SKIP Run the tests using the legacy SymPy runner: >>> sympy.test(use_sympy_runner=True) # doctest: +SKIP Note that this option is slated for deprecation in the near future and is only currently provided to ensure users have an alternative option while the pytest-based runner receives real-world testing. Parameters ========== paths : first n positional arguments of strings Paths, both partial and absolute, describing which subset(s) of the test suite are to be run. subprocess : bool, default is True Legacy option, is currently ignored. rerun : int, default is 0 Legacy option, is ignored. use_sympy_runner : bool or None, default is None Temporary option to invoke the legacy SymPy test runner instead of `pytest.main`. Will be removed in the near future. verbose : bool, default is False Sets the verbosity of the pytest output. Using `True` will add the `--verbose` option to the pytest call. tb : str, 'auto', 'long', 'short', 'line', 'native', or 'no' Sets the traceback print mode of pytest using the `--tb` option. kw : str Only run tests which match the given substring expression. An expression is a Python evaluatable expression where all names are substring-matched against test names and their parent classes. Example: -k 'test_method or test_other' matches all test functions and classes whose name contains 'test_method' or 'test_other', while -k 'not test_method' matches those that don't contain 'test_method' in their names. -k 'not test_method and not test_other' will eliminate the matches. Additionally keywords are matched to classes and functions containing extra names in their 'extra_keyword_matches' set, as well as functions which have names assigned directly to them. The matching is case-insensitive. pdb : bool, default is False Start the interactive Python debugger on errors or `KeyboardInterrupt`. colors : bool, default is True Color terminal output. force_colors : bool, default is False Legacy option, is ignored. sort : bool, default is True Run the tests in sorted order. pytest uses a sorted test order by default. Requires pytest-randomly. seed : int Seed to use for random number generation. Requires pytest-randomly. timeout : int, default is 0 Timeout in seconds before dumping the stacks. 0 means no timeout. Requires pytest-timeout. fail_on_timeout : bool, default is False Legacy option, is currently ignored. slow : bool, default is False Run the subset of tests marked as `slow`. enhance_asserts : bool, default is False Legacy option, is currently ignored. split : string in form `/` or None, default is None Used to split the tests up. As an example, if `split='2/3' is used then only the middle third of tests are run. Requires pytest-split. time_balance : bool, default is True Legacy option, is currently ignored. blacklist : iterable of test paths as strings, default is BLACKLIST_DEFAULT Blacklisted test paths are ignored using the `--ignore` option. Paths may be partial or absolute. If partial then they are matched against all paths in the pytest tests path. parallel : bool, default is False Parallelize the test running using pytest-xdist. If `True` then pytest will automatically detect the number of CPU cores available and use them all. Requires pytest-xdist. store_durations : bool, False Store test durations into the file `.test_durations`. The is used by `pytest-split` to help determine more even splits when more than one test group is being used. Requires pytest-split. Úuse_sympy_runnerFÚparallelÚstore_durationsTÚslowNrr…Úverbosez --verboseÚtbz--tbÚpdbz--pdbÚcolorsz--colorÚnoÚseedz9`pytest-randomly` plugin required to control random seed.z--randomly-seedÚsortz--randomly-dont-reorganizez:`pytest-randomly` plugin required to randomize test order.Útimeoutz;`pytest-timeout` plugin required to apply timeout to tests.z --timeoutz-mzslow and not tooslowznot slow and not tooslowrkz6`pytest-split` plugin required to run tests as groups.zNsplit must be a string of the form a/b where a and b are positive nonzero intsz--groupz--splitszcannot have a group number z with only z splitsÚ blacklistz--ignorez8`pytest-xdist` plugin required to run tests in parallel.z-nÚautoz7`pytest-split` plugin required to store test durations.z--store-durationsrocss|]}t|ƒVqdSr#)r0)Ú.0ror r r Ú Ïs€ztest..r )ÚgetÚpopÚ test_sympyrr*r rr;rEr:r,ÚModuleNotFoundErrorr0r.Úintr-Ú split_patternÚmatchr‚ÚmapÚgroupsÚBLACKLIST_DEFAULTr„r/Útupler)r†r‡r<rÚpytest_plugin_managerrrr‘rr“rkržÚgroupÚsplitsr”rPr=Ú exit_coder r r rsŒ x               rcCst‚)zNInterface to run doctests via pytest compatible with SymPy's test runner. )ÚNotImplementedErrorr r r r ÚdoctestØsr¨) r r2Úimportlib.utilr%rFr5ÚrerÚtypingrrrr Ú ImportErrorÚ ExceptionrÚsympy.testing.runtestsrršr6rsr¡rÚcompilerÚ lru_cacher9r0r;rr„r¨r r r r ÚsJ   û  þ  ÿ þý ü{ V