wgebddlZddlZddlmZddlmZddlmZGddej Zy)N) base_client) exceptions)packetceZdZdZidddddddfdZdZdd Zdd Zdd Zd Z d Z dZ d dZ dZ dZdZdZdZdZdZdZdZdZdZdZdZy)!ClientaMA Socket.IO client. This class implements a fully compliant Socket.IO web client with support for websocket and long-polling transports. :param reconnection: ``True`` if the client should automatically attempt to reconnect to the server after an interruption, or ``False`` to not reconnect. The default is ``True``. :param reconnection_attempts: How many reconnection attempts to issue before giving up, or 0 for infinite attempts. The default is 0. :param reconnection_delay: How long to wait in seconds before the first reconnection attempt. Each successive attempt doubles this delay. :param reconnection_delay_max: The maximum delay between reconnection attempts. :param randomization_factor: Randomization amount for each delay between reconnection attempts. The default is 0.5, which means that each delay is randomly adjusted by +/- 50%. :param logger: To enable logging set to ``True`` or pass a logger object to use. To disable logging set to ``False``. The default is ``False``. Note that fatal errors are logged even when ``logger`` is ``False``. :param serializer: The serialization method to use when transmitting packets. Valid values are ``'default'``, ``'pickle'``, ``'msgpack'`` and ``'cbor'``. Alternatively, a subclass of the :class:`Packet` class with custom implementations of the ``encode()`` and ``decode()`` methods can be provided. Client and server must use compatible serializers. :param json: An alternative json module to use for encoding and decoding packets. Custom json modules must have ``dumps`` and ``loads`` functions that are compatible with the standard library versions. :param handle_sigint: Set to ``True`` to automatically handle disconnection when the process is interrupted, or to ``False`` to leave interrupt handling to the calling application. Interrupt handling can only be enabled when the client instance is created in the main thread. The Engine.IO configuration supports the following settings: :param request_timeout: A timeout in seconds for requests. The default is 5 seconds. :param http_session: an initialized ``requests.Session`` object to be used when sending requests to the server. Use it if you need to add special client options such as proxy servers, SSL certificates, custom CA bundle, etc. :param ssl_verify: ``True`` to verify SSL certificates, or ``False`` to skip SSL certificate verification, allowing connections to servers with self signed certificates. The default is ``True``. :param websocket_extra_options: Dictionary containing additional keyword arguments passed to ``websocket.create_connection()``. :param engineio_logger: To enable Engine.IO logging set to ``True`` or pass a logger object to use. To disable logging set to ``False``. The default is ``False``. Note that fatal errors are logged even when ``engineio_logger`` is ``False``. Nz socket.ioTrFc n|jrtjd||_||_||_||_||_||_|tt|jjjt|jj}d|vr|jdt!|dk(rdg}nt#|t$r|g}||_i|_|j( |j*j-|_n|j(j/|j1|j} |j1|j} |j*j3| | |||r|j(j?| rc|j(j/t|j&t|jk(rn|j(j?| rct|j&t|jk7r%|jAtjd d |_y#t4jj$r} |jD]I} |j7d| t!| j8dkDr| j8dn| j8dK| r.|j;|j*j<d k(rYd} ~ ytj| j8ddd} ~ wwxYw) a0 Connect to a Socket.IO server. :param url: The URL of the Socket.IO server. It can include custom query string parameters if required by the server. If a function is provided, the client will invoke it to obtain the URL each time a connection or reconnection is attempted. :param headers: A dictionary with custom headers to send with the connection request. If a function is provided, the client will invoke it to obtain the headers dictionary each time a connection or reconnection is attempted. :param auth: Authentication data passed to the server with the connection request, normally a dictionary with one or more string key/value pairs. If a function is provided, the client will invoke it to obtain the authentication data each time a connection or reconnection is attempted. :param transports: The list of allowed transports. Valid transports are ``'polling'`` and ``'websocket'``. If not given, the polling transport is connected first, then an upgrade to websocket is attempted. :param namespaces: The namespaces to connect as a string or list of strings. If not given, the namespaces that have registered event handlers are connected. :param socketio_path: The endpoint where the Socket.IO server is installed. The default value is appropriate for most cases. :param wait: if set to ``True`` (the default) the call only returns when all the namespaces are connected. If set to ``False``, the call returns as soon as the Engine.IO transport is connected, and the namespaces will connect in the background. :param wait_timeout: How long the client should wait for the connection. The default is 1 second. This argument is only considered when ``wait`` is set to ``True``. :param retry: Apply the reconnection logic if the initial connection attempt fails. The default is ``False``. Example usage:: sio = socketio.Client() sio.connect('http://localhost:5000') zAlready connectedN*r/)headers transports engineio_path connect_errorr connectedtimeoutz(One or more namespaces failed to connectT)!rrConnectionErrorconnection_urlconnection_headersconnection_authconnection_transportsconnection_namespaces socketio_pathlistsethandlerskeysunionnamespace_handlersremovelen isinstancestr namespaces_connect_eventeio create_eventclear_get_real_valueconnectengineio_trigger_eventargs_handle_reconnectstatewait disconnect)selfurlr authr r$rr0 wait_timeoutretryreal_url real_headersexcns T/home/mcse/projects/flask/flask-venv/lib/python3.12/site-packages/socketio/client.pyr*zClient.connectIs\ >>,,-@A A!")#%/"%/"*  c$--"4"4"67==D++002356Jj !!#&:!#!U  C ($J%/"    &"&(("7"7"9D     % % '''(;(;<++D,C,CD  D HH  X|(2+8  : %%**<*@##))+t'3t/I/I+JJ%%**<*@4??#s4+E+E'FF! 00>@@+""22 D// G###Q#&sxx=1#4CHHQK#((1+G G&&(88>>[0,,SXXa[9t C Ds/I''L4BL/ #L//L4c |jj|jd|js|jjdk(rRy|jj |jjdk7ry)zWait until the connection with the server ends. Client applications can use this function to block the main thread during the life of the connection. rrN)r&r0sleep_reconnect_taskr/joinr2s r;r0z Client.waitsj  HHMMO JJqM''88>>[0  % % 'xx~~,cx|xsd}||jvrtj|dz|jj d||||j ||}nd}t |tr t|}n||g}ng}|j|jtj||g|z|y)a/Emit a custom event to the server. :param event: The event name. It can be any string. The event names ``'connect'``, ``'message'`` and ``'disconnect'`` are reserved and should not be used. :param data: The data to send to the server. Data can be of type ``str``, ``bytes``, ``list`` or ``dict``. To send multiple arguments, use a tuple where each element is of one of the types indicated above. :param namespace: The Socket.IO namespace for the event. If this argument is omitted the event is emitted to the default namespace. :param callback: If given, this function will be called to acknowledge the server has received the message. The arguments that will be passed to the function are those provided by the server. Note: this method is not thread safe. If multiple threads are emitting at the same time on the same client connection, messages composed of multiple packets may end up being sent in an incorrect sequence. Use standard concurrency solutions (such as a Lock object) to prevent this situation. r z is not a connected namespace.zEmitting event "%s" [%s]N) namespacedataid) r$rBadNamespaceErrorloggerinfo_generate_ack_idr"tupler _send_packet packet_classrEVENT)r2eventrDrCcallbackrEs r;emitz Client.emits0$ DOO +..<<> > 3UIF  &&y(;BB dE ":D  6DD $++FLLI274B,H IrAc.|jd|||y)aSend a message to the server. This function emits an event with the name ``'message'``. Use :func:`emit` to issue custom event names. :param data: The data to send to the server. Data can be of type ``str``, ``bytes``, ``list`` or ``dict``. To send multiple arguments, use a tuple where each element is of one of the types indicated above. :param namespace: The Socket.IO namespace for the event. If this argument is omitted the event is emitted to the default namespace. :param callback: If given, this function will be called to acknowledge the server has received the message. The arguments that will be passed to the function are those provided by the server. messagerDrCrON)rP)r2rDrCrOs r;sendz Client.sends$ )$)#  %rAc"|jjgfd}|j||||j|st j t ddkDrdSt ddk(rddSdS)aZEmit a custom event to the server and wait for the response. This method issues an emit with a callback and waits for the callback to be invoked before returning. If the callback isn't invoked before the timeout, then a ``TimeoutError`` exception is raised. If the Socket.IO connection drops during the wait, this method still waits until the specified timeout. :param event: The event name. It can be any string. The event names ``'connect'``, ``'message'`` and ``'disconnect'`` are reserved and should not be used. :param data: The data to send to the server. Data can be of type ``str``, ``bytes``, ``list`` or ``dict``. To send multiple arguments, use a tuple where each element is of one of the types indicated above. :param namespace: The Socket.IO namespace for the event. If this argument is omitted the event is emitted to the default namespace. :param timeout: The waiting timeout. If the timeout is reached before the server acknowledges the event, then a ``TimeoutError`` exception is raised. Note: this method is not thread safe. If multiple threads are emitting at the same time on the same client connection, messages composed of multiple packets may end up being sent in an incorrect sequence. Use standard concurrency solutions (such as a Lock object) to prevent this situation. cHj|jyN)appendr)r- callback_argscallback_events r;event_callbackz#Client.call..event_callback"s   &    rArSrrrN)r&r'rPr0r TimeoutErrorr!)r2rNrDrCrr[rYrZs @@r;callz Client.calls:..0  ! %di)  +""7"3))+ +#&}Q'7#81#<}Q (+M!,<(=(Bq!!$  rAc|jD]2}|j|jtj|4|j j dy)zDisconnect from the server.rCTabortN)r$rKrLr DISCONNECTr&r1)r2r:s r;r1zClient.disconnect.sY 1A   d//!!Q00 1 1 $'rAc|jr|jy|jr5|jj |jj yy)aAStop the client. If the client is connected to a server, it is disconnected. If the client is attempting to reconnect to server, the reconnection attempts are stopped. If the client is not connected to a server and is not attempting to reconnect, then this function does nothing. N)rr1r>_reconnect_abortrr?r@s r;shutdownzClient.shutdown7sG >> OO   ! !  ! ! % % '  % % '"rAcB|jj|g|i|S)aOStart a background task using the appropriate async model. This is a utility function that applications can use to start a background task using the method that is compatible with the selected async mode. :param target: the target function to execute. :param args: arguments to pass to the function. :param kwargs: keyword arguments to pass to the function. This function returns an object that represents the background task, on which the ``join()`` methond can be invoked to wait for the task to complete. )r&start_background_task)r2targetr-kwargss r;rgzClient.start_background_taskEs%.txx--fFtFvFFrAc8|jj|S)aSleep for the requested amount of time using the appropriate async model. This is a utility function that applications can use to put a task to sleep without having to worry about using the correct call for the selected async mode. )r&r=)r2secondss r;r=z Client.sleepVsxx~~g&&rAc*t|s|S|S)zTReturn the actual value, for parameters that can also be given as callables.)callable)r2values r;r)zClient._get_real_value`sLwrAc|j}t|tr#|D]}|jj |y|jj |y)z&Send a Socket.IO packet to the server.N)encoder"rr&rT)r2pktencoded_packeteps r;rKzClient._send_packetgsH nd +$ " b! " HHMM. )rAc |xsd}||jvrz|jjd|d|xsijd|j|j|<|j d||j jyy)Nr z Namespace z is connectedsidr*r_)r$rGrHgetrur,r%rr2rCrDs r;_handle_connectzClient._handle_connectps$ DOO + KK  z)MB C*.*")9)9%)JDOOI &    Y  ?    # # % ,rAc2|jsy|xsd}|jd||jj|jd|||jvr |j|=|js$d|_|j j dyy)Nr r1__disconnect_finalFTr`)rr,reasonSERVER_DISCONNECTr$r&r1)r2rCs r;_handle_disconnectzClient._handle_disconnectxs~~ $  L) KK99 ; 0)<  ' *"DN HH  d  +rAc6|xsd}|jjd|d||j|d|g|dd}|W|g}nt|tr t |}n|g}|j |jtj|||yy)Nr zReceived event "%s" [%s]rr)rCrErD) rGrHr,r"rJrrKrLrACK)r2rCrErDrs r; _handle_eventzClient._handle_events$  3T!WiH D  Q >T!"X > >yAu%Aws   d// iBT0C D rAc|xsd}|jjd|d} |j||}|j||=|||yy#t$r|jj dY/wxYw)Nr zReceived ack [%s]z$Unknown callback received, ignoring.)rGrH callbacksKeyErrorwarning)r2rCrErDrOs r; _handle_ackzClient._handle_acks$  ,i8 .~~i04H y)"-   dO  H KK   F G HsA$A87A8cj|xsd}|jjdj|| t}nt |tt fs|f}|j d|g||jj||jvr |j|=|dk(ri|_ d|_ yy)Nr z'Connection to namespace {} was rejectedrF) rGrHformatrJr"rr,r%rr$rrws r; _handle_errorzClient._handle_errors$  BII   <7DD5$-07DOY>> !  ' *   DO"DN rAc|j|||\}}|r ||S|j||\}}|r|j|g|Sy#t$r|dk(r ||ddcYSwxYw)z$Invoke an application event handler.r1N)_get_event_handler TypeError_get_namespace_handler trigger_event)r2rNrCr-handlers r;r,zClient._trigger_events//y$G   ~%33ItD  (7((66 6  L("D"I..  sA A$"A$c |j|jj|_|jjtj j |d}|j} |}|dz}||jkDr |j}||jdtjzdz zz }|jjdj||jj|r@|jjd|jD]}|j!d|n}|dz } |j#|j$|j&|j(|j*|j|j,d |jjd d|_ tj j9|y#t0j2t4f$rYnwxYw|j6rO||j6k\r@|jjd |jD]}|j!d|) Nrrz1Connection failed, new attempt in {:.02f} secondszReconnect task abortedrzr_F)r r4r r$rr6zReconnection successfulz0Maximum reconnection attempts reached, giving up)rdr&r'r(rreconnecting_clientsrXreconnection_delayreconnection_delay_maxrandomization_factorrandomrGrHrr0rr,r*rrrrrr>rr ValueErrorreconnection_attemptsr )r2 attempt_count current_delaydelayr:s r;r.zClient._handle_reconnects3  ($(HH$9$9$;D ! ##%((//5 // !E Q Mt22233 T..!fmmo2E2IJ JE KK  CJJ $$))%0   !9:33KA''(<'JK Q M  T00%)%<%<"&"6"6(,(B(B(,(B(B+/+=+=#( *   !:;'+$ ((//5.. ;   ))!T%?%??   FH33KA''(<'JKGs AG""G>=G>c2|jjd|jj|_|j |j xsi}|j D]3}|j|jtj||5y)z&Handle the Engine.IO connection event.z Engine.IO connection established)rDrCN) rGrHr&rur)rrrKrLrCONNECT)r2 real_authr:s r;_handle_eio_connectzClient._handle_eio_connects ;<88<<(()=)=>D" ++ >A   d//Y!0= > >rAc|jr|j}|j|rd|_|jtjk(r2|j |j |j|jy|j|j |j|jyy|j|}|jtjk(r'|j|j |jy|jtjk(r|j|j y|jtjk(r2|j |j |j|jy|jtj k(r2|j|j |j|jy|jtjk(s|jtj"k(r||_y|jtj$k(r'|j'|j |jyt)d)zDispatch Engine.IO messages.N)rrzUnknown packet type.)_binary_packetadd_attachment packet_typer BINARY_EVENTrrCrErDrrLrrxrbr}rMr BINARY_ACK CONNECT_ERRORrr)r2rDrqs r;_handle_eio_messagezClient._handle_eio_messages   %%C!!$'&*#??f&9&99&&s}}cffchhG$$S]]CFFCHHE (##4#8C&..0$$S]]CHH=F$5$55'' 6FLL0""3==#&&#((CFJJ.  AF$7$77OOv'8'88&)#F$8$88""3==#((; !788rAc|jjd|jxr|jjdk(}|j rG|j D]*}|jd|||r|jd|,i|_d|_i|_d|_ d|_ |r.|js!|j|j|_ yyy)z)Handle the Engine.IO disconnection event.zEngine.IO connection droppedrr1rzFN)rGrH reconnectionr&r/rr$r,rrrur>rgr.)r2r{will_reconnectr:s r;_handle_eio_disconnectzClient._handle_eio_disconnects 78**Ltxx~~/L >>__ A##L!V<%''(rAc"tjSrW)r+rr@s r;_engineio_client_classzClient._engineio_client_class*s rA)NNN)NN)NN<)r)__name__ __module__ __qualname____doc__r*r0rPrTr]r1rergr=r)rKrxr}rrrr,r.rrrrrAr;rr s=|$&DT{ebH(*IX%**X( (G"'*& ,D # 7&+6Z>98($rAr)rr+rrr BaseClientrrrAr;rs( a[ # #arA