wsbuilder 0.1.0__tar.gz

wsbuilder-0.1.0/LICENSE

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

wsbuilder-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: wsbuilder
+Version: 0.1.0
+Summary: Framework ligero HTTP + WebSocket extraido de PortHound4.
+Author: wsbuilder Authors
+License-Expression: MIT
+Keywords: websocket,http,framework,server,python
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# wsbuilder
+
+`wsbuilder` es un paquete Python extraido de `PortHound4` para construir servidores HTTP + WebSocket sin dependencias externas.
+
+## Incluye
+
+- `wsbuilder.framework`: router, request/response, servidor HTTP, handshake WS y utilidades de frames.
+- `wsbuilder.ws_demo`: demo completo HTTP + WebSocket + REST + SQLite.
+
+## Instalacion local
+
+```bash
+python -m pip install -e .
+```
+
+## Uso rapido del framework
+
+```python
+from wsbuilder import App, Response, parse_close_payload
+
+app = App()
+
+@app.view("/")
+def home(_request):
+    return Response.html("<h1>wsbuilder</h1>")
+
+@app.api("/api/health")
+def health(_request):
+    return {"ok": True}
+
+@app.ws("/ws/")
+def ws_handler(ws, _request):
+    while True:
+        fin, opcode, payload, _masked, _mask = ws.recv_frame()
+        if opcode == 0x8:
+            code, reason = parse_close_payload(payload)
+            ws.close(code or 1000, reason or "")
+            break
+        if opcode == 0x9:
+            ws.send_pong(payload)
+            continue
+        if opcode == 0x1:
+            ws.send_text(payload.decode("utf-8", errors="ignore"))
+        elif opcode == 0x2:
+            ws.send_binary(payload)
+
+app.run("0.0.0.0", 8765)
+```
+
+## Ejecutar demo incluido
+
+```bash
+python -m wsbuilder --host 0.0.0.0 --port 8765
+# o
+wsbuilder --host 0.0.0.0 --port 8765
+```
+
+## Variables de entorno
+
+- `WSBUILDER_CORS_ALLOW_ORIGIN`: valor CORS para rutas `@app.api`.
+- Compatibilidad heredada: tambien respeta `PORTHOUND_CORS_ALLOW_ORIGIN`.

wsbuilder-0.1.0/README.md

@@ -0,0 +1,61 @@
+# wsbuilder
+
+`wsbuilder` es un paquete Python extraido de `PortHound4` para construir servidores HTTP + WebSocket sin dependencias externas.
+
+## Incluye
+
+- `wsbuilder.framework`: router, request/response, servidor HTTP, handshake WS y utilidades de frames.
+- `wsbuilder.ws_demo`: demo completo HTTP + WebSocket + REST + SQLite.
+
+## Instalacion local
+
+```bash
+python -m pip install -e .
+```
+
+## Uso rapido del framework
+
+```python
+from wsbuilder import App, Response, parse_close_payload
+
+app = App()
+
+@app.view("/")
+def home(_request):
+    return Response.html("<h1>wsbuilder</h1>")
+
+@app.api("/api/health")
+def health(_request):
+    return {"ok": True}
+
+@app.ws("/ws/")
+def ws_handler(ws, _request):
+    while True:
+        fin, opcode, payload, _masked, _mask = ws.recv_frame()
+        if opcode == 0x8:
+            code, reason = parse_close_payload(payload)
+            ws.close(code or 1000, reason or "")
+            break
+        if opcode == 0x9:
+            ws.send_pong(payload)
+            continue
+        if opcode == 0x1:
+            ws.send_text(payload.decode("utf-8", errors="ignore"))
+        elif opcode == 0x2:
+            ws.send_binary(payload)
+
+app.run("0.0.0.0", 8765)
+```
+
+## Ejecutar demo incluido
+
+```bash
+python -m wsbuilder --host 0.0.0.0 --port 8765
+# o
+wsbuilder --host 0.0.0.0 --port 8765
+```
+
+## Variables de entorno
+
+- `WSBUILDER_CORS_ALLOW_ORIGIN`: valor CORS para rutas `@app.api`.
+- Compatibilidad heredada: tambien respeta `PORTHOUND_CORS_ALLOW_ORIGIN`.

wsbuilder-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wsbuilder"
+version = "0.1.0"
+description = "Framework ligero HTTP + WebSocket extraido de PortHound4."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "wsbuilder Authors" }]
+keywords = ["websocket", "http", "framework", "server", "python"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+]
+
+[project.scripts]
+wsbuilder = "wsbuilder.__main__:main"
+wsbuilder-demo = "wsbuilder.__main__:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = ["wsbuilder"]

wsbuilder-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wsbuilder-0.1.0/src/wsbuilder/__init__.py

@@ -0,0 +1,27 @@
+"""wsbuilder: mini framework HTTP + WebSocket extraido de PortHound4."""
+
+from .framework import (
+    App,
+    HTTPServer,
+    Request,
+    Response,
+    Route,
+    Router,
+    WebSocket,
+    parse_close_payload,
+    parse_query_string,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "App",
+    "HTTPServer",
+    "Request",
+    "Response",
+    "Route",
+    "Router",
+    "WebSocket",
+    "parse_close_payload",
+    "parse_query_string",
+]

wsbuilder-0.1.0/src/wsbuilder/__main__.py

@@ -0,0 +1,17 @@
+import argparse
+
+from .ws_demo import HOST, PORT, run_server
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Levanta el demo HTTP + WebSocket incluido en wsbuilder"
+    )
+    parser.add_argument("--host", default=HOST, help="Host de escucha")
+    parser.add_argument("--port", type=int, default=PORT, help="Puerto de escucha")
+    args = parser.parse_args()
+    run_server(args.host, args.port)
+
+
+if __name__ == "__main__":
+    main()