wsbuilder 1.2.10__tar.gz → 1.2.12__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {wsbuilder-1.2.10/src/wsbuilder.egg-info → wsbuilder-1.2.12}/PKG-INFO +1 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/api-map.md +1 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/app-http.md +12 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/cache-security.md +1 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/data-orm.md +11 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/dns.md +18 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/http-versions.md +26 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/http.md +27 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/network-edge.md +6 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/proxy.md +25 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/reference/index.md +2 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/websocket.md +5 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/app.py +21 -7
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/pyproject.toml +1 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/__init__.py +38 -12
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/__main__.py +1 -1
- wsbuilder-1.2.12/src/wsbuilder/_pragma.py +36 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/app.py +43 -23
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/cache.py +2 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/caches.py +3 -2
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/db_replicas.py +6 -7
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/dns.py +219 -39
- wsbuilder-1.2.12/src/wsbuilder/headers.py +147 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http.py +42 -18
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http1.py +21 -3
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http2.py +117 -12
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http3.py +31 -4
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http3_server.py +27 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/orm.py +23 -11
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/proxyi.py +148 -13
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/connection.py +179 -6
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/frames.py +68 -7
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/server.py +107 -22
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/ws.py +47 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12/src/wsbuilder.egg-info}/PKG-INFO +1 -1
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/SOURCES.txt +3 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_app_threads.py +11 -3
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_cache.py +25 -5
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_caches.py +27 -6
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_dns.py +242 -0
- wsbuilder-1.2.12/tests/test_example_full_project.py +80 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_headers_cookies.py +24 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http.py +48 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http2.py +250 -5
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http3.py +60 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http3_streaming.py +95 -0
- wsbuilder-1.2.12/tests/test_optional_extras.py +108 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_orm.py +71 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_pki.py +5 -4
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_proxyi.py +159 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_recovery.py +217 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_server.py +197 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_ws.py +75 -0
- wsbuilder-1.2.10/src/wsbuilder/headers.py +0 -52
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/LICENSE +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/MANIFEST.in +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/README.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/404.html +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/CNAME +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/advanced.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/ai-predict.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/architecture.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/assets/wsbuilder-mark.svg +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/beginners.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/cache.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/capabilities.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/full-project.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/getting-started.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/help/index.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/ia.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/index.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/install.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/intermediate.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/mdns.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/observability-tasks.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/observability.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/persistence.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/security.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/stylesheets/extra.css +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/tasks.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/tls-certificates.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/.gitignore +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/README.md +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/pyproject.toml +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/upstream.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/mkdocs.yml +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/setup.cfg +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/_coerce.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/constants.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/cookies.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/framework.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/hpack.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http3_websocket.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/ia.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/logs.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/mdns.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/metrics.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/pki.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/predicts.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/qpack.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/__init__.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/address.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/crypto.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/packet.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/recovery.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/tls.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/varint.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/security.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/tasks.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/dependency_links.txt +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/entry_points.txt +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/requires.txt +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/top_level.txt +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_contributing_policy.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_demo_monitor.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_docs.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_documentation_files.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_hpack.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http1.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http3_server.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http3_streaming_udp.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_ia.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_logs.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_mdns.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_metrics.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_orm_replicas.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_pr_identity_policy.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_predicts.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_proxyi_routing.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_address.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_crypto.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_protocol.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_tls.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_security.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_server_errors.py +0 -0
- {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_tasks.py +0 -0
|
@@ -65,7 +65,7 @@ Filtros `QuerySet` documentados:
|
|
|
65
65
|
|
|
66
66
|
| Grupo | Exportaciones |
|
|
67
67
|
| --- | --- |
|
|
68
|
-
| Cabeceras | `normalize_header_name`, `get_header`, `has_header`, `set_header` |
|
|
68
|
+
| Cabeceras | `normalize_header_name`, `get_header`, `has_header`, `set_header`, `add_header` |
|
|
69
69
|
| Cookies | `parse_cookie_header`, `get_cookie`, `build_set_cookie` |
|
|
70
70
|
|
|
71
71
|
## DNS y proxy
|
|
@@ -249,7 +249,7 @@ Limites por defecto:
|
|
|
249
249
|
| `MAX_CONNECTION_WORKERS` | `64` conexiones activas |
|
|
250
250
|
| `MAX_REQUEST_HEADER_BYTES` | `64 KiB` |
|
|
251
251
|
| `MAX_REQUEST_BODY_BYTES` | `2 MiB` |
|
|
252
|
-
| `REQUEST_READ_TIMEOUT_SECONDS` | `10.0` segundos |
|
|
252
|
+
| `REQUEST_READ_TIMEOUT_SECONDS` | `10.0` segundos en total para leer cabeceras y cuerpo |
|
|
253
253
|
| `KEEPALIVE_TIMEOUT_SECONDS` | `5.0` segundos entre peticiones |
|
|
254
254
|
| `MAX_KEEPALIVE_REQUESTS` | `100` peticiones por conexion |
|
|
255
255
|
| `MAX_CONCURRENT_STREAMS` | `100` streams HTTP/2 |
|
|
@@ -258,6 +258,17 @@ Limites por defecto:
|
|
|
258
258
|
| `HANDLE_SIGTERM` | `True`: `SIGTERM` detiene el servidor de forma ordenada |
|
|
259
259
|
| `MAX_WS_FRAME_BYTES` / `MAX_WS_MESSAGE_BYTES` | `None`: usa los `2 MiB` de `wsbuilder.ws` |
|
|
260
260
|
|
|
261
|
+
`REQUEST_READ_TIMEOUT_SECONDS` es un plazo total: cuenta desde que llegan los
|
|
262
|
+
primeros bytes de la peticion hasta que se ha leido el cuerpo completo, de modo
|
|
263
|
+
que un cliente que envia los bytes muy despacio recibe `408` al agotarlo
|
|
264
|
+
aunque cada lectura individual sea rapida. `KEEPALIVE_TIMEOUT_SECONDS` solo
|
|
265
|
+
limita la espera entre peticiones de una conexion reutilizada.
|
|
266
|
+
|
|
267
|
+
Con `app.enable_security()`, el servidor HTTP/1 evalua la lista negra, la ACL y
|
|
268
|
+
el rate limit con las cabeceras, antes de responder `100 Continue` y antes de
|
|
269
|
+
leer el cuerpo. Una peticion denegada recibe la respuesta de seguridad y la
|
|
270
|
+
conexion se cierra; `App.dispatch()` no vuelve a evaluar la misma peticion.
|
|
271
|
+
|
|
261
272
|
Se cambian con argumentos al crear el servidor, en `app.run()` o desde la CLI.
|
|
262
273
|
Un valor invalido (cero workers, timeout `0`, tamano negativo) lanza
|
|
263
274
|
`ValueError`; una clave desconocida, `TypeError`.
|
|
@@ -30,6 +30,11 @@ Capacidades principales:
|
|
|
30
30
|
- `read_replica_*` para lecturas balanceadas.
|
|
31
31
|
- `set_pragma`, `get_pragma`, `checkpoint`, `vacuum`, `optimize`.
|
|
32
32
|
|
|
33
|
+
`set_pragma` (y los `pragmas` del constructor, de las replicas y del cache)
|
|
34
|
+
solo acepta numeros, booleanos o una palabra clave simple como `WAL` o
|
|
35
|
+
`NORMAL`; cualquier otro valor lanza `ValueError`, porque los PRAGMA no admiten
|
|
36
|
+
parametros enlazados.
|
|
37
|
+
|
|
33
38
|
Los lotes de escritura ejecutados con `executemany` son atomicos: si una fila
|
|
34
39
|
falla, el prefijo ya procesado se revierte. `replica_count` debe ser mayor que
|
|
35
40
|
cero cuando se construye un pool de replicas.
|
|
@@ -94,6 +99,12 @@ Metodos utiles:
|
|
|
94
99
|
- `count`, `exists`, `update`, `delete`, `create`
|
|
95
100
|
- `where_raw`, `using`
|
|
96
101
|
|
|
102
|
+
`update()` y `delete()` respetan el slice: con `limit` u `offset` (y su
|
|
103
|
+
`order_by`) solo cambian las filas que seleccionaria la consulta, mediante una
|
|
104
|
+
subconsulta por clave primaria (o `rowid` si el modelo no declara una). Asi
|
|
105
|
+
`Note.objects(db).order_by("-id").limit(1).delete()` borra una sola fila. Sin
|
|
106
|
+
slice el `WHERE` es el de los filtros, como antes.
|
|
107
|
+
|
|
97
108
|
Ejemplo con replica de lectura:
|
|
98
109
|
|
|
99
110
|
```python
|
|
@@ -43,6 +43,24 @@ La resolucion soporta:
|
|
|
43
43
|
- upstream servers opcionales
|
|
44
44
|
- fallback cuando el upstream no responde
|
|
45
45
|
|
|
46
|
+
## Endurecimiento UDP
|
|
47
|
+
|
|
48
|
+
- Una consulta con un numero de preguntas distinto de uno (`MAX_QUESTIONS = 1`)
|
|
49
|
+
recibe `FORMERR`.
|
|
50
|
+
- Las respuestas se limitan a 512 bytes, o al tamano que anuncia un registro
|
|
51
|
+
EDNS(0) `OPT` del cliente con tope en `max_udp_payload` (1232 por defecto). Si
|
|
52
|
+
no caben, se envia solo la pregunta con el bit `TC`. El servidor no tiene
|
|
53
|
+
listener TCP, asi que un cliente sin EDNS no obtiene respuestas mayores de 512
|
|
54
|
+
bytes; esto evita la amplificacion.
|
|
55
|
+
- Un `OSError` al recibir o enviar un datagrama se registra con
|
|
56
|
+
`wsbuilder.logs` y el bucle sigue.
|
|
57
|
+
- El reenvio a upstreams corre en un pool acotado (`upstream_workers=4`,
|
|
58
|
+
`max_pending_upstream=64`) y no bloquea las respuestas locales. Con el pool
|
|
59
|
+
lleno se responde `SERVFAIL`; `close()` lo detiene.
|
|
60
|
+
|
|
61
|
+
Opciones nuevas solo por clave: `upstream_workers`, `max_pending_upstream`,
|
|
62
|
+
`max_udp_payload` y `app` (destino de los logs, via `get_log(app)`).
|
|
63
|
+
|
|
46
64
|
## Ejemplo de test
|
|
47
65
|
|
|
48
66
|
```python
|
|
@@ -73,6 +73,19 @@ Notas de comportamiento que conviene conocer:
|
|
|
73
73
|
|
|
74
74
|
- Un handler que lanza responde **500**, igual que en HTTP/1, en vez de
|
|
75
75
|
`RST_STREAM`. Se mantiene la coherencia con el resto del framework.
|
|
76
|
+
- Los handlers se ejecutan fuera del bucle que lee frames, en un pool por
|
|
77
|
+
conexion (como mucho `MAX_HANDLER_THREADS`, 16, y nunca mas que
|
|
78
|
+
`MAX_CONCURRENT_STREAMS`). Un handler lento no bloquea `PING`,
|
|
79
|
+
`WINDOW_UPDATE` ni los demas streams. Un stream que el cliente resetea
|
|
80
|
+
mientras su handler trabaja no recibe respuesta, y una respuesta que no se
|
|
81
|
+
puede codificar termina en `RST_STREAM` `INTERNAL_ERROR`.
|
|
82
|
+
- Los campos repetidos de la peticion se combinan como en HTTP/1: `cookie` con
|
|
83
|
+
`"; "` y el resto con `", "`. Un `host` o `content-length` repetido con
|
|
84
|
+
valores distintos es una peticion malformada. Los nombres deben ser tokens en
|
|
85
|
+
minuscula y los valores no pueden contener CR, LF ni NUL ni empezar o acabar
|
|
86
|
+
en espacio; si no, el stream se resetea con `PROTOCOL_ERROR` (en HTTP/3,
|
|
87
|
+
`H3_MESSAGE_ERROR`). Un `content-length` que no coincide con los DATA
|
|
88
|
+
recibidos tambien es `PROTOCOL_ERROR`.
|
|
76
89
|
- Una respuesta mayor que la ventana del par **se encola** y sale cuando llega
|
|
77
90
|
credito. Bloquear pararia todos los demas streams de la conexion.
|
|
78
91
|
- `PRIORITY` se valida pero no se usa: RFC 9113 lo declara obsoleto.
|
|
@@ -102,6 +115,11 @@ def algo(request):
|
|
|
102
115
|
|
|
103
116
|
- Una respuesta con `stream=` se envia por trozos a medida que el generador los
|
|
104
117
|
produce, en lugar de unirse en memoria. Sirve para SSE y respuestas largas.
|
|
118
|
+
El productor espera cuando el stream tiene mas de
|
|
119
|
+
`Http3Server.MAX_PENDING_STREAM_BYTES` (256 KiB) sin enviar; si no hay sitio
|
|
120
|
+
en `STREAM_STALL_TIMEOUT_SECONDS` (30 s), o el generador falla, el stream se
|
|
121
|
+
abandona con `RESET_STREAM` (`H3_INTERNAL_ERROR`) en vez de un FIN que haria
|
|
122
|
+
pasar la respuesta truncada por completa.
|
|
105
123
|
- Un `CONNECT` con `:protocol: websocket` (RFC 9220) se responde 200 y el stream
|
|
106
124
|
queda abierto en ambos sentidos. Las rutas `@app.ws(...)` se ejecutan sobre
|
|
107
125
|
ese stream con la misma API que en HTTP/1.1, asi que el handler no cambia.
|
|
@@ -188,7 +206,14 @@ solo describian el pasado, como un ACK, se descartan al retransmitir.
|
|
|
188
206
|
|
|
189
207
|
El control de congestion es NewReno: slow start hasta la primera perdida, luego
|
|
190
208
|
crecimiento lineal, con la ventana partida por la mitad y un unico evento de
|
|
191
|
-
congestion por RTT.
|
|
209
|
+
congestion por RTT. Los datos nuevos de los streams solo salen mientras
|
|
210
|
+
`bytes_in_flight` cabe en la ventana; las retransmisiones y los probes de PTO no
|
|
211
|
+
esperan. No hay deteccion de congestion persistente ni pacing.
|
|
212
|
+
|
|
213
|
+
El emisor tambien respeta el control de flujo del par: `initial_max_data`,
|
|
214
|
+
`initial_max_stream_data_*` y los `MAX_DATA` / `MAX_STREAM_DATA` que llegan
|
|
215
|
+
despues. Un stream bloqueado no frena a los demas, y el bloqueo se anuncia una
|
|
216
|
+
vez por limite con `DATA_BLOCKED` o `STREAM_DATA_BLOCKED`.
|
|
192
217
|
|
|
193
218
|
```python
|
|
194
219
|
app.enable_metrics() # el snapshot incluye rtt, ventana y perdidas
|
|
@@ -34,6 +34,20 @@ Response.stream(iter(["a", "b", "c"]), content_type="text/plain")
|
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
`Response.stream` devuelve una respuesta en streaming con soporte para generadores, iterables y objetos con `read()`.
|
|
37
|
+
Al terminar el envio (o si el cliente se desconecta) el servidor llama a
|
|
38
|
+
`close()` sobre el origen del stream cuando existe.
|
|
39
|
+
|
|
40
|
+
`Response.headers` es un diccionario con un valor por nombre. Un valor puede ser
|
|
41
|
+
una lista o tupla para enviar el campo repetido, que es lo que necesita
|
|
42
|
+
`Set-Cookie`:
|
|
43
|
+
|
|
44
|
+
```python
|
|
45
|
+
Response.text("ok", headers={"Set-Cookie": ["a=1; Path=/", "b=2; HttpOnly"]})
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
HTTP/1 escribe una linea por valor y HTTP/2 y HTTP/3 un campo por valor. En las
|
|
49
|
+
vistas con workers, la cookie de afinidad se anade a las del handler, de modo
|
|
50
|
+
que `response.headers["Set-Cookie"]` puede ser una lista.
|
|
37
51
|
|
|
38
52
|
## Enrutado
|
|
39
53
|
|
|
@@ -68,9 +82,21 @@ Si `cors_allow_origin` esta definido, la respuesta incluye:
|
|
|
68
82
|
La libreria trae helpers para nombres, lectura y escritura:
|
|
69
83
|
|
|
70
84
|
```python
|
|
71
|
-
from wsbuilder import
|
|
85
|
+
from wsbuilder import (
|
|
86
|
+
add_header,
|
|
87
|
+
build_set_cookie,
|
|
88
|
+
get_cookie,
|
|
89
|
+
get_header,
|
|
90
|
+
has_header,
|
|
91
|
+
normalize_header_name,
|
|
92
|
+
set_header,
|
|
93
|
+
)
|
|
72
94
|
```
|
|
73
95
|
|
|
96
|
+
`add_header(headers, name, value)` anade un valor sin reemplazar los
|
|
97
|
+
existentes: el campo pasa a ser una lista. `get_header` devuelve el valor tal
|
|
98
|
+
cual, que puede ser una lista si el campo se repite.
|
|
99
|
+
|
|
74
100
|
Usos comunes:
|
|
75
101
|
|
|
76
102
|
- leer `Authorization`, `Content-Type` o cualquier header normalizado.
|
|
@@ -155,7 +155,12 @@ ProxyI elimina headers hop-by-hop, incluidos los nombrados por `Connection`, y
|
|
|
155
155
|
reconstruye `X-Forwarded-*` desde el peer, host y TLS reales. No reutiliza
|
|
156
156
|
valores `Forwarded` aportados por un cliente directo. El limite
|
|
157
157
|
`max_request_body_bytes` tambien se aplica al usar `dispatch()` directamente y
|
|
158
|
-
responde `413` cuando el cuerpo lo supera.
|
|
158
|
+
responde `413` cuando el cuerpo lo supera. Los paths con segmentos `.`/`..`
|
|
159
|
+
(tambien codificados) reciben `400`; los cuerpos de respuesta con buffer se
|
|
160
|
+
limitan con `max_response_bytes` (`502`) y `response_timeout_seconds` (`504`), y
|
|
161
|
+
las respuestas sin longitud o SSE se retransmiten en streaming. La cabecera
|
|
162
|
+
`X-ProxyI-Upstream` solo se envia con `expose_upstream_header=True`. Detalles en
|
|
163
|
+
[Proxy](proxy.md).
|
|
159
164
|
|
|
160
165
|
Para despachar trafico real, una ruta HTTP de tu aplicacion debe invocar
|
|
161
166
|
`app.proxyi.dispatch(request)`.
|
|
@@ -40,6 +40,31 @@ proxy.vhost("api.test.local", name="api-vhost").location("/api").upstream("http:
|
|
|
40
40
|
- `verify_tls`
|
|
41
41
|
- `extra_headers`
|
|
42
42
|
|
|
43
|
+
## Seguridad y limites de respuesta
|
|
44
|
+
|
|
45
|
+
`ProxyI` acepta estas opciones al construirse:
|
|
46
|
+
|
|
47
|
+
| Opcion | Defecto | Efecto |
|
|
48
|
+
| --- | --- | --- |
|
|
49
|
+
| `max_request_body_bytes` | `8 MiB` | Un cuerpo de peticion mayor recibe `413`. |
|
|
50
|
+
| `max_response_bytes` | `16 MiB` | Un cuerpo de upstream con buffer mayor recibe `502`. |
|
|
51
|
+
| `response_timeout_seconds` | `30.0` | Plazo total para leer un cuerpo con buffer; si se agota, `504`. |
|
|
52
|
+
| `expose_upstream_header` | `False` | Con `True` anade `X-ProxyI-Upstream` con la URL interna del upstream. |
|
|
53
|
+
|
|
54
|
+
- Un path con segmentos `.` o `..`, literales o codificados (`%2e`, `%2f`,
|
|
55
|
+
`%5c`, tambien `..;param`), se rechaza con `400` antes de evaluar reglas, para
|
|
56
|
+
que no escape de un prefijo ni del `base_path` del target.
|
|
57
|
+
- Las respuestas con `Content-Length` se leen con buffer bajo esos dos limites.
|
|
58
|
+
Las respuestas `chunked`, delimitadas por el cierre de la conexion o
|
|
59
|
+
`text/event-stream` se retransmiten como `Response.stream` por bloques, sin
|
|
60
|
+
cargarlas en memoria. En ese modo no hay plazo total ni limite de bytes: cada
|
|
61
|
+
lectura respeta `timeout_seconds` del target, de modo que un upstream que sigue
|
|
62
|
+
enviando datos (por ejemplo SSE) mantiene ocupado el worker mientras dure.
|
|
63
|
+
- Se conservan todos los `Set-Cookie` del upstream: las cabeceras repetidas
|
|
64
|
+
llegan a `Response.headers` como lista.
|
|
65
|
+
- `X-ProxyI-Upstream` ya no se envia por defecto; `X-ProxyI-Rule` y
|
|
66
|
+
`X-ProxyI-Target` se mantienen.
|
|
67
|
+
|
|
43
68
|
## Balanceo
|
|
44
69
|
|
|
45
70
|
Estrategias disponibles:
|
|
@@ -24,7 +24,7 @@ from wsbuilder import App, Response, Database, Model, SQLiteMemoryCache
|
|
|
24
24
|
| Proxy | `ProxyI`, `proxyi`, `ProxyRule`, `ProxyRouteBuilder`, `ProxyTarget` | Reverse proxy y balancing |
|
|
25
25
|
| DNS | `LocalDNSServer` | Resolucion local y tests |
|
|
26
26
|
| IA | `DataSet`, `DataSummary`, `ErrorSummary`, `NeuralNetwork`, `Predictor` | Datos y modelos sencillos |
|
|
27
|
-
| Utilidades | `get_header`, `set_header`, `build_set_cookie`, `parse_cookie_header` | Helpers HTTP |
|
|
27
|
+
| Utilidades | `get_header`, `set_header`, `add_header`, `build_set_cookie`, `parse_cookie_header` | Helpers HTTP |
|
|
28
28
|
|
|
29
29
|
## Core HTTP
|
|
30
30
|
|
|
@@ -195,6 +195,7 @@ fetch, store_response, invalidate_path, clear, snapshot
|
|
|
195
195
|
- `get_header()`
|
|
196
196
|
- `has_header()`
|
|
197
197
|
- `set_header()`
|
|
198
|
+
- `add_header()`
|
|
198
199
|
- `parse_cookie_header()`
|
|
199
200
|
- `get_cookie()`
|
|
200
201
|
- `build_set_cookie()`
|
|
@@ -68,6 +68,11 @@ Callbacks opcionales:
|
|
|
68
68
|
- fallo de ping/pong
|
|
69
69
|
- error de protocolo
|
|
70
70
|
|
|
71
|
+
Un timeout de lectura a mitad de un frame no pierde los bytes ya recibidos: se
|
|
72
|
+
conservan y el frame se completa en la siguiente lectura, asi que el framing no
|
|
73
|
+
se desincroniza. Mientras sigan llegando bytes de un frame, la conexion no
|
|
74
|
+
cuenta como inactiva; `idle_timeout` solo vence si el par deja de enviar.
|
|
75
|
+
|
|
71
76
|
## Ejemplo echo
|
|
72
77
|
|
|
73
78
|
```python
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import argparse
|
|
2
2
|
import json
|
|
3
|
+
import math
|
|
3
4
|
import os
|
|
5
|
+
import sqlite3
|
|
4
6
|
import threading
|
|
5
7
|
from datetime import UTC, datetime
|
|
6
8
|
from pathlib import Path
|
|
@@ -244,12 +246,19 @@ def build_app(*, upstream_port=DEFAULT_UPSTREAM_PORT, enable_dns=False, dns_host
|
|
|
244
246
|
else:
|
|
245
247
|
tags = []
|
|
246
248
|
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
249
|
+
try:
|
|
250
|
+
note = Note.create(
|
|
251
|
+
app.db,
|
|
252
|
+
title=title,
|
|
253
|
+
body=str(payload.get("body", "")),
|
|
254
|
+
tags=tags,
|
|
255
|
+
)
|
|
256
|
+
except sqlite3.IntegrityError:
|
|
257
|
+
# The title column is UNIQUE: a repeated title is a conflict, not a crash.
|
|
258
|
+
return Response.json(
|
|
259
|
+
{"status": "error", "message": "a note with this title already exists"},
|
|
260
|
+
status=409,
|
|
261
|
+
)
|
|
253
262
|
app.logs.event("note_created", note_id=note.id, title=note.title)
|
|
254
263
|
if app.caches:
|
|
255
264
|
app.caches.invalidate_path("/pages/overview")
|
|
@@ -267,7 +276,12 @@ def build_app(*, upstream_port=DEFAULT_UPSTREAM_PORT, enable_dns=False, dns_host
|
|
|
267
276
|
|
|
268
277
|
@app.api("/api/ml/predict")
|
|
269
278
|
def predict(request):
|
|
270
|
-
|
|
279
|
+
try:
|
|
280
|
+
x_value = float(request.query.get("x", "5"))
|
|
281
|
+
except ValueError:
|
|
282
|
+
x_value = math.nan
|
|
283
|
+
if not math.isfinite(x_value):
|
|
284
|
+
return Response.json({"status": "error", "message": "x must be a number"}, status=400)
|
|
271
285
|
prediction, sigma, lower, upper = app.predictor.predict([x_value])
|
|
272
286
|
return {
|
|
273
287
|
"x": x_value,
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
"""wsbuilder: mini framework HTTP + WebSocket."""
|
|
2
2
|
|
|
3
|
+
import importlib.util
|
|
4
|
+
|
|
3
5
|
from .cache import Cache, SQLiteMemoryCache, install_cache
|
|
4
6
|
from .caches import GlobalCacheRule, ViewResponseCache, install_caches
|
|
5
7
|
from .cookies import build_set_cookie, get_cookie, parse_cookie_header
|
|
@@ -59,7 +61,7 @@ from .framework import (
|
|
|
59
61
|
parse_query_string,
|
|
60
62
|
proxyi,
|
|
61
63
|
)
|
|
62
|
-
from .headers import get_header, has_header, normalize_header_name, set_header
|
|
64
|
+
from .headers import add_header, get_header, has_header, normalize_header_name, set_header
|
|
63
65
|
from .ia import (
|
|
64
66
|
DataSet,
|
|
65
67
|
DataSummary,
|
|
@@ -107,15 +109,36 @@ _PKI_EXPORTS = frozenset(
|
|
|
107
109
|
)
|
|
108
110
|
|
|
109
111
|
|
|
112
|
+
def _tls_extra_available():
|
|
113
|
+
"""Whether the optional ``tls`` extra (cryptography) can be imported."""
|
|
114
|
+
try:
|
|
115
|
+
return importlib.util.find_spec("cryptography") is not None
|
|
116
|
+
except (ImportError, ValueError):
|
|
117
|
+
return False
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
_TLS_EXTRA_AVAILABLE = _tls_extra_available()
|
|
121
|
+
|
|
122
|
+
|
|
110
123
|
def __getattr__(name):
|
|
111
|
-
"""Resolve TLS helpers lazily so cryptography stays an optional install.
|
|
124
|
+
"""Resolve TLS helpers lazily so cryptography stays an optional install.
|
|
125
|
+
|
|
126
|
+
Without the extra, the names raise ``AttributeError`` (with the install
|
|
127
|
+
hint), so ``hasattr()``, ``getattr(..., default)`` and ``inspect`` work.
|
|
128
|
+
"""
|
|
112
129
|
if name in _PKI_EXPORTS:
|
|
113
130
|
try:
|
|
114
131
|
from . import pki
|
|
115
|
-
except ImportError as exc:
|
|
116
|
-
|
|
132
|
+
except ImportError as exc:
|
|
133
|
+
# Installed but unusable (too old, broken binding): stop
|
|
134
|
+
# advertising the names so later star imports and dir() work.
|
|
135
|
+
global _TLS_EXTRA_AVAILABLE
|
|
136
|
+
_TLS_EXTRA_AVAILABLE = False
|
|
137
|
+
__all__[:] = [item for item in __all__ if item not in _PKI_EXPORTS]
|
|
138
|
+
raise AttributeError(
|
|
117
139
|
f"wsbuilder.{name} needs the 'cryptography' package. "
|
|
118
|
-
"Install it with: pip install wsbuilder[tls]"
|
|
140
|
+
"Install it with: pip install wsbuilder[tls]",
|
|
141
|
+
name=name,
|
|
119
142
|
) from exc
|
|
120
143
|
value = getattr(pki, name)
|
|
121
144
|
globals()[name] = value
|
|
@@ -124,9 +147,12 @@ def __getattr__(name):
|
|
|
124
147
|
|
|
125
148
|
|
|
126
149
|
def __dir__():
|
|
127
|
-
|
|
150
|
+
names = set(globals())
|
|
151
|
+
if _TLS_EXTRA_AVAILABLE:
|
|
152
|
+
names |= _PKI_EXPORTS
|
|
153
|
+
return sorted(names)
|
|
128
154
|
|
|
129
|
-
__version__ = "1.2.
|
|
155
|
+
__version__ = "1.2.12"
|
|
130
156
|
|
|
131
157
|
__all__ = [
|
|
132
158
|
"App",
|
|
@@ -181,6 +207,7 @@ __all__ = [
|
|
|
181
207
|
"get_header",
|
|
182
208
|
"has_header",
|
|
183
209
|
"set_header",
|
|
210
|
+
"add_header",
|
|
184
211
|
"parse_cookie_header",
|
|
185
212
|
"get_cookie",
|
|
186
213
|
"build_set_cookie",
|
|
@@ -231,9 +258,8 @@ __all__ = [
|
|
|
231
258
|
"evaluate_errors",
|
|
232
259
|
"submit_training_task",
|
|
233
260
|
"Predictor",
|
|
234
|
-
"CertificateAuthority",
|
|
235
|
-
"CertificateManager",
|
|
236
|
-
"MaterializedFiles",
|
|
237
|
-
"TLSMaterial",
|
|
238
|
-
"install_tls",
|
|
239
261
|
]
|
|
262
|
+
if _TLS_EXTRA_AVAILABLE:
|
|
263
|
+
# Only advertised when importable, so ``from wsbuilder import *`` works
|
|
264
|
+
# on a core-only install.
|
|
265
|
+
__all__ += sorted(_PKI_EXPORTS)
|
|
@@ -189,7 +189,7 @@ CLI_LIMITS = (
|
|
|
189
189
|
("--max-workers", "max_connection_workers", int, "conexiones atendidas a la vez"),
|
|
190
190
|
("--max-header-bytes", "max_request_header_bytes", int, "tamano maximo de cabeceras"),
|
|
191
191
|
("--max-body-bytes", "max_request_body_bytes", int, "tamano maximo del body"),
|
|
192
|
-
("--request-timeout", "request_read_timeout", float, "segundos para leer una peticion"),
|
|
192
|
+
("--request-timeout", "request_read_timeout", float, "segundos en total para leer una peticion"),
|
|
193
193
|
("--keepalive-timeout", "keepalive_timeout", float, "segundos de espera entre peticiones"),
|
|
194
194
|
("--max-keepalive-requests", "max_keepalive_requests", int, "peticiones por conexion (0 = sin limite)"),
|
|
195
195
|
("--shutdown-timeout", "graceful_shutdown_timeout", float, "segundos de espera al apagar"),
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
"""Validation for SQLite ``PRAGMA name=value`` statements.
|
|
2
|
+
|
|
3
|
+
PRAGMA values cannot be bound as parameters, so they are checked before being
|
|
4
|
+
interpolated: numbers, booleans, and bare keywords/identifiers only.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import math
|
|
8
|
+
import re
|
|
9
|
+
|
|
10
|
+
_NAME_RE = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")
|
|
11
|
+
_KEYWORD_RE = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")
|
|
12
|
+
_NUMBER_RE = re.compile(r"^[+-]?[0-9]+(\.[0-9]+)?$")
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
def pragma_value_sql(value):
|
|
16
|
+
"""Return ``value`` as safe PRAGMA SQL text, or raise ``ValueError``."""
|
|
17
|
+
if isinstance(value, bool):
|
|
18
|
+
return "1" if value else "0"
|
|
19
|
+
if isinstance(value, int):
|
|
20
|
+
return str(value)
|
|
21
|
+
if isinstance(value, float):
|
|
22
|
+
if not math.isfinite(value):
|
|
23
|
+
raise ValueError(f"Unsafe PRAGMA value: {value!r}")
|
|
24
|
+
return repr(value)
|
|
25
|
+
if isinstance(value, str):
|
|
26
|
+
text = value.strip()
|
|
27
|
+
if _KEYWORD_RE.match(text) or _NUMBER_RE.match(text):
|
|
28
|
+
return text
|
|
29
|
+
raise ValueError(f"Unsafe PRAGMA value: {value!r}")
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def pragma_assignment(name, value):
|
|
33
|
+
"""``PRAGMA name=value`` with both parts validated."""
|
|
34
|
+
if not isinstance(name, str) or not _NAME_RE.match(name):
|
|
35
|
+
raise ValueError(f"Unsafe SQL identifier: {name!r}")
|
|
36
|
+
return f"PRAGMA {name}={pragma_value_sql(value)}"
|
|
@@ -8,6 +8,7 @@ from html import escape as html_escape
|
|
|
8
8
|
|
|
9
9
|
from .constants import DEFAULT_CORS_ALLOW_ORIGIN
|
|
10
10
|
from .cookies import build_set_cookie, get_cookie
|
|
11
|
+
from .headers import add_header
|
|
11
12
|
from .http import Response
|
|
12
13
|
from .logs import get_log
|
|
13
14
|
from .tasks import TaskManager
|
|
@@ -1232,6 +1233,39 @@ class App:
|
|
|
1232
1233
|
if pool:
|
|
1233
1234
|
pool.close()
|
|
1234
1235
|
|
|
1236
|
+
def security_response(self, request):
|
|
1237
|
+
"""Evaluate the security policy once for ``request``.
|
|
1238
|
+
|
|
1239
|
+
Returns the denial ``Response``, or ``None`` when the request may go
|
|
1240
|
+
on. The request is marked as evaluated, so a later ``dispatch()`` does
|
|
1241
|
+
not count it again; the server calls this with the headers alone,
|
|
1242
|
+
before it answers ``100 Continue`` or reads the body.
|
|
1243
|
+
"""
|
|
1244
|
+
security = getattr(self, "security", None)
|
|
1245
|
+
try:
|
|
1246
|
+
request.security_evaluated = True
|
|
1247
|
+
except Exception:
|
|
1248
|
+
pass
|
|
1249
|
+
if not security:
|
|
1250
|
+
return None
|
|
1251
|
+
decision = security.evaluate(request)
|
|
1252
|
+
if decision.allowed:
|
|
1253
|
+
return None
|
|
1254
|
+
cors_allow_origin = self.cors_allow_origin
|
|
1255
|
+
route_for_format = self.router.resolve(request.path, request.method)
|
|
1256
|
+
headers = decision.response_headers()
|
|
1257
|
+
if cors_allow_origin:
|
|
1258
|
+
headers.setdefault("Access-Control-Allow-Origin", cors_allow_origin)
|
|
1259
|
+
if cors_allow_origin != "*":
|
|
1260
|
+
headers.setdefault("Vary", "Origin")
|
|
1261
|
+
if route_for_format and route_for_format.kind == "api":
|
|
1262
|
+
return Response.json(
|
|
1263
|
+
{"status": "error", "message": decision.message, "reason": decision.reason},
|
|
1264
|
+
status=decision.status,
|
|
1265
|
+
headers=headers,
|
|
1266
|
+
)
|
|
1267
|
+
return Response.text(decision.message, status=decision.status, headers=headers)
|
|
1268
|
+
|
|
1235
1269
|
def dispatch(self, request):
|
|
1236
1270
|
try:
|
|
1237
1271
|
request.app = self
|
|
@@ -1239,23 +1273,10 @@ class App:
|
|
|
1239
1273
|
pass
|
|
1240
1274
|
cors_allow_origin = self.cors_allow_origin
|
|
1241
1275
|
|
|
1242
|
-
|
|
1243
|
-
|
|
1244
|
-
|
|
1245
|
-
|
|
1246
|
-
route_for_format = self.router.resolve(request.path, request.method)
|
|
1247
|
-
headers = decision.response_headers()
|
|
1248
|
-
if cors_allow_origin:
|
|
1249
|
-
headers.setdefault("Access-Control-Allow-Origin", cors_allow_origin)
|
|
1250
|
-
if cors_allow_origin != "*":
|
|
1251
|
-
headers.setdefault("Vary", "Origin")
|
|
1252
|
-
if route_for_format and route_for_format.kind == "api":
|
|
1253
|
-
return Response.json(
|
|
1254
|
-
{"status": "error", "message": decision.message, "reason": decision.reason},
|
|
1255
|
-
status=decision.status,
|
|
1256
|
-
headers=headers,
|
|
1257
|
-
)
|
|
1258
|
-
return Response.text(decision.message, status=decision.status, headers=headers)
|
|
1276
|
+
if not getattr(request, "security_evaluated", False):
|
|
1277
|
+
denied = self.security_response(request)
|
|
1278
|
+
if denied is not None:
|
|
1279
|
+
return denied
|
|
1259
1280
|
|
|
1260
1281
|
if request.method == "OPTIONS" and not self.router.resolve(
|
|
1261
1282
|
request.path,
|
|
@@ -1350,13 +1371,11 @@ class App:
|
|
|
1350
1371
|
if thread_info.port > 0:
|
|
1351
1372
|
resp.headers.setdefault(THREAD_RESPONSE_PORT_HEADER, str(thread_info.port))
|
|
1352
1373
|
resp.headers.setdefault(THREAD_RESPONSE_MODE_HEADER, "worker")
|
|
1353
|
-
#
|
|
1354
|
-
#
|
|
1355
|
-
if thread_info is not None
|
|
1356
|
-
str(name).lower() == "set-cookie" for name in resp.headers
|
|
1357
|
-
):
|
|
1374
|
+
# The affinity cookie is added next to any Set-Cookie the handler
|
|
1375
|
+
# set: list values are sent as separate Set-Cookie fields.
|
|
1376
|
+
if thread_info is not None:
|
|
1358
1377
|
signed_cookie = self._sign_thread_cookie(route.path, thread_info.thread_id)
|
|
1359
|
-
|
|
1378
|
+
affinity_cookie = build_set_cookie(
|
|
1360
1379
|
self.thread_cookie_name,
|
|
1361
1380
|
signed_cookie,
|
|
1362
1381
|
path=route.path or "/",
|
|
@@ -1369,6 +1388,7 @@ class App:
|
|
|
1369
1388
|
secure=bool((request.tls or {}).get("enabled")),
|
|
1370
1389
|
same_site="Lax",
|
|
1371
1390
|
)
|
|
1391
|
+
add_header(resp.headers, "Set-Cookie", affinity_cookie)
|
|
1372
1392
|
|
|
1373
1393
|
if route.kind == "api":
|
|
1374
1394
|
if cors_allow_origin:
|
|
@@ -11,6 +11,7 @@ from collections.abc import Mapping
|
|
|
11
11
|
|
|
12
12
|
from ._coerce import safe_float as _safe_float
|
|
13
13
|
from ._coerce import safe_int as _safe_int
|
|
14
|
+
from ._pragma import pragma_assignment
|
|
14
15
|
|
|
15
16
|
DEFAULT_NAMESPACE = "default"
|
|
16
17
|
DEFAULT_CLEANUP_INTERVAL_SECONDS = 30.0
|
|
@@ -141,7 +142,7 @@ class SQLiteMemoryCache:
|
|
|
141
142
|
cfg.update(pragmas)
|
|
142
143
|
cur = self._conn.cursor()
|
|
143
144
|
for key, value in cfg.items():
|
|
144
|
-
cur.execute(
|
|
145
|
+
cur.execute(pragma_assignment(key, value))
|
|
145
146
|
cur.close()
|
|
146
147
|
|
|
147
148
|
def _create_schema(self):
|
|
@@ -14,6 +14,7 @@ from dataclasses import dataclass
|
|
|
14
14
|
from ._coerce import safe_float as _safe_float
|
|
15
15
|
from ._coerce import safe_int as _safe_int
|
|
16
16
|
from .cache import SQLiteMemoryCache
|
|
17
|
+
from .headers import header_value_text
|
|
17
18
|
from .http import Response
|
|
18
19
|
|
|
19
20
|
DEFAULT_VIEW_CACHE_NAMESPACE = "http-view-cache"
|
|
@@ -67,7 +68,7 @@ def _normalize_methods(methods):
|
|
|
67
68
|
|
|
68
69
|
def _normalize_headers(headers):
|
|
69
70
|
return {
|
|
70
|
-
str(key or "").strip().lower():
|
|
71
|
+
str(key or "").strip().lower(): header_value_text(value)
|
|
71
72
|
for key, value in (headers or {}).items()
|
|
72
73
|
if str(key or "").strip()
|
|
73
74
|
}
|
|
@@ -105,7 +106,7 @@ def _strip_uncacheable_headers(headers):
|
|
|
105
106
|
low = k.lower()
|
|
106
107
|
if low in _DROP_HEADERS or low in _THREAD_HEADERS:
|
|
107
108
|
continue
|
|
108
|
-
clean[k] =
|
|
109
|
+
clean[k] = header_value_text(value)
|
|
109
110
|
return clean
|
|
110
111
|
|
|
111
112
|
|
|
@@ -6,6 +6,7 @@ import sqlite3
|
|
|
6
6
|
import threading
|
|
7
7
|
from dataclasses import dataclass
|
|
8
8
|
|
|
9
|
+
from ._pragma import pragma_assignment
|
|
9
10
|
from .logs import get_log
|
|
10
11
|
|
|
11
12
|
|
|
@@ -254,8 +255,9 @@ class OptimizedDatabase:
|
|
|
254
255
|
|
|
255
256
|
with self._lock:
|
|
256
257
|
for key, value in base_pragmas.items():
|
|
257
|
-
|
|
258
|
-
self.
|
|
258
|
+
sql = pragma_assignment(key, value)
|
|
259
|
+
self._log(sql)
|
|
260
|
+
self._conn.execute(sql)
|
|
259
261
|
|
|
260
262
|
# WAL checkpoint settings
|
|
261
263
|
if config.journal_mode.upper() == "WAL":
|
|
@@ -281,11 +283,8 @@ class OptimizedDatabase:
|
|
|
281
283
|
return self._get_tx_depth() > 0
|
|
282
284
|
|
|
283
285
|
def set_pragma(self, name: str, value):
|
|
284
|
-
"""Set a PRAGMA value."""
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
validate_identifier(name)
|
|
288
|
-
sql = f"PRAGMA {name}={value}"
|
|
286
|
+
"""Set a PRAGMA value (a number, bool, or keyword)."""
|
|
287
|
+
sql = pragma_assignment(name, value)
|
|
289
288
|
with self._lock:
|
|
290
289
|
self._log(sql)
|
|
291
290
|
self._conn.execute(sql)
|