B 18™\e»ã@s’ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZddlmZddl m!Z!ddlm"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*ddlm+Z+Gdd„dƒZ,ej-j.r:d Z/nd Z/d  0¡Z1e2d d „e/DƒƒZ3d 0¡Z4e2dd „e/DƒƒZ5d 6dej7¡Z8dZ9d 0¡Z:d 0¡Z;d 0¡Zdd„Z?dd„Z@dd„ZAdd„ZBd d!„ZCGd"d#„d#ejDƒZEGd$d%„d%ejDƒZFGd&d'„d'eEƒZGGd(d)„d)ejDƒZHGd*d+„d+ejDƒZIGd,d-„d-eEƒZJGd.d/„d/ejDƒZKGd0d1„d1ejDƒZLGd2d3„d3ejDƒZMe%d4d5„ƒZNeOd6krŽeNƒdS)7éN)ÚStringIO)Ú namedtuple)Úassert_python_ok) ÚTESTFNÚrmtreeÚ reap_childrenÚ reap_threadsÚcaptured_outputÚcaptured_stdoutÚcaptured_stderrÚunlinkÚrequires_docstrings)Ú pydoc_modc@seZdZdZdS)ÚnonasciiuЦе не латиницÑN)Ú__name__Ú __module__Ú __qualname__Ú__doc__©rrúS/oak/stanford/groups/akundaje/marinovg/programs/Python-3.7.3/Lib/test/test_pydoc.pyr$sr)ú.dictionary for instance variables (if defined)ú2list of weak references to the object (if defined)rr)Úrrraq NAME test.pydoc_mod - This is a test module for test_pydoc %s CLASSES builtins.object A B C class A(builtins.object) | Hello and goodbye | | Methods defined here: | | __init__() | Wow, I have no function! | | ---------------------------------------------------------------------- | Data descriptors defined here: | | __dict__%s | | __weakref__%s class B(builtins.object) | Data descriptors defined here: | | __dict__%s | | __weakref__%s | | ---------------------------------------------------------------------- | Data and other attributes defined here: | | NO_MEANING = 'eggs' | | __annotations__ = {'NO_MEANING': } class C(builtins.object) | Methods defined here: | | get_answer(self) | Return say_no() | | is_it_true(self) | Return self.get_answer() | | say_no(self) | | ---------------------------------------------------------------------- | Data descriptors defined here: | | __dict__ | dictionary for instance variables (if defined) | | __weakref__ | list of weak references to the object (if defined) FUNCTIONS doc_func() This function solves all of the world's problems: hunger lack of Python war nodoc_func() DATA __xyz__ = 'X, Y and Z' VERSION 1.2.3.4 AUTHOR Benjamin Peterson CREDITS Nobody FILE %s ccs|]}|rd|ndVqdS)z | rNr)Ú.0Úsrrrú „sra*
 
 
test.pydoc_mod (version 1.2.3.4)		index
%s%s

This is a test module for test_pydoc

 
Classes
       
builtins.object
A
B
C

 
class A(builtins.object)
    Hello and goodbye
 
  Methods defined here:
__init__()
Wow, I have no function!
Data descriptors defined here:
__dict__
%s
__weakref__
%s

 
class B(builtins.object)
     Data descriptors defined here:
__dict__
%s
__weakref__
%s
Data and other attributes defined here:
NO_MEANING = 'eggs'
__annotations__ = {'NO_MEANING': <class 'str'>}

 
class C(builtins.object)
     Methods defined here:
get_answer(self)
Return say_no()
is_it_true(self)
Return self.get_answer()
say_no(self)
Data descriptors defined here:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

 
Functions
       
doc_func()
This function solves all of the world's problems:
hunger
lack of Python
war
nodoc_func()

 
Data
        __xyz__ = 'X, Y and Z'

 
Author
        Benjamin Peterson

 
Credits
        Nobody
ccs|]}| dd¡VqdS)ú z N)Úreplace)rrrrrrsz~No Python documentation found for %r. Use help() to get the interactive help utility. Use help(str) for help on the str class.Ú z7problem in %s - ModuleNotFoundError: No module named %ra/ Help on class DA in module %s: class DA(builtins.object) | Data descriptors defined here: | | __dict__%s | | __weakref__%s | | ham | | ---------------------------------------------------------------------- | Data and other attributes inherited from Meta: | | ham = 'spam' z‡ Help on class Class in module %s: class Class(builtins.object) | Data and other attributes inherited from Meta: | | LIFE = 42 zˆ Help on class Class1 in module %s: class Class1(builtins.object) | Data and other attributes inherited from Meta1: | | one = 1 a Help on class Class2 in module %s: class Class2(Class1) | Method resolution order: | Class2 | Class1 | builtins.object | | Data and other attributes inherited from Meta1: | | one = 1 | | ---------------------------------------------------------------------- | Data and other attributes inherited from Meta3: | | three = 3 | | ---------------------------------------------------------------------- | Data and other attributes inherited from Meta2: | | two = 2 z€ Help on class C in module %s: class C(builtins.object) | Data and other attributes defined here: | | here = 'present!' cOs,||f}tdtjf|ž|Ž\}}}| ¡S)zW Runs pydoc on the specified module. Returns the stripped output of pydoc. z-B)rÚpydocÚ__file__Ústrip)Ú module_nameÚargsÚenvÚrcÚoutÚerrrrrÚ run_pydocSs r(cCs<t ¡}| |¡}| t¡pd}|r0d|d}| ¡|fS)z&Returns pydoc generated output as htmlrz
Module Docs)rÚHTMLDocÚ docmoduleÚ getdoclocrr!)ÚmoduleÚdocÚoutputÚlocrrrÚget_pydoc_html]s   r0cCs:tjj}tjj}|||tƒƒƒ}t ¡}|j||d}|S)z,Returns a documentation web link of a module)Úbasedir)ÚosÚpathÚabspathÚdirnamer rÚTextDocr+)r,r4r5r1r-r/rrrÚget_pydoc_linkfs r7cCsRt ¡}| t¡pd}|r&d|d}| |¡}t d¡}| d|¡}| ¡|fS)z&Returns pydoc generated output as textrz MODULE DOCS rz.) rr6r+rr*ÚreÚcompileÚsubr!)r,r-r/r.ZpattrrrÚget_pydoc_textos    r;cCs4| d¡\}}}| d¡\}}}| d¡\}}}|S)Nzzz)Ú partition)ÚtextÚheaderÚ_ÚtitlerrrÚget_html_title}srAc@s.eZdZddd„Zejd dd„ƒZdd„ZdS) Ú PydocBaseTestNcs&|ptj t¡g‰d‡‡fdd„ }|S)zi A version of pkgutil.walk_packages() that will restrict itself to a given path. Nrcsˆ|pˆ||ƒS)Nr)r3ÚprefixÚonerror)Ú default_pathÚ walk_packagesrrÚwrappersz8PydocBaseTest._restricted_walk_packages..wrapper)NrN)r2r3r5r )ÚselfrFr3rGr)rErFrÚ_restricted_walk_packages‡sz'PydocBaseTest._restricted_walk_packagesccs,tj}| ||¡t_z dVWd|t_XdS)N)ÚpkgutilrFrI)rHr3rFrrrÚrestrict_walk_packages‘s  z$PydocBaseTest.restrict_walk_packagescCs&t |d¡}t|ƒ}| |||¡|S)Nz text/html)rÚ _url_handlerrAÚ assertEqual)rHÚurlZexpected_titler=ÚresultrrrÚcall_url_handler›s zPydocBaseTest.call_url_handler)N)N)rrrrIÚ contextlibÚcontextmanagerrKrPrrrrrB…s  rBc@s€eZdZdZe ejjdkd¡e e edƒo2e  ¡d¡e dd„ƒƒƒZ e ejjdkd¡e e edƒole  ¡d¡e dd „ƒƒƒZ d d „Zd d „Zdd„Zdd„Zdd„Zdd„Ze ejjdkd¡dd„ƒZdd„Zdd„Ze ejjdkd¡e e edƒoe  ¡d¡e dd„ƒƒƒZdd „Zd!d"„Ze ejjdkd¡d#d$„ƒZd%d&„Zd'd(„Zd)d*„Zd+d,„Zd-d.„Zd/d0„Z d1d2„Z!dS)3Ú PydocDocTestNéz)Docstrings are omitted with -O2 and aboveÚgettracez1trace function introduces __locals__ unexpectedlycCsDttƒ\}}t t¡}tj |¡}t|||ft}|  ||¡dS)N) r0rÚinspectÚ getabsfileÚurllibÚparseÚquoteÚexpected_html_patternÚexpected_html_data_docstringsrM)rHrOÚdoc_locÚmod_fileZmod_urlZ expected_htmlrrrÚ test_html_doc¦s   zPydocDocTest.test_html_doccCs6ttƒ\}}t|ftt t¡f}| ||¡dS)N)r;rÚexpected_text_patternÚexpected_text_data_docstringsrVrWrM)rHrOr]Ú expected_textrrrÚ test_text_doc´s  zPydocDocTest.test_text_doccCs4ddl}Gdd„d|jƒ}t |¡}| d|¡dS)Nrc@seZdZdZdZdS)zIPydocDocTest.test_text_enum_member_with_value_zero..BinaryIntegerréN)rrrZzeroÚonerrrrÚ BinaryIntegerÅsrfz)ÚenumÚIntEnumrÚ render_docÚassertIn)rHrgrfr-rrrÚ%test_text_enum_member_with_value_zeroÁs z2PydocDocTest.test_text_enum_member_with_value_zerocCsttjjƒ}| d|¡dS)Nzxml.etree.elementtree)r7ÚxmlÚetreeÚ ElementTreerj)rHZdoc_linkrrrÚ,test_mixed_case_module_names_are_lower_casedËs z9PydocDocTest.test_mixed_case_module_names_are_lower_casedcCs ttjƒ\}}| |dd¡dS)Nrz'MODULE DOCS incorrectly includes a link)r;rlrmrM)rHrOr]rrrÚtest_issue8225ÐszPydocDocTest.test_issue8225cCs&tj}zdt_t ¡Wd|t_XdS)N)ÚsysÚstdinrÚgetpager)rHZprevious_stdinrrrÚtest_getpager_with_stdin_noneÕs  z*PydocDocTest.test_getpager_with_stdin_nonecCsLGdd„dƒ}Gdd„dƒ}t |ƒ¡}t |ƒ¡}| | dd¡|¡dS)Nc@seZdZdZdS)z)PydocDocTest.test_non_str_name..Aé*N)rrrrrrrÚAàsrvc@s eZdZdS)z)PydocDocTest.test_non_str_name..BN)rrrrrrrÚBâsrw)rrirMr)rHrvrwZadocZbdocrrrÚtest_non_str_nameÝs   zPydocDocTest.test_non_str_namecCs,d}tt|ƒdƒ}t|}| ||d¡dS)Nztest.i_am_not_hereÚasciiz&documentation for missing module found)Ústrr(Úmissing_patternrM)rHÚmissing_modulerOÚexpectedrrrÚ test_not_hereès zPydocDocTest.test_not_herez)Docstrings are omitted with -OO and abovecCs*tddd}tj dd¡}| ||¡dS)Nztest.test_pydoc.nonasciiry)ZPYTHONIOENCODINGÚbackslashreplace)r(rrÚencoderj)rHrOÚencodedrrrÚtest_not_asciiïs zPydocDocTest.test_not_asciicCs.d}tt|ƒdƒ}t| ¡}| ||¡dS)Nz test.i_am_not_here ry)rzr(r{r!rM)rHr|rOr}rrrÚtest_input_stripös zPydocDocTest.test_input_stripcCsJtj}| |dƒd¡| |dƒd¡| |dƒd¡| |dƒd¡dS)Nzzz Z42z)rÚstripidrM)rHr„rrrÚ test_stripidüs   zPydocDocTest.test_stripidc Csðt}tj}dd„}d|_tƒ}tj|d}ttƒ\}}d}d ¡} t   | ¡} | t} |t_zˆt dƒv} t dƒb} |  |¡|  ¡ ¡} | |ftt t¡f}| d|   ¡¡| d|   ¡¡| || ¡WdQRXWdQRXWd|t_XdS) NcSsdd„S)NcSs|S)Nr)ÚxrrrÚózJPydocDocTest.test_help_output_redirect....rrrrrr‡rˆz8PydocDocTest.test_help_output_redirect..)r.ztest.pydoc_modz9 Help on module test.pydoc_mod in test: ÚstdoutÚstderrr)r`rrsÚmaxDiffrÚHelperr;rÚlstripÚtextwrapÚdedentr ÚhelpÚgetvaluer!rarVrWrM)rHZ old_patternZ getpager_oldZ getpager_newÚbufÚhelperZunusedr]r,Z help_headerZexpected_help_patternr.r'rOrbrrrÚtest_help_output_redirect s0       $z&PydocDocTest.test_help_output_redirectc Cs^tdddgdd}tƒ}t |¡WdQRX| ¡}| d|¡| d|¡| d|¡dS) NÚNTÚabcÚdefT)ÚrenameZ_1Ú_replaceÚ_asdict)rr rrr‘rj)rHr•Úhelp_ioÚhelptextrrrÚ!test_namedtuple_public_underscore1s  z.PydocDocTest.test_namedtuple_public_underscorec Cs‚| tt¡xpdD]h}ttd|d8}|dkr@td |¡|dtd|dtd|dWdQRXt ti¡}| |d ¡qWdS) N)z ISO-8859-1zUTF-8Úw)ÚencodingzUTF-8z #coding: {})Úfileu"""line 1: héz line 2: hi"""u line 1: hé) Ú addCleanupr rÚopenÚprintÚformatrÚsynopsisrM)rHrŸÚscriptr¥rrrÚ test_synopsis:s    zPydocDocTest.test_synopsiscCs.tj ¡d}tj}t |¡}| ||¡dS)Nr)r2rÚ splitlinesÚ __cached__rr¥rM)rHr}Úfilenamer¥rrrÚtest_synopsis_sourcelessEs z%PydocDocTest.test_synopsis_sourcelessc CsŠtj ¡v}tj |d¡}tj |¡}t |dƒ}|  d¡WdQRXt   |¡t  |i¡}| |¡t  |i¡}| |¡WdQRXdS)Nz foomod42.pyržzfoo = 1)ÚtestÚsupportÚtemp_cwdr2r3ÚjoinÚ importlibÚutilÚcache_from_sourcer¢ÚwriteÚ py_compiler9rr¥Ú assertIsNone)rHÚtest_dirÚ init_pathZ cached_pathÚfobjr¥Zsynopsis_cachedrrrÚ"test_synopsis_sourceless_empty_docNs       z/PydocDocTest.test_synopsis_sourceless_empty_doccCsd}| t |¡d¡dS)Nz#I Am A Doc Here is my description)z I Am A Docz Here is my description)rMrZsplitdoc)rHZexample_stringrrrÚtest_splitdoc_with_descriptionZs z+PydocDocTest.test_splitdoc_with_descriptioncCs@t ¡}| t |j¡¡| t tj¡¡| t d¡¡dS)NzI am not a method)rZDocÚ assertTrueZ_is_some_methodÚfailÚintÚ__add__Ú assertFalse)rHr-rrrÚtest_is_object_or_method_sz%PydocDocTest.test_is_object_or_methodc Cs*tj ¡}| t |¡¡WdQRXdS)N)r¬r­r®r¿rÚ ispackage)rHr¶rrrÚ test_is_package_when_not_packagehs z-PydocDocTest.test_is_package_when_not_packagec CsPtj ¡<}tj |d¡}t|dƒ ¡| t   |¡¡t  |¡WdQRXdS)Nz __init__.pyrž) r¬r­r®r2r3r¯r¢Úcloser»rrÁÚremove)rHr¶r·rrrÚtest_is_package_when_is_packagels  z,PydocDocTest.test_is_package_when_is_packagecCs`Gdd„dtƒ}tttƒƒ}|j|d<|d=|d=|j|d<|j|d<t |¡}| ||¡dS)Nc@seZdZdd„ZdS)z/PydocDocTest.test_allmethods..TestClasscSsdS)NTr)rHrrrÚmethod_returning_truezszEPydocDocTest.test_allmethods..TestClass.method_returning_trueN)rrrrÆrrrrÚ TestClassysrÇrÆrÚ __class__Ú__subclasshook__Ú__init_subclass__) ÚobjectÚdictÚvarsrÆrÉrÊrZ allmethodsÚassertDictEqual)rHrÇr}ÚmethodsrrrÚtest_allmethodsss     zPydocDocTest.test_allmethodscspGdd„dƒ‰G‡fdd„dˆƒ}t |¡}t dd|¡}| |dt¡tj|t ¡d}| |d t¡dS) Nc@s"eZdZddd„ZeZdd„ZdS)z+PydocDocTest.test_method_aliases..ANcSsdS)z(Raise this widget in the stacking order.Nr)rHZ aboveThisrrrÚtkraiseŽsz3PydocDocTest.test_method_aliases..A.tkraisecSsdS)z Return sizeNr)rHrrrÚa_size‘sz2PydocDocTest.test_method_aliases..A.a_size)N)rrrrÑZliftrÒrrrrrvs rvcs eZdZddd„ZeZ”jZdS)z+PydocDocTest.test_method_aliases..BNc[sdS)z'Configure resources of an item TAGORID.Nr)rHZtagOrIdZcnfÚkwrrrÚ itemconfigure”sz9PydocDocTest.test_method_aliases..B.itemconfigure)N)rrrrÔZ itemconfigrÒZb_sizer)rvrrrw“s rwz.raPython Library Documentation: class B in module %s class B(A) | Method resolution order: | B | A | builtins.object | | Methods defined here: | | b_size = a_size(self) | | itemconfig = itemconfigure(self, tagOrId, cnf=None, **kw) | | itemconfigure(self, tagOrId, cnf=None, **kw) | Configure resources of an item TAGORID. | | ---------------------------------------------------------------------- | Methods inherited from A: | | a_size(self) | Return size | | lift = tkraise(self, aboveThis=None) | | tkraise(self, aboveThis=None) | Raise this widget in the stacking order. | | ---------------------------------------------------------------------- | Data descriptors inherited from A: | | __dict__ | dictionary for instance variables (if defined) | | __weakref__ | list of weak references to the object (if defined) )ZrendereraPython Library Documentation: class B in module %s

 
class B(A)
    
Method resolution order:
B
A
builtins.object
Methods defined here:
b_size = a_size(self)
itemconfig = itemconfigure(self, tagOrId, cnf=None, **kw)
itemconfigure(self, tagOrId, cnf=None, **kw)
Configure resources of an item TAGORID.
Methods inherited from A:
a_size(self)
Return size
lift = tkraise(self, aboveThis=None)
tkraise(self, aboveThis=None)
Raise this widget in the stacking order.
Data descriptors inherited from A:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)
)rrir8r:rMrr))rHrwr-r)rvrÚtest_method_aliasesŒs % (z PydocDocTest.test_method_aliases)"rrrr‹ÚunittestÚskipIfrqÚflagsÚoptimizeÚhasattrrUr r_rcrkrorprtrxr~r‚rƒr…r”rr§r«r¹rºrÀrÂrÅrÐrÕrrrrrS£sJ     $    rSc@szeZdZdd„Zdd„Zdd„Zdd„Zd d „Zd d „Ze   d ¡dd„ƒZ e   d ¡dd„ƒZ e   d¡dd„ƒZ dd„ZdS)ÚPydocImportTestcCs$t t¡|_| tt¡t ¡dS)N)r2Úmkdirrr¶r¡rr°Úinvalidate_caches)rHrrrÚsetUpñs  zPydocImportTest.setUpc Csªd}dddd |¡dfd |¡d |¡ff}tj t|¡tjd}x`|D]X\}}t|d ƒ}| d  |¡¡WdQRXt|td   d ¡}t ||f}|  ||¡qJWdS) NZ testmod_xyzzy)Ú i_am_not_hererß)ztest.i_am_not_here_eitherztest.i_am_not_here_either)ztest.i_am_not_here.neither_am_iztest.i_am_not_herezi_am_not_here.{}rßztest.{}Úpyržz import {} )Ú PYTHONPATHry) r¤r2r3r¯rÚextsepr¢r³r(ÚdecodeÚbadimport_patternrM) rHÚmodnameZ testpairsZsourcefnZ importstringZ expectedinmsgÚfrOr}rrrÚtest_badimportös   zPydocImportTest.test_badimportc Cstj td¡}t |¡tj |d¡tjd}t|dƒ}| d¡WdQRX|jtgd¦t ƒ"}t ƒ}t   d¡WdQRXWdQRX|  | ¡d¡|  | ¡d¡t ƒ"}t ƒ}t   d¡WdQRXWdQRX|  | ¡ ¡d¡|  | ¡d¡WdQRXdS) NZ syntaxerrÚ__init__ràržzinvalid python syntax = $1 )r3Zxyzzyr)r2r3r¯rrÜrâr¢r³rKr r rÚaproposrMr‘r!)rHÚpkgdirZ badsyntaxrær&r'rrrÚtest_apropos_with_bad_package s   z-PydocImportTest.test_apropos_with_bad_packagec Csštj td¡|_t |jd¡| tj|j¡|jtgd4t ƒ"}t ƒ}t   d¡WdQRXWdQRXWdQRX|  | ¡d¡|  | ¡d¡dS)NZ unreadabler)r3ZSOMEKEYr)r2r3r¯rZunreadable_dirrÜr¡ÚrmdirrKr r rrérMr‘)rHr&r'rrrÚ test_apropos_with_unreadable_dir s(z0PydocImportTest.test_apropos_with_unreadable_dirc CsÖtj td¡}t |¡| t|¡tj |d¡}t|dƒ}| d¡WdQRXt   t  |¡j ¡}z^t  ||t j @¡|jtgd"tƒ}t d¡WdQRXWdQRX| d| ¡¡Wdt  ||¡XdS)NZwalkpkgz __init__.pyržzfoo = 1)r3r)r2r3r¯rrÜr¡rr¢r³ÚstatÚS_IMODEÚst_modeÚchmodÚS_IEXECrKr rrérjr‘)rHrêr·r¸Z current_moder‰rrrÚtest_apropos_empty_doc/s   z&PydocImportTest.test_apropos_empty_docc CsÒtj td¡}t |¡tj |d¡}t|ddd}| d¡WdQRX|jtgdptt jƒ}t j  dt¡z@|  t d ¡ddl }WdQRX| d d ¡}d }| ||¡Wd|t jdd…<XWdQRXdS) NÚtest_error_packagez __init__.pyZwtry)rŸzraise ValueError("ouch") )r3rZouchzsearch?key=test_error_packagezPydoc: Search Resultsz8test_error_package)r2r3r¯rrÜr¢r³rKÚtuplerqÚinsertÚassertRaisesRegexÚ ValueErrorrôrPrj)rHrêÚinitræZ saved_pathsrôr=ÚfoundrrrÚtest_url_search_package_error?s   z-PydocImportTest.test_url_search_package_errorz(causes undesirable side-effects (#20128)c CsZd}d}d}|||}tƒ}tj|d}|dƒ| ¡ ¡}t| ¡ƒ}| ||¡dS)NrTéé)r.Úmodules)rrrŒr‘r!Úlenr¨ÚassertGreaterEqual) rHZnum_header_linesZnum_module_lines_minZnum_footer_linesr}r.r“rOÚ num_linesrrrÚ test_modulesVs    zPydocImportTest.test_modulesc CsHd}tƒ}tj|d}tƒ}|dƒWdQRX| ¡}| ||¡dS)Nzpydoc - )r.z modules pydoc)rrrŒr r‘rj)rHr}r.r“r›rOrrrÚtest_modules_searchfs z#PydocImportTest.test_modules_searchz+some buildbots are not cooperating (#20128)c CsLd}tƒ}tj|d}tƒ}|dƒWdQRX| ¡}| | |¡¡dS)Nzgc - )r.zmodules garbage)rrrŒr r‘r»Ú startswith)rHr}r.r“r›rOrrrÚtest_modules_search_builtinss z+PydocImportTest.test_modules_search_builtincCsJt tj¡}| |t¡| |jd¡| |jtj¡| |jtj¡dS)Nr)rZ importfiler Ú assertIsNotrMrÚ__spec__)rHZ loaded_pydocrrrÚtest_importfiles   zPydocImportTest.test_importfileN)rrrrÞrçrërírórûrÖÚskiprrrrrrrrrÛïs  rÛc@steZdZdd„Zdd„Zdd„Zdd„Zed d „ƒZd d „Z e d d„ƒZ dd„Z dd„Z e dd„ƒZe dd„ƒZdS)ÚTestDescriptionscCs&ddlm}t |¡}| d|¡dS)Nr)Ú pydocfodderr )r¬r rrirj)rHr r-rrrÚ test_moduleŠs  zTestDescriptions.test_modulecCsVGdd„dƒ}|ƒ}| t |¡d¡| t |¡d¡dt}| |t |¡¡dS)Nc@seZdZdZdS)z&TestDescriptions.test_class..CzNew-style classN)rrrrrrrrÚC‘sr zclass CzC in module %s object)rMrZdescriberrjri)rHr Úcr}rrrÚ test_classs zTestDescriptions.test_classcCstjtjttjtjttjfdœdd„}t d¡}Gdd„dtj|tjtt fƒ}|  t   |¡  ¡dd¡|  t   |¡  ¡d d ¡dS) N)Údatar†ÚreturncSsdS)Nr)rr†rrrÚfoošsz/TestDescriptions.test_typing_pydoc..fooÚTc@s eZdZdS)z-TestDescriptions.test_typing_pydoc..CN)rrrrrrrr žsr éÿÿÿÿz?ffoooo(data: List[Any], x: int) -> Iterator[Tuple[int, Any]]rTz2class CC(collections.abc.Mapping, typing.Generic))ÚtypingZListZAnyr½ÚIteratorZTupleZTypeVarZGenericÚMappingrzrMrrir¨)rHrrr rrrÚtest_typing_pydoc™s " "z"TestDescriptions.test_typing_pydocc Cs„xPdD]H}| t |¡¡yt |¡Wqtk rL| d |¡¡YqXqWx,dD]$}| t |¡¡| ttj|¡qXWdS)N)rzz str.translatez builtins.strzbuiltins.str.translatezfinding the doc of {!r} failed)Z notbuiltinsZstrrrzstrr.translatezstr.trrrranslatezbuiltins.strrrzbuiltins.str.trrranslate) ÚassertIsNotNonerZlocateriÚ ImportErrorr¼r¤rµÚ assertRaises)rHÚnamerrrÚ test_builtin¥s  zTestDescriptions.test_builtincCs2t t |¡¡}| d¡}t|ƒdks*t‚|dS)NrrT)rZplainriÚsplitrÿÚAssertionError)Úor=ÚlinesrrrÚ_get_summary_line¶s z"TestDescriptions._get_summary_linecCs| | tjj¡d¡dS)Nzwrap(self, text))rMr"rŽÚ TextWrapperÚwrap)rHrrrÚtest_unbound_python_method¾sz+TestDescriptions.test_unbound_python_methodcCs| | tjj¡d¡dS)Nzdump(self, obj, /))rMr"Ú_pickleÚPicklerÚdump)rHrrrÚtest_unbound_builtin_methodÂsz,TestDescriptions.test_unbound_builtin_methodcCs t ¡}| | |j¡d¡dS)Nz2wrap(text) method of textwrap.TextWrapper instance)rŽr#rMr"r$)rHÚtrrrÚtest_bound_python_methodÈsz)TestDescriptions.test_bound_python_methodcCs~tddddgƒ}t |¡}| | d¡| d¡¡| | d¡| d¡¡Gdd„dƒ}Gdd„dƒ}t |¡t |¡dS) NÚPersonZnicknameZ firstnameZagegroupc@seZdZdZdS)zMTestDescriptions.test_field_order_for_named_tuples..NonIterableFieldsN)rrrÚ_fieldsrrrrÚNonIterableFieldsÓsr.c@seZdZggZdS)zMTestDescriptions.test_field_order_for_named_tuples..NonHashableFieldsN)rrrr-rrrrÚNonHashableFieldsÖsr/)rrriÚ assertLessÚindex)rHr,rr.r/rrrÚ!test_field_order_for_named_tuplesÍs  z2TestDescriptions.test_field_order_for_named_tuplescCs(tƒ}t |¡}| | |j¡d¡dS)Nz/dump(obj, /) method of _pickle.Pickler instance)rr&r'rMr"r()rHrÚprrrÚtest_bound_builtin_methodÝs z*TestDescriptions.test_bound_builtin_methodcCs| | tj¡d¡dS)Nz0stat(path, *, dir_fd=None, follow_symlinks=True))rMr"r2rî)rHrrrÚtest_module_level_callableåsz+TestDescriptions.test_module_level_callableN)rrrr rrrÚ staticmethodr"r%r r)r+r2r4r5rrrrr ˆs     r c@seZdZdZdd„ZdS)ÚPydocServerTestzTests for pydoc._start_servercCs|dd„}tj|ddd}| d|jj¡t ¡}d}x4|jrht d¡|jr6t ¡||kr6|  ¡Pq6W|  |j d¡dS)NcSsd||f}|S)Nzthe URL sent was: (%s, %s)r)rNZ content_typer=rrrÚmy_url_handlerñs z3PydocServerTest.test_server..my_url_handlerz0.0.0.0r)ÚhostnameÚportrdg{®Gáz„?) rZ _start_serverrjZ docserverÚaddressÚtimeÚ monotonicZservingÚsleepÚstoprMÚerror)rHr8Z serverthreadÚ starttimeÚtimeoutrrrÚ test_serverîs zPydocServerTest.test_serverN)rrrrrCrrrrr7ësr7c@s eZdZdZdd„Zdd„ZdS)ÚPydocUrlHandlerTestzTests for pydoc._url_handlercCs*tj}| t|dd¡| t|dd¡dS)NrvrrwÚfoobar)rrLrÚ TypeError)rHrærrrÚtest_content_type_errsz)PydocUrlHandlerTest.test_content_type_errc Cstddddddddd d d d g }| ¡Fx|D]\}}| ||¡q,Wtj}d |}d|}| ||¡WdQRXdS)N)rzPydoc: Index of Modules)zget?key=zPydoc: Index of Modules)r1zPydoc: Index of Modules)Ztopicsz Pydoc: Topics)ÚkeywordszPydoc: Keywords)rzPydoc: module pydoc)z get?key=pydoczPydoc: module pydoc)zsearch?key=pydoczPydoc: Search Results)z topic?key=defzPydoc: KEYWORD def)ztopic?key=STRINGSzPydoc: TOPIC STRINGS)rEzPydoc: Error - foobar)zgetfile?key=foobarz!Pydoc: Error - getfile?key=foobarzPydoc: getfile z getfile?key=)rKrPÚstringr )rHZrequestsrNr@r3rrrÚtest_url_requests s& z%PydocUrlHandlerTest.test_url_requestsN)rrrrrGrJrrrrrDsrDc@seZdZdd„ZdS)Ú TestHelpercCs| ttjjƒttjƒ¡dS)N)rMÚsortedrrŒrHÚkeywordÚkwlist)rHrrrÚ test_keywords*szTestHelper.test_keywordsN)rrrrOrrrrrK)srKc@sìeZdZe ejjdkd¡e eedƒo.e  ¡d¡dd„ƒƒZ e ejjdkd¡e eedƒode  ¡d¡dd„ƒƒZ e ejjdkd¡e eedƒoše  ¡d¡d d „ƒƒZ e ejjdkd¡e eedƒoÐe  ¡d¡d d „ƒƒZ d d„ZdS)ÚPydocWithMetaClassesrTz)Docstrings are omitted with -O2 and aboverUz1trace function introduces __locals__ unexpectedlycCs€Gdd„dtƒ}Gdd„d|d}tdd„tDƒƒ}tƒ}tj|d}||ƒttf|dd …}| ¡  ¡}|  ||¡dS) NcseZdZ‡fdd„Z‡ZS)z=PydocWithMetaClasses.test_DynamicClassAttribute..Metacs|dkr dStƒ |¡S)NÚhamZspam)ÚsuperÚ __getattr__)rHr)rÈrrrS5szIPydocWithMetaClasses.test_DynamicClassAttribute..Meta.__getattr__)rrrrSÚ __classcell__rr)rÈrÚMeta4srUc@seZdZejdd„ƒZdS)z;PydocWithMetaClasses.test_DynamicClassAttribute..DAcSsdS)NZeggsr)rHrrrrQ:sz?PydocWithMetaClasses.test_DynamicClassAttribute..DA.hamN)rrrÚtypesÚDynamicClassAttributerQrrrrÚDA9srX)Ú metaclasscss|]}|rd|ndVqdS)z | rNr)rrrrrr=szBPydocWithMetaClasses.test_DynamicClassAttribute..)r.rT) ÚtyperõÚexpected_data_docstringsrrrŒÚ!expected_dynamicattribute_patternrr‘r!rM)rHrUrXrar.r“rbrOrrrÚtest_DynamicClassAttribute/s   z/PydocWithMetaClasses.test_DynamicClassAttributecCs`Gdd„dtƒ}Gdd„d|d}tƒ}tj|d}||ƒtt}| ¡ ¡}| ||¡dS)Ncs$eZdZdd„Z‡fdd„Z‡ZS)zHPydocWithMetaClasses.test_virtualClassAttributeWithOneMeta..MetacSs ddddgS)NrÈrrÚLIFEr)ÚclsrrrÚ__dir__MszPPydocWithMetaClasses.test_virtualClassAttributeWithOneMeta..Meta.__dir__cs|dkr dStƒ |¡S)Nr^ru)rRZ_Meta__getattr)rHr)rÈrrrSOszTPydocWithMetaClasses.test_virtualClassAttributeWithOneMeta..Meta.__getattr__)rrrr`rSrTrr)rÈrrULsrUc@s eZdZdS)zIPydocWithMetaClasses.test_virtualClassAttributeWithOneMeta..ClassN)rrrrrrrÚClassSsra)rY)r.) rZrrrŒÚ"expected_virtualattribute_pattern1rr‘r!rM)rHrUrar.r“rbrOrrrÚ%test_virtualClassAttributeWithOneMetaGs  z:PydocWithMetaClasses.test_virtualClassAttributeWithOneMetac sÞGdd„dtƒ‰Gdd„dtƒ‰G‡‡fdd„dˆˆƒ}Gdd„dˆd }Gd d „d ||d }d }}tƒ}tj|d }||ƒtt}| ¡ ¡} | || ¡tƒ}tj|d }||ƒt t} | ¡ ¡} | | | ¡dS)Ncs$eZdZdd„Z‡fdd„Z‡ZS)zIPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta1cSs ddddgS)NrÈrrrer)r_rrrr`bszQPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta1.__dir__cs|dkr dStƒ |¡S)Nrerd)rRrS)rHr)rÈrrrSdszUPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta1.__getattr__)rrrr`rSrTrr)rÈrÚMeta1asrdcs$eZdZdd„Z‡fdd„Z‡ZS)zIPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta2cSs ddddgS)NrÈrrÚtwor)r_rrrr`iszQPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta2.__dir__cs|dkr dStƒ |¡S)NrerT)rRrS)rHr)rÈrrrSkszUPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta2.__getattr__)rrrr`rSrTrr)rÈrÚMeta2hsrfcs*eZdZ‡‡fdd„Z‡fdd„Z‡ZS)zIPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta3cs,tttddddgˆ |¡ˆ |¡ƒƒƒS)NrÈrrÚthree)ÚlistrLÚsetr`)r_)rdrfrrr`pszQPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta3.__dir__cs|dkr dStƒ |¡S)Nrgrý)rRrS)rHr)rÈrrrStszUPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Meta3.__getattr__)rrrr`rSrTr)rdrf)rÈrÚMeta3osrjc@s eZdZdS)zJPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Class1N)rrrrrrrÚClass1xsrk)rYc@s eZdZdS)zJPydocWithMetaClasses.test_virtualClassAttributeWithTwoMeta..Class2N)rrrrrrrÚClass2zsrlF)r.) rZrrrŒÚ"expected_virtualattribute_pattern2rr‘r!rMÚ"expected_virtualattribute_pattern3) rHrjrkrlZfail1Zfail2r.r“Zexpected_text1Zresult1Zexpected_text2Zresult2r)rdrfrÚ%test_virtualClassAttributeWithTwoMeta\s$      z:PydocWithMetaClasses.test_virtualClassAttributeWithTwoMetacCs`Gdd„dtƒ}Gdd„d|d}tƒ}tj|d}||ƒtt}| ¡ ¡}| ||¡dS)Nc@seZdZdd„ZdS)z.PydocWithMetaClasses.test_buggy_dir..McSs ddddgS)NrÈrÚmissingÚherer)r_rrrr`sz6PydocWithMetaClasses.test_buggy_dir..M.__dir__N)rrrr`rrrrÚMsrrc@seZdZdZdS)z.PydocWithMetaClasses.test_buggy_dir..Czpresent!N)rrrrqrrrrr ’sr )rY)r.) rZrrrŒÚ!expected_missingattribute_patternrr‘r!rM)rHrrr r.r“rbrOrrrÚtest_buggy_dirŠs  z#PydocWithMetaClasses.test_buggy_dirc Cs4tƒ}t d¡WdQRX| ¡}| d|¡dS)Nz enum.Enumz class Enum)r rrr‘rj)rHr›rœrrrÚtest_resolve_false›sz'PydocWithMetaClasses.test_resolve_falseN)rrrrÖr×rqrØrÙrÚrUr]rcrortrurrrrrP.s"+rPc@sFeZdZdd„Zddd„Zdd„Zdd „Zd d „Zd d „Zdd„Z dS)ÚTestInternalUtilitiescCsNt ¡}|j|_tj |jd¡|_| |j ¡t  ¡|_ }dtj |g|_ dS)NZ nonexistentr)ÚtempfileÚTemporaryDirectoryrÚargv0dirr2r3r¯Úargv0r¡ÚcleanupÚgetcwdÚ abs_curdirÚcurdirÚcurdir_spellings)rHZtmpdirr}rrrrÞ¦s  zTestInternalUtilities.setUpNcCs|dkr|j}t ||¡S)N)rzrÚ_get_revised_path)rHÚ given_pathrzrrrr€®sz'TestInternalUtilities._get_revised_pathcCs@tj ¡}x0|jD]&}x t| |¡ƒD]}| |¡q&WqW|S)N)rqr3ÚcopyrÚrangeÚcountrÄ)rHÚ clean_pathÚspellingÚ__rrrÚ_get_starting_pathµs   z(TestInternalUtilities._get_starting_pathcCs*| ¡}|jg|}| | |¡|¡dS)N)rˆr}rMr€)rHr…Ú expected_pathrrrÚ,test_sys_path_adjustment_adds_missing_curdir½s zBTestInternalUtilities.test_sys_path_adjustment_adds_missing_curdircCsT| ¡}|jg|}|jg|}| | |¡|¡||jg}| | |¡|¡dS)N)rˆr}ryrMr€)rHr…r‰Úleading_argv0dirÚtrailing_argv0dirrrrÚ*test_sys_path_adjustment_removes_argv0_dirÂs    z@TestInternalUtilities.test_sys_path_adjustment_removes_argv0_dircsh‡fdd„}ˆ ¡}ˆjg|}ˆjg|}ˆ ||ƒ|¡|ˆjg}ˆjg|}ˆ ||ƒ|¡dS)Ncsˆj|tjdS)N)rz)r€rr )r)rHrrr€Ìsz\TestInternalUtilities.test_sys_path_adjustment_protects_pydoc_dir.._get_revised_path)rˆryr}rM)rHr€r…r‹r‰rŒr)rHrÚ+test_sys_path_adjustment_protects_pydoc_dirËs     zATestInternalUtilities.test_sys_path_adjustment_protects_pydoc_dirc Cs | ¡}x’|jD]ˆ}|j|dr|g|}| | |¡¡||g}| | |¡¡|jg|}| | |¡¡||jg}| | |¡¡WdQRXqWdS)N)Zcurdir_spelling)rˆrÚsubTestrµr€ry)rHr…r†Zleading_curdirZtrailing_curdirr‹rŒrrrÚ5test_sys_path_adjustment_when_curdir_already_includedÖs     zKTestInternalUtilities.test_sys_path_adjustment_when_curdir_already_included)N) rrrrÞr€rˆrŠrrŽrrrrrrv¤s   rvc Cs,ztj ttttttt t ¡Wdt ƒXdS)N) r¬r­Ú run_unittestrSrÛr r7rDrKrPrvrrrrrÚ test_mainås r’Ú__main__)Pr2rqrQÚimportlib.utilr°rVrr´rMr&rJr8rîrIrwZ test.supportr¬r<rVrrÖÚ urllib.parserXZ xml.etreerlÚxml.etree.ElementTreerŽÚ threadingÚiorÚ collectionsrZtest.support.script_helperrrrrrr r r r r rrr­ÚHAVE_DOCSTRINGSr[r!r`rõrar[r\rÚlinesepr{rär\rbrmrnrsr(r0r7r;rAÚTestCaserBrSrÛr r7rDrKrPrvr’rrrrrÚs‚   ,  T {       Nc%vA