NexusServer

A lightweight, pure-Python HTTP server and web framework: routing, middleware, cookies, sessions, SQLite helpers. No dependencies beyond the standard library.

Version 26.2.0 (see CHANGELOG) · Python 3.9+ · MIT

Install

pip install -e .

Quick start

from nexusserver import Application

app = Application()

@app.get("/")
def index(request):
    return "Hello, world!"

if __name__ == "__main__":
    app.run()

Run it with the CLI (the target is module:attribute):

python -m nexusserver examples.hello_server:app --port 8080
# or, after pip install:
nexusserver examples.hello_server:app --port 8080

Features

• Threaded HTTP/1.1 server (one request per connection)
• Decorator routing with <int:id>, <str:name>, <path:rest>
• Handlers return str, bytes, dict/list (JSON), Response, or (body, status[, headers])
• Middleware: CORS, security headers, sessions, gzip, request logging (+ your own)
• Cookies, form and JSON bodies, query strings
• SQLite helper with one-shot, idempotent migrations
• Static file helpers with path-traversal protection

Documentation

Examples

All in examples/, each runnable with python -m nexusserver examples.<name>:app:

Tests

pip install pytest
pytest

pypi-AgEIcHlwaS5vcmcCJGNjN2MyODg1LTNkNDQtNDlhMS05NGNhLWM2YzBlNGZkNTdhOQACKlszLCIwYWUwZTUyNi04YWZjLTRmNjMtOGQ0Yy01Yjc5NWUxNjFlODgiXQAABiC-8FJ1b5b0XxmJs8JSqMtzvkRMZNr6S_DNj51gbBB69Q

pypi-AgENdGVzdC5weXBpLm9yZwIkYTc1MzA2NWYtMDdjMi00YWI0LThjMzUtZTViMzI0NWFlNTczAAIqWzMsImNmOGYxMDM3LWYzYTgtNGQ2OS04YjgxLWZlZWFhOTY2NjNhOCJdAAAGIO1A8STfMWdTusfzQ-RiGKSyhosPK4lVE5X34uTbq-bo

$secureToken = Read-Host "pypi-AgENdGVzdC5weXBpLm9yZwIkYTc1MzA2NWYtMDdjMi00YWI0LThjMzUtZTViMzI0NWFlNTczAAIqWzMsImNmOGYxMDM3LWYzYTgtNGQ2OS04YjgxLWZlZWFhOTY2NjNhOCJdAAAGIO1A8STfMWdTusfzQ-RiGKSyhosPK4lVE5X34uTbq-bo" -AsSecureString $env:TWINE_USERNAME = "token" $env:TWINE_PASSWORD = [System.Net.NetworkCredential]::new("", $secureToken).Password

python -m twine upload --verbose --repository testpypi dist/*

Remove-Item Env:TWINE_USERNAME -ErrorAction SilentlyContinue Remove-Item Env:TWINE_PASSWORD -ErrorAction SilentlyContinue Remove-Variable secureToken -ErrorAction SilentlyContinue