QSEWeb

High-performance web framework with C++ backend. Call Python from JavaScript easily.

Install

pip install qseweb

Example

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

app = qseweb.QSEWeb()              # Default: 0.0.0.0:5000
app = qseweb.QSEWeb(port=8080)     # Custom port

Make routes

@app.serve("/")
def home():
    return "<h1>Hello</h1>"

@app.serve("/about")
def about():
    return "<h1>About page</h1>"

Call Python from JavaScript

@app.assign("greet")
def greet(name):
    return f"Hello {name}!"

const msg = await qse.greet("World");  // "Hello World!"

Get request data

@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

app.stop()

# Or from web:
@app.serve("/shutdown")
def shutdown():
    import threading
    threading.Thread(target=app.stop, daemon=True).start()
    return "Stopping..."

Examples

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