HTTP¶

La capa HTTP cubre requests, responses, headers, cookies y serializacion basica.

`Request`¶

Request representa una peticion ya parseada:

method
path
query_string
query
headers
body
client
tls

Helpers utiles:

body_text = request.text()
payload = request.json()

`Response`¶

Response soporta cuatro formas comunes:

Response.text("ok")
Response.html("<h1>hola</h1>")
Response.json({"ok": True})
Response.stream(iter(["a", "b", "c"]), content_type="text/plain")

Response.stream devuelve una respuesta en streaming con soporte para generadores, iterables y objetos con read().

Enrutado¶

App.view() y App.api() usan el router interno:

from wsbuilder import App, Response

app = App(cors_allow_origin="*")

@app.view("/hello")
def hello(_request):
    return Response.text("hola")

@app.api("/api/health")
def health(_request):
    return {"ok": True}

CORS y OPTIONS¶

App.dispatch() responde OPTIONS automaticamente cuando detecta una ruta registrada. Si cors_allow_origin esta definido, la respuesta incluye:

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Vary: Origin cuando no se usa *

Headers y cookies¶

La libreria trae helpers para nombres, lectura y escritura:

from wsbuilder import build_set_cookie, get_cookie, get_header, has_header, normalize_header_name, set_header

Usos comunes:

leer Authorization, Content-Type o cualquier header normalizado.
construir Set-Cookie con HttpOnly, Secure, SameSite y Max-Age.
inyectar headers de respuesta sin reescribir diccionarios manualmente.

Servidor HTTP¶

HTTPServer conecta el socket con App.dispatch(). Si quieres ejecutar tu app dentro de otro proceso, usa app.run(host, port) o integra el server en tu propio bootstrap.

Ejemplo compacto¶

from wsbuilder import App, Response

app = App()

@app.view("/sum")
def sum_view(request):
    a = int(request.query.get("a", "0"))
    b = int(request.query.get("b", "0"))
    return Response.json({"result": a + b})

Puntos de extension¶

parse_http_request para parseo de requests en bruto.
send_http_response si necesitas escribir respuestas manualmente.
parse_query_string para utilidades ligeras de query strings.