
    g
%                        d dl Z d dlZd dlZd dlZd dlZd dlmZ d dlmZ d dlm	Z	 d dl
mZ d dlmZ d dlmZ d dlmZ d d	lmZ d d
lmZ d dlmZ d dlmZ d dlmZ d dlmZ  ej6                  e      Z G d de      Zy)    N)ABC)abstractmethod)IOBase)system)PIPE)sleep)Optional)cast)request)URLError)WebDriverException)SubprocessStdAlias)utilsc                      e Zd ZdZ	 	 	 	 	 ddedededej                  ej                  ej                  ej                  f      deddfd	Zedefd
       Zedej                  e   fd       Zedefd       Zej$                  deddfd       ZddZddZdefdZddZddZddZddZdeddfdZdee   fdZy)Servicea(  The abstract base class for all service objects.  Services typically
    launch a child program in a new process as an interim process to
    communicate with a browser.

    :param executable: install path of the executable.
    :param port: Port for the service to run on, defaults to 0 where the operating system will decide.
    :param log_output: (Optional) int representation of STDOUT/DEVNULL, any IO instance or String path to file.
    :param env: (Optional) Mapping of environment variables for the new process, defaults to `os.environ`.
    Nexecutable_pathport
log_outputenvdriver_path_env_keyreturnc                    t        |t              r"t        t        t	        |dd            | _        n|t        j                  k(  r>t        t        j                  t        j                  t        t        f      d       | _        nh||t        j                  k(  rLt        t        j                  t        j                  t        t        f      t        j                        | _        n|| _        |xs t        j                         | _        |j!                  di       | _        | j"                  j!                  dd      | _        |xs t&        j(                  | _        || _        | j/                         xs || _        y )Nza+zutf-8)encodingpopen_kwcreation_flagsr   )
isinstancestrr
   r   openr   
subprocessSTDOUTtypingr	   UnionintDEVNULLr   	free_portr   popr   r   osenvironr   DRIVER_PATH_ENV_KEYenv_path_path)selfr   r   r   r   r   kwargss          T/var/www/html/venv/lib/python3.12/site-packages/selenium/webdriver/common/service.py__init__zService.__init__3   s    j#&"64
D7+STDO:,,,"6??6<<V3L#MtTDO:1C1C#C"6??6<<V3L#MzOaOabDO(DO-EOO-	

:r2"mm//0@!D$"**#6 ]]_7
    c                 H    dt        j                  d| j                         S )zGets the url of the Service.zhttp://	localhost)r   join_host_portr   r,   s    r.   service_urlzService.service_urlM   s#     --k499EFGGr0   c                     t        d      )z7A List of program arguments (excluding the executable).z2This method needs to be implemented in a sub class)NotImplementedErrorr4   s    r.   command_line_argszService.command_line_argsR   s     ""VWWr0   c                 "    | j                   xs dS )N )r+   r4   s    r.   pathzService.pathW   s    zzRr0   valuec                 $    t        |      | _        y N)r   r+   )r,   r<   s     r.   r;   zService.path[   s    Z
r0   c                 *   | j                   t        d      | j                  | j                          d}	 | j                          | j	                         ryt        t        dd|z  z   d             |dz  }|dk(  rt        d	| j                          _)
zStarts the Service.

        :Exceptions:
         - WebDriverException : Raised either when it can't start the service
           or when it can't connect to the service
        NService path cannot be None.r   g{Gz?g?g      ?   F   zCan not connect to the Service )r+   r   _start_processassert_process_still_runningis_connectabler   min)r,   counts     r.   startzService.start_   s     ::$%CDDDJJ'--/""$#dTE\)3/0QJE{(+J4::,)WXX r0   c                 r    | j                   j                         }|rt        d| j                   d|       y)z1Check if the underlying process is still running.zService z' unexpectedly exited. Status code was: N)processpollr   r+   )r,   return_codes     r.   rD   z$Service.assert_process_still_runningu   s;    ll'')$x

|;bcnbo%pqq r0   c                 @    t        j                  | j                        S )zfEstablishes a socket connection to determine if the service running
        on the port is accessible.)r   rE   r   r4   s    r.   rE   zService.is_connectable{   s     ##DII..r0   c                     	 t        j                  | j                   d       t	        d      D ]  }| j                         s yt        d       ! y# t        $ r Y yw xY w)zcDispatch an HTTP request to the shutdown endpoint for the service in
        an attempt to stop it.z	/shutdownN   rA   )r   urlopenr5   r   rangerE   r   )r,   _s     r.   send_remote_shutdown_commandz$Service.send_remote_shutdown_command   s`    	OOt//0	:; r 	A&&(!H	  		s   "A 	AAc                    | j                   t        t        j                  hvrnt	        | j                   t
              r| j                   j                          n9t	        | j                   t              rt        j                  | j                          | j                  "	 | j                          | j                          yy# t        $ r Y w xY w)zStops the service.N)r   r   r   r$   r   r   closer#   r'   rJ   rS   	TypeError_terminate_processr4   s    r.   stopzService.stop   s     ??4););"<<$//62%%'DOOS1)<<#113 ##% $  s   C   	CCc                 *   	 | j                   j                  | j                   j                  | j                   j                  }}}|||fD ]  }	 |j	                           | j                   j                          	 | j                   j                  d       y# t
        $ r Y Xw xY w# t        j                  $ r4 t        j                  dd       | j                   j                          Y yw xY w# t        $ r t        j                  dd       Y yw xY w)a#  Terminate the child process.

        On POSIX this attempts a graceful SIGTERM followed by a SIGKILL,
        on a Windows OS kill is an alias to terminate.  Terminating does
        not raise itself if something has gone wrong but (currently)
        silently ignores errors here.
        <   zTService process refused to terminate gracefully with SIGTERM, escalating to SIGKILL.T)exc_infoz"Error terminating service process.N)rJ   stdinstdoutstderrrU   AttributeError	terminatewaitr   TimeoutExpiredloggererrorkillOSError)r,   r\   r]   r^   streams        r.   rW   zService._terminate_process   s    	N""#### "6E
  / LLN
 LL""$$!!"%	 & 
 ,, $j!   !!#$  	NLL=LM	NsU   A
C/ BC/ :B% 	B"C/ !B""C/ %AC,)C/ +C,,C/ / DDc                 D    	 | j                          y # t        $ r Y y w xY wr>   )rX   	Exceptionr4   s    r.   __del__zService.__del__   s"    	IIK 		s    	r;   c                    |g}|j                  | j                                | j                  j                  dt	               dk7        }	 d}t	               dk(  rOt        j                         }t
        j                  t
        j                  z  |_	        t
        j                  |_        t        j                  |f| j                  |t        t        j                   t        j"                  t$        t        j&                  t        j(                     f      | j*                        t        t        j                   t        j"                  t$        t        j&                  t        j(                     f      | j*                        t,        | j.                  |d| j                  | _        t2        j5                  d| j6                  | j0                  j8                  | j.                  | j*                         y# t:        $ r  t<        $ rq}|j>                  t>        j@                  k(  rN| j6                  tC        d      tC        dtD        jF                  jI                  | j6                         d      | d}~ww xY w)	zmCreates a subprocess by executing the command provided.

        :param cmd: full command to execute
        	close_fdsWindowsN)r   rl   r]   r^   r\   creationflagsstartupinfozNStarted executable: `%s` in a child process with pid: %s using %s to output %sr@   'z(' executable may have wrong permissions.)%extendr8   r   r&   r   r   STARTUPINFOCREATE_NEW_CONSOLESTARTF_USESHOWWINDOWdwFlagsSW_HIDEwShowWindowPopenr   r
   r!   r	   r"   r#   IOAnyr   r   r   rJ   rc   debugr+   pidrV   rf   errnoEACCESr   r'   r;   basename)r,   r;   cmdclose_file_descriptors
start_infoerrs         r.   rC   zService._start_process   s   
 f

4))+,!%!2!2;I@U!V"	Jx9$'335
%/%B%BZEdEd%d
")3););
&%++
HH0FOOFLLfii

>S9S,TUW[WfWfgFOOFLLfii

>S9S,TUW[WfWfg"11&
 --
DL LL`

  ##  	 	yyELL(::%,-KLL(((455]^ 	s   F$G0 0I3A,I..I3c                 B    t        j                  | j                  d       S r>   )r'   getenvr)   r4   s    r.   r*   zService.env_path   s    yy11488r0   )Nr   NNN)r   N)__name__
__module____qualname____doc__r   r#   r   r!   r	   Mappingrz   r/   propertyr5   r   Listr8   r;   setterrH   rD   boolrE   rS   rX   rW   rj   rC   r*    r0   r.   r   r   (   sM     $)-GK#'88 8 '	8
 __V^^FJJ

,BCD8 !8 
84 HS H H X6;;s#3 X X  c     
[[ #  $    Y,r/ /
& N>	*3 *4 *X9(3- 9r0   r   )r}   loggingr'   r   r!   abcr   r   ior   platformr   r   timer   r	   r
   urllibr   urllib.errorr   selenium.common.exceptionsr   selenium.typesr   selenium.webdriver.commonr   	getLoggerr   rc   r   r   r0   r.   <module>r      s]   "   	            ! 9 - +			8	$L9c L9r0   