4dZddlZddlZddlZddlmZddlmZddlm Z m Z m Z ddl m Z ddlmZdadZd Zdd ZGd d ZGd de ZGdde ZdZedk(r5eej4dk(rddlmZedddddlmZeeyy)zModule browser. XXX TO DO: - reparse when source changed (maybe just a button would be OK?) (or recheck on window popup) - add popup menu with more options (e.g. doc strings, base classes, imports) - add base classes to class browser tree N)idleConf)pyshell)TreeNodeTreeItemScrolledCanvas) py_extensions)ListedToplevel)z.pyictjj|\}}tjj|}|tvxr|t vSN)ospathsplitextnormcaserbrowseable_extension_blocklist)r _exts &/usr/lib/python3.12/idlelib/browser.pyis_browseable_extensionrsD WW  d #FAs ''  3 C -  MC/M$MMcg}|jD]\}}||j|k(st|dr|jr|j|k(rg}|jD]\}t |t r|}n6|j}|j|jk7r|jd|}|j|^|xjdjdj|z c_|j||S)aTransform a child dictionary to an ordered sequence of objects. The dictionary maps names to pyclbr information objects. Filter out imported objects. Augment class names with bases. The insertion order of the dictionary is assumed to have been in line number order, so sorting is not necessary. The current tree only calls this once per child_dict as it saves TreeItems once created. A future tree and tests might violate this, so a check prevents multiple in-place augmentations. super.z({})z, ) itemsmodulehasattrrname isinstancestrappendformatjoin) child_dictmodnameobskeyobjsuperssupsnames rtransform_childrenr*#s C$$&S ?cjjG3sG$sxx399C!#s+ # #::3'*zzl!E7$;EMM%(%FMM$))F*;<< JJsO' Jrc8eZdZdZddddZd dZdZdZd Zy) ModuleBrowserz1Browse module classes and functions in IDLE. F)_htest_utestc\||_||_||_||_|j y)aCreate a window for browsing a module's structure. Args: master: parent for widgets. path: full path of file to browse. _htest - bool; change box location when running htest. -utest - bool; suppress contents when running unittest. Global variables: file_open: Function used for opening a file. Instance variables: name: Module name. file: Full path and module with supported extension. Used in creating ModuleBrowserTreeItem as the rootnode for the tree and subsequently in the children. N)masterr r-r.init)selfr0r r-r.s r__init__zModuleBrowser.__init__Js)$     rNcl|jj|jjy)z&Dismiss the window and the tree nodes.N)topdestroynode)r2events rclosezModuleBrowser.closebs"  rc|j}|js|jstjntj |}|j atjjt|x|_ }|jd|j|jd|j|jr5|j!d|j#|j%dzfz|j'|j)t+j,}t+j.|dd}t1||dd }|j2j5dd |j7}t9|j:d |x|_}|js!|j?|jAy y ) z3Create browser tkinter widgets, including the tree.WM_DELETE_WINDOWzz+%d+%dnormal backgroundr)bghighlightthickness takefocusboth)expandfillN)!r0r-r.rflistPyShellFileListopen file_openpyclbr_modulesclearr r5protocolr9bindgeometry winfo_rootx winfo_rootysettitle focus_setr CurrentTheme GetHighlightrframepackrootnodercanvasr7updaterD) r2rootrFr5themer>scitemr7s rr1zModuleBrowser.initgs`{{'+{{dkk--d3 JJ (--3 '4 TZZ( ;; LL!!#T%5%5%7#%=>? @  %%'**5(;LI CJ1&')  QV ,}}#BIItT:: D{{ KKM KKMrc|jjdtjj |jz|jj dy)zSet the window title.zModule Browser - zModule BrowserN)r5wm_titler r basename wm_iconnamer2s rrRzModuleBrowser.settitles@ -0@0@0KKL -.rc,t|jS)z7Return a ModuleBrowserTreeItem as the root of the tree.)ModuleBrowserTreeItemr rcs rrXzModuleBrowser.rootnodes$TYY//rr ) __name__ __module__ __qualname____doc__r3r9r1rRrXrrr,r,Cs' 05U0 >/ 0rr,c:eZdZdZdZdZdZdZdZdZ dZ y ) rez~Browser tree for Python module. Uses TreeItem as the basis for the structure of the tree. Used by both browsers. c||_y)zdCreate a TreeItem for the file. Args: file: Full path and module name. N)file)r2rms rr3zModuleBrowserTreeItem.__init__s  rcTtjj|jS)z5Return the module name as the text string to display.)r r rarmrcs rGetTextzModuleBrowserTreeItem.GetTextsww **rcy)'Return the name of the icon to display.pythonrjrcs r GetIconNamez!ModuleBrowserTreeItem.GetIconNamesrcZ|jDcgc] }t|c}Scc}wz*Return ChildBrowserTreeItems for children.) listchildrenChildBrowserTreeItemr2r&s r GetSubListz ModuleBrowserTreeItem.GetSubLists+595F5F5HI5Hc$S)5HIIIs(ct|jsytjj |jsyt |jy)z6Open a module in an editor window when double clicked.N)rrmr r existsrIrcs r OnDoubleClickz#ModuleBrowserTreeItem.OnDoubleClicks4&tyy1 ww~~dii( $))rc,t|jS)zReturn True if Python file.)rrmrcs r IsExpandablez"ModuleBrowserTreeItem.IsExpandables&tyy11rcXt|jsgStjj |j\}}tjj |\}} t j||gtjz}t||S#t$rgcYSwxYw)z5Return sequenced classes and functions in the module.) rrmr r splitrrJ readmodule_exsys ImportErrorr*)r2dirbaserrtrees rrvz"ModuleBrowserTreeItem.listchildrens&tyy1IGGMM$)), T''""4(a ''sechh.>?D"$-- I s'(B B)(B)N) rfrgrhrir3rorsryr|r~rvrjrrreres+ +J2 .rrec4eZdZdZdZdZdZdZdZdZ y) rwzsBrowser tree for child nodes within the module. Uses TreeItem as the basis for the structure of the tree. cr||_|j|_t|tj|_y)z5Create a TreeItem for a pyclbr class/function object.N)r&rrrJFunction isfunctionrxs rr3zChildBrowserTreeItem.__init__s&HH $S&//:rcL|j}|jrd|zdzSd|zS)z1Return the name of the function/class to display.zdef z(...)zclass )rr)r2rs rrozChildBrowserTreeItem.GetTexts+yy ??D=7* *d? "rc|jryy)rqrrfolder)rrcs rrsz ChildBrowserTreeItem.GetIconNames ??rc4|jjik7S)z+Return True if self.obj has nested objects.)r&childrenrcs rr~z!ChildBrowserTreeItem.IsExpandablesxx  B&&rcxt|jjDcgc] }t|c}Scc}wru)r*r&rrwrxs rryzChildBrowserTreeItem.GetSubListsA.dhh.?.?@B@C%S)@B BBs7c t|jj}|j|jjy#t t f$rYywxYw)z2Open module with file_open and position to lineno.N)rIr&rmgotolinelinenoOSErrorAttributeError)r2edits rr|z"ChildBrowserTreeItem.OnDoubleClicksD TXX]]+D MM$((// *(   sAAAAN) rfrgrhrir3rorsr~ryr|rjrrrwrws& ; #'B rrwcttjdkDrtjd}nt}Gddt}d}t ||dy)Nr?ceZdZdZy)'_module_browser..Nested_in_funccyr rjrjrrnested_in_classz7_module_browser..Nested_in_func.nested_in_classs4rN)rfrgrhrrjrrNested_in_funcrs 'rrcGdd}y)Nc eZdZy);_module_browser..closure..Nested_in_closureN)rfrgrhrjrrNested_in_closurersrrrj)rs rclosurez _module_browser..closures ) )rT)r-)lenrargv__file__rr,)parentrmrrs r_module_browserrsA 388}qxx{ (X ( *&$t,r__main__r?)mainzidlelib.idle_test.test_browserF) verbosityexit)runr )rir rJridlelib.configridlelibr idlelib.treerrr idlelib.utilridlelib.windowr rIrrr*r,rerwrrfrrunittestridlelib.idle_test.htestrrjrrrs #;;&)  "+N @J0J0Z1.H1.h*8*Z - z 388}! -G+ r