Je69dZddlZddlmZddlZddlZddlmZm Z m Z m Z m Z ddl mZddlmZddlmZmZmZddlmZddlmZdd lmZmZdd lmZmZdd lm Z dd l!m"Z"d Z#GddZ$GddZ%GddZ&ddgZ' ddlm(Z(difdZ)e)e_(dejVd<Gdde Z,GddeZ-dZ.e/dk(re.yy#e*$rY=wxYw) z PyDoc widget. N)QtQThreadQUrlSignalSlot)QCursor) WEBENGINE) QApplicationQLabel QVBoxLayout_)PluginMainWidget) _start_server _url_handler) FrameWebViewWebViewActions) UrlComboBox) FindReplaceiuceZdZdZdZy)PydocBrowserActions home_action find_actionN)__name__ __module__ __qualname__HomeFindC/usr/lib/python3/dist-packages/spyder/plugins/onlinehelp/widgets.pyrr%s D Dr rceZdZdZy)PydocBrowserMainToolbarSections main_sectionN)rrrMainrr r!r#r#+s Dr r#ceZdZdZdZy)PydocBrowserToolbarItems package_label url_comboN)rrr PackageLabelUrlComborr r!r'r'/s "LHr r'numpyz numpy.core) safeimportc2|tvrd}t|||S)Nr) forceloadcache)DIRECT_PYDOC_IMPORT_MODULESr-)pathr/r0s r!spyder_safeimportr3>s . .I$)5AAr 1PYDEVD_DISABLE_FILE_VALIDATIONcBeZdZdZeZdZdZdZdZ dZ dZ y) PydocServerz Pydoc server. chtj||||_d|_d|_d|_y)NF)r__init__portservercompleteclosed)selfparentr:s r!r9zPydocServer.__init__Rs.v&    r cZ|jttd|jy)Nz 127.0.0.1)hostnamer:)callbackrrr:r>s r!runzPydocServer.runZs# $YY  r c||_|jr|jy|jj yN)r;r= quit_serversig_server_startedemit)r>r;s r!rBzPydocServer.callbackcs. ;;      # # ( ( *r cd|_yNT)r<rCs r! completerzPydocServer.completerjs  r cj|jry|jy|jjS)zCheck if the server is runningTF) isRunningr;servingrCs r! is_runningzPydocServer.is_runningms, >>  ;; {{"""r cd|_|jy|jjr|jjyyrK)r=r;rOstoprCs r!rGzPydocServer.quit_serverxs8 ;;   ;;   KK    r N) rrr__doc__rrHr9rDrBrLrPrGrr r!r7r7Ls/  + #r r7c eZdZdZdZeZ dfd ZdZdZ dZ dZ dZ d Z d Zd Zd Zd ZfdZdZeed dZdZdZdZdZdZdZdZdZdZdZ edZ!dZ"dZ#eedZ$xZ%S)! PydocBrowserzPyDoc browser widget.Tcrt|||d_d_d_t t d_tjj_ ttj_ tjd_j j#j j%jdj j&j)j*j j,j)j.j j0j)j2j j4j)j6t8s/j j:j)j<t?_ j@jCj j@jEjjGjdt d }jjIjK|jjIjM|jjNj)fd tQ}|jSj |jUd |jSj@jW|y) N)r?FPackage:)id_ handle_links)rY zoom_factormax_history_entriesz&Write a package name here, e.g. pandasc$jSrF)_handle_url_combo_activation)xr>s r!z'PydocBrowser.__init__..sd779r ),superr9 _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!r9zPydocBrowser.__init__sA vf5   AjM* 0== $ .779$ ~6    $$T]]=%AB   ((5 !!))$,,7 !!))$*=*=> ''(8(89 LL $ $ , ,T-E-E F't, ##DLL1  ""4==1F#GH89 !44S9 !,,S1 $$ 9 ;&!))* vr ctdS)Nz Online helpr rCs r! get_titlezPydocBrowser.get_titles r cj|jjj|jSrF)r)ry selectAllrCs r!get_focus_widgetzPydocBrowser.get_focus_widgets% !++-~~r c |jtjtdtd|j d|j }|jtj tdtd|j d|jd}|jtj}|jtj}|j}|jtj|jtj||||j|j |jtj"|jtj$|f D]$}|j'||t(j* &|j,j.j1|j2|j5j7D]$\}}|s |j8j;|&|j>j1|j@y#t<$rYXwxYw) Nrhome)textricon triggeredrz Find textfindF)rrrtoggledinitial)toolbarsection)! create_actionrrr create_icongo_homertoggle_find_widget get_actionrStopRefreshget_main_toolbarBackForwardrdr)ZoomInZoomOutadd_item_to_toolbarr#r%ruvisibility_changedrk setChecked get_actionsitemsrg addAction RuntimeErrorsig_toggle_view_changed initialize) r>rr stop_actionrefresh_actionritem__actions r!rhzPydocBrowser.setups((  $ $6& !!&)ll ) ((  $ $6+!!&)++ ) oon&9&9: )?)?@'')__^%8%89__^%;%;>__^%:%:;__^%;%;rrs r!update_actionszPydocBrowser.update_actionssUoon&9&9: )?)?@!!d&6&6"67t//0r cRd|_|j|jy)zWebview load started.TN)rb start_spinnerrrCs r!rlzPydocBrowser._starts"  r cd|_|j|j|jj y)zWebview load finished.FN)rb stop_spinnerrsig_load_finishedrI)r>codes r!rnzPydocBrowser._finishs4    ##%r cL|jtjy)zLoad home page.N)rr restoreOverrideCursorrCs r!_continue_initializationz%PydocBrowser._continue_initialization s **,r c:|jsDt|jj}|j |j |n-|j tjj|jjy)z#Load URL from combo box first item.N) rbstrr) currentTextgo_to text_to_urlrrrtriggerrsetFocusr>rs r!r]z)PydocBrowser._handle_url_combo_activationsit~~1134D JJt''- . OON// 0 8 8 : ((*r cX|jj|j|y)zF Displayed URL has changed -> updating URL combo box. N)r)add_text url_to_textr>urls r!rrzPydocBrowser._change_urls!  0 0 56r c|jj|jj|jj |j |jj y)z& Handle icon changes. N)r) setItemIcon currentIndexrgr setWindowIconrCs r!rtz PydocBrowser._handle_icon_change!sP ""4>>#>#>#@#'<<#4#4#6 8 4<<,,./r c|jjj|jr?|jjj |j |jt|%|yrF) rg web_widgetrRr;finishedrk deleteLaterrGra closeEvent)r>eventrs r!rzPydocBrowser.closeEvent+sW $$& ;; KK ( ()9)9 :     5!r c:|jj|y)z Load history. Parameters ---------- history: list List of searched items. N)r)addItems)r>historys r! load_historyzPydocBrowser.load_history4s (r c|xr|jdu}|s|s|jsb|jj|jt j ttj|jyy)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.initialize?sh 7DKK4$7 M)?)?)A  ( ( 3 3DOO D  * *72==+A B    *Br cV|jduxr|jjS)z/Return True if pydoc server is already running.N)r;rPrCs r!rzPydocBrowser.is_server_runningTs#{{$&C4;;+A+A+CCr c|j%|jdjtn}|jj rc|jj j |j|jj|jjtdt|_|jj j|j|jjy)zStart pydoc server.Nzhttp://127.0.0.1:{}/)r:) r; set_home_urlformatPORTrPrHrrquitwaitr7rkstartrCs r!rzPydocBrowser.start_serverXs ;;    4;;DA B [[ # # % KK * * 5 5-- / KK    KK   !$T2  &&..  ) ) + r cN|jy|jjr~|jjj|j|jj |jj |jjyy)zQuit the server.N)r;rPrHrrrGrrrCs r!rGzPydocBrowser.quit_servergsu ;;   ;; ! ! # KK * * 5 5-- / KK # # % KK    KK    $r ctdS)zReturn address label textrWr rCs r! get_labelzPydocBrowser.get_labelss }r cR|jr|jjyy)z Reload page.N)r;rgreloadrCs r!rzPydocBrowser.reloadws ;; LL   ! r c|dk7r|dz }|jdr|dd}t|jj|zS)z Convert text address into QUrl object. Parameters ---------- text: str Url address. about:blankz.html/r`N) startswithrrctoStringrs r!rzPydocBrowser.text_to_url|sI = GOD ??3 8DDMM**,t344r c|j}d|vryd|vsd|vr"|jjddStjt |j dddS) z Convert QUrl object to displayed text in combo box. Parameters ---------- url: QUrl Url address. rzget?key=z search?key==rr`N)rsplitospsplitextrr2)r>r string_urls r!rzPydocBrowser.url_to_textsj\\^ J & : %*)D<<>'',R0 0||C O,Q/33r c$t||_y)zv Set home URL. Parameters ---------- text: str Home url address. N)rrcrs r!rzPydocBrowser.set_home_urlsT  r cH|j||j|y)z{ Set current URL. Parameters ---------- url: QUrl or str Url address. N)rrrrs r!set_urlzPydocBrowser.set_urls  3r cvt|tr t|}n|}|jj |y)z! Go to page URL. N) isinstancerrrgload)r> url_or_textrs r!rzPydocBrowser.go_tos/ k3 '{#CC #r cT|j|j|jyy)z" Go to home page. N)rcrrCs r!rzPydocBrowser.go_homes# == $ LL ' %r c6|jjS)zt Get the current zoom factor. Returns ------- int Zoom factor. )rgget_zoom_factorrCs r!rzPydocBrowser.get_zoom_factors||++--r cg}t|jjD]5}|jt |jj |7|S)z Return the list of history items in the combobox. Returns ------- list List of strings. )ranger)countappendritemText)r>rindexs r! get_historyzPydocBrowser.get_historysS4>>//12 @E NN3t~~66u=> ? @r cr|r|jjy|jjy)z Show/hide the find widget. Parameters ---------- state: bool True to show and False to hide the find widget. N)rushowrw)r>states r!rzPydocBrowser.toggle_find_widgets+     ! ! #    ! ! #r )NNN)TF)&rrrrSENABLE_SPINNERrrr9rrrhrrlrnrr]rrrtrrrboolrrrrGrrrrrrrrrrr __classcell__)rs@r!rUrUsN,` 0>d1 &- +7 0" ) $Z  (D  " 5"4" #   V( ( .  $Z $ $r rUc ddlm}ddlm}|}d|_|d}t d|}|j |j|jtj|jy) zRun web browser.r) qapplication) MagicMock onlinehelp) test_timeN)r) spyder.utils.qthelpersr unittest.mockr CONF_SECTIONrU_setuprhr sysexitexec_)rr plugin_mockappwidgets r!testrsZ3'+K+K  #C ${ 3F MMO LLN KKMHHSYY[r __main__)0rSosos.pathr2rpydocr qtpy.QtCorerrrrr qtpy.QtGuirqtpy.QtWebEngineWidgetsr qtpy.QtWidgetsr r r spyder.api.translationsrspyder.api.widgets.main_widgetr%spyder.plugins.onlinehelp.pydoc_patchrrspyder.widgets.browserrrspyder.widgets.comboboxesrspyder.widgets.findreplacerrrr#r'r1r-r3 Exceptionenvironr7rUrrrr r!r/s   87-<<&;M?12    ' 5   *+2B )E 03 +,2'2jn$#n$b  zF{   sCCC