pyloid 0.26.3__py3-none-any.whl → 0.26.5__py3-none-any.whl

pyloid/tray.py

@@ -1,48 +1,64 @@
-from enum import Enum
-from PySide6.QtWidgets import QSystemTrayIcon
+from enum import (
+	Enum,
+)
+from PySide6.QtWidgets import (
+	QSystemTrayIcon,
+)
 
 
 class TrayEvent(Enum):
-    """
-    TrayEvent is an enumeration class representing events related to the system tray icon.
-
-    Enumeration Members
-    -------------------
-    DoubleClick : Event that occurs when the tray icon is double-clicked
-    MiddleClick : Event that occurs when the tray icon is clicked with the middle button
-    RightClick : Event that occurs when the tray icon is right-clicked (context menu)
-    LeftClick : Event that occurs when the tray icon is left-clicked
-    Unknown : Unknown event
-
-    Usage Example
-    -------------
-    ```python
-    from pyloid import Pyloid, TrayEvent
-
-    app = Pyloid(app_name="Pyloid-App")
-
-    app.set_tray_icon("icons/icon.ico")
-
-    app.set_tray_actions(
-        {
-        TrayEvent.DoubleClick: lambda: print("Tray icon was double-clicked."),
-        TrayEvent.MiddleClick: lambda: print("Tray icon was middle-clicked."),
-        TrayEvent.RightClick: lambda: print("Tray icon was right-clicked."),
-        TrayEvent.LeftClick: lambda: print("Tray icon was left-clicked."),
-        }
-    )
-    ```
-    """
-    DoubleClick = QSystemTrayIcon.ActivationReason.DoubleClick
-    MiddleClick = QSystemTrayIcon.ActivationReason.MiddleClick
-    RightClick = QSystemTrayIcon.ActivationReason.Context
-    LeftClick = QSystemTrayIcon.ActivationReason.Trigger
-    Unknown = QSystemTrayIcon.ActivationReason.Unknown
-
-    def __eq__(self, other):
-        if isinstance(other, QSystemTrayIcon.ActivationReason):
-            return self.value == other
-        return super().__eq__(other)
-
-    def __hash__(self):
-        return hash(self.value)
+	"""
+	TrayEvent is an enumeration class representing events related to the system tray icon.
+
+	Enumeration Members
+	-------------------
+	DoubleClick : Event that occurs when the tray icon is double-clicked
+	MiddleClick : Event that occurs when the tray icon is clicked with the middle button
+	RightClick : Event that occurs when the tray icon is right-clicked (context menu)
+	LeftClick : Event that occurs when the tray icon is left-clicked
+	Unknown : Unknown event
+
+	Usage Example
+	-------------
+	```python
+	from pyloid import (
+	    Pyloid,
+	    TrayEvent,
+	)
+
+	app = Pyloid(app_name='Pyloid-App')
+
+	app.set_tray_icon('icons/icon.ico')
+
+	app.set_tray_actions(
+	    {
+	        TrayEvent.DoubleClick: lambda: print('Tray icon was double-clicked.'),
+	        TrayEvent.MiddleClick: lambda: print('Tray icon was middle-clicked.'),
+	        TrayEvent.RightClick: lambda: print('Tray icon was right-clicked.'),
+	        TrayEvent.LeftClick: lambda: print('Tray icon was left-clicked.'),
+	    }
+	)
+	```
+	"""
+
+	DoubleClick = QSystemTrayIcon.ActivationReason.DoubleClick
+	MiddleClick = QSystemTrayIcon.ActivationReason.MiddleClick
+	RightClick = QSystemTrayIcon.ActivationReason.Context
+	LeftClick = QSystemTrayIcon.ActivationReason.Trigger
+	Unknown = QSystemTrayIcon.ActivationReason.Unknown
+
+	def __eq__(
+		self,
+		other,
+	):
+		if isinstance(
+			other,
+			QSystemTrayIcon.ActivationReason,
+		):
+			return self.value == other
+		return super().__eq__(other)
+
+	def __hash__(
+		self,
+	):
+		return hash(self.value)

pyloid/url_interceptor.py

@@ -1,25 +1,42 @@
-from PySide6.QtWebEngineCore import QWebEngineUrlRequestInterceptor, QWebEngineUrlRequestInfo
+from PySide6.QtWebEngineCore import (
+	QWebEngineUrlRequestInterceptor,
+	QWebEngineUrlRequestInfo,
+)
+
 
 # interceptor ( all url request )
 class ServerUrlInterceptor(QWebEngineUrlRequestInterceptor):
-    def __init__(self, server_url: str, window_id: str):
-        super().__init__()
-        self.server_url = server_url
-        self.headers = {
-            "X-Pyloid-Window-Id": window_id,
-        }
-        
-        print("interceptor init")
+	def __init__(
+		self,
+		server_url: str,
+		window_id: str,
+	):
+		super().__init__()
+		self.server_url = server_url
+		self.headers = {
+			'X-Pyloid-Window-Id': window_id,
+		}
+
+		print('interceptor init')
+
+	def interceptRequest(
+		self,
+		info,
+	):
+		# host = info.requestUrl().host()
+		url = info.requestUrl().toString()
 
-    def interceptRequest(self, info):
-        # host = info.requestUrl().host()
-        url = info.requestUrl().toString()
-        
-        print(url)
+		print(url)
 
-        if url.startswith(self.server_url):
-            headers = info.httpHeaders()
-            print("before", headers)
-            headers.update(self.headers)
-            print("after", headers)
-            return
+		if url.startswith(self.server_url):
+			headers = info.httpHeaders()
+			print(
+				'before',
+				headers,
+			)
+			headers.update(self.headers)
+			print(
+				'after',
+				headers,
+			)
+			return

pyloid/utils.py

@@ -1,208 +1,258 @@
 import sys
 import os
 import platform
-from typing import Optional
+from typing import (
+	Optional,
+)
 import socket
 
 
-def get_production_path(path: Optional[str] = None) -> Optional[str]:
-    """
-    Constructs the absolute path to a resource file, adjusting based on the execution environment.
-
-    In a production environment (e.g., when packaged with PyInstaller or Nuitka),
-    it prepends the application's base directory (sys._MEIPASS for PyInstaller,
-    or the directory of the executable for Nuitka) to the provided relative path.
-    If no path is provided, it returns the base path itself.
-
-    If not running in a production environment (e.g., during development as a regular
-    Python script), it simply returns the provided path as is. If no path is provided,
-    it returns None in a non-production environment.
-
-    Parameters
-    ----------
-    path : Optional[str], optional
-        The relative path to the resource file from the application's root directory.
-        Defaults to None.
-
-    Returns
-    -------
-    Optional[str]
-        - If in production: The absolute path to the resource file (or the base path if `path` is None).
-        - If not in production: The original `path` value passed to the function.
-
-    Examples
-    --------
-    >>> # Assume running NOT in production
-    >>> get_production_path("assets/icon.ico")
-    'assets/icon.ico'
-    >>> get_production_path()
-    None
-
-    >>> # Assume running IN production (e.g., PyInstaller bundle)
-    >>> # where sys._MEIPASS might be '/tmp/_MEIabcde'
-    >>> get_production_path("assets/icon.ico") # doctest: +SKIP
-    '/tmp/_MEIabcde/assets/icon.ico'
-    >>> get_production_path() # doctest: +SKIP
-    '/tmp/_MEIabcde'
-    """
-    if is_production():
-        if hasattr(sys, "_MEIPASS"):
-            # PyInstaller
-            base_path = sys._MEIPASS
-        else:
-            # Nuitka
-            base_path = os.path.dirname(sys.executable)
-
-            if base_path is None:
-                # 환경변수가 없는 경우 실행 파일 디렉토리 사용
-                base_path = os.path.dirname(os.path.abspath(sys.argv[0]))
-
-        return os.path.join(base_path, path) if path else base_path
-    else:
-        return path
+def get_production_path(
+	path: Optional[str] = None,
+) -> Optional[str]:
+	"""
+	Constructs the absolute path to a resource file, adjusting based on the execution environment.
+
+	In a production environment (e.g., when packaged with PyInstaller or Nuitka),
+	it prepends the application's base directory (sys._MEIPASS for PyInstaller,
+	or the directory of the executable for Nuitka) to the provided relative path.
+	If no path is provided, it returns the base path itself.
+
+	If not running in a production environment (e.g., during development as a regular
+	Python script), it simply returns the provided path as is. If no path is provided,
+	it returns None in a non-production environment.
+
+	Parameters
+	----------
+	path : Optional[str], optional
+	    The relative path to the resource file from the application's root directory.
+	    Defaults to None.
+
+	Returns
+	-------
+	Optional[str]
+	    - If in production: The absolute path to the resource file (or the base path if `path` is None).
+	    - If not in production: The original `path` value passed to the function.
+
+	Examples
+	--------
+	>>> # Assume running NOT in production
+	>>> get_production_path('assets/icon.ico')
+	'assets/icon.ico'
+	>>> get_production_path()
+	None
+
+	>>> # Assume running IN production (e.g., PyInstaller bundle)
+	>>> # where sys._MEIPASS might be '/tmp/_MEIabcde'
+	>>> get_production_path('assets/icon.ico')  # doctest: +SKIP
+	'/tmp/_MEIabcde/assets/icon.ico'
+	>>> get_production_path()  # doctest: +SKIP
+	'/tmp/_MEIabcde'
+	"""
+	if is_production():
+		if hasattr(
+			sys,
+			'_MEIPASS',
+		):
+			# PyInstaller
+			base_path = sys._MEIPASS
+		else:
+			# Nuitka
+			base_path = os.path.dirname(sys.executable)
+
+			if base_path is None:
+				# 환경변수가 없는 경우 실행 파일 디렉토리 사용
+				base_path = os.path.dirname(os.path.abspath(sys.argv[0]))
+
+		return (
+			os.path.join(
+				base_path,
+				path,
+			)
+			if path
+			else base_path
+		)
+	else:
+		return path
 
 
 def is_production() -> bool:
-    """
-    Checks if the current environment is a production environment.
-
-    Returns
-    -------
-    bool
-        True if in a production environment, False otherwise.
-
-    Examples
-    --------
-    >>> from pyloid.utils import is_production
-    >>> if is_production():
-    >>>     print("Running in production environment.")
-    >>> else:
-    >>>     print("Not in production environment.")
-    """
-    # Nuitka 환경 확인을 추가
-    if "__compiled__" in globals():
-        return True
-    # PyInstaller 환경 확인
-    return getattr(sys, "frozen", False)
+	"""
+	Checks if the current environment is a production environment.
+
+	Returns
+	-------
+	bool
+	    True if in a production environment, False otherwise.
+
+	Examples
+	--------
+	>>> from pyloid.utils import (
+	...     is_production,
+	... )
+	>>> if is_production():
+	>>>     print("Running in production environment.")
+	>>> else:
+	>>>     print("Not in production environment.")
+	"""
+	# Nuitka 환경 확인을 추가
+	if '__compiled__' in globals():
+		return True
+	# PyInstaller 환경 확인
+	return getattr(
+		sys,
+		'frozen',
+		False,
+	)
 
 
 def get_platform() -> str:
-    """
-    Returns the name of the current system's platform.
-
-    This function uses `platform.system()` to return the name of the current operating system.
-
-    Returns
-    -------
-    "windows" | "macos" | "linux"
-        - "windows" for Windows systems
-        - "macos" for macOS systems
-        - "linux" for Linux systems
-
-    Examples
-    --------
-    >>> from pyloid.utils import get_platform
-    >>> platform_name = get_platform()
-    >>> print(platform_name)
-    windows
-    """
-    os_name = platform.system().lower()
-    os_type = {"darwin": "macos", "linux": "linux", "windows": "windows"}.get(os_name)
-    if os_type is None:
-        raise ValueError(f"Unsupported platform: {os_name}")
-
-    return os_type
-
-
-def get_absolute_path(path: str) -> str:
-    """
-    Returns the absolute path of the given relative path.
-
-    Parameters
-    ----------
-    path : str
-        The relative path to get the absolute path of.
-
-    Returns
-    -------
-    str
-        The absolute path of the given relative path.
-
-    Examples
-    --------
-    >>> from pyloid.utils import get_absolute_path
-    >>> absolute_path = get_absolute_path("assets/icon.ico")
-    >>> print(absolute_path)
-    C:/Users/aaaap/Documents/pyloid/pyloid/assets/icon.ico
-    """
-    return os.path.normpath(os.path.abspath(path))
+	"""
+	Returns the name of the current system's platform.
+
+	This function uses `platform.system()` to return the name of the current operating system.
+
+	Returns
+	-------
+	"windows" | "macos" | "linux"
+	    - "windows" for Windows systems
+	    - "macos" for macOS systems
+	    - "linux" for Linux systems
+
+	Examples
+	--------
+	>>> from pyloid.utils import (
+	...     get_platform,
+	... )
+	>>> platform_name = get_platform()
+	>>> print(platform_name)
+	windows
+	"""
+	os_name = platform.system().lower()
+	os_type = {
+		'darwin': 'macos',
+		'linux': 'linux',
+		'windows': 'windows',
+	}.get(os_name)
+	if os_type is None:
+		raise ValueError(f'Unsupported platform: {os_name}')
+
+	return os_type
+
+
+def get_absolute_path(
+	path: str,
+) -> str:
+	"""
+	Returns the absolute path of the given relative path.
+
+	Parameters
+	----------
+	path : str
+	    The relative path to get the absolute path of.
+
+	Returns
+	-------
+	str
+	    The absolute path of the given relative path.
+
+	Examples
+	--------
+	>>> from pyloid.utils import (
+	...     get_absolute_path,
+	... )
+	>>> absolute_path = get_absolute_path('assets/icon.ico')
+	>>> print(absolute_path)
+	C:/Users/aaaap/Documents/pyloid/pyloid/assets/icon.ico
+	"""
+	return os.path.normpath(os.path.abspath(path))
 
 
 def get_free_port() -> int:
-    """
-    Finds and returns an available random network port number from the operating system.
-
-    This function creates a socket and binds it to port '0', allowing the operating system
-    to allocate a random available port. It retrieves the port number and safely closes
-    the socket afterward.
-
-    Returns
-    -------
-    int
-        An available network port number (typically in the range 1024-65535)
-
-    Notes
-    -----
-    - Since this function closes the socket immediately after finding a port, there is a
-      possibility that the port could be reassigned to another process.
-    - It is recommended to use the port number quickly after receiving it.
-    - This function interacts with the operating system's network stack, so its behavior
-      may vary depending on firewall or network settings.
-
-    Examples
-    --------
-    >>> from pyloid.utils import get_free_port
-    >>> port = get_free_port()
-    >>> print(f"Found available port: {port}")
-    Found available port: 49152
-
-    >>> # Web server example
-    >>> import http.server
-    >>> server = http.server.HTTPServer(('localhost', port), http.server.SimpleHTTPRequestHandler)
-    """
-    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
-        s.bind(("", 0))
-        return s.getsockname()[1]
-
-
-def set_qt_backend(backend="software"):
-    """
-    Sets the Qt Quick backend to force a specific rendering mode.
-
-    This function allows changing the Qt Quick rendering backend by setting
-    the QT_QUICK_BACKEND environment variable. Setting it to 'software'
-    forces software rendering, which can be useful in environments with
-    graphics driver issues or where hardware acceleration is not available.
-
-    Parameters
-    ----------
-    backend : str, optional
-        The backend to use for Qt Quick rendering. Default is 'software'.
-
-    Returns
-    -------
-    None
-
-    Notes
-    -----
-    - This setting must be applied before the Qt application is initialized
-    - Software rendering may be slower but more compatible across systems
-
-    Examples
-    --------
-    >>> from pyloid.utils import set_qt_backend
-    >>> # Force software rendering
-    >>> set_qt_backend("software")
-    """
-    print(f"Setting QT_QUICK_BACKEND to {backend}.")
-    os.environ["QT_QUICK_BACKEND"] = backend
+	"""
+	Finds and returns an available random network port number from the operating system.
+
+	This function creates a socket and binds it to port '0', allowing the operating system
+	to allocate a random available port. It retrieves the port number and safely closes
+	the socket afterward.
+
+	Returns
+	-------
+	int
+	    An available network port number (typically in the range 1024-65535)
+
+	Notes
+	-----
+	- Since this function closes the socket immediately after finding a port, there is a
+	  possibility that the port could be reassigned to another process.
+	- It is recommended to use the port number quickly after receiving it.
+	- This function interacts with the operating system's network stack, so its behavior
+	  may vary depending on firewall or network settings.
+
+	Examples
+	--------
+	>>> from pyloid.utils import (
+	...     get_free_port,
+	... )
+	>>> port = get_free_port()
+	>>> print(f'Found available port: {port}')
+	Found available port: 49152
+
+	>>> # Web server example
+	>>> import http.server
+	>>> server = http.server.HTTPServer(
+	...     (
+	...         'localhost',
+	...         port,
+	...     ),
+	...     http.server.SimpleHTTPRequestHandler,
+	... )
+	"""
+	with socket.socket(
+		socket.AF_INET,
+		socket.SOCK_STREAM,
+	) as s:
+		s.bind(
+			(
+				'',
+				0,
+			)
+		)
+		return s.getsockname()[1]
+
+
+def set_qt_backend(
+	backend='software',
+):
+	"""
+	Sets the Qt Quick backend to force a specific rendering mode.
+
+	This function allows changing the Qt Quick rendering backend by setting
+	the QT_QUICK_BACKEND environment variable. Setting it to 'software'
+	forces software rendering, which can be useful in environments with
+	graphics driver issues or where hardware acceleration is not available.
+
+	Parameters
+	----------
+	backend : str, optional
+	    The backend to use for Qt Quick rendering. Default is 'software'.
+
+	Returns
+	-------
+	None
+
+	Notes
+	-----
+	- This setting must be applied before the Qt application is initialized
+	- Software rendering may be slower but more compatible across systems
+
+	Examples
+	--------
+	>>> from pyloid.utils import (
+	...     set_qt_backend,
+	... )
+	>>> # Force software rendering
+	>>> set_qt_backend('software')
+	"""
+	print(f'Setting QT_QUICK_BACKEND to {backend}.')
+	os.environ['QT_QUICK_BACKEND'] = backend

{pyloid-0.26.3.dist-info → pyloid-0.26.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyloid
-Version: 0.26.3
+Version: 0.26.5
 Summary: 
 Author: aesthetics-of-record
 Author-email: 111675679+aesthetics-of-record@users.noreply.github.com

pyloid-0.26.5.dist-info/RECORD

@@ -0,0 +1,23 @@
+pyloid/__init__.py,sha256=qBmAo_EOAW4N-XYqv9fK3GD2VQhMkRCO-Yaar0dGqAE,60
+pyloid/autostart.py,sha256=4q3YiYt2SKJiJV16FalISYVjg9X7b0l7eAmSWOhfXo0,3679
+pyloid/base_ipc/base.py,sha256=eo0mkAOCl2h9NDD1sQNYauS15iyEGNpXY5oO5n4nNPo,8052
+pyloid/base_ipc/event_api.py,sha256=JY8YfyTns4jMwZ43ob9KuGedMBSVML8FuQJHk_bDhFE,959
+pyloid/base_ipc/window_api.py,sha256=-isphU3m2wGB5U0yZrSuK_4XiBz2mG45HsjYTUq7Fxs,7348
+pyloid/browser_window.py,sha256=M2dKhVz0BLh_4rQI0tGLAmbgfDJ63yKjgDhwn4DNCbo,91674
+pyloid/custom/titlebar.py,sha256=wkh3h6ZBOYJczTrOosgiTKiSL-ZU92RWQv4FjpnH9u8,3728
+pyloid/filewatcher.py,sha256=Rdu76qpwXpFNQuapZZBajRN_0svcPZa2s-06IBH4dkk,4062
+pyloid/ipc.py,sha256=W58SIYN8rfx4ZwdryMCfb-UMy8VkmpFBF-a0wIGhYsA,2256
+pyloid/monitor.py,sha256=cCBQgX0OJg7Gt3WeNfb-koTNR17ZToN2Lq35o_2F350,23970
+pyloid/pyloid.py,sha256=5WfbuiW8JYi1B2AadoScyI5rrc_fq2GEoVdn1VEQhHM,74638
+pyloid/rpc.py,sha256=40KsbCnYotLm5M7S2Uo41ELV4N7ugz9tBtdfIfFIIG0,18964
+pyloid/serve.py,sha256=w17OteQOGW5-Q2SOdkyv0R1tb-67wxbGjTzvFbSvwB4,6674
+pyloid/store.py,sha256=hjv8c7h6EQUzbBY7g2tXX9sRGFnfKU0pQWG5UtGcfWA,4611
+pyloid/thread_pool.py,sha256=6ohTRbQqIuLL6OVGo70qvAPZnq-V-bSVuawLFN0yMiY,12591
+pyloid/timer.py,sha256=YNxQn2HVMKBk417YDiz8WwhTmSAkbnGUyFGV2biUEPg,7821
+pyloid/tray.py,sha256=yHWsOMPpEjZa3W-T-O8Wrwo1GphCV-9adodLdxU0_mA,1673
+pyloid/url_interceptor.py,sha256=lA-i5Raw-GDRDMKHRO361N6igLfN9_mIANCXwZ_FZT8,771
+pyloid/utils.py,sha256=x7PGkgreV3l4K-Tke9W06t_VEtq0mH0AYWK695IR-mo,6416
+pyloid-0.26.5.dist-info/LICENSE,sha256=F96EzotgWhhpnQTW2TcdoqrMDir1jyEo6H915tGQ-QE,11524
+pyloid-0.26.5.dist-info/METADATA,sha256=vRjpHU_PHJpGOV4mHTHFet15IXYVcubHQXMNKu3yheU,2298
+pyloid-0.26.5.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+pyloid-0.26.5.dist-info/RECORD,,