G@dV9dZddlZddlmZddlZddlZddlmZm Z m Z m Z m Z ddl mZddlmZddlmZmZmZddlmZddlmZdd lmZdd lmZmZdd lmZm Z dd l!m"Z"dd l#m$Z$dZ%GddZ&GddZ'GddZ(ddgZ) ddlm*Z*difdZ+e+e_*n #e,$rYnwxYwer dej-d<Gdde Z.GddeZ/dZ0e1d kr e0dSdS)!z PyDoc widget. N)QtQThreadQUrlSignalSlot)QCursor) WEBENGINE) QApplicationQLabel QVBoxLayout_)PluginMainWidget) is_pynsist) _start_server _url_handler) FrameWebViewWebViewActions) UrlComboBox) FindReplaceiuceZdZdZdZdS)PydocBrowserActions home_action find_actionN)__name__ __module__ __qualname__HomeFindAlib/python3.11/site-packages/spyder/plugins/onlinehelp/widgets.pyrr&s D DDDr!rceZdZdZdS)PydocBrowserMainToolbarSections main_sectionN)rrrMainr r!r"r$r$,s DDDr!r$ceZdZdZdZdS)PydocBrowserToolbarItems package_label url_comboN)rrr PackageLabelUrlCombor r!r"r(r(0s"LHHHr!r(numpyz numpy.core) safeimportc<|tvrd}t|||S)Nr) forceloadcache)DIRECT_PYDOC_IMPORT_MODULESr.)pathr0r1s r"spyder_safeimportr4?s( . . .I$)5AAAAr!1PYDEVD_DISABLE_FILE_VALIDATIONcJeZdZdZeZdZdZdZdZ dZ dZ dS) PydocServerz Pydoc server. chtj||||_d|_d|_d|_dS)NF)r__init__portservercompleteclosed)selfparentr;s r"r:zPydocServer.__init__Ts5v&&&    r!cd|ttd|jdS)Nz 127.0.0.1)hostnamer;)callbackrrr;r?s r"runzPydocServer.run\s? $Y        r!c||_|jr|dS|jdSN)r<r> quit_serversig_server_startedemit)r?r<s r"rCzPydocServer.callbackesF ; +          # ( ( * * * * *r!cd|_dSNT)r=rDs r" completerzPydocServer.completerls  r!cX|rdS|jdS|jjS)zCheck if the server is runningTNF) isRunningr<servingrDs r" is_runningzPydocServer.is_runningos1 >>   4 ; 5{""r!ctd|_|jdS|jjr|jdSdSrL)r>r<rPstoprDs r"rHzPydocServer.quit_serverzsG ;  F ;   K         r!N) rrr__doc__rrIr:rErCrMrQrHr r!r"r8r8Ns    +++ # # #r!r8cJeZdZdZdZeZ d!fd ZdZdZ dZ dZ d Z d Z d Zd Zd ZdZfdZdZeed"dZdZdZdZdZdZdZdZdZdZdZ edZ!dZ"dZ#eed Z$xZ%S)# PydocBrowserzPyDoc browser widget.TNcZt|||d_d_d_t t d_tj j_ ttj _ td_jjdjjjjjjjjjjjjt8s$jjjt?_ j !jj "j #dt d }j $%|j $&|j j'fd tQ}|)j|*d |)j +|dS) N)r@FPackage:)id_ handle_links)rZ zoom_factormax_history_entriesz&Write a package name here, e.g. pandasc,SrG)_handle_url_combo_activation)xr?s r"z'PydocBrowser.__init__..sd7799r!),superr: _is_runninghome_urlr<r rlabelr(r+IDrr,r*rget_confwebviewsetupset_zoom_factor loadStartedconnect_start loadFinished_finish titleChangedsetWindowTitle urlChanged _change_urlr iconChanged_handle_icon_changer find_widget set_editorhide setMaxCountlineEditsetPlaceholderText setToolTipvalidr addWidget addSpacing setLayout)r?namepluginr@tiplayout __class__s` r"r:zPydocBrowser.__init__s vf555   AjMM** 0= $ .7999$ ~66      $$T]]=%A%ABBB  ((555 !))$,777 !))$*=>>> ''(8999 G L $ , ,T-E F F F't,, ##DL111  ""4==1F#G#GHHH899 !!44S999 !!,,S111 $$ 9 9 9 9 ; ; ;&&&!)*** vr!c tdS)Nz Online helpr rDs r" get_titlezPydocBrowser.get_titlesr!cf|j|jSrG)r*rz selectAllrDs r"get_focus_widgetzPydocBrowser.get_focus_widgets* !!++---~r!c |tjtdtd|d|j}|tjtdtd|d|jd}|tj }|tj }| }|tj |tj||||j|j|tj|tj|f D]$}|||t(j %|jj|j|D]3\}}|r, |j|##t<$rY/wxYw4|j|j dS) Nrhome)textricon triggeredrz Find textfindF)rrrtoggledinitial)toolbarsection)! create_actionrrr create_icongo_homertoggle_find_widget get_actionrStopRefreshget_main_toolbarBackForwardrer*ZoomInZoomOutadd_item_to_toolbarr$r&rvvisibility_changedrl setChecked get_actionsitemsrh addAction RuntimeErrorsig_toggle_view_changed initialize) r?rr stop_actionrefresh_actionritem__actions r"rizPydocBrowser.setups%((  $6& !!&))l )  ((  $6+!!&))+ )  oon&9:: )?@@''))__^%899__^%;<__^%:;;__^%;< updating URL combo box. N)r*add_text url_to_textr?urls r"rszPydocBrowser._change_urls.  0 0 5 566666r!c|j|j|j||jdS)z& Handle icon changes. N)r* setItemIcon currentIndexrhr setWindowIconrDs r"ruz PydocBrowser._handle_icon_change#sg ""4>#>#>#@#@#'<#4#4#6#6 8 8 8 4<,,../////r!c|jj|jr8|jj|j|t |dSrG) rh web_widgetrSr<finishedrl deleteLaterrHrb closeEvent)r?eventrs r"rzPydocBrowser.closeEvent-sp $$&&& ;  K ( ()9 : : :       5!!!!!r!c:|j|dS)z Load history. Parameters ---------- history: list List of searched items. N)r*addItems)r?historys r" load_historyzPydocBrowser.load_history6s  (((((r!Fc |o|jdu}|s|s|s`|j|jt jttj | dSdS)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. force: bool, optional Force a server start even if the server is running. Default is False. N) r<is_server_runningr disconnectrr setOverrideCursorrr WaitCursor start_server)r?checkedforce server_neededs r"rzPydocBrowser.initializeAs 7DK4$7  M )?)?)A)A  ( 3 3DO D D D  *72=+A+A B B B          r!cF|jduo|jS)z/Return True if pydoc server is already running.N)r<rQrDs r"rzPydocBrowser.is_server_runningVs"{$&C4;+A+A+C+CCr!c|j.|dtno|jrV|jj|j|j|j tdt|_|jj |j|j dS)zStart pydoc server.Nzhttp://127.0.0.1:{}/)r;) r< set_home_urlformatPORTrQrIrrquitwaitr8rlstartrDs r"rzPydocBrowser.start_serverZs ;    4;;DAA B B B B [ # # % %  K * 5 5- / / / K      K     !$T222  &..  ) + + + r!c,|jdS|jrq|jj|j|j|j|jdSdS)zQuit the server.N)r<rQrIrrrHrrrDs r"rHzPydocBrowser.quit_serveris ;  F ; ! ! # #  K * 5 5- / / / K # # % % % K      K          r!c tdS)zReturn address label textrXr rDs r" get_labelzPydocBrowser.get_labelus}}r!cJ|jr|jdSdS)z Reload page.N)r<rhreloadrDs r"rzPydocBrowser.reloadys0 ; " L   ! ! ! ! ! " "r!c|dkr|dz }|dr |dd}t|j|zS)z Convert text address into QUrl object. Parameters ---------- text: str Url address. about:blankz.html/raN) startswithrrdtoStringrs r"rzPydocBrowser.text_to_url~sZ = GOD ??3   8DDM**,,t3444r!c"|}d|vrdSd|vsd|vr-|ddStjt |dddS) z Convert QUrl object to displayed text in combo box. Parameters ---------- url: QUrl Url address. rzget?key=z search?key==rraN)rsplitospsplitextrr3)r?r string_urls r"rzPydocBrowser.url_to_texts\\^^ J & & = : % %*)D)D<<>>'',,R0 0|C OO,,Q/33r!c.t||_dS)zv Set home URL. Parameters ---------- text: str Home url address. N)rrdrs r"rzPydocBrowser.set_home_urlsT  r!cZ||||dS)z{ Set current URL. Parameters ---------- url: QUrl or str Url address. N)rsrrs r"set_urlzPydocBrowser.set_urls+  3r!ct|trt|}n|}|j|dS)z! Go to page URL. N) isinstancerrrhload)r? url_or_textrs r"rzPydocBrowser.go_tosF k3 ' ' {##CCC #r!cL|j||jdSdS)z" Go to home page. N)rdrrDs r"rzPydocBrowser.go_homes. = $ LL ' ' ' ' ' % $r!c4|jS)zt Get the current zoom factor. Returns ------- int Zoom factor. )rhget_zoom_factorrDs r"rzPydocBrowser.get_zoom_factors|++---r!cg}t|jD]<}|t |j|=|S)z Return the list of history items in the combobox. Returns ------- list List of strings. )ranger*countappendritemText)r?rindexs r" get_historyzPydocBrowser.get_historysb4>//1122 @ @E NN3t~66u==>> ? ? ? ?r!cr|r|jdS|jdS)z Show/hide the find widget. Parameters ---------- state: bool True to show and False to hide the find widget. N)rvshowrx)r?states r"rzPydocBrowser.toggle_find_widgetsB  $   ! ! # # # # #   ! ! # # # # #r!)NNN)TF)&rrrrTENABLE_SPINNERrrr:rrrirrmrorr^rsrurrrboolrrrrHrrrrrrrrrrr __classcell__)rs@r"rVrVs>N,,,,,,`   0>0>0>d111 &&&--- +++777 000""""" ) ) ) T$ZZ   Z (DDD      """ 555"444" # # #       TVV(( V( . . .    T$ZZ $ $Z $ $ $ $ $r!rVc>ddlm}ddlm}|}d|_|d}t d|}|||tj | dS) zRun web browser.r) qapplication) MagicMock onlinehelp) test_timeN)r) spyder.utils.qthelpersr unittest.mockr CONF_SECTIONrV_setuprir sysexitexec_)rr plugin_mockappwidgets r"testrs333333'''''')++K+K , # # #C ${ 3 3 3F MMOOO LLNNN KKMMMHSYY[[r!__main__)2rTosos.pathr3rpydocr qtpy.QtCorerrrrr qtpy.QtGuirqtpy.QtWebEngineWidgetsr qtpy.QtWidgetsr r r spyder.api.translationsrspyder.api.widgets.main_widgetrspyder.config.baser%spyder.plugins.onlinehelp.pydoc_patchrrspyder.widgets.browserrrspyder.widgets.comboboxesrspyder.widgets.findreplacerrrr$r(r2r.r4 Exceptionenvironr8rVrrr r!r"r1s   87777777777777------<<<<<<<<<<&%%%%%;;;;;;))))))MMMMMMMM????????111111222222    ' 5        *+2BBBB )E   D :<<736BJ/022222'222jn$n$n$n$n$#n$n$n$b    zDFFFFFsB))B10B1