pyloid 0.23.17__tar.gz → 0.23.19__tar.gz

{pyloid-0.23.17 → pyloid-0.23.19}/LICENSE

@@ -198,4 +198,4 @@ Apache License
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
+   limitations under the License.

{pyloid-0.23.17 → pyloid-0.23.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyloid
-Version: 0.23.17
+Version: 0.23.19
 Summary: 
 Author: aesthetics-of-record
 Author-email: 111675679+aesthetics-of-record@users.noreply.github.com
@@ -14,7 +14,7 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: aiohttp-cors (>=0.8.1,<0.9.0)
 Requires-Dist: pickledb (>=1.3.2,<2.0.0)
 Requires-Dist: platformdirs (>=4.3.7,<5.0.0)
-Requires-Dist: pyside6 (>=6.8.2.1,<7.0.0.0)
+Requires-Dist: pyside6 (==6.8.3)
 Description-Content-Type: text/markdown
 
 <h1 style="text-align: center; font-size: 200px; font-weight: 500;">

{pyloid-0.23.17 → pyloid-0.23.19}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pyloid"
-version = "0.23.17"
+version = "0.23.19"
 description = ""
 authors = ["aesthetics-of-record <111675679+aesthetics-of-record@users.noreply.github.com>"]
 readme = "README.md"
@@ -10,7 +10,7 @@ packages = [
 
 [tool.poetry.dependencies]
 python = ">=3.9,<3.14"
-pyside6 = "^6.8.2.1"
+pyside6 = "6.8.3"
 platformdirs = "^4.3.7"
 pickledb = "^1.3.2"
 aiohttp-cors = "^0.8.1"

{pyloid-0.23.17 → pyloid-0.23.19}/src/pyloid/pyloid.py

@@ -37,7 +37,7 @@ import threading
 import signal
 
 # software backend
-os.environ["QT_QUICK_BACKEND"] = "software"
+# os.environ["QT_QUICK_BACKEND"] = "software"
 
 #########################################################################
 # for linux debug
@@ -1666,11 +1666,6 @@ class Pyloid(QObject):
             The name of the application.
         single_instance : bool, optional
             Determines whether to run as a single instance. (Default is True)
-
-        Notes
-        -----
-        The generated or passed `id` is transmitted to the frontend via IPC,
-        and is used as an API key to connect to the integrated backend FastAPI server.
         """
         super().__init__()
 

{pyloid-0.23.17 → pyloid-0.23.19}/src/pyloid/utils.py

@@ -46,7 +46,7 @@ def get_production_path(path: Optional[str] = None) -> Optional[str]:
     '/tmp/_MEIabcde'
     """
     if is_production():
-        if hasattr(sys, '_MEIPASS'):
+        if hasattr(sys, "_MEIPASS"):
             # PyInstaller
             base_path = sys._MEIPASS
         else:
@@ -57,7 +57,6 @@ def get_production_path(path: Optional[str] = None) -> Optional[str]:
                 # 환경변수가 없는 경우 실행 파일 디렉토리 사용
                 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
@@ -81,10 +80,10 @@ def is_production() -> bool:
     >>>     print("Not in production environment.")
     """
     # Nuitka 환경 확인을 추가
-    if '__compiled__' in globals():
+    if "__compiled__" in globals():
         return True
     # PyInstaller 환경 확인
-    return getattr(sys, 'frozen', False)
+    return getattr(sys, "frozen", False)
 
 
 def get_platform() -> str:
@@ -108,20 +107,17 @@ def get_platform() -> str:
     windows
     """
     os_name = platform.system().lower()
-    os_type = {
-        'darwin': 'macos',
-        'linux': 'linux',
-        'windows': 'windows'
-    }.get(os_name)
+    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
@@ -131,7 +127,7 @@ def get_absolute_path(path: str) -> str:
     -------
     str
         The absolute path of the given relative path.
-        
+
     Examples
     --------
     >>> from pyloid.utils import get_absolute_path
@@ -141,19 +137,20 @@ def get_absolute_path(path: str) -> str:
     """
     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
@@ -161,18 +158,51 @@ def get_free_port() -> int:
     - 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))
+        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