pyloid 0.24.7__tar.gz → 0.24.9__tar.gz

{pyloid-0.24.7 → pyloid-0.24.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyloid
-Version: 0.24.7
+Version: 0.24.9
 Summary: 
 Author: aesthetics-of-record
 Author-email: 111675679+aesthetics-of-record@users.noreply.github.com
@@ -11,10 +11,11 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: aiofiles (>=24.1.0,<25.0.0)
 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.3)
+Requires-Dist: pyside6 (==6.9.2)
 Description-Content-Type: text/markdown
 
 <h1 style="text-align: center; font-size: 200px; font-weight: 500;">
@@ -23,7 +24,7 @@ Description-Content-Type: text/markdown
 
 ![example image](example.png)
 
-<h2 align="center" style="font-size: 28px;"><b>Pyloid: Thread-Safe Desktop Apps—Unified with Any Frontend and Python Technology</b></h2>
+<h2 align="center" style="font-size: 28px;"><b>Pyloid: Electron for Python Developer • Web-based desktop app framework</b></h2>
 
 ## 💡 Key Features
 

{pyloid-0.24.7 → pyloid-0.24.9}/README.md

@@ -4,7 +4,7 @@
 
 ![example image](example.png)
 
-<h2 align="center" style="font-size: 28px;"><b>Pyloid: Thread-Safe Desktop Apps—Unified with Any Frontend and Python Technology</b></h2>
+<h2 align="center" style="font-size: 28px;"><b>Pyloid: Electron for Python Developer • Web-based desktop app framework</b></h2>
 
 ## 💡 Key Features
 

{pyloid-0.24.7 → pyloid-0.24.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pyloid"
-version = "0.24.7"
+version = "0.24.9"
 description = ""
 authors = ["aesthetics-of-record <111675679+aesthetics-of-record@users.noreply.github.com>"]
 readme = "README.md"
@@ -10,10 +10,11 @@ packages = [
 
 [tool.poetry.dependencies]
 python = ">=3.9,<3.14"
-pyside6 = "6.8.3"
+pyside6 = "6.9.2"
 platformdirs = "^4.3.7"
 pickledb = "^1.3.2"
 aiohttp-cors = "^0.8.1"
+aiofiles = "^24.1.0"
 
 [build-system]
 requires = ["poetry-core"]

{pyloid-0.24.7 → pyloid-0.24.9}/src/pyloid/browser_window.py

@@ -82,7 +82,7 @@ class CustomWebPage(QWebEnginePage):
     #     return
     #     print("Desktop media request received:", request)
 
-    #     # 사용 가능한 화면 목록 확인
+    #     # check the available screen list
     #     screens_model = request.screensModel()
     #     print("\n=== Available Screens ===")
     #     for i in range(screens_model.rowCount()):
@@ -90,7 +90,7 @@ class CustomWebPage(QWebEnginePage):
     #         screen_name = screens_model.data(screen_index)
     #         print(f"Screen {i}: {screen_name}")
 
-    #     # 사용 가능한 창 목록 확인
+    #     # check the available window list
     #     windows_model = request.windowsModel()
     #     print("\n=== Available Windows ===")
     #     for i in range(windows_model.rowCount()):
@@ -102,7 +102,7 @@ class CustomWebPage(QWebEnginePage):
 
     # # interceptor ( navigation request )
     # def acceptNavigationRequest(self, url, navigation_type, is_main_frame):
-    #     """네비게이션 요청을 처리하는 메서드"""
+    #     """method to handle navigation requests"""
     #     print(f"Navigation Request - URL: {url.toString()}")
     #     print(f"Navigation Type: {navigation_type}")
     #     print(f"Is Main Frame: {is_main_frame}")
@@ -228,10 +228,10 @@ class CustomWebEngineView(QWebEngineView):
 
     def eventFilter(self, source, event):
         if self.focusProxy() is source:
-            # 리사이징 영역에 있을 때는 모든 클릭 이벤트를 가로채기
+            # when in the resize area, all click events are intercepted
             if self.is_in_resize_area and event.type() == QEvent.MouseButtonPress:
                 self.mouse_press_event(event)
-                return True  # 이벤트를 소비하여 웹뷰로 전달되지 않도록 함
+                return True  # consume the event so it is not passed to the web view
 
             if event.type() == QEvent.MouseButtonPress:
                 self.mouse_press_event(event)
@@ -358,18 +358,18 @@ class _BrowserWindow:
         self.close_on_load = True
         self.splash_screen = None
         ###########################################################################################
-        # RPC 서버가 없으면 추가하지 않음
+        # if the RPC server is not present, do not add it
         if not self.rpc:
             return
 
         self.rpc.pyloid = self.app.pyloid_wrapper
         # self.rpc.window = self.window_wrapper
 
-        # RPC 서버 중복 방지
+        # prevent duplicate RPC servers
         if self.rpc in self.app.rpc_servers:
             return
 
-        # RPC 서버 추가
+        # add the RPC server
         self.app.rpc_servers.add(self.rpc)
 
         # Start unique RPC servers
@@ -405,7 +405,7 @@ class _BrowserWindow:
             central_widget.setLayout(layout)
             self._window.setCentralWidget(central_widget)
 
-            # Add properties for window movement
+            # add properties for window movement
             self._window.moving = False
             self._window.offset = QPoint()
         else:
@@ -490,6 +490,9 @@ class _BrowserWindow:
         self.web_view.settings().setAttribute(
             QWebEngineSettings.WebAttribute.WebRTCPublicInterfacesOnly, False
         )
+        self.web_view.settings().setAttribute(
+            QWebEngineSettings.WebAttribute.WebGLEnabled, True
+        )
 
         # Set icon
         if self.app.icon:
@@ -540,10 +543,10 @@ class _BrowserWindow:
         # Set F12 shortcut
         self.set_dev_tools(self.dev_tools)
 
-        # 프로필 가져오기 및 인터셉터 설정
+        # get the profile and set the interceptor
         profile = self.web_view.page().profile()
 
-        # # 기존 인터셉터가 있다면 제거
+        # # if the existing interceptor is present, remove it
         # if self.interceptor:
         #     profile.setUrlRequestInterceptor(None)
 
@@ -562,15 +565,15 @@ class _BrowserWindow:
                 new QWebChannel(qt.webChannelTransport, function (channel) {
                     window.pyloid = {
                         EventAPI: {
-                            _listeners: {},  // 콜백 함수들을 저장할 객체
+                            _listeners: {},  // object to store the callback functions
                             
                             listen: function(eventName, callback) {
-                                // 이벤트에 대한 콜백 배열이 없다면 생성
+                                // if the callback array for the event is not present, create it
                                 if (!this._listeners[eventName]) {
                                     this._listeners[eventName] = [];
                                 }
                                 
-                                // 콜백 함수 저장
+                                // save the callback function
                                 this._listeners[eventName].push(callback);
                                 
                                 document.addEventListener(eventName, function(event) {
@@ -585,12 +588,12 @@ class _BrowserWindow:
                             },
                             
                             unlisten: function(eventName) {
-                                // 해당 이벤트의 모든 리스너 제거
+                                // remove all listeners for the event
                                 if (this._listeners[eventName]) {
                                     this._listeners[eventName].forEach(callback => {
                                         document.removeEventListener(eventName, callback);
                                     });
-                                    // 저장된 콜백 제거
+                                    // remove the saved callback
                                     delete this._listeners[eventName];
                                 }
                             }

pyloid-0.24.9/src/pyloid/serve.py

@@ -0,0 +1,232 @@
+import threading
+import asyncio
+import mimetypes
+import aiofiles
+from aiohttp import web
+from aiohttp.web_fileresponse import FileResponse
+from typing import Optional
+from pathlib import Path
+from .utils import get_free_port, is_production
+import logging
+
+# 로깅 설정
+logging.getLogger('aiohttp').setLevel(logging.WARNING)
+
+
+class ZeroCopyFileResponse(FileResponse):
+    """zero-copy optimized file response class"""
+    
+    def __init__(self, path, chunk_size=65536, headers=None):
+        """
+        Args:
+            path: file path
+            chunk_size: streaming chunk size (64KB default)
+            headers: additional HTTP headers
+        """
+        super().__init__(path, chunk_size=chunk_size, headers=headers)
+        self._enable_sendfile = True  # sendfile() system call activation
+
+
+class ZeroCopyStaticHandler:
+    """zero-copy optimized static file handler"""
+    
+    def __init__(self, directory: str):
+        self.directory = Path(directory).resolve()
+        self.chunk_size = 65536  # 64KB chunk
+        
+    async def handle_request(self, request):
+        """HTTP request processing"""
+        try:
+            # URL path parsing
+            path = request.path_qs.split('?')[0]  # 쿼리 파라미터 제거
+            if path.endswith('/'):
+                path += 'index.html'
+            
+            # Security: prevent directory traversal attacks
+            file_path = (self.directory / path.lstrip('/')).resolve()
+            if not str(file_path).startswith(str(self.directory)):
+                return web.Response(status=403, text="Forbidden")
+            
+            # Check if the file exists
+            if not file_path.exists() or not file_path.is_file():
+                return web.Response(status=404, text="File not found")
+            
+            # Check the file size and type
+            stat = file_path.stat()
+            file_size = stat.st_size
+            content_type, _ = mimetypes.guess_type(str(file_path))
+            
+            # Range request processing (partial download supported)
+            range_header = request.headers.get('Range')
+            if range_header:
+                return await self._handle_range_request(file_path, range_header, file_size, content_type, request)
+            
+            if is_production():
+                cache_control = 'public, max-age=3600'  # 1 hour caching
+            else:
+                cache_control = 'no-cache'
+                
+            # zero-copy file response creation
+            headers = {
+                'Content-Type': content_type or 'application/octet-stream',
+                'Content-Length': str(file_size),
+                'Accept-Ranges': 'bytes',
+                'Cache-Control': cache_control,
+                'ETag': f'"{stat.st_mtime}-{file_size}"'
+            }
+            
+            # ETag based cache check
+            if_none_match = request.headers.get('If-None-Match')
+            if if_none_match == headers['ETag']:
+                return web.Response(status=304, headers=headers)
+            
+            # zero-copy response return (sendfile used)
+            return ZeroCopyFileResponse(
+                path=file_path,
+                chunk_size=self.chunk_size,
+                headers=headers
+            )
+            
+        except Exception as e:
+            return web.Response(status=500, text=f"Internal Server Error: {str(e)}")
+    
+    async def _handle_range_request(self, file_path, range_header, file_size, content_type, request):
+        """Range request processing (partial download)"""
+        try:
+            # Range header parsing: bytes=start-end
+            range_match = range_header.replace('bytes=', '').split('-')
+            start = int(range_match[0]) if range_match[0] else 0
+            end = int(range_match[1]) if range_match[1] else file_size - 1
+            
+            # Range validation
+            if start >= file_size or end >= file_size or start > end:
+                return web.Response(
+                    status=416,  # Range Not Satisfiable
+                    headers={'Content-Range': f'bytes */{file_size}'}
+                )
+            
+            content_length = end - start + 1
+            
+            headers = {
+                'Content-Type': content_type or 'application/octet-stream',
+                'Content-Length': str(content_length),
+                'Content-Range': f'bytes {start}-{end}/{file_size}',
+                'Accept-Ranges': 'bytes'
+            }
+            
+            # zero-copy partial response
+            response = web.StreamResponse(status=206, headers=headers)
+            await response.prepare(request)
+            
+            # aiofiles to async zero-copy transfer
+            async with aiofiles.open(file_path, 'rb') as f:
+                await f.seek(start)
+                remaining = content_length
+                
+                while remaining > 0:
+                    chunk_size = min(self.chunk_size, remaining)
+                    chunk = await f.read(chunk_size)
+                    if not chunk:
+                        break
+                    await response.write(chunk)
+                    remaining -= len(chunk)
+            
+            await response.write_eof()
+            return response
+            
+        except Exception as e:
+            return web.Response(status=500, text=f"Range Request Error: {str(e)}")
+
+
+async def start_zero_copy_server(directory: str, port: int):
+    """zero-copy optimized server starts"""
+    handler = ZeroCopyStaticHandler(directory)
+    
+    # aiohttp app creation
+    app = web.Application()
+    app.router.add_route('GET', '/{path:.*}', handler.handle_request)
+    
+    # server configuration optimization
+    runner = web.AppRunner(
+        app,
+        access_log=None,  # access log disabled (performance improvement)
+        keepalive_timeout=75,  # Keep-Alive timeout
+        client_timeout=600,    # client timeout
+    )
+    
+    await runner.setup()
+    
+    site = web.TCPSite(
+        runner, 
+        '127.0.0.1', 
+        port,
+        backlog=1024,  # connection backlog size
+        reuse_address=True  # port reuse only
+    )
+    
+    await site.start()
+    
+    return runner, site
+
+
+def pyloid_serve(
+    directory: str,
+    port: Optional[int] = None,
+) -> str:
+    """
+    zero-copy optimized static file server starts.
+    
+    Args
+    ----
+    directory (str): Path to the static file directory to serve
+    port (int, optional): Server port (default: None - will use a random free port)
+    
+    Returns
+    -------
+    str
+        URL of the started server
+        
+    Examples
+    --------
+    ```python
+    from pyloid import Pyloid
+    from pyloid.serve import pyloid_serve
+    
+    app = Pyloid("Pyloid-App")
+    url = pyloid_serve("dist")
+    window = app.create_window("Pyloid-App")
+    window.load_url(url)
+    window.show_and_focus()
+    ```
+    """
+    
+    if port is None:
+        port = get_free_port()
+    
+    def run_zero_copy_server():
+        """run async server in a separate thread"""
+        loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(loop)
+        
+        try:
+            runner, site = loop.run_until_complete(
+                start_zero_copy_server(directory, port)
+            )
+            
+            print(f"🚀 Zero-copy server started on http://127.0.0.1:{port}")
+            print(f"📁 Serving directory: {directory}")
+            print(f"⚡ Features: sendfile, Range requests, ETag caching")
+            
+            # wait until the server starts
+            loop.run_forever()
+            
+        except Exception as e:
+            print(f"Zero-copy server error: {e}")
+        finally:
+            loop.close()
+    
+    # start server in a daemon thread
+    thread = threading.Thread(target=run_zero_copy_server, daemon=True)
+    thread.start()
+    
+    return f"http://127.0.0.1:{port}"

pyloid-0.24.7/src/pyloid/serve.py

@@ -1,56 +0,0 @@
-import threading
-from http.server import HTTPServer, SimpleHTTPRequestHandler
-from typing import Optional
-from .utils import get_free_port
-
-class CustomStaticHandler(SimpleHTTPRequestHandler):
-    def __init__(self, *args, directory=None, **kwargs):
-        super().__init__(*args, directory=directory, **kwargs)
-    
-    def log_message(self, format, *args):
-        pass
-
-def pyloid_serve(
-    directory: str,
-    port: Optional[int] = None,
-) -> str:
-    """
-    Static file server starts.
-    
-    Args
-    ----
-    directory (str): Path to the static file directory to serve
-    port (int, optional): Server port (default: None - will use a random free port)
-    
-    Returns
-    -------
-    str
-        URL of the started server
-        
-    Examples
-    --------
-    ```python
-    from pyloid import Pyloid
-    from pyloid.serve import pyloid_serve
-    
-    app = Pyloid("Pyloid-App")
-    url = pyloid_serve("dist")
-    window = app.create_window("Pyloid-App")
-    window.load_url(url)
-    window.show_and_focus()
-    ```
-    """
-    
-    if port is None:
-        port = get_free_port()
-    
-    handler = lambda *args: CustomStaticHandler(*args, directory=directory)
-    server = HTTPServer(("127.0.0.1", port), handler)
-    
-    thread = threading.Thread(
-        target=server.serve_forever,
-        daemon=True
-    )
-    thread.start()
-    
-    return f"http://127.0.0.1:{port}"