a  ³Ša8ã@sldZddlmZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZddlmZmZmZddlmZddlmZdd lmZmZdd lmZmZdd lmZdd l m!Z!ed ƒZ"dZ#Gdd„dƒZ$Gdd„dƒZ%Gdd„dƒZ&ddgZ'z$ddlm(Z(difdd„Z)e)e_(Wne*y.Yn0Gdd„deƒZ+Gdd„deƒZ,dd„Z-e.d krhe-ƒdS)!z PyDoc widget. éN)ÚQtÚQThreadÚQUrlÚSignalÚSlot)ÚQCursor)Ú WEBENGINE)Ú QApplicationÚQLabelÚ QVBoxLayout)Úget_translation)ÚPluginMainWidget)Ú _start_serverÚ _url_handler)Ú FrameWebViewÚWebViewActions)Ú UrlComboBox)Ú FindReplaceZspyderi°uc@seZdZdZdZdS)ÚPydocBrowserActionsÚ home_actionÚ find_actionN)Ú__name__Ú __module__Ú __qualname__ÚHomeÚFind©rrú@lib/python3.9/site-packages/spyder/plugins/onlinehelp/widgets.pyr(src@seZdZdZdS)ÚPydocBrowserMainToolbarSectionsZ main_sectionN)rrrÚMainrrrrr.src@seZdZdZdZdS)ÚPydocBrowserToolbarItemsZ package_labelÚ url_comboN)rrrÚ PackageLabelÚUrlComborrrrr 2sr Znumpyz numpy.core)Ú safeimportcCs|tvr d}t|||dS)Nr)Ú forceloadÚcache)ÚDIRECT_PYDOC_IMPORT_MODULESr$)Úpathr%r&rrrÚspyder_safeimportAsr)c@sFeZdZdZeƒZdd„Zdd„Zdd„Zdd „Z d d „Z d d „Z dS)Ú PydocServerz Pydoc server. cCs&t |¡||_d|_d|_d|_dS)NF)rÚ__init__ÚportÚserverÚcompleteÚclosed)Úselfr,rrrr+Qs  zPydocServer.__init__cCs| ttd|jd¡dS)Nz 127.0.0.1)Zhostnamer,)Úcallbackrrr,©r0rrrÚrunYsýÿzPydocServer.runcCs$||_|jr| ¡n |j ¡dS©N)r-r/Ú quit_serverÚsig_server_startedÚemit)r0r-rrrr1bs zPydocServer.callbackcCs d|_dS©NT)r.r2rrrÚ completeriszPydocServer.completercCs"| ¡r dS|jdurdS|jjS)zCheck if the server is runningTNF)Ú isRunningr-Úservingr2rrrÚ is_runningls  zPydocServer.is_runningcCs*d|_|jdurdS|jjr&|j ¡dSr8)r/r-r;Ústopr2rrrr5ws  zPydocServer.quit_serverN) rrrÚ__doc__rr6r+r3r1r9r<r5rrrrr*Ks  r*cseZdZdZdZeƒZd<‡fdd„ Zdd„Zdd „Z d d „Z d d „Z dd„Z dd„Z dd„Zdd„Zdd„Zdd„Zdd„Zdd„Zeeƒd=dd„ƒZd d!„Zd"d#„Zd$d%„Zd&d'„Zd(d)„Zd*d+„Zd,d-„Zd.d/„Zd0d1„Zd2d3„Z eƒd4d5„ƒZ!d6d7„Z"d8d9„Z#eeƒd:d;„ƒZ$‡Z%S)>Ú PydocBrowserzPyDoc browser widget.TNcsztƒj|||ddˆ_dˆ_dˆ_ttdƒƒˆ_tj ˆj_ t ˆtj dˆ_ tˆˆ d¡dˆ_tˆƒˆ_ˆj ˆj¡ˆj ¡ˆj  ˆ d¡¡tdƒ}ˆj  ¡ |¡ˆj  ¡ |¡ˆj ¡ˆj ˆ d ¡¡tƒ}| ˆj¡| d ¡| ˆj¡ˆ |¡ˆj j  ‡fd d „¡ˆjj!  ˆj"¡ˆjj#  ˆj$¡ˆjj%  ˆj&¡ˆjj'  ˆj(¡t)svˆjj*  ˆj+¡dS) N)ÚparentFúPackage:)Zid_Ú handle_links)rBZmax_history_entriesz&Write a package name here, e.g. pandasZ zoom_factorécsˆ ¡Sr4)Ú_handle_url_combo_activation)Úxr2rrÚ³óz'PydocBrowser.__init__..),Úsuperr+Ú _is_runningÚhome_urlr-r Ú_Úlabelr r"ZIDrr#r!rZget_confÚwebviewrÚ find_widgetZ set_editorÚhideZ setMaxCountÚlineEditZsetPlaceholderTextZ setToolTipÚsetupZset_zoom_factorr Z addWidgetZ addSpacingZ setLayoutZvalidÚconnectZ loadStartedÚ_startZ loadFinishedÚ_finishZ titleChangedZsetWindowTitleZ urlChangedÚ _change_urlrZ iconChangedÚ_handle_icon_change)r0ÚnameÚpluginr@ÚtipZlayout©Ú __class__r2rr+ŒsH ÿþ        ÿzPydocBrowser.__init__cCstdƒS)Nz Online help©rKr2rrrÚ get_title¾szPydocBrowser.get_titlecCs|j ¡ ¡|jSr4)r!rPZ selectAllr2rrrÚget_focus_widgetÁszPydocBrowser.get_focus_widgetc Cs |jtjtdƒtdƒ| d¡|jd}|jtjtdƒtdƒ| d¡|jdd}| t j ¡}| t j ¡}|  ¡}| t j ¡| t j¡||||j|j| t j¡| t j¡|f D]}|j||tjd qª|jj |j¡| ¡ ¡D]\}}|rÞ|j |¡qÞ|j |j¡dS) NrÚhome)ÚtextrYÚiconZ triggeredrz Find textÚfindF)r`rYraZtoggledÚinitial)ÚtoolbarZsection) Z create_actionrrrKZ create_iconÚgo_homerÚtoggle_find_widgetÚ get_actionrÚStopÚRefreshZget_main_toolbarZBackZForwardrLr!ZZoomInZZoomOutZadd_item_to_toolbarrrrNZvisibility_changedrRZ setCheckedZ get_actionsÚitemsrMZ addActionÚsig_toggle_view_changedÚ initialize) r0rrÚ stop_actionÚrefresh_actionrdÚitemÚ__ÚactionrrrrQÅsDûú       üýzPydocBrowser.setupcCs6| tj¡}| tj¡}| |j ¡| |j¡dSr4)rgrrhriZ setVisiblerI)r0rmrnrrrÚupdate_actionsôs  zPydocBrowser.update_actionscCsd|_| ¡| ¡dS)zWebview load started.TN)rIZ start_spinnerrrr2rrrrSýszPydocBrowser._startcCs$d|_| ¡| ¡|j ¡dS)zWebview load finished.FN)rIZ stop_spinnerrrÚsig_load_finishedr7)r0ÚcoderrrrTszPydocBrowser._finishcCs| ¡t ¡dS)zLoad home page.N)rer ZrestoreOverrideCursorr2rrrÚ_continue_initialization sz%PydocBrowser._continue_initializationcCsF|js&t|j ¡ƒ}| | |¡¡n| tj¡  ¡|  ¡  ¡dS)z#Load URL from combo box first item.N) rIÚstrr!Z currentTextÚgo_toÚ text_to_urlrgrrhZtriggerr^ZsetFocus©r0r`rrrrDs z)PydocBrowser._handle_url_combo_activationcCs|j | |¡¡dS)zF Displayed URL has changed -> updating URL combo box. N)r!Zadd_textÚ url_to_text©r0ÚurlrrrrUszPydocBrowser._change_urlcCs.|j |j ¡|j ¡¡| |j ¡¡dS)z& Handle icon changes. N)r!Z setItemIconZ currentIndexrMraZ setWindowIconr2rrrrVsÿz PydocBrowser._handle_icon_changecCs|j ¡| ¡dSr4)r-r5Zaccept)r0ZeventrrrÚ closeEvent)s zPydocBrowser.closeEventcCs|j |¡dS)z€ Load history. Parameters ---------- history: list List of searched items. N)r!ZaddItems)r0ÚhistoryrrrÚ load_history/s zPydocBrowser.load_historycCs@|r<|jdur<|j |j¡t ttjƒ¡t  ¡|  ¡dS)a/ Start pydoc server. Parameters ---------- checked: bool, optional This method is connected to the `sig_toggle_view_changed` signal, so that the first time the widget is made visible it will start the server. Default is True. N) r-rkÚ disconnectrlr ZsetOverrideCursorrrZ WaitCursorZ processEventsÚ start_server)r0Úcheckedrrrrl:s zPydocBrowser.initializecCs |jduS)z/Return True if pydoc server is already running.N)r-r2rrrÚis_server_runningLszPydocBrowser.is_server_runningcCsj|jdur| d t¡¡n$|j ¡r@|jj |j¡|j ¡t td|_|jj  |j¡|j  ¡dS)zStart pydoc server.Nzhttp://127.0.0.1:{}/)r,) r-Ú set_home_urlÚformatÚPORTr:r6r€ruÚquitr*rRÚstartr2rrrrPs  ÿ  ÿzPydocBrowser.start_servercCs@|jdurdS|j ¡r<|jj |j¡|j ¡|j ¡dS)zQuit the server.N)r-r<r6r€rur5r‡r2rrrr5^s  ÿ zPydocBrowser.quit_servercCstdƒS)zReturn address label textrAr\r2rrrÚ get_labeliszPydocBrowser.get_labelcCs|jr|j ¡dS)z Reload page.N)r-rMÚreloadr2rrrrŠmszPydocBrowser.reloadcCs8|dkr|d7}| d¡r&|dd…}t|j ¡|ƒS)zŠ Convert text address into QUrl object. Parameters ---------- text: str Url address. ú about:blankz.htmlú/rCN)Ú startswithrrJÚtoStringryrrrrxrs   zPydocBrowser.text_to_urlcCsT| ¡}d|vrdSd|vs$d|vr6| ¡ d¡dSt t| ¡ƒ¡ddd…S) z— Convert QUrl object to displayed text in combo box. Parameters ---------- url: QUrl Url address. r‹zget?key=z search?key=ú=éÿÿÿÿrrCN)rŽÚsplitÚospÚsplitextrvr()r0r|Z string_urlrrrrzƒs zPydocBrowser.url_to_textcCst|ƒ|_dS)zv Set home URL. Parameters ---------- text: str Home url address. N)rrJryrrrr„”s zPydocBrowser.set_home_urlcCs| |¡| |¡dS)z{ Set current URL. Parameters ---------- url: QUrl or str Url address. N)rUrwr{rrrÚset_urlŸs zPydocBrowser.set_urlcCs(t|tƒrt|ƒ}n|}|j |¡dS)z! Go to page URL. N)Ú isinstancervrrMÚload)r0Z url_or_textr|rrrrw«s  zPydocBrowser.go_tocCs|jdur| |j¡dS)z" Go to home page. N)rJr”r2rrrre¶s zPydocBrowser.go_homecCs |j ¡S)zt Get the current zoom factor. Returns ------- int Zoom factor. )rMÚget_zoom_factorr2rrrr—¾s zPydocBrowser.get_zoom_factorcCs2g}t|j ¡ƒD]}| t|j |¡ƒ¡q|S)zŽ Return the list of history items in the combobox. Returns ------- list List of strings. )Úranger!ÚcountÚappendrvZitemText)r0r~ÚindexrrrÚ get_historyÉs zPydocBrowser.get_historycCs|r|j ¡n |j ¡dS)z£ Show/hide the find widget. Parameters ---------- state: bool True to show and False to hide the find widget. N)rNÚshowrO)r0ÚstaterrrrfØs  zPydocBrowser.toggle_find_widget)NNN)T)&rrrr>ZENABLE_SPINNERrrsr+r]r^rQrrrSrTrurDrUrVr}rrÚboolrlrƒrr5r‰rŠrxrzr„r”rwrer—rœrfÚ __classcell__rrrZrr?€sD2/           r?cCsdddlm}ddlm}|ƒ}d|_|dd}td|d}| ¡| ¡| ¡t   |  ¡¡dS) zRun web browser.r)Ú qapplication)Ú MagicMockZ onlinehelpé)Z test_timeN)rX) Zspyder.utils.qthelpersr¡Z unittest.mockr¢Z CONF_SECTIONr?Ú_setuprQrÚsysÚexitZexec_)r¡r¢Z plugin_mockZappZwidgetrrrÚtestès    r§Ú__main__)/r>Úos.pathr(r’Úpydocr¥Z qtpy.QtCorerrrrrZ qtpy.QtGuirZqtpy.QtWebEngineWidgetsrZqtpy.QtWidgetsr r r Zspyder.api.translationsr Zspyder.api.widgets.main_widgetr Z%spyder.plugins.onlinehelp.pydoc_patchrrZspyder.widgets.browserrrZspyder.widgets.comboboxesrZspyder.widgets.findreplacerrKr†rrr r'r$r)Ú Exceptionr*r?r§rrrrrÚs@          5j