U
|
W ±dk! ã
|
@ sz d Z ddlZddlZddlZdddddgZz ddlZW n ek
|
rN dZY nX zddlm Z W n ek
|
rx dZ Y nX d d
|
Z
|
d Z d Z d a dae ejej¡add Zz eejd Zejd= e W nd eefk
|
rþ Z ze
|
dded W 5 dZ[X Y n2 ek
|
r. Z ze
|
dded W 5 dZ[X Y nX dd Zed!ddZ dd Z ee d d dZ d d Z ej!d d Z"dS )"a>
|
This module connects to the bootloader to send messages to the splash screen.
|
|
It is intended to act as a RPC interface for the functions provided by the bootloader, such as displaying text or
|
closing. This makes the users python program independent of how the communication with the bootloader is implemented,
|
since a consistent API is provided.
|
|
To connect to the bootloader, it connects to a local tcp socket whose port is passed through the environment variable
|
'_PYIBoot_SPLASH'. The bootloader creates a server socket and accepts every connection request. Since the os-module,
|
which is needed to request the environment variable, is not available at boot time, the module does not establish the
|
connection until initialization.
|
|
The protocol by which the Python interpreter communicates with the bootloader is implemented in this module.
|
|
This module does not support reloads while the splash screen is displayed, i.e. it cannot be reloaded (such as by
|
importlib.reload), because the splash screen closes automatically when the connection to this instance of the module
|
is lost.
|
é NÚCLOSE_CONNECTIONÚFLUSH_CHARACTERÚis_aliveÚcloseÚ update_text©Úupdate_wrapperc O s& t r"t t¡}|j| |f|| dS )z¹
|
Conditional wrapper around logging module. If the user excluded logging from the imports or it was not imported,
|
this function should handle it and avoid using the logger.
|
N)Ú_loggingÚ getLoggerÚ__name__Úlog)ÚlevelÚmsgÚargsÚkwargsÚlogger© r úZd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\PyInstaller/fake-modules/pyi_splash.pyÚ_log9 s
|
r ó ó FTc
|
C sZ z$t dtf¡ dadatdd W n0 tk
|
rT } ztdt | W 5 d} ~ X Y nX dS )z.
|
Initialize this module
|
|
:return:
|
Ú localhostFTé z?A connection to the splash screen was successfully established.z5Unable to connect to the tcp server socket on port %dN)Ú _ipc_socketÚconnectÚ _ipc_portÚ_ipc_socket_closedÚ _initializedr ÚOSErrorÚConnectionError)Úerrr r r Ú _initializeO s r! Z_PYIBoot_SPLASHé zThe environment does not allow connecting to the splash screen. Are the splash resources attached to the bootloader or did an error occur?)Úexc_infoé( z3Cannot connect to the bootloaders ipc server socketc s fdd}t rt | |S )z´
|
Utility decorator for checking whether the function should be executed.
|
|
The wrapped function may raise a ConnectionError if the module was not initialized correctly.
|
c s, t rtrtdd dS t s"td | |S )a
|
Executes the wrapped function if the environment allows it.
|
|
That is, if the connection to to bootloader has not been closed and the module is initialized.
|
|
:raises RuntimeError: if the module was not initialized correctly.
|
r zUThe module has been disabled, so the use of the splash screen is no longer supported.Nz4This module is not initialized; did it fail to load?)r r r Ú RuntimeError)r r ©Úfuncr r Úwrappery s ÿz"_check_connection.<locals>.wrapperr )r' r( r r& r Ú_check_connections s
|
r) c
|
C sl |dkr g }d| d |¡f }zt | d¡t ¡ W n0 tk
|
rf } ztd| |W 5 d}~X Y nX dS )a
|
Send the command followed by args to the splash screen.
|
|
:param str cmd: The command to send. All command have to be defined as procedures in the tcl splash screen script.
|
:param list[str] args: All arguments to send to the receiving function
|
Nz%s(%s)ú zutf-8z%Unable to send '%s' to the bootloader)Újoinr ÚsendallÚencoder r r )Úcmdr Zfull_cmdr r r r Ú _send_command s r/ c C s
|
t ot S )zÈ
|
Indicates whether the module can be used.
|
|
Returns False if the module is either not initialized or was disabled by closing the splash screen. Otherwise,
|
the module should be usable.
|
)r r r r r r r ¤ s ©r c C s t d| g dS )zæ
|
Updates the text on the splash screen window.
|
|
:param str msg: the text to be displayed
|
:raises ConnectionError: If the OS fails to write to the socket.
|
:raises RuntimeError: If the module is not initialized.
|
r N)r/ r0 r r r r ® s c C s" t r ts t t¡ t ¡ dadS )a
|
Close the connection to the ipc tcp server socket.
|
|
This will close the splash screen and renders this module unusable. After this function is called, no connection
|
can be opened to the splash screen again and all functions in this module become unusable.
|
TN)r r r r, r r r r r r r º s
|
c C s
|
t d S )N)r r r r r Ú_exitÈ s r1 )N)#Ú__doc__ÚatexitÚosÚ_socketÚ__all__Úloggingr Ú ImportErrorÚ functoolsr r r r r r ÚsocketÚAF_INETÚ SOCK_STREAMr r! ÚintÚenvironr ÚKeyErrorÚ
|
ValueErrorZ_errr r) r/ r Ústrr r Úregisterr1 r r r r Ú<module> sP
|
|
|
ý
|
|
