o Zh[ @s<dZddlZddlZddlZddlZddlZddlmZddl Z ddl Z ddl Z ddl Z ddlmZddlZddlZddlZddlmZddlZddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlm Z ddlm!Z!ddlm"Z"ddlm#Z#ddlm$Z$ddlm%Z%ddlm&Z&ddlm'Z'ddlm(Z(ddlm)Z)ddlm*Z*ddl+Z+ddl,Z,ddl,m-Z-ddl,m.Z.ddl,m/Z/ddl,m0Z0ddl,m1Z1dd l2m3Z3dd!l4m5Z5dd"l4m6Z6dd#l7m8Z8ddl9Z:dd$l9m;Z;dd%l9mZ>ddl?Z:ddl@Z:dd'lAmBZBdd(lAmCZCdd)lDmEZEdd*lDmFZFdd+lDmGZGdd,lDmHZHdd-lDmIZIdd.lDmJZJdd/lKmLZLdd0lMmNZNdd1lMmOZOe)rydd2lPmQZQdd3lPmRZRdd4lSmTZTdd5lUmVZVeWZX e-d6ZYe/d6ZZeGd7d8d8ej[Z\Gd9d:d:e]Z^d;e:j_j`dZb  dd?e#e*e"ecd@fdAe#e$e*eceXfdfddZ|decdr ExceptionrKstrrPrCrCrCrDrEss  rEentryrHcCst|odt|jtjvS)zFilter tracebacks entries which point to pytest internals or importlib. Make a special case for importlib because we use it to import test modules and conftest files in _pytest.pathlib.import_path. importlib)r$rRrFsplitossep)rSrCrCrD,filter_traceback_for_conftest_import_failuresrXargszos.PathLike[str]pluginsc Cshzzt||}WnVty^}zJt|j}ttj}|jd|j ddd|j t |_ |j r8|j dddn|}t|}|D] }|j|ddqDtjWYd}~WSd}~wwz$|jj|d } z t| WW|WSty| YW|WSw|wty}zttj}|jD] } |jd | d ddqtjWYd}~Sd}~ww) aLPerform an in-process test run. :param args: List of command line arguments. If `None` or not given, defaults to reading arguments directly from the process command line (:data:`sys.argv`). :param plugins: List of plugin objects to be auto-registered during initialization. :returns: An exit code. z$ImportError while loading conftest 'z'.T)redZshortF)stylechainNconfigzERROR:  )_prepareconfigrEr#from_exceptionrGr%sysstderrlinerF tracebackfilterrXgetreprZexconlyrR splitlinesrstripr7rBhookZpytest_cmdline_main_ensure_unconfigure ValueErrorr!rY) rYrZr_eexc_infotwZexc_reprZ formatted_tbreretmsgrCrCrDmainsN           rscCsNz t}tj|WSty&ttjtj}t |tj YdSw)zoThe CLI entry point of pytest. This function is not meant for programmable use; use `main()` instead. r) rsrcstdoutflushBrokenPipeErrorrVopendevnullO_WRONLYdup2fileno)coderxrCrCrD console_mains  r}c@seZdZeeZdS)cmdlineN)r<r=r> staticmethodrsrCrCrCrDr~ r~rFoptnamecCs"tj|rt|d||S)ztArgparse type validator for filename arguments. :path: Path of filename. :optname: Name of the option. z must be a filename, given: rVrFisdirr!rFrrCrCrD filename_arg rcCs"tj|st|d||S)zvArgparse type validator for directory arguments. :path: Path of directory. :optname: Name of the option. z must be a directory, given: rrrCrCrD directory_argrr)markrsrunnerZfixturesZ helpconfigpythonZterminalZ debuggingZunittestcaptureZskippingZ legacypathZtmpdirZ monkeypatchZrecwarnZpastebin assertionZjunitxmldoctest cacheproviderZfreeze_supportZ setuponlyZ setupplanstepwisewarningsloggingZreportsZ python_pathZunraisableexceptionZthreadexception faulthandlerZpytesterZpytester_assertionsConfigcCsTt}t|tj|p d|tdd}|dur|j|ddtD]}||q |S)NrCrYrZdirinvocation_paramsT exclude_only)PytestPluginManagerrInvocationParamsrcwdconsider_preparsedefault_plugins import_plugin)rYrZ pluginmanagerr_specrCrCrD get_configs  rrcCstjS)zObtain a new instance of the :py:class:`pytest.PytestPluginManager`, with default plugins already loaded. This function can be used by integration with other tools, like hooking into pytest to run tests into an IDE. )rrrCrCrCrDget_plugin_manager/srcCs|dur tjdd}nt|tjrt|g}nt|ts*d}t||t |t ||}|j }z"|rJ|D]}t|t rD| |q7||q7|jj||d}|WSty`|w)NrzG`args` parameter expected to be a list of strings, got: {!r} (type: {}))rrY)rcargv isinstancerVPathLikefspathlist TypeErrorformatrNrrrRconsider_pluginargregisterrkpytest_cmdline_parse BaseExceptionrl)rYrZrrr_rpluginrCrCrDra:s0       racCs|r|jS|S)zjsz)_get_legacy_hook_marks..Z pytestmark=Tz=TrueF, )rNfullname hook_opts)rinspect isroutinegetattrAttributeErrorappendjoin_pytest deprecatedZHOOK_LEGACY_MARKINGrr>r0rr) rrrZ known_marksZ must_warnoptsZopt_nameZopt_attrrmessagerCrCrD_get_legacy_hook_marksbs.     rcsjeZdZdZdIfdd Zdededeeffdd Z dedee ffd d Z dJdedeedeeffd d Z defddZ dedefddZdKddZdeeeefdedededeededeeefdeddfddZd edefd!d"Zd#edeeefdededdf d$d%Zd edeeefdededdf d&d'Zd edeejfd(d)Zded edeejeffd*d+Zd,edeeefdededejf d-d.Zd/ejd,eddfd0d1Z d2d3deed4eddfd5d6Z!d7eddfd8d9Z"d:ejd;eddfdd?Z$d/ejddfd@dAZ%dBedejeeefddfdCdDZ&dLdEedFeddfdGdHZ'Z(S)Mra;A :py:class:`pluggy.PluginManager ` with additional pytest-specific functionality: * Loading plugins from the command line, ``PYTEST_PLUGINS`` env variable and ``pytest_plugins`` global variables found in plugins being loaded. * ``conftest.py`` loading during start-up. rHNcsddl}tdt|_i|_d|_d|_tdt |_ g|_ | |j | |tjdratj}t|dd}ztt||jd|d }Wn tyTYnw|jj|j||j|_ d|_!dS) Nrr6FZ PYTEST_DEBUGencodingutf8r)mode bufferingr)"_pytest.assertionsuperrKset_conftest_plugins_dirpath2confmods _confcutdir _noconftestrrskipped_pluginsZ add_hookspecshookspecrrVenvirongetrcrdrrwdupr{rrQtracerootZ setwriterwriteZenable_tracingrZDummyRewriteHook rewrite_hook _configured)rJrerrr __class__rCrDrKs6         zPytestPluginManager.__init__rrcsX|dsdS|dkr dSt||}|dur|St||}t|s&dSt|ddS):meta private:pytest_Npytest_pluginsimpl)ZtryfirsttrylastZ optionalhookZ hookwrapper) startswithrparse_hookimpl_optsrrrr)rJrrrrrrCrDrs   z'PytestPluginManager.parse_hookimpl_optscs:t||}|durt||}|drt|dd}|S)rNrr)Z firstresultZhistoric)rparse_hookspec_optsrrr)rJZmodule_or_classrrrrrCrDrs  z'PytestPluginManager.parse_hookspec_optsc sv|tjjvrttd|dddSt ||}|dur9|j j j t |||ddt|tjr9|||S)NzQ{} plugin has been merged into the core, please remove it from your requirements._-)r plugin_namemanagerkwargs)rrZDEPRECATED_EXTERNAL_PLUGINSrwarnr/rreplacerrrkZpytest_plugin_registered call_historicdictrtypes ModuleTypeconsider_module)rJrrrrrCrDrs,    zPytestPluginManager.registercCs||}|SrI) get_plugin)rJrrrCrCrD getplugins zPytestPluginManager.getplugincCst||S)z:Return whether a plugin with the given name is registered.)boolr)rJrrCrCrD haspluginzPytestPluginManager.haspluginr_rcCs"|dd|ddd|_dS)rmarkersztryfirst: mark a hook implementation function such that the plugin machinery will try to call it first/as early as possible. DEPRECATED, use @pytest.hookimpl(tryfirst=True) instead.ztrylast: mark a hook implementation function such that the plugin machinery will try to call it last/as late as possible. DEPRECATED, use @pytest.hookimpl(trylast=True) instead.TN)addinivalue_liner)rJr_rCrCrDpytest_configure s z$PytestPluginManager.pytest_configurerYpyargs noconftestrootpath confcutdirinvocation_dir importmodeconsider_namespace_packagescCs|rt||nd|_||_||_d} |D]*} t| } | d} | dkr*| d| } t|| } t| r?|j| |||dd} q| sM|j||||ddSdS)a`Load initial conftest files given a preparsed "namespace". As conftest files may add their own command line options which have arguments ('--my-opt somepath') we might get some false positives. All builtin and 3rd party plugins will have been loaded, however, so common options will not confuse our logic here. NFz::rT)r(rr _using_pyargsrRfindr-_try_load_conftest)rJrYrrrrrrrZ foundanchorZ intitial_pathrFianchorrCrCrD_set_initial_conftestss8    z*PytestPluginManager._set_initial_conftestsrFcCs|jdurdS||jjvS)z:Whether to consider the given path to load conftests from.NT)rparents)rJrFrCrCrD_is_in_confcutdirRs  z%PytestPluginManager._is_in_confcutdirr cCsL|j||||d|r"|dD]}|r!|j||||dqdSdS)Nrztest*)_loadconftestmodulesis_dirglob)rJr rrrxrCrCrDr as$z&PytestPluginManager._try_load_conftestc Cs|jrdS||}||jvrdSg}t|g|jRD]}||r9|d}|r9|j||||d} || q||j|<dS)Nz conftest.pyr) rrrreversedrrr_importconftestr) rJrFrrr directoryZclistr conftestpathmodrCrCrDrzs&    z(PytestPluginManager._loadconftestmodulescCs||}|j|dS)NrC)rrr)rJrFrrCrCrD_getconftestmoduless z'PytestPluginManager._getconftestmodulesc CsF||}t|D]}z |t||fWStyYq wt|rI)rrrrKeyError)rJrrFmodulesrrCrCrD_rget_with_confmods   z&PytestPluginManager._rget_with_confmodrc CsBt|}||}|durttj|St|}|dur,ztj|j=Wn t y+Ynwz t ||||d}Wnt yP} z| j dusEJt || d| d} ~ ww||||j||j} | |jvr|jD]%\} } | | jvsw| | kr|| vrtd|d|d|jd| |qj|d||j||d|S) N)rrr)rGz#While trying to load conftest path z, found that the module z is already loaded with path zE. This is not supposed to happen. Please report this issue to pytest.zloading conftestmodule )registration_name)rRrrrrr,rcrstemrr*rQ __traceback__rE_check_non_top_pytest_pluginsraddrritemsrAssertionError__file__rrconsider_conftest) rJrrrrZconftestpath_plugin_nameexistingpkgpathrrndirpathrFmodsrCrCrDrsT        z#PytestPluginManager._importconftestrcCs@t|dr|jr|jsd}t|||jdddSdSdSdS)NrafDefining 'pytest_plugins' in a non-top-level conftest is no longer supported: It affects the entire test suite instead of just below the conftest as expected. {} Please move it to a top level conftest file at the rootdir: {} For more information, visit: https://docs.pytest.org/en/stable/deprecations.html#pytest-plugins-in-non-top-level-conftest-filesF)Zpytrace)hasattrrr r&rr)rJrrrrrCrCrDr!s z1PytestPluginManager._check_non_top_pytest_pluginsFrrcCsd}t|}||krU||}|d7}t|trO|dkr1z||}Wn ty+YdSw|d7}n |dr=|dd}nq|}|rJ|dsJq||||ks dSdS)rrrz-pNr8no:)lenrrR IndexErrorrstripr)rJrYrr noptZpargrCrCrDrs*      z%PytestPluginManager.consider_preparseargcCs|dr8|dd}|tvrtd||dkr#|d|d|||ds6|d|dSdS|}|||dsK|d||j|d d dS) rr,r9Nzplugin %s cannot be disabledrrZpytest_stepwiserT)consider_entry_points)ressential_pluginsr!Z set_blockedZunblockr)rJr2rrCrCrDrs         z&PytestPluginManager.consider_pluginargconftestmodulercCs|j||ddS)rrN)r)rJr5rrCrCrDr&*sz%PytestPluginManager.consider_conftestcCs|tjddS)rZPYTEST_PLUGINSN)_import_plugin_specsrVrrrOrCrCrD consider_env0z PytestPluginManager.consider_envcCs|t|dgdS)rrN)r6r)rJrrCrCrDr4r8z#PytestPluginManager.consider_modulercCs t|}|D]}||qdSrI)_get_plugin_specs_as_listr)rJrrZZ import_specrCrCrDr68s z(PytestPluginManager._import_plugin_specsmodnamer3c Cs t|ts Jd|||s||durdS|tvr!d|n|}|j||r6|jd|d}|r6dSzt|Wn;t yZ}zt d|d|j d |j |d}~wt yw}z|j||jpid fWYd}~dSd}~wwtj|}|||dS) zImport a plugin with ``modname``. If ``consider_entry_points`` is True, entry point names are also considered to find a plugin. z$module name as text required, got %rNz_pytest.pytest11rzError importing plugin "z": r)rrR is_blockedrbuiltin_pluginsr mark_rewriteload_setuptools_entrypoints __import__ ImportErrorrYwith_tracebackr r'rrrrrcrr)rJr:r3Z importspecZloadedrnrrCrCrDr?s4    $ z!PytestPluginManager.import_pluginrHNrI)r_rrHN)F))r<r=r>r?rK _PluggyPluginrRrrrrrrrrrrrrrr+rrr rrrrrrrrr!rrr&r7rr6r __classcell__rCrCrrDrs3    3          5    specscCsZ|durgSt|tjrgSt|tr|r|dSgSt|tjjr't|St d|)z:Parse a plugins specification into a list of plugin names.N,zYPlugins may be specified as a sequence or a ','-separated string of plugin names. Got: %r) rrrrRrU collectionsabcrrr!)rGrCrCrDr9es  r9c@seZdZddZdS)NotsetcCsdS)NzrCrOrCrCrD__repr__|szNotset.__repr__N)r<r=r>rLrCrCrCrDrK{rrK package_filesc cst|}d}|D]=}d|vo|d}|ddko|d}|r9tj|\}}|dkr8|ds8d}|Vq |rFtj|}d}|Vq |spg}|D]}|d} d | dd } | rd| | qM|rrt |Ed Hd Sd Sd S) aMGiven an iterable of file names in a source distribution, return the "names" that should be marked for assertion rewrite. For example the package "pytest_mock/__init__.py" should be added as "pytest_mock" in the assertion rewrite mechanism. This function has to deal with dist-info based distributions and egg based distributions (which are still very much in use for "editable" installs). Here are the file names as seen in a dist-info based distribution: pytest_mock/__init__.py pytest_mock/_version.py pytest_mock/plugin.py pytest_mock.egg-info/PKG-INFO Here are the file names as seen in an egg based distribution: src/pytest_mock/__init__.py src/pytest_mock/_version.py src/pytest_mock/plugin.py src/pytest_mock.egg-info/PKG-INFO LICENSE setup.py We have to take in account those two distribution flavors in order to determine which names should be considered for assertion rewriting. More information: https://github.com/pytest-dev/pytest-mock/issues/167 F/z.pyrz __init__.pysetupZ __editable__TN) rendswithcountrVrFsplitextrdirnamerUrr_iter_rewritable_modules) rMZ seen_somefnZis_simple_module is_package module_namer package_nameZnew_package_filespartsZnew_fnrCrCrDrTs:     rTc@seZdZUdZeejddGdddZGdddej Z dd d e d e ed dfd dZ ed efddZed e efddZdegdfd dfddZdddZdddZd efddZd e deed dfddZ ddeed e ejd dfd!d"Zd#ed efd$d%Z e!dd&d'Z"dd*d+Z#e$dd,dd.d/Z%de&ed dfd0d1Z'de&ed dfd2d3Z(dd4d5Z)deed6ed eefd7d8Z*deed9e+d:eed;edd?Z-ddeed@e+d dfdAdBZ.e$ddCd e/de0e0ffdDdEZ1ddFdGZ2ddHdIZ3ddJdKZ4dLed dfdMdNZ5d eefdOdPZ6ddeed@e+d dfdQdRZ7dSe8dTe9d dfdUdVZ:dWedXed dfdYdZZ;dWefd[d\ZdWefdadbZ?dWedced e eefdddeZ@dWed e efdfdgZAeBdhfdWedie+fdjdkZCddWefdldmZDddWefdndoZEdpZFeGeHdq<drZIeGeHds<dtZJeGeHdu<ddve ed e9fdwdxZKeLdved efdydzZMeLd{d|dved}ed dfd~dZNded dfddZOdddZPdS)raAccess to configuration values, pluginmanager and plugin hooks. :param PytestPluginManager pluginmanager: A pytest PluginManager. :param InvocationParams invocation_params: Object containing parameters regarding the :func:`pytest.main` invocation. T)frozenc@sveZdZUdZeedfed< eee ee fed< e ed< de edeee ee fde ddfdd Z dS) zConfig.InvocationParamsaHolds parameters passed during :func:`pytest.main`. The object attributes are read-only. .. versionadded:: 5.1 .. note:: Note that the environment variable ``PYTEST_ADDOPTS`` and the ``addopts`` ini option are handled by pytest, not being included in the ``args`` attribute. Plugins accessing ``InvocationParams`` must be aware of that. .rYrZrrHNcCs2t|dt|t|d|t|d|dS)NrYrZr)object __setattr__tuple)rJrYrZrrCrCrDrKsz Config.InvocationParams.__init__)r<r=r>r?rrR__annotations__rrrrErrrKrCrCrCrDrs" rc@s,eZdZdZeZeZeZeZ dS)zConfig.ArgsSourcezSIndicates the source of the test arguments. .. versionadded:: 7.2 N) r<r=r>r?enumautoARGSINVOCATION_DIRZINCOVATION_DIR TESTPATHSrCrCrCrD ArgsSources  rdNrrrrHcCsddlm}ddlm}|dur|jddtd}t|_ ||_ |}|d|d|d|j d d |_ ||_ t |_ |j|_|j jjd |_t|j j|_i|_d|_i|_g|_|j |d d |_|jjjt|j |j ddtjj |_!g|_"t#rddl$m%}d|_&dSdS)Nr) FILE_OR_DIRr2rCrz%(prog)s [options] [z] [z] [...]T)usageZ processoptZ _ispytestr_Z pytestconfigF)parserrrr)Cache)' argparsingrer3rrrargparse Namespaceoptionr _processopt_parserrr.stash_storerrrrrk _inicache _override_ini _opt2dest_cleanuprrZpytest_addoptionrrrrdra args_sourcerYrZ_pytest.cacheproviderrhcache)rJrrrer3_arhrCrCrDrKsL       zConfig.__init__cC|jS)znThe path to the :ref:`rootdir `. :type: pathlib.Path .. versionadded:: 6.1 ) _rootpathrOrCrCrDrCzConfig.rootpathcCrx)zThe path to the :ref:`configfile `. :type: Optional[pathlib.Path] .. versionadded:: 6.1 )_inipathrOrCrCrDinipathMrzzConfig.inipathfunccCs|j|dS)zxAdd a function to be called when the config object gets out of use (usually coinciding with pytest_unconfigure).N)rtr)rJr}rCrCrD add_cleanupWszConfig.add_cleanupcCs^|jrJd|_ttd|jjjt|ddWddS1s(wYdS)NTdefaultr^r)rrcatch_warnings simplefilterrkrrrrOrCrCrD _do_configure\s   "zConfig._do_configurecCsH|jrd|_|jj|dg|jj_|jr"|j}||jsdSdS)NFr^)rrkZpytest_unconfigurerZ _call_historyrtpop)rJZfinrCrCrDrlcs  zConfig._ensure_unconfigurecCs|jd}|dus J|jS)Nterminalreporter)rrZ_tw)rJrrCrCrDget_terminal_writerls  zConfig.get_terminal_writerrYcCsz||W|StyBt|jddsd|vr%ddlm}||t|jdds4d|vs4d|vrA|jt j d w) NversionFz --versionr) showversionhelpz--helpz-hz8 NOTE: displaying only minimal help due to UsageError. ) parser!rrlZ_pytest.helpconfigrrnZ _getparser print_helprcrtr)rJrrYrrCrCrDrss"    zConfig.pytest_cmdline_parseexcinforlcCs|r t|ddr d}nd}|jdt|dd|d}|jj||d}t|s %s ) rrhrkZpytest_internalerroranyrRrUrcrdrru)rJrrlr\rresrerCrCrDnotify_exceptions zConfig.notify_exceptionnodeidcCs*|jj|jkr|j|}t|jj|}|SrI)rrrr))rJrfullpathrCrCrDcwd_relative_nodeids zConfig.cwd_relative_nodeidcCsBt|}|jj||j|dd|jjD]}|j|q|S)z$Constructor usable for subprocesses.Faddopts)rrl__dict__updaterrZrr)clsZ option_dictrYr_rrCrCrD fromdictargss  zConfig.fromdictargsr1r1cCsT|j|jD]}|j|j|<qt|dr&t|j|js(t|j|j|jdSdSdS)Nr) _short_opts _long_optsdestrsr+rlsetattrr)rJr1rrCrCrDrms zConfig._processopt)r early_configc Csj|j|jj|jj|d|jj|jdd\}}|jj ||jj|jj |j|jj |jj|jj |dddS)N testpathsFrYrrrrrr)rYrrrrrrr) _decide_argsknown_args_namespace file_or_dirrgetinirrrrrrrr)rJrrYrurCrCrDpytest_load_initial_conftestss(  z$Config.pytest_load_initial_conftestscCs|jj|t|jd\}}t|j|j||jpd|jj d\}}}||_ ||_ ||_ t |j|jjd<t |j|jjd<|jddd|jdd |jjd d dgd |jpZd |_dS)N namespace)inifilerYZrootdir_cmd_argrrootdirrrzExtra command line optionsrY minversionz!Minimally required pytest versionrequired_pluginsz.Plugins that must be present for pytest to run)rNrrC)rnparse_known_and_unknown_argscopyrlr"Z inifilenamerrrrryr{inicfgrRrZ extra_infor|addiniZ override_inirr)rJrYns unknown_argsrr|rrCrCrD_initinis.   zConfig._initinicCsl|j|\}}t|dd}|dkr/ddl}z|j|}Wn ty)d}Ynw||||dS)zInstall the PEP 302 import hook if using assertion rewriting. Needs to parse the --assert= option from the commandline and find all the installed plugins to mark them for rewriting by the importhook. Z assertmodeplainZrewriterN) rnrrrrZinstall_importhook SystemError_mark_plugins_for_rewrite_warn_about_missing_assertion)rJrYrrrrrkrCrCrD_consider_importhooks   zConfig._consider_importhookcCsH||j_tjdr dSddtjD}t|D]}| |qdS)zGiven an importhook, mark for rewrite any top-level modules or packages in the distribution package for all pytest plugins.PYTEST_DISABLE_PLUGIN_AUTOLOADNcss<|]}tdd|jDr|jpgD]}t|VqqdS)css|]}|jdkVqdS)r;N)group)reprCrCrD sz=Config._mark_plugins_for_rewrite...N)r entry_pointsfilesrR)rdistfilerCrCrDr s z3Config._mark_plugins_for_rewrite..) rrrVrrrTmetadata distributionsrTr?)rJrkrMrrCrCrDrs   z Config._mark_plugins_for_rewriteviacCs6||j_z|jj|t|jdW|j`|S|j`w)zValidate known args.r)rnZ_config_source_hintrrrl)rJrYrrCrCrD_validate_argss zConfig._validate_argsrrrrrc Cs|r tjj}|}||fS||kr>tjj}|r|}n'g}|D]} |ttj| ddq|r=|s=|r=d} |jt | ddng}|sKtjj }t |g}||fS)zDecide the args (initial paths/nodeids) to use given the relevant inputs. :param warn: Whether can issue warnings. :returns: The args and the args source. Guaranteed to be non-empty. T) recursivezNo files were found in testpaths; consider removing or adjusting your testpaths configuration. Searching recursively from the current directory instead.r9 stacklevel) rrdrarcextendsortedriglobissue_config_time_warningr/rbrR) rJrYrrrrrsourceresultrF warning_textrCrCrDrs0 zConfig._decide_argsrc Cs|rtjdd}t|r|t|d||dd<|||r2||dd||dd<|j j |t |j d|_ ||||jj|ddtjd s\|jd |j|j j |t |j d|_ |||j jdur|jdurt|jj}nt|j}||j _z |jj|||j d WdSty}z|j js|j jr|j t!d |j"d dnWYd}~dSd}~ww)NZPYTEST_ADDOPTSr<zvia PYTEST_ADDOPTSrzvia addopts configrFrrr;)rrYrgz"could not load initial conftests: r8r)#rVrrr-rshlexrUrrrnparse_known_argsrrlr _checkversionrrrr@r7_validate_plugins_warn_about_skipped_pluginsrr|rRrrrkrrErrrr/rF)rJrYrZ env_addoptsrrnrCrCrD _preparseLsX            zConfig._preparse)wrapperccszdVW|S|wrI)_validate_config_optionsrOrCrCrDpytest_collectionszConfig.pytest_collectioncCszddl}|jdd}|r9ddlm}t|ts |d|j||||j kr;||jd|d|j ddSdS)NrrVersionz'%s: 'minversion' must be a single valuez: 'minversion' requires pytest-z, actual pytest-') r6rrpackaging.versionrrrRr!r| __version__)rJr6ZminverrrCrCrDrs   zConfig._checkversioncCs(t|D] }|d|dqdS)NzUnknown config option: r`)r_get_unknown_ini_keys_warn_or_fail_if_strict)rJkeyrCrCrDrszConfig._validate_config_optionsc Cst|d}|s dSddlm}ddlm}ddlm}|j}dd|D}g}|D]4}z||} Wn|yC| |Yq-w| j |vrO| |q-| j j ||| j dd sa| |q-|rnt d d |dS) Nrr)InvalidRequirement) RequirementrcSsi|] \}}|j|jqSrC) project_namer)rrrrCrCrD sz,Config._validate_plugins..T) prereleaseszMissing required plugins: {}r)rrZpackaging.requirementsrrrrrZlist_plugin_distinforr specifiercontainsr!rr) rJrrrrZ plugin_infoZplugin_dist_infoZmissing_pluginsZrequired_pluginreqrCrCrDrs8          zConfig._validate_pluginsrcCs&|jjrt||jt|dddS)Nr9r)rZ strict_configr!rr/)rJrrCrCrDrszConfig._warn_or_fail_if_strictcs|jjfdd|jDS)Ncsg|]}|vr|qSrCrC)rrZ parser_inicfgrCrD sz0Config._get_unknown_ini_keys..)rn_inidictrrOrCrrDrszConfig._get_unknown_ini_keyscCs|jgks Jd|jjjt|jdd|j||dd|j_z%|jj ||j |j d}|j ||j j |d|jj|jdd\|_|_WdStyOYdSw) Nz:can only parse cmdline args at most once per Config object)rrrTrrr)rYrkZpytest_addhooksrrrrrnZafter_preparseZparse_setoptionrlrrrrrrrrur )rJrYrrCrCrDrs.    z Config.parsewarningrcCs|jdrdS|jjp g}|d}tjdd}tdt|t ||tj ||dWdn1s8wY|rbt |d}|j j|j|j jf}|jjjt|d d d |d d dSdS)aIssue and handle a warning during the "configure" stage. During ``pytest_configure`` we can't capture warnings using the ``catch_warnings_for_item`` function because it is not possible to have hook wrappers around ``pytest_configure``. This function is mainly intended for plugins that need to issue warnings during ``pytest_configure`` (or similar stages). :param warning: The warning instance. :param stacklevel: stacklevel forwarded to warnings.warn. rNfilterwarningsT)recordalwaysrrrr_r<)Zwarning_messagewhenrlocationr)rr=rZpythonwarningsrrrrrNapply_warning_filtersrrc _getframef_code co_filenamef_linenoco_namerkZpytest_warning_recordedrr)rJrrcmdline_filtersconfig_filtersrecordsframerrCrCrDrs*     z Config.issue_config_time_warningrrecCs&||}t|ts J||dS)zAdd a line to an ini-file option. The option must have been declared but might not yet be set in which case the line becomes the first line in its value.N)rrrr)rJrrerrCrCrDrs zConfig.addinivalue_linecCs8z|j|WSty|||j|<}|YSw)a8Return configuration value from an :ref:`ini file `. If a configuration value is not defined in an :ref:`ini file `, then the ``default`` value provided while registering the configuration through :func:`parser.addini ` will be returned. Please note that you can even provide ``None`` as a valid default value. If ``default`` is not provided while registering using :func:`parser.addini `, then a default value based on the ``type`` parameter passed to :func:`parser.addini ` will be returned. The default values based on ``type`` are: ``paths``, ``pathlist``, ``args`` and ``linelist`` : empty list ``[]`` ``bool`` : ``False`` ``string`` : empty string ``""`` If neither the ``default`` nor the ``type`` parameter is passed while registering the configuration through :func:`parser.addini `, then the configuration is treated as a string and a default empty string '' is returned. If the specified name hasn't been registered through a prior :func:`parser.addini ` call (usually from a plugin), a ValueError is raised. )rqr_getini)rJrvalrCrCrDrs   z Config.getinirNvaluecCsd|}t||)Nzunknown configuration type: )rm)rJrrNrrrrCrCrD_getini_unknown_type4s  zConfig._getini_unknown_typec sZz |jj|\}}}Wnty}ztd||d}~ww||}|dur.rYZlinelistcSsg|]}|r|qSrCrC)rtrCrCrDr`rcSs|SrIr/)rrCrCrD`sz Config._getini..r`rstring)rnrrrm_get_override_ini_valuerr|rrrrrRrrUmap _strtoboolr/r) rJr descriptionrNrrnZoverride_valuerZ input_valuesrCrrDr8sD    zConfig._getinirFcCsz |j||\}}Wn tyYdSw|jdusJt|jj}g}|D]}t|tjr4t|}n | dtj }t ||}| |q'|S)NrN) rrrr%rrrrVrrrWr(r)rJrrFrZrelrootsmodpathvaluesZrelrootrCrCrD_getconftest_pathlistls      zConfig._getconftest_pathlistc Cs`d}|jD](}z |dd\}}Wnty&}z td|d|d}~ww||kr-|}q|S)Nrrz3-o/--override-ini expects option=value style (got: z).)rrrUrmr!)rJrrZ ini_configrZuser_ini_valuernrCrCrDr}s   zConfig._get_override_ini_valueFskipc Cs|j||}zt|j|}|dur|rt||WStyI}z#|tur.|WYd}~S|r=ddl}|d|dtd||d}~ww)aiReturn command line option value. :param name: Name of the option. You may also specify the literal ``--OPT`` option instead of the "dest" option name. :param default: Default value if no option of that name exists. :param skip: If True, raise pytest.skip if option does not exists or has a None value. Nrzno z option foundzno option named ) rsrrrlrnotsetr6rrm)rJrrrrrnr6rCrCrD getoptions   zConfig.getoptioncCs ||S)z$Deprecated, use getoption() instead.rrJrrFrCrCrDgetvalue zConfig.getvaluecCs|j|ddS)z-Deprecated, use getoption(skip=True) instead.T)rrrrCrCrDgetvalueorskiprzConfig.getvalueorskipZ assertionsVERBOSITY_ASSERTIONSZ test_casesVERBOSITY_TEST_CASESr`_VERBOSITY_INI_DEFAULTverbosity_typecCs\|jj}t|ts J|dur|St|}||jjvr|S||}|tj kr*|St|S)a4Retrieve the verbosity level for a fine-grained verbosity type. :param verbosity_type: Verbosity type to get level for. If a level is configured for the given type, that value will be returned. If the given type is not a known verbosity type, the global verbosity level will be returned. If the given type is None (default), the global verbosity level will be returned. To configure a level for a fine-grained verbosity type, the configuration file should have a setting for the configuration name and a numeric value for the verbosity level. A special value of "auto" can be used to explicitly use the global verbosity level. Example: .. code-block:: ini # content of pytest.ini [pytest] verbosity_assertions = 2 .. code-block:: console pytest -v .. code-block:: python print(config.get_verbosity()) # 1 print(config.get_verbosity(Config.VERBOSITY_ASSERTIONS)) # 2 N) rlverboserintr_verbosity_ini_namernrrr)rJrZ global_levelZini_namelevelrCrCrD get_verbositys    zConfig.get_verbositycCs d|S)NZ verbosity_rC)rrCrCrDrrzConfig._verbosity_ini_namergr3rcCs|jt||dtjddS)aAdd a output verbosity configuration option for the given output type. :param parser: Parser for command line arguments and ini-file values. :param verbosity_type: Fine-grained verbosity category. :param help: Description of the output this type controls. The value should be retrieved via a call to :py:func:`config.get_verbosity(type) `. r)rrNrN)rrrr)rgrrrCrCrD_add_verbosity_inis   zConfig._add_verbosity_inircCs2ts|dkr d}nd}|jt|dddSdS)NrzRASSERTIONS ARE NOT EXECUTED and FAILING TESTS WILL PASS. Are you using python -O?zassertions not in test modules or plugins will be ignored because assert statements are not executed by the underlying Python interpreter (are you using python -O?) r9r)_assertion_supportedrr/)rJrrrCrCrDrs z$Config._warn_about_missing_assertioncCs4|jjD]\}}|jtd|d|ddqdS)Nzskipped plugin rLr8r)rrrr/)rJrWrrrCrCrDr s z"Config._warn_about_skipped_pluginsrDrI)rHr)r1r1rHN)rrrHN)T)Qr<r=r>r?r dataclasses dataclassrr_EnumrdrrrKpropertyrrr|rr~rrlr%rrrRrr#rrjrkrr classmethodrrmhookimplrrrrrrrrrrr r[rrrrrrrWarningrrrrrrrr rrrrrrr r^rrrrrrrrrCrCrCrDrs  ! B            -6   !#"$4   -cCszJty YdSw)NFT)r$rCrCrCrDr s  r r_rcCs\t|d}|jjdkrd|_n |jjdkrd|_|jjdkr#d|_|S|jjdkr,d|_|S)zCreate a TerminalWriter instance configured according to the options in the config object. Every code which requires a TerminalWriter object and has access to a config object should use this function. )ryesTnoF)r%rlcolorZ hasmarkupZcode_highlight)r_rrprCrCrDcreate_terminal_writers    r+rcCs.|}|dvr dS|dvrdStd|)aConvert a string representation of truth to True or False. True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if 'val' is anything else. .. note:: Copied from distutils.util. )yr(rtrueon1T)r0r)ffalseoff0Fzinvalid truth value )lowerrm)rrCrCrDr 5s  r 2)maxsizer2escapezwarnings._ActionKindc Csd}td|d}|d}t|dkr,d}tdt|d|d }t|j|d t|dkr=|d t|dks2d d |D\}}} } } zt|} Wntjyh} z t|jt | d dd} ~ wwzt | }Wnt yt }|jdd}t|j|d dw|r|rt|}| r|rt| d} | rzt| }|dkrtdWnty} zt|jd| d| d dd} ~ wwd}| ||| |fS)zParse a warnings filter string. This is copied from warnings._setoption with the following changes: * Does not apply the filter. * Escaping is optional. * Raises UsageError so we get nice error messages on failure. TzF while parsing the following warning configuration: z8 This error occurred: {error} :r;zJhttps://docs.python.org/3/library/warnings.html#describing-warning-filtersz Too many fields (z), expected at most 5 separated by colons: action:message:category:module:line For more information please consult: z )errorr<css|]}|VqdSrIr)rsrCrCrDrrsz'parse_warning_filter..Nr)r\z\Zrznumber is negativezinvalid lineno rL)rrUr-r!rrr _getaction _OptionErrorrR_resolve_warning_categoryrQr#Z from_currentrhrer7rrm)r2r7__tracebackhide__Zerror_templaterYZdoc_urlr9Zaction_rZ category_moduleZlineno_actionrncategoryroZexception_textlinenorCrCrDparse_warning_filterGsn         rDrBcCsrd}|stSd|vrddl}|}n|d\}}}t|dd|g}t||}t|ts2t|dttt|S)z Copied from warnings._getcategory, but changed so it lets exceptions (specially ImportErrors) propagate so we can get access to their tracebacks (#9218). T.rNz is not a Warning subclass) r'builtins rpartitionrAr issubclassr!rr)rBr?rklassr@rcatrCrCrDr=s  r=rrcCs<|D] }tjt|ddq|D] }tjt|ddqdS)z8Applies pytest-configured filters to the warnings moduleF)r7TN)rrrD)rrr2rCrCrDrs r)NN)rHrrI)r?rjcollections.abcrIrr!r_ functoolsrrimportlib.metadatarTrrVpathlibrr>rrctextwraprrrtypingrrrr r r r r rrrrrrrrrrrrZpluggyrrrrrcompatr exceptionsr r!Z findpathsr"Z _pytest._coderr#r$Z _pytest._ior%Z_pytest.deprecatedZ_pytest.hookspecZ_pytest.outcomesr&r'Z_pytest.pathlibr(r)r*r+r,r-Z _pytest.stashr.Z_pytest.warning_typesr/r0rir1r3Z_pytest._code.coder4Z_pytest.terminalr5r[rEr&rIntEnumr7rQrE_codeZTracebackEntryrrXrRrrsr}r~rrr4rrr>r"rrrarrrrr9rKrrTrr r+r r'rDr=rrCrCrCrDs                                                       2                  e AU   G