webview-python 0.99.15__py3-none-any.whl

webview/_webview_ffi.py

@@ -0,0 +1,134 @@
+import ctypes
+import sys
+import os
+import platform
+import urllib.request
+from pathlib import Path
+from ctypes import c_int, c_char_p, c_void_p, CFUNCTYPE
+import ctypes.util
+
+def _encode_c_string(s: str) -> bytes:
+    return s.encode("utf-8")
+
+def _get_webview_version():
+    """Get webview version from environment variable or use default"""
+    return os.getenv("WEBVIEW_VERSION", "0.8.1")
+
+def _get_lib_names():
+    """Get platform-specific library names."""
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+    
+    if system == "windows":
+        if machine == "amd64" or machine == "x86_64":
+            return ["webview.dll", "WebView2Loader.dll"]
+        elif machine == "arm64":
+            raise Exception("arm64 is not supported on Windows")
+    elif system == "darwin":
+        if machine == "arm64":
+            return ["libwebview.aarch64.dylib"]
+        else:
+            return ["libwebview.x86_64.dylib"]
+    else:  # linux
+        return ["libwebview.so"]
+
+def _get_download_urls():
+    """Get the appropriate download URLs based on the platform."""
+    version = _get_webview_version()
+    return [f"https://github.com/webview/webview_deno/releases/download/{version}/{lib_name}" 
+            for lib_name in _get_lib_names()]
+
+def _be_sure_libraries():
+    """Ensure libraries exist and return paths."""
+    if getattr(sys, 'frozen', False):
+        if hasattr(sys, '_MEIPASS'):
+            base_dir = Path(sys._MEIPASS)
+        else:
+            base_dir = Path(sys.executable).parent / '_internal'
+    else:
+        base_dir = Path(__file__).parent
+    
+    lib_dir = base_dir / "lib"
+    lib_names = _get_lib_names()
+    lib_paths = [lib_dir / lib_name for lib_name in lib_names]
+    
+    # Check if any library is missing
+    missing_libs = [path for path in lib_paths if not path.exists()]
+    if not missing_libs:
+        return lib_paths
+
+    # Download missing libraries
+    download_urls = _get_download_urls()
+    system = platform.system().lower()
+    
+    lib_dir.mkdir(parents=True, exist_ok=True)
+    
+    for url, lib_path in zip(download_urls, lib_paths):
+        if lib_path.exists():
+            continue
+            
+        print(f"Downloading library from {url}")
+        try:
+            req = urllib.request.Request(
+                url,
+                headers={'User-Agent': 'Mozilla/5.0'}
+            )
+            with urllib.request.urlopen(req) as response, open(lib_path, 'wb') as out_file:
+                out_file.write(response.read())
+        except Exception as e:
+            raise RuntimeError(f"Failed to download library: {e}")
+    
+    return lib_paths
+
+class _WebviewLibrary:
+    def __init__(self):
+        lib_names=_get_lib_names()
+        try:
+            library_path = ctypes.util.find_library(lib_names[0])
+            if not library_path:
+                library_paths = _be_sure_libraries()
+            self.lib = ctypes.cdll.LoadLibrary(str(library_paths[0]))
+        except Exception as e:
+            print(f"Failed to load webview library: {e}")
+            raise
+        # Define FFI functions
+        self.webview_create = self.lib.webview_create
+        self.webview_create.argtypes = [c_int, c_void_p]
+        self.webview_create.restype = c_void_p
+
+        self.webview_destroy = self.lib.webview_destroy
+        self.webview_destroy.argtypes = [c_void_p]
+
+        self.webview_run = self.lib.webview_run
+        self.webview_run.argtypes = [c_void_p]
+
+        self.webview_terminate = self.lib.webview_terminate
+        self.webview_terminate.argtypes = [c_void_p]
+
+        self.webview_set_title = self.lib.webview_set_title
+        self.webview_set_title.argtypes = [c_void_p, c_char_p]
+
+        self.webview_set_size = self.lib.webview_set_size
+        self.webview_set_size.argtypes = [c_void_p, c_int, c_int, c_int]
+
+        self.webview_navigate = self.lib.webview_navigate
+        self.webview_navigate.argtypes = [c_void_p, c_char_p]
+
+        self.webview_init = self.lib.webview_init
+        self.webview_init.argtypes = [c_void_p, c_char_p]
+
+        self.webview_eval = self.lib.webview_eval
+        self.webview_eval.argtypes = [c_void_p, c_char_p]
+
+        self.webview_bind = self.lib.webview_bind
+        self.webview_bind.argtypes = [c_void_p, c_char_p, c_void_p, c_void_p]
+
+        self.webview_unbind = self.lib.webview_unbind
+        self.webview_unbind.argtypes = [c_void_p, c_char_p]
+
+        self.webview_return = self.lib.webview_return
+        self.webview_return.argtypes = [c_void_p, c_char_p, c_int, c_char_p]
+
+        self.CFUNCTYPE = CFUNCTYPE
+
+_webview_lib = _WebviewLibrary()

webview/webview.py

@@ -0,0 +1,92 @@
+from enum import IntEnum
+from typing import Optional, Callable, Any
+import json
+import ctypes
+from ._webview_ffi import _webview_lib, _encode_c_string
+
+class SizeHint(IntEnum):
+    NONE = 0
+    MIN = 1
+    MAX = 2
+    FIXED = 3
+
+class Size:
+    def __init__(self, width: int, height: int, hint: SizeHint):
+        self.width = width
+        self.height = height
+        self.hint = hint
+
+class Webview:
+    def __init__(self, debug: bool = False, size: Optional[Size] = None, window: Optional[int] = None):
+        self._handle = _webview_lib.webview_create(int(debug), window)
+        self._callbacks = {}
+
+        if size:
+            self.size = size
+
+    @property
+    def size(self) -> Size:
+        return self._size
+
+    @size.setter
+    def size(self, value: Size):
+        _webview_lib.webview_set_size(self._handle, value.width, value.height, value.hint)
+        self._size = value
+
+    @property
+    def title(self) -> str:
+        return self._title
+
+    @title.setter
+    def title(self, value: str):
+        _webview_lib.webview_set_title(self._handle, _encode_c_string(value))
+        self._title = value
+
+    def destroy(self):
+        for name in list(self._callbacks.keys()):
+            self.unbind(name)
+        _webview_lib.webview_terminate(self._handle)
+        _webview_lib.webview_destroy(self._handle)
+        self._handle = None
+
+    def navigate(self, url: str):
+        _webview_lib.webview_navigate(self._handle, _encode_c_string(url))
+
+    def run(self):
+        _webview_lib.webview_run(self._handle)
+        self.destroy()
+
+    def bind(self, name: str, callback: Callable[..., Any]):
+        def wrapper(seq: bytes, req: bytes, arg: int):
+            args = json.loads(req.decode())
+            try:
+                result = callback(*args)
+                success = True
+            except Exception as e:
+                result = str(e)
+                success = False
+            self.return_(seq.decode(), 0 if success else 1, json.dumps(result))
+
+        c_callback = _webview_lib.CFUNCTYPE(None, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_void_p)(wrapper)
+        self._callbacks[name] = c_callback
+        _webview_lib.webview_bind(self._handle, _encode_c_string(name), c_callback, None)
+
+    def unbind(self, name: str):
+        if name in self._callbacks:
+            _webview_lib.webview_unbind(self._handle, _encode_c_string(name))
+            del self._callbacks[name]
+
+    def return_(self, seq: str, status: int, result: str):
+        _webview_lib.webview_return(self._handle, _encode_c_string(seq), status, _encode_c_string(result))
+
+    def eval(self, source: str):
+        _webview_lib.webview_eval(self._handle, _encode_c_string(source))
+
+    def init(self, source: str):
+        _webview_lib.webview_init(self._handle, _encode_c_string(source))
+
+if __name__ == "__main__":
+    wv = Webview()
+    wv.title = "Hello, World!"
+    wv.navigate("https://www.google.com")
+    wv.run()

webview_python-0.99.15.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Python Webview Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

webview_python-0.99.15.dist-info/METADATA

@@ -0,0 +1,292 @@
+Metadata-Version: 2.1
+Name: webview_python
+Version: 0.99.15
+Summary: Python bindings for the webview library, which completely follow deno_webview design and principles
+License: MIT License
+        
+        Copyright (c) 2024 Python Webview Contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/congzhangzh/webview_python
+Project-URL: Repository, https://github.com/congzhangzh/webview_python.git
+Project-URL: Bug Tracker, https://github.com/congzhangzh/webview_python/issues
+Keywords: webview,gui,desktop,application,html,web
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Webview Python
+
+[![Test - Windows](https://github.com/congzhangzh/webview_python/actions/workflows/test.yml/badge.svg?branch=main&event=push&label=Windows)](https://github.com/congzhangzh/webview_python/actions/workflows/test.yml)
+[![Test - Linux](https://github.com/congzhangzh/webview_python/actions/workflows/test.yml/badge.svg?branch=main&event=push&label=Linux)](https://github.com/congzhangzh/webview_python/actions/workflows/test.yml)
+[![Test - macOS](https://github.com/congzhangzh/webview_python/actions/workflows/test.yml/badge.svg?branch=main&event=push&label=macOS)](https://github.com/congzhangzh/webview_python/actions/workflows/test.yml)
+[![PyPI version](https://badge.fury.io/py/webview_python.svg)](https://badge.fury.io/py/webview_python)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/pypi/pyversions/webview_python.svg)](https://pypi.org/project/webview_python/)
+
+Python bindings for the webview library, allowing you to create desktop applications with web technologies.
+
+## Installation
+
+```bash
+pip install webview_python
+```
+
+## Usage
+
+### Display Inline HTML:
+
+```python
+from webview.webview import Webview
+from urllib.parse import quote
+
+html = """
+<html>
+<body>
+<h1>Hello from Python Webview!</h1>
+</body>
+</html>
+"""
+webview = Webview()
+webview.navigate(f"data:text/html,{quote(html)}")
+webview.run()
+```
+
+### Load Local HTML File:
+
+```python
+from webview.webview import Webview
+import os
+
+webview = Webview()
+current_dir = os.path.dirname(os.path.abspath(__file__))
+html_path = os.path.join(current_dir, 'local.html')
+webview.navigate(f"file://{html_path}")
+webview.run()
+```
+
+### Load Remote URL:
+
+```python
+from webview.webview import Webview
+webview = Webview()
+webview.navigate("https://www.python.org")
+webview.run()
+```
+
+### Python-JavaScript Bindings:
+
+```python
+from webview.webview import Webview, Size, SizeHint
+from urllib.parse import quote
+
+webview = Webview(debug=True)
+
+# Python functions that can be called from JavaScript
+def hello():
+    webview.eval("updateFromPython('Hello from Python!')")
+    return "Hello from Python!"
+
+def add(a, b):
+    return a + b
+
+# Bind Python functions
+webview.bind("hello", hello)
+webview.bind("add", add)
+
+# Configure window
+webview.title = "Python-JavaScript Binding Demo"
+webview.size = Size(640, 480, SizeHint.FIXED)
+
+# Load HTML with JavaScript
+html = """
+<html>
+<head>
+    <title>Python-JavaScript Binding Demo</title>
+    <script>
+        async function callPython() {
+            const result = await hello();
+            document.getElementById('result').innerHTML = result;
+        }
+
+        async function callPythonWithArgs() {
+            const result = await add(40, 2);
+            document.getElementById('result').innerHTML = `Result: ${result}`;
+        }
+
+        function updateFromPython(message) {
+            document.getElementById('result').innerHTML = `Python says: ${message}`;
+        }
+    </script>
+</head>
+<body>
+    <h1>Python-JavaScript Binding Demo</h1>
+    <button onclick="callPython()">Call Python</button>
+    <button onclick="callPythonWithArgs()">Call Python with Args</button>
+    <div id="result"></div>
+</body>
+</html>
+"""
+
+webview.navigate(f"data:text/html,{quote(html)}")
+webview.run()
+```
+
+## Features
+
+- Create desktop applications using HTML, CSS, and JavaScript
+- Load local HTML files or remote URLs
+- Bidirectional Python-JavaScript communication
+- Window size and title customization
+- Debug mode for development
+- Cross-platform support (Windows, macOS, Linux)
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Install Python build tools
+pip install --upgrade pip build twine
+
+# Install GitHub CLI (choose one based on your OS):
+# macOS
+brew install gh
+
+# Windows
+winget install GitHub.cli
+# or
+choco install gh
+
+# Linux (Debian/Ubuntu)
+curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \
+&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
+&& sudo apt update \
+&& sudo apt install gh
+```
+
+### Running Tests
+
+```bash
+python -m unittest discover tests
+```
+
+### Project Structure
+
+```
+webview_python/
+├── src/
+│   ├── webview.py      # Main webview implementation
+│   └── ffi.py          # Foreign Function Interface
+├── examples/           # Example applications
+├── tests/             # Unit tests
+└── README.md          # Documentation
+```
+
+### Release Process
+
+For maintainers who want to release a new version:
+1. **Test**
+```bash
+# Install dependencies if not installed 
+pip install -r requirements.txt
+
+# Run tests
+pytest
+
+# Build wheels
+python -m build -n -w
+```
+
+2. **Update Version**
+   ```bash
+   # Ensure you have the latest code
+   git pull origin main
+   
+   # Update version in pyproject.toml
+   # Edit version = "x.y.z" to new version number
+   ```
+
+3. **Create Release**
+   ```bash
+   # Commit changes
+   old_version=0.99.0
+   new_version=0.99.1
+   git add pyproject.toml
+   git commit -m "Bump version to ${new_version}"
+   git push origin main
+
+   # Create and push tag
+   git tag v${new_version}
+   git push origin v${new_version}
+
+   # Create GitHub release
+    gh release create v${new_version} --title "${new_version}" \
+        --notes "Full Changelog: https://github.com/congzhangzh/webview_python/compare/v${old_version}...v${new_version}"
+   ```
+
+4. **Monitor Release**
+   - Check GitHub Actions progress in the Actions tab
+   - Verify package on PyPI after workflow completion
+
+### First-time Release Setup
+
+1. **PyPI Setup**
+   - Create account: https://pypi.org/account/register/
+   - Generate API token: https://pypi.org/manage/account/token/
+
+2. **GitHub Setup**
+   - Repository Settings → Secrets and variables → Actions
+   - Add new secret: `PYPI_API_TOKEN` with PyPI token value
+
+## Roadmap
+
+- [ ] Publish to PyPI
+- [ ] Setup GitHub Actions for CI/CD
+- [ ] Add preact example
+- [ ] Add three.js example
+- [ ] Add three.js fiber example
+- [ ] Add screen saver 4 window example
+- [ ] Add MRI principle demo example by three.js fiber
+- [ ] Add screen saver 4 windows with MRI principle demo example by three.js fiber
+
+## References
+
+- [Webview](https://github.com/webview/webview)
+- [webview_deno](https://github.com/eliassjogreen/webview_deno)
+
+# License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

webview_python-0.99.15.dist-info/RECORD

@@ -0,0 +1,8 @@
+webview/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+webview/_webview_ffi.py,sha256=xe3-MVoA7f-ZdhaNa3c_XBT35jQMDC7yKr80YXBvo60,4616
+webview/webview.py,sha256=AlW5SnasXeWS4skhwu30b0Upfr90SobVKU37MUZVTqc,2931
+webview_python-0.99.15.dist-info/LICENSE,sha256=I4hXdAjGE4JH-VoHpo4KKCdxNskzk_ECEhBjwP70xSU,1084
+webview_python-0.99.15.dist-info/METADATA,sha256=mabkhCU3vWyiGMhiqWjKhEsLPMM_BR-TjYMtJIXXu88,9223
+webview_python-0.99.15.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
+webview_python-0.99.15.dist-info/top_level.txt,sha256=d5SpaV1yBkWk3tar-VrEOX-bBM9jXPlVdVNpN5FQrxA,8
+webview_python-0.99.15.dist-info/RECORD,,

webview_python-0.99.15.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.3.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

webview_python-0.99.15.dist-info/top_level.txt

@@ -0,0 +1 @@
+webview