qseweb 1.0.0__py3-none-any.whl

qseweb/__init__.py

@@ -0,0 +1,147 @@
+from . import _qseweb_core
+import functools
+from typing import Callable, Any
+import json
+
+__version__ = "1.0.0"
+
+class QSEWeb:
+    
+    def __init__(self, host: str = "0.0.0.0", port: int = 5000):
+        self.host = host
+        self.port = port
+        self._initialized = False
+        self._js_functions = {}
+        
+    def _ensure_initialized(self):
+        if not self._initialized:
+            _qseweb_core.init(self.host, self.port)
+            self._initialized = True
+            self._register_js_bridge()
+    
+    def _register_js_bridge(self):
+        @self.serve("/__qseweb_call__")
+        def js_bridge():
+            return '{"status":"error","message":"Not implemented yet"}'
+    
+    def serve(self, path: str, methods: list = None):
+        if methods is None:
+            methods = ["GET"]
+            
+        def decorator(func: Callable) -> Callable:
+            self._ensure_initialized()
+            original_func = func
+            
+            @functools.wraps(func)
+            def wrapper(request=None):
+                import inspect
+                sig = inspect.signature(original_func)
+                if len(sig.parameters) > 0:
+                    result = original_func(request)
+                else:
+                    result = original_func()
+                    
+                if isinstance(result, str) and '<html' in result.lower() and self._js_functions:
+                    result = self._inject_js_bridge(result)
+                return result
+            
+            for method in methods:
+                _qseweb_core.add_route(path, method, wrapper)
+            
+            return wrapper
+        
+        return decorator
+    
+    def _inject_js_bridge(self, html: str) -> str:
+        bridge_code = """
+<script>
+(function() {
+    window.qse = window.qse || {};
+    const functions = """ + json.dumps(list(self._js_functions.keys())) + """;
+    
+    functions.forEach(funcName => {
+        window.qse[funcName] = async function(...args) {
+            try {
+                const response = await fetch('/__qseweb_call__/' + funcName + '?' + 
+                    args.map((arg, i) => 'arg' + i + '=' + encodeURIComponent(arg)).join('&'));
+                const data = await response.json();
+                if (data.status === 'success') {
+                    return data.result;
+                } else {
+                    console.error('QSEWeb error:', data.message);
+                    return null;
+                }
+            } catch (error) {
+                console.error('QSEWeb call failed:', error);
+                return null;
+            }
+        };
+    });
+    
+    console.log('✅ QSEWeb bridge loaded. Available functions:', functions);
+})();
+</script>
+"""
+        if '</body>' in html:
+            html = html.replace('</body>', bridge_code + '</body>')
+        elif '</head>' in html:
+            html = html.replace('</head>', bridge_code + '</head>')
+        else:
+            html = html + bridge_code
+        
+        return html
+    
+    def assign(self, name: str):
+        def decorator(func: Callable) -> Callable:
+            self._ensure_initialized()
+            _qseweb_core.assign_function(name, func)
+            self._js_functions[name] = func
+            route_path = f"/__qseweb_call__/{name}"
+            
+            @self.serve(route_path)
+            def js_handler(request=None):
+                if request and 'query' in request:
+                    args = []
+                    i = 0
+                    while f'arg{i}' in request['query']:
+                        args.append(request['query'][f'arg{i}'])
+                        i += 1
+                    
+                    try:
+                        result = func(*args)
+                        return json.dumps({"status": "success", "result": str(result)})
+                    except Exception as e:
+                        return json.dumps({"status": "error", "message": str(e)})
+                else:
+                    return json.dumps({"status": "error", "message": "No request data"})
+            
+            @functools.wraps(func)
+            def wrapper(*args, **kwargs):
+                return func(*args, **kwargs)
+            
+            return wrapper
+        
+        return decorator
+    
+    def run(self):
+        self._ensure_initialized()
+        print(f" * Running on http://{self.host}:{self.port}")
+        print(" * Press Ctrl+C to quit")
+        
+        try:
+            _qseweb_core.run()
+        except KeyboardInterrupt:
+            print("\n⚠️  Interrupted by Ctrl+C")
+            print("🛑 Shutting down server...")
+            _qseweb_core.stop()
+            print("✅ Server stopped\n")
+    
+    def stop(self):
+        _qseweb_core.stop()
+
+
+def create_app(host: str = "0.0.0.0", port: int = 5000) -> QSEWeb:
+    return QSEWeb(host=host, port=port)
+
+
+__all__ = ["QSEWeb", "create_app"]

qseweb-1.0.0.dist-info/METADATA

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: qseweb
+Version: 1.0.0
+Summary: High-performance Flask-like web framework with C++ backend
+Author: QSEWeb Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/qseweb
+Project-URL: Documentation, https://github.com/yourusername/qseweb#readme
+Project-URL: Repository, https://github.com/yourusername/qseweb
+Project-URL: Issues, https://github.com/yourusername/qseweb/issues
+Keywords: web,framework,http,server,flask,async,performance,c++
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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 :: 3.13
+Classifier: Programming Language :: C++
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# QSEWeb
+
+High-performance web framework with C++ backend. Call Python from JavaScript easily.
+
+## Install
+
+```bash
+pip install qseweb
+```
+
+## Example
+
+```python
+import qseweb
+
+app = qseweb.QSEWeb()
+
+@app.assign("Btn")
+def button():
+    print("Button clicked")
+    return "success"
+
+@app.serve("/")
+def main():
+    return """
+    <html>
+    <body>
+        <h1>Click the button</h1>
+        <button onclick="button()">Click me</button>
+        
+        <script>
+        async function button() {
+            const response = await qse.Btn();
+            alert(response);
+        }
+        </script>
+    </body>
+    </html>
+    """
+
+print("Starting server on http://localhost:5000")
+app.run()
+```
+
+That's it! Run it and click the button.
+
+## How it works
+
+1. Use `@app.assign("name")` to expose Python functions
+2. Call them from JavaScript with `await qse.name()`
+3. Python function runs, returns result to JavaScript
+
+## API
+
+### Create app
+```python
+app = qseweb.QSEWeb()              # Default: 0.0.0.0:5000
+app = qseweb.QSEWeb(port=8080)     # Custom port
+```
+
+### Make routes
+```python
+@app.serve("/")
+def home():
+    return "<h1>Hello</h1>"
+
+@app.serve("/about")
+def about():
+    return "<h1>About page</h1>"
+```
+
+### Call Python from JavaScript
+```python
+@app.assign("greet")
+def greet(name):
+    return f"Hello {name}!"
+```
+
+```javascript
+const msg = await qse.greet("World");  // "Hello World!"
+```
+
+### Get request data
+```python
+@app.serve("/api")
+def api(request):
+    user_id = request['query'].get('id')    # Query params
+    method = request['method']              # GET, POST, etc
+    path = request['path']                  # URL path
+    body = request.get('body', '')          # Request body
+    return f"User: {user_id}"
+```
+
+### Stop server
+```python
+app.stop()
+
+# Or from web:
+@app.serve("/shutdown")
+def shutdown():
+    import threading
+    threading.Thread(target=app.stop, daemon=True).start()
+    return "Stopping..."
+```
+
+## Examples
+
+```bash
+python examples/basic.py              # Hello world
+python examples/javascript_bridge.py  # JS ↔ Python
+python examples/server_control.py     # Start/stop
+python examples/advanced.py           # Full demo
+```
+
+## Features
+
+- ✅ Flask-like API
+- ✅ Call Python from JavaScript (`qse.function()`)
+- ✅ Multi-threaded C++ backend
+- ✅ Fast routing
+- ✅ Async with Ctrl+C support
+- ✅ Pre-compiled (no build needed)
+
+## Requirements
+
+- Python 3.7+
+- Windows (pre-compiled .pyd included)
+
+## License
+
+MIT

qseweb-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+qseweb/__init__.py,sha256=G414h8PpQtQ7h0681Y3gKyyn2i8K3QaFlJVV7d5XgIE,5036
+qseweb/_qseweb_core.pyd,sha256=vUbJIjZUJGvG2eSSU84sOaslZq-wD5qofKwWjjYiW-M,142848
+qseweb-1.0.0.dist-info/licenses/LICENSE,sha256=W8WcgqYeS9lGBqmCiqIlbglbjgF3OrlFQAEaK9KLDn8,1097
+qseweb-1.0.0.dist-info/METADATA,sha256=5nbo57VcAz1yjEEStc7gZx6JBJcmmfm_xtSjH7OQh9Y,3955
+qseweb-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+qseweb-1.0.0.dist-info/top_level.txt,sha256=OnOqpc3fbNFMKBV4DEjzjuEPdz82jhF1Glm6dsxDOqU,7
+qseweb-1.0.0.dist-info/RECORD,,

qseweb-1.0.0.dist-info/WHEEL

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

qseweb-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QSEWeb 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.

qseweb-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+qseweb