Wji^ h d Z ddlZddlZddlZddlZddlZddlZddlZg dZ G d de Z
ej Z i Z
dadad1dddZd1d Zd2d
Zd Zd Zddd
Z G d de Z G d de Z G d de Z G d de Z G d de Z G d de Z G d de Z e Z G d d e Z G d d e Z G d d!e Z! G d" d#e Z"d$ Z#d% Z$ejJ dd& d'k( r G d( d)e Z&ejJ d*k( r G d+ d,e Z' G d- d.e Z(d/ Z)e*d0k( r e) yy)3z?Interfaces for launching and remotely controlling web browsers. N)Erroropenopen_new open_new_tabgetregisterc e Zd Zy)r N)__name__
__module__ __qualname__ #/usr/lib64/python3.12/webbrowser.pyr r s r r F preferredc t 5 t
t ||gt | j < |st
r#| dt
k( rt j
d| nt j | ddd y# 1 sw Y yxY w)z Register a browser connector.Nz.desktopr )_lock _tryorderregister_standard_browsers _browserslower_os_preferred_browserinsertappend)nameklassinstancer s r r r se & (#(("3 $**,
.dV83DH]3] Q % T "
s A*A::Bc t t 5 t
t ddd | | g}nt }|D ]u }d|v r:t j | }|d dk( rt |dd c S t
| c S t |j }|d |d c S |d k |d c S t d # 1 sw Y xY w# t $ r t | }Y Lw xY w)zCReturn a browser launcher instance appropriate for the environment.N%s& r z!could not locate runnable browser) r r r shlexsplitBackgroundBrowserGenericBrowserr r KeyError _synthesizer )using alternativesbrowsercommands r r r & s
*,
w 7?kk'*Gr{c!(" 66%g..
/#GMMO4 qz% qz!'!wqz|## $ 3
443 U&
/%g.
/s B76C7C CCc t t 5 t
t ddd t D ]" }t | }|j | || s" y y# 1 sw Y 5xY w)az Display url using the default browser.
If possible, open url in a location determined by new.
- 0: the same browser window (the default).
- 1: a new browser window.
- 2: a new browser page ("tab").
If possible, autoraise raises the window (the default) or not.
If opening the browser succeeds, return True.
If there is a problem, return False.
NTF)r r r r r )urlnew autoraiser r+ s r r r H sS
*, d) <<S) , Us AAc t | d S )zuOpen url in a new window of the default browser.
If not possible, then open url in the only browser window.
r" r r. s r r r ^
Q<r c t | d S )zOpen url in a new page ("tab") of the default browser.
If not possible, then the behavior becomes equivalent to open_new().
r2 r3 s r r r e r4 r c | j d }t j | sddgS t j j | } t |j }|d }|rp|j |j
k( rSddl }|j | }| |_
t j j | |_ t | d|| d|gS ddgS # t $ r ddgcY S w xY w)a Attempt to synthesize a controller based on existing controllers.
This is useful to create a controller when a user specifies a path to
an entry in the BROWSER environment variable -- we can copy a general
controller to operate using a specific installation of the desired
browser in this way.
If we can't create a controller in this way, or if there is no
executable for the requested browser, return [None, None].
r Nr" )r r ) r$ shutilwhichospathbasenamer r r' copyr r )r+ r cmdr r,
controllerr= s r r( r( m s --/!
C << d|
77 C D DJJL) Jdjjlj&9&99YYz*
!
gg . .w 7
$yIj!! $< d| s
C
C/.C/c B e Zd ZdZdgZd dZd
dZd Zd Ze d Z
y) BaseBrowserz3Parent class for all browsers. Do not use directly.r c || _ || _ y N)r r< selfr s r __init__zBaseBrowser.__init__ s
r c t rC )NotImplementedErrorrE r. r/ r0 s r r zBaseBrowser.open s !!r c & | j |d S )Nr" r2 rE r. s r r zBaseBrowser.open_new yya r c & | j |d S )Nr6 r2 rK s r r zBaseBrowser.open_new_tab rL r c d | r.| j j d rt d| yy)zCEnsures that the URL is safe to pass to subprocesses as a parameter-z
Invalid URL: N)lstrip
startswith
ValueErrorr3 s r
_check_urlzBaseBrowser._check_url s3 3::<**3/ }SE 23 3 03r N) r T) r
r r __doc__argsrF r r r staticmethodrS r
r r rA rA s4 = 6D "!! 4 4r rA c e Zd ZdZd ZddZy)r& zVClass for all browsers started with a command
and without remote functionality.c t |t r|| _ dg| _ n|d | _ |dd | _ t j
j
| j | _ y )Nr r r" )
isinstancestrr rW r: r; r< rD s r rF zGenericBrowser.__init__ sP dC DI DI QDI QRDI((3
r c t j d| | j | | j g| j D cg c] }|j d| c}z } t j d d dk( rt j | }nt j |d }|j S c c}w # t $ r Y yw xY w)Nwebbrowser.openr winT) close_fdsF) sysauditrS r rW replaceplatform
subprocessPopenwaitOSErrorrE r. r/ r0 argcmdlineps r r zGenericBrowser.open s #S) 99+,0II!7,5S "%T3!7,5!7 7 ||BQ 5( $$W- $$W=vvx< !7 s B5!AB: : CCNrU r
r r rV rF r r
r r r& r& s ,4 r r& c e Zd ZdZddZy)r% zHClass for all browsers which are to be started in the
background.c | j g| j D cg c] }|j d| c}z }t j d| | j | t j d d dk( rt j | }nt j |dd }|j d u S c c}w # t $ r Y yw xY w)Nr r^ r_ r` T)ra start_new_sessionF) r rW rd rb rc rS re rf rg pollri rj s r r zBackgroundBrowser.open s 99+,0II!7,5S "%T3!7,5!7 7 #S) ||BQ 5( $$W- $$W7;=FFH$ %!7 s B7!AB< < CCNrU r
r r rV r r
r r r% r% s
r r% c @ e Zd ZdZdZdZdZddgZdZdZ dZ
d dZ d
dZ y) UnixBrowserz=Parent class for all Unix browsers with remote functionality.NFT%actionr c g }|r+| j r t | }| j | }|r|g}| j g|z |z }|s | j rt j
}nd }t j |d|| j xr |xs d |d } |r | j d }
|
S | j r| j yy| j S # t j $ r Y yw xY w)NTra stdinstdoutstderrrq F)
raise_optsintr
backgroundrf DEVNULLrg redirect_stdoutrh TimeoutExpiredrr ) rE rW remoter0 r. raise_optoptrl inoutrm rcs r _invokezUnixBrowser._invoke s dooII//),CI99+ )D0 T__ &&E E WE%)%9%9%Ce%Kt$)T
C
VVAY v
__vvx vvx< ,,
s C C-,C-c t j d| |dk( r
| j }nN|dk( r
| j }n<|dk( r&| j
| j }n | j }nt dd|z z | j
|j d| | j D cg c]$ }|j d| j d| & }}|D cg c] }|s| }}| j |d || }|s<| j D cg c] }|j d| }}| j |d
d
S y c c}w c c}w c c}w ) Nr^ r r" r6 z Bad 'new' parameter to open(); zexpected 0, 1, or 2, got %srv r TF) rb rc
remote_actionremote_action_newwinremote_action_newtabr rS rd remote_argsr rW )rE r. r/ r0 actionrk rW successs r r zUnixBrowser.open
sH #S) !8''F
AX..F
AX((0 22 2295;< =
=
Iv67 ++-+C Iv.66tSA+
- #+tst+,,tT9c:6:ii@isCKKc*iD@<<eU3 3-+ As &)D6D; D;E rC rU )
r
r r rV r} r r r r r r r r r
r r ru ru s< GJJO d#KM ! Fr ru c ( e Zd ZdZddgZdZdZdZdZy) Mozillaz$Launcher class for Mozilla browsers.rv r rT z -new-windowz-new-tabTN r
r r rV r r r r r r
r r r r * s% . d#KM(%Jr r c , e Zd ZdZddgZddgZdZdZdZy )
Epiphanyz$Launcher class for Epiphany browser.z-noraiserT rv r -nz-wTN) r
r r rV r} r r r r r
r r r r 4 s) . b!J d#KM Jr r c ( e Zd ZdZddgZdZdZdZdZy)Chromez)Launcher class for Google Chrome browser.rv r rT --new-windowTNr r
r r r r > s% / d#KM) Jr r c ( e Zd ZdZddgZdZdZdZdZy)Operaz!Launcher class for Opera browser.rv r rT r TNr r
r r r r J s% ' d#KM) Jr r c , e Zd ZdZddgZdZdZdZdZdZ y) Elinksz#Launcher class for Elinks browsers.z-remotezopenURL(%s%action)rT z ,new-windowz,new-tabFN)
r
r r rV r r r r r r r
r r r r T s- ) 23KM(%J Or r c e Zd ZdZddZy) KonquerorzController for the KDE File Manager (kfm, or Konqueror).
See the output of ``kfmclient --commands``
for more information on the Konqueror remote-control interface.
c t j d| | j | |dk( rd}nd}t j } t j
d||gd||| }|j
y# t $ r Y nw xY w t j
dd |gd|||d
}|j y# t $ r Y nw xY w t j
d d |gd|||d
}|j d u S # t $ r Y y
w xY w)Nr^ r6 newTabopenURL kfmclientT)ra ry rz r{ konquerorz--silentrx kfmz-dF) rb rc rS rf r rg rh ri rr )rE r. r/ r0 r devnullrm s r r zKonqueror.openi s& #S) !8 F F $$
+vs!;+/w(/AA
FFH
+z3!?+/w(/379A vvx
& %s!3+/w(/379A FFH$ % s6 A1 1 A=<A= B0 0 B<;B< C0 0 C<;C<NrU rs r
r r r r b s ,&r r c ( e Zd ZdZddgZdZdZdZdZy)Edgez*Launcher class for Microsoft Edge browser.rv r rT r TNr r
r r r r s% 0 d#KM) Jr r c t j d rt dd t d t j d rt dd t g d dt j
v r+t j d rt dd t d dt j
v r/t j d rt dt t
d t j d rt dd t d d D ]. } t j | st | d t | 0 t j d
rt d
t t
d
n/t j d rt d t t
d t j d rt d d t d d
D ]. } t j | st | d t | 0 t j d rt dd t d t j d rt dd t d y y )Nzxdg-opengio)r r z--r GNOME_DESKTOP_SESSION_IDz gvfs-openKDE_FULL_SESSIONr z
x-www-browser)firefox iceweasel seamonkeyzmozilla-firefoxmozillar r epiphany)z
google-chromechromechromiumzchromium-browseroperamicrosoft-edge) r8 r9 r r% r: environr r r r r r )r+ s r register_X_browsersr s ||J T#4Z#@A ||E /0K LM "RZZ/FLL4Md$5k$BC RZZ'FLL,Ei;)?@ ||O$ $(9/(JK << WdGG$4 5 ||E 9U#34 k "i;)?@ ||J T8J#78 O << WdF7O 4 O
||G $g/ ||$%!4.>)?@ &r c g a t j dk( rXt dd t d t dd t d t dd t d t dd t d t j dk( rt dd t d t j d d d
k( rt d t t j j t j j d d
d } t j j t j j dd d }ddddd| |fD ]. }t j | st |d t | 0 t j d rt dd t d nt j j d s t j j d r` dj }t! j" |t j$ }|j' j) }|at5 t j j d rt j d rt dd t7 d t j d rt d d t7 d t j d rt d d t9 d t j d rt d d t7 d t j d rt d d t7 d d t j v ryt j d j t j: }|j= |D ]3 }|d!k7 s t? |d"# }|d$ t |d t7 | d"# 5 y y # t, t j. t0 t2 f$ r Y w xY w)%NdarwinMacOSXdefaultr r safari
serenityosBrowserr_ r` zwindows-defaultzPROGRAMFILES(x86)zC:\Program Files (x86)z%Microsoft\Edge\Application\msedge.exe PROGRAMFILESzC:\Program Filesr r r zMicrosoftEdge.exer DISPLAYWAYLAND_DISPLAYz$xdg-settings get default-web-browser)r{ TERMz www-browserlinkselinkslynxw3mBROWSERrT Tr r" ) r rb re r MacOSXOSAScriptr% WindowsDefaultr: r; joinr r r8 r9 r r$ rf check_outputr decodestripr FileNotFoundErrorCalledProcessErrorPermissionErrorNotADirectoryErrorr r& r pathsepreverser( )edge64edge32r+ r>
raw_resultresult userchoicesrl s r r r s I
||x 4 !;<4 !:;D/)"<=4 !:; |||#D"3I">?
||BQ5 "N3 bjjnn-@B[ \ HJ bjjnn^=P Q HJ!; 8 1G||G$$(9'(BC1 <<+ , %tT2E-F G ::>>) $
7H(I
/<BBD ' 4 4SASAS T
#**,224
)/% ! ::>>& !||M* n].KL||G$$w(?@||H%4)9:||F#~f'=>||E"nU&;< BJJ jj+11"**= #G"}!'T:q6> WdN7,CtT #
7 &z'D'DoWij
s AO #O('O(r_ r` c e Zd ZddZy)r c t j d| | j | t j | y# t
$ r Y yw xY w)Nr^ TF)rb rc rS r: startfileri rI s r r zWindowsDefault.open6 sI II' - OOC
S!
s ? A
A NrU )r
r r r r
r r r r 5 s
r r r c e Zd ZdZd ZddZy)r a{ Launcher class for Aqua browsers on Mac OS X
Optionally specify a browser name on instantiation. Note that this
will not work for Aqua browsers if the user has moved the application
package after installation.
If no browser is specified, the default browser, as specified in the
Internet System Preferences panel, will be used.
c x t j | j j dt d || _ y )Nz3 is deprecated in 3.11 use MacOSXOSAScript instead.r6
stacklevelwarningswarn __class__r
DeprecationWarningr rD s r rF zMacOSX.__init__R s5 MMT^^ 4 4 5 6: :;MZ[
] DIr c t j d| d|vrd|z }t t | }| j dk( rd|j dd z }nE| j dk( rd }nd
|d z
z }d |j dd z }d
| j d|d|d}t
j dd }|y|j | |j }| S )Nr^ :zfile:r open location "%s""%22OmniWebrT z toWindow %dr" z OpenURL "%s"ztell application "zK"
activate
z%
end tell osascriptwF)
rb rc r~ boolr rd r: popenwriteclose) rE r. r/ r0 scripttoWindowr> osapiper s r r z MacOSX.openW s II' - #: ck d3i.CyyI%- C0GG 99 ) !H -a 8H$s{{3'>> ,099c8E
hh{C0G MM& ! B6Mr NrU rn r
r r r r H s
r r c \ e Zd Zd fd Zed Zej d ZddZ xZS )r c $ t | | y rC )superrF )rE r r s r rF zMacOSXOSAScript.__init__z s G T "r c t j | j j d| j j dt d | j
S Nz!._name is deprecated in 3.11 use z.name instead.r6 r r )rE s r _namezMacOSXOSAScript._name} sK MMT^^ 4 4 5 6""&.."9"9!:.J,
< 99 r c t j | j j d| j j dt d || _ y r r )rE vals r r zMacOSXOSAScript._name sH MMT^^ 4 4 5 6""&.."9"9!:.J,
< DIr c V t j d| | j | | j dk( rd|j dd z }n!d| j |j dd fz }t j dd }|y |j | |j }| S )
Nr^ r r r r z
tell application "%s"
activate
open location "%s"
end
r r F) rb rc rS r rd r: r r r )rE r. r/ r0 r r r s r r zMacOSXOSAScript.open s II' - OOC yyI%- C0GG
3;;sE#:; < hh{C0G MM& ! B6Mr )r rU ) r
r r rF propertyr setterr
__classcell__)r s @r r r y s9 #
r r c dd l } dt j d z } | j t j dd ddg \ }}d}D ]O \ }}|dk( rd}|dk( rd }|d
k( s|d k( s!t |t j
t j Q t dk7 r0t |t j
t j d |d }t || t d y # | j $ rV}t |t j
t |t j
t j d Y d }~d }~ww xY w)
Nr zcUsage: %s [-n | -t | -h] url
-n: open new window
-t: open new tab
-h, --help: show helpr" ntdhhelp)filer z-tr6 z-hz--help) getoptrb argverrorprintr{ exitlenr ) r usageoptsrW msgnew_winoar. s r mainr s
#xx{
+E]]388AB<A
d
G1 9g
$Y!
$Y!x- %cjj ) HHJ 4yA~
e#**%
q'Cg $K% <<
c
#
e#**% s (C5 5EA EE__main__rC rU )+rV r: r# r8 rb rf threadingr __all__ Exceptionr RLockr r r r r r r r r r( objectrA r& r% ru r r r Chromiumr r r r r r re r r r r r
r
r r r s| E
J I
#e
# 5D, ', D4& 42[ : (N+ Nbk { [ K [ 3& 3&l; "2AjMUl <<u " <<8/ /b%+ %P8 zF r