pyloid 0.20.2__py3-none-any.whl → 0.20.2.dev0__py3-none-any.whl

pyloid/tray.py

@@ -1,48 +1,48 @@
-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)
+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)

pyloid/utils.py

@@ -1,122 +1,122 @@
-import sys
-import os
-import platform
-from typing import Optional
-
-
-def get_production_path(path: Optional[str] = None) -> Optional[str]:
-    """
-    Returns the path to the resource files in a production environment.
-    If running as a regular Python script, returns None.
-
-    Returns
-    -------
-    str | None
-        The path to the resource files if in a production environment, 
-        otherwise None.
-
-    Examples
-    --------
-    >>> from pyloid.utils import get_production_path
-    >>> path = get_production_path("assets/icon.ico")
-    >>> if path:
-    >>>     print(f"Production path: {path}")
-    >>> else:
-    >>>     print("Not in a production environment.")
-    """
-    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 None
-
-
-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)
-
-
-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))
-
+import sys
+import os
+import platform
+from typing import Optional
+
+
+def get_production_path(path: Optional[str] = None) -> Optional[str]:
+    """
+    Returns the path to the resource files in a production environment.
+    If running as a regular Python script, returns None.
+
+    Returns
+    -------
+    str | None
+        The path to the resource files if in a production environment, 
+        otherwise None.
+
+    Examples
+    --------
+    >>> from pyloid.utils import get_production_path
+    >>> path = get_production_path("assets/icon.ico")
+    >>> if path:
+    >>>     print(f"Production path: {path}")
+    >>> else:
+    >>>     print("Not in a production environment.")
+    """
+    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 None
+
+
+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)
+
+
+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))
+