o h9@s dZddlmZddlZddlmZddlmZddlmZddlmZddlm Z ddl Z ddl Z ddl Z ddlZddlZddlZdd lmZddlZdd lmZdd lmZdd lmZdd lmZddlZddlZddlmZddlZddlmZddlm Z ddlm!Z!ddlm"Z"ddlm#Z#ddlm$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl+m-Z-ddl+m.Z.ddl+m/Z/ddl+m0Z0ddl1m2Z2ddl1m3Z3ddl4m5Z5dd l4m6Z6dd!l7m8Z8erdd"l9m:Z:dd#l;mdmd3d4Z?dnd5d6Z@dod:d;ZAdpddd?d:d@d<|jdAddBd:dCd<|jdDdd:dEdFdG|jdHdIgdJdKdLdM|jdNdOdPgdQdR|jdSdTdPgdR|jdUdVdWdXdR|jdYdWd:dZd[|d\d]}|jd^d_d`tdadbdc|jddd dedfdg|jdhdidt d4djdkdS)lNgeneralzRunning and selection optionsz-xz --exitfirst store_constmaxfailz,Exit instantly on first error or failed test)actiondestconsthelpz --maxfailnumstorerz'Exit after first num failures or errors)metavarr,typer-defaultr/z--strict-config store_truezbAny warnings encountered while parsing the `pytest` section of the configuration file raise errors)r,r/z--strict-markerszVMarkers not registered in the `markers` section of the configuration file raise errorsz--strictz&(Deprecated) alias to --strict-markerszpytest-warningsz-Wz--pythonwarningsappendz.is_ancestor)rfrrgrr&rR)argparseArgumentTypeErrorrcwdabsoluteresolve)r;msgrircrcrdras    raconfigrdoit2Callable[[Config, Session], int | ExitCode | None]int | ExitCodecCst|}tj|_d}zz|d}|jj|dd}|||p#d|_Wnty2tj |_t y>tj |_Ynt t jfytjj}tj}t|jt jrt|jjdura|jj}|dkrttj|jd|jjd|jj|d||_YnTtytj|_tjj}z |||j Wn+t jy}z|jdur|j|_tjt!|j"d|dWYd}~nd}~wwt|jt#rtjd YnwWd}t$%|j&|dkrz |jj'||jd Wn-t jy}z|jdur|j|_tjt!|j"d|dWYd}~nd}~ww|(|jSd}t$%|j&|dkrhz |jj'||jd Wn-t jyg}z|jdurN|j|_tjt!|j"d|dWYd}~nd}~ww|(w) zSkeleton command line program.rr+sessionNz:  )excinfoz(mainloop: caught unexpected SystemExit! )ru exitstatus))Session from_configrOKry _do_configurehookpytest_sessionstartr USAGE_ERRORFailed TESTS_FAILEDKeyboardInterruptr Exception_pytest_code ExceptionInfo from_current INTERRUPTED isinstancevalue returncodesysstderrwritetypenameropytest_keyboard_interrupt BaseExceptionINTERNAL_ERRORnotify_exceptionoptionr3__name__ SystemExitoschdir startpathpytest_sessionfinish_ensure_unconfigure)rprqru initstaterxryexcrcrcrd wrap_sessions          *      *    * rcCs t|tSN)r_mainrprcrcrdpytest_cmdline_mainOs rrurzint | ExitCode | NonecCs<|jj|d|jj|d|jrtjS|jdkrtjSdS)z[Default command line protocol for initialization, session, running tests and reporting.rtrN)r~pytest_collectionpytest_runtestloop testsfailedrrtestscollectedNO_TESTS_COLLECTED)rprurcrcrdrSs rcCs |dSr)perform_collectrtrcrcrdr`s rrRcCs|jr|jjjs||jd|jdkrdndd|jjjr"dSt|jD]1\}}|dt|jkr;|j|dnd}|jj j ||d|j rO| |j |j rX||j q'dS)Nz errorr+sz during collectionT)itemnextitem)rrprrC Interrupted collectonly enumerateitemslenr~pytest_runtest_protocol shouldfailr shouldstop)ruirrrcrcrdrds $  rrcCs6z|dp|ddWStyYdSw)aAttempt to detect if ``path`` is the root of a Virtual Environment by checking for the existence of the pyvenv.cfg file. [https://peps.python.org/pep-0405/] For regression protection we also check for conda environments that do not include pyenv.cfg yet -- https://github.com/conda/conda/issues/13337 is the conda issue tracking adding pyenv.cfg. Checking for the `conda-meta/history` file per https://github.com/pytest-dev/pytest/issues/12652#issuecomment-2246336902. z pyvenv.cfgz conda-metahistoryF)joinpathis_fileOSErrorr;rcrcrd_in_venvws  rcollection_path bool | NonecsjdkrdS|jdjd}|pg}|d}|r$|dd|D|vr*dS|jdjd}|p5g}|d }|rG|d d|Dtfd d|DrTdS|d }|satradSrw|d }tfdd|DrwdSdS)N __pycache__Tcollect_ignorerignorecs|]}t|VqdSrr.0xrcrcrd z(pytest_ignore_collect..collect_ignore_glob ignore_globcsrrrrrcrcrdrrc3s$|] }ttt|VqdSr)fnmatchr`)rglobrrcrdrs"rBrHc3s|]}t|VqdSrr)rpatrrcrdrs) name_getconftest_pathlistparent getoptionextendanyris_dirgetini)rrp ignore_paths excludeopt ignore_globsexcludeglobopt allow_in_venvnorecursepatternsrcrrdpytest_ignore_collects8      rrnodes.Collectornodes.Collector | NonecCstj||dS)Nr)Dir from_parentr;rrcrcrdpytest_collect_directorysrrlist[nodes.Item]cCstt|dpg}|s dSg}g}|D]}|j|r!||q||q|r8|jj|d||dd<dSdS)Ndeselect)r)tuplernodeid startswithr6r~pytest_deselected)rrpdeselect_prefixes remaining deselectedcolitemrcrcrdpytest_collection_modifyitemss   rc@s eZdZdddZdd d ZdS) FSHookProxypmr remove_modsAbstractSet[object]r&r'cCs||_||_dSr)rr)selfrrrcrcrd__init__s zFSHookProxy.__init__rr`pluggy.HookCallercCs |jj||jd}||j|<|S)N)remove_plugins)rsubset_hook_callerr__dict__)rrrrcrcrd __getattr__s zFSHookProxy.__getattr__N)rrrrr&r')rr`r&r)r __module__ __qualname__rrrcrcrcrdrs rc@seZdZdZdZdS)rz*Signals that the test run was interrupted.builtinsNrrr__doc__rcrcrcrdrsrc@seZdZdZdS)rz"Signals a stop as failed test run.Nrrcrcrcrdrsrc@s$eZdZUdZded<d ddZdS) _bestrelpath_cacherrr;r&r`cCst|j|}|||<|Sr)rr;)rr;rrcrcrd __missing__s z_bestrelpath_cache.__missing__N)r;rr&r`)rrr __slots____annotations__rrcrcrcrdrs rcs0eZdZdZed fdd Zdd d ZZS)raCollector of files in a file system directory. .. versionadded:: 8.0 .. note:: Python directories with an `__init__.py` file are instead collected by :class:`~pytest.Package` by default. Both are :class:`~pytest.Directory` collectors. rrr;rr&r#cstj||dS)zThe public constructor. :param parent: The parent collector of this Dir. :param path: The directory's path. :type path: pathlib.Path )rr;)superr)clsrr; __class__rcrdrs zDir.from_parent&Iterable[nodes.Item | nodes.Collector]ccs|j}|j}t|jD]M}|r6t|j}|jj|dds'|j||dr'q |j ||d}|dur5|Vq | rYt|j}|j|sM|j||drMq |j ||d}|EdHq dS)NT with_parents)rrpr file_pathr) rpihookrr;rrru isinitpathrrrpytest_collect_file)rrpr direntryr;colcolsrcrcrdr9 s,    z Dir.collect)rrr;rr&r#)r&r)rrrr classmethodrr9 __classcell__rcrcrrdrs  rcsTeZdZUdZeZeZded<ded<ded<dTfd d ZedUddZ dVddZ e dWddZ e j dXddZ e dWddZej dXddZe dYddZdZdd Zed!d"d[d#d$Zed!d"d\d'd(ZeZd)d*d]d/d0Zd^d4d5Zd_d9d:Ze ;d`dadAdBZe ;d`dbdDdBZ !dcdbdFdBZ !dddedKdLZdfdNdOZdgdRdSZZS)hrzzoThe root of the collection tree. ``Session`` collects the initial paths given as arguments to pytest. r! _setupstater$_fixturemanagerrsryrprr&r'c stjd|jdd||ddd|_d|_d|_d|_|jj d|_t |_ t |_ g|_ g|_i|_g|_t|j|_|jjj|dddS)Nr)rr;fspathrrprurrFr:ru)r)rrrootpathrr _shouldstop _shouldfailtracerootget frozenset _initialpaths_initialpaths_with_parents _notfound_initial_parts_collection_cacherr_bestrelpathcacherp pluginmanagerregister)rrprrcrdr2s,  zSession.__init__cCs|j|d}|S)Nr)_create)rrprurcrcrdr{Ls zSession.from_configr`c Cs4d|jjd|jd|jd|jd t|ddS)N< z exitstatus=%r testsfailed=z testscollected=>ryz)rrrrrgetattrrrcrcrd__repr__Qs zSession.__repr__ bool | strcC|jSr)rr,rcrcrdrYzSession.shouldstoprcC.|dur|jrtjtddddS||_dS)NFzCsession.shouldstop cannot be unset after it has been set; ignoring.rv stacklevel)rwarningswarnr"rrrcrcrdr] cCr/r)rr,rcrcrdrkr0zSession.shouldfailcCr1)NFzCsession.shouldfail cannot be unset after it has been set; ignoring.rvr2)rr4r5r"r6rcrcrdror7rcCs |jjjS)zQThe path from which pytest was invoked. .. versionadded:: 7.0.0 )rpinvocation_paramsr>r,rcrcrdr}s zSession.startpath node_pathcCs |j|Sr)r$)rr9rcrcrd_node_location_to_relpaths z!Session._node_location_to_relpathT)tryfirstcCs(|jr ||j|jr||jdSr)rrrrr,rcrcrdpytest_collectstarts   zSession.pytest_collectstartreportTestReport | CollectReportcCs\|jr&t|ds(|jd7_|jd}|r*|j|kr,d|jd|_dSdSdSdSdS)Nwasxfailr+r*zstopping after z failures)failedhasattrrrpgetvaluer)rr=r*rcrcrdpytest_runtest_logreports z Session.pytest_runtest_logreportFr r;str | os.PathLike[str]r rRcCs.t|tr|nt|}|r||jvS||jvS)a>Is path an initial path? An initial path is a path explicitly given to pytest on the command line. :param with_parents: If set, also return True if the path is a parent of an initial path. .. versionchanged:: 8.0 Added the ``with_parents`` parameter. )rrr r)rr;r path_rcrcrdrs  zSession.isinitpathros.PathLike[str]pluggy.HookRelaycCsVt|tr|nt|}|jj}||}|j|}|r%tt||}|S|jj }|Sr) rrrpr%_getconftestmodules_conftest_plugins differencerrr~)rrr;rmy_conftestmodulesrproxyrcrcrd gethookproxys  zSession.gethookproxy path_cache%dict[Path, Sequence[nodes.Collector]]Sequence[nodes.Collector]cCsx||vr||S|r#||j}|j||d}|dur |fnd}n|r4||}|j||d}nd}|||<|S)zCreate a Collector for the given path. `path_cache` makes it so the same Collectors are returned for the same path. rNrcr )rrMrrrr)rr;rNr rrrcrcrd _collect_paths   zSession._collect_path.rISequence[str] | Nonegenitems Literal[True]Sequence[nodes.Item]cCdSrrcrrIrSrcrcrdrzSession.perform_collect&Sequence[nodes.Item | nodes.Collector]cCrVrrcrWrcrcrdrrXNc Cs|dur|jj}|d|||jjjd7_|jj}g|_g|_i|_g|_ |j }zg}g}|D](}t |jj j ||jj jd}|j|||j||j||jjq2t||_t||_t|} |jj| d|jjjd8_|jrg} |jD]\}} | r| d|d| dq| d |qt| |s| j}n| jr| jD] } |j || q|jj|j||j|d Wg|_g|_i|_|j |d ng|_g|_i|_|j |d w|rt!||_"|S) aPerform the collection phase for this session. This is called by the default :hook:`pytest_collection` hook implementation; see the documentation of this hook for more details. For testing purposes, it may also be called directly on a fresh ``Session``. This function normally recursively expands any collectors collected from the session to their items, and only items are returned. For testing purposes, this may be suppressed by passing ``genitems=False``, in which case the return value contains these collectors unexpanded, and ``session.items`` is empty. Nrr+ as_pypathr=z not found: z (no match in any of )zfound no collectors for )rurprrt)#rprIrrindentr~r!r"r#rresolve_collection_argumentr8r>rpyargsr6r;rrhrrr r r pytest_collectreportrresultpassedrSr% check_pendingrpytest_collection_finishrr) rrIrSr~r initialpathsinitialpaths_with_parentsargcollection_argumentreperrors collectorsnodercrcrdrsr        rmr handle_dupestuple[CollectReport, bool]cCs:||jvr|r|j|}|dfSt|}||j|<|dfS)NTF)r#r )rrmrnrjrcrcrd_collect_one_node>s   zSession._collect_one_node&Iterator[nodes.Item | nodes.Collector]ccsi}|jj}|jD]`}|d||jjjd7_|j}|j}|j}| r4|r4Jd||f|g}|durO|j D]}| |sGn| d|q>n&| d} t|j dD]\} }| t| ksl|j| | krnn| d|qZd} g} |g||fg} | rL| \}}|s|Vd} qt|tjsqt|trt|dtsJ||d|}n/t|dkot|dto|d }|||\}}|s|js|jj|d |jsq|j}d}t|D][}t|dtr|j|dk}tj d kr|st!j"|j|d}|ot!j#|jt!j#|dk}n|j$|dkp0|j$ d d|dk}|rA| %||ddfd}q|sJ| %|| s| sbd &t'|g|R}|j(%|| f|jjjd8_q dS) Nzprocessing argumentr+z invalid arg r.rvFTr\win32[::))rpr%r"rrr^r;parts module_namerrh_is_in_confcutdirinsertsplitrrstempoprr CollectorrzrrQrrprcr rarbreversedrplatformrsamefileislinkrr6joinr`r!)rrNrriargpathnamesrwpathsr;module_name_partsrany_matched_in_initial_partnotfound_collectorswork matchnode matchpartssubnodesrnrj duplicateany_matched_in_collectorrmis_match same_file report_argrcrcrdr9Ks                FzSession.collectnodes.Item | nodes.CollectorIterator[nodes.Item]ccs|d|t|tjr|jj|d|VdSt|tjs!J|jd}|o.t|tj  }| ||\}}|r>|s>dS|j rO|j D] }| |EdHqD|sZ|jj|ddSdS)NrS)rrAr\)rrr Itemr pytest_itemcollectedr}rprFilerprcrbrSra)rrmrArnrjrsubnodercrcrdrSs"     zSession.genitems)rprr&r')rprr&rz)r&r`)r&r.)rr.r&r')r&r)r9rr&r`)r&r')r=r>r&r')r;rDr rRr&rR)rrFr&rG)r;rrNrOr&rP)..)rIrRrSrTr&rU)rIrRrSrRr&rY)NT)T)rmrrnrRr&ro)r&rq)rmrr&r)rrrrrrrrrr{r-propertyrsetterrrr:rr<rCrarrMrQr rrpr9rSrrcrcrrdrz#sV              U yrw str | Nonec Csfztj|}Wn tttfyYdSw|dus$|jdus$|jdkr&dS|jr0tj |jS|jS)zaSearch sys.path for the given a dotted module name, and return its file system path if found.N namespace) rEutil find_specAttributeError ImportError ValueErrororiginsubmodule_search_locationsrr;dirname)rwspecrcrcrd search_pypathsrT)frozenc@s*eZdZUdZded<ded<ded<dS) CollectionArgumentzA resolved collection argument.rr;z Sequence[str]rvrrwN)rrrrrrcrcrcrdrs  rFrZinvocation_pathrhr[c Cst|d\}}}|d^}}|r|d|||d<d}|r/t|} | dur/|}| }||} t| } t| sI|r?dnd} t| j|d|r]| r]|rSdnd } t| j|dt | ||d S) aParse path arguments optionally containing selection parts and return (fspath, names). Command-line arguments can point to files and/or directories, and optionally contain parts for specific tests selection, for example: "pkg/tests/test_foo.py::TestClass::test_foo" This function ensures the path exists, and returns a resolved `CollectionArgument`: CollectionArgument( path=Path("/full/path/to/pkg/tests/test_foo.py"), parts=["TestClass", "test_foo"], module_name=None, ) When as_pypath is True, expects that the command-line argument actually contains module paths instead of file-system paths: "pkg.tests.test_foo::TestClass::test_foo" In which case we search sys.path for a matching module, and then return the *path* to the found module, which may look like this: CollectionArgument( path=Path("/home/u/myvenv/lib/site-packages/pkg/tests/test_foo.py"), parts=["TestClass", "test_foo"], module_name="pkg.tests.test_foo", ) If the path doesn't exist, raise UsageError. If the path is a directory and selection parts are present, raise UsageError. rtruNz9module or package not found: {arg} (missing __init__.py?)z"file or directory not found: {arg})rhz9package argument cannot contain :: selection parts: {arg}z;directory argument cannot contain :: selection parts: {arg})r;rvrw) r` partitionrzrrrrformatrr) rrhr[rfsquacketreststrpathrvrw pyarg_strpathrrorcrcrdr_s:# r_)r%rr&r')r;r`r&r`)rprrqrrr&rs)rprr&rs)rprrurzr&r)rurzr&r')rurzr&rR)r;rr&rR)rrrprr&r)r;rrrr&r)rrrprr&r')rwr`r&r)rrrhr`r[rRr&r)Xr __future__rrjcollections.abcrrrrr AbstractSet dataclassesrr^rEimportlib.utilrpathlibrrtypingr r r r r4pluggyrr _pytest._code_pytest.configrrrrrr_pytest.config.argparsingr_pytest.config.compatr_pytest.outcomesr_pytest.pathlibrrrrr_pytest.reportsrr_pytest.runnerr r!_pytest.warning_typesr"typing_extensionsr#_pytest.fixturesr$rerarrrrrrrrrrrrrr dataclassdictr`r Directoryrr}rzrrr_rcrcrcrds                                   D  ;     &  3 7