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.
Files changed (136) hide show
  1. {wsbuilder-1.2.10/src/wsbuilder.egg-info → wsbuilder-1.2.12}/PKG-INFO +1 -1
  2. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/api-map.md +1 -1
  3. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/app-http.md +12 -1
  4. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/cache-security.md +1 -0
  5. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/data-orm.md +11 -0
  6. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/dns.md +18 -0
  7. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/http-versions.md +26 -1
  8. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/http.md +27 -1
  9. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/network-edge.md +6 -1
  10. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/proxy.md +25 -0
  11. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/reference/index.md +2 -1
  12. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/websocket.md +5 -0
  13. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/app.py +21 -7
  14. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/pyproject.toml +1 -1
  15. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/__init__.py +38 -12
  16. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/__main__.py +1 -1
  17. wsbuilder-1.2.12/src/wsbuilder/_pragma.py +36 -0
  18. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/app.py +43 -23
  19. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/cache.py +2 -1
  20. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/caches.py +3 -2
  21. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/db_replicas.py +6 -7
  22. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/dns.py +219 -39
  23. wsbuilder-1.2.12/src/wsbuilder/headers.py +147 -0
  24. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http.py +42 -18
  25. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http1.py +21 -3
  26. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http2.py +117 -12
  27. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http3.py +31 -4
  28. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http3_server.py +27 -1
  29. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/orm.py +23 -11
  30. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/proxyi.py +148 -13
  31. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/connection.py +179 -6
  32. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/frames.py +68 -7
  33. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/server.py +107 -22
  34. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/ws.py +47 -1
  35. {wsbuilder-1.2.10 → wsbuilder-1.2.12/src/wsbuilder.egg-info}/PKG-INFO +1 -1
  36. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/SOURCES.txt +3 -0
  37. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_app_threads.py +11 -3
  38. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_cache.py +25 -5
  39. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_caches.py +27 -6
  40. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_dns.py +242 -0
  41. wsbuilder-1.2.12/tests/test_example_full_project.py +80 -0
  42. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_headers_cookies.py +24 -0
  43. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http.py +48 -0
  44. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http2.py +250 -5
  45. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http3.py +60 -0
  46. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http3_streaming.py +95 -0
  47. wsbuilder-1.2.12/tests/test_optional_extras.py +108 -0
  48. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_orm.py +71 -0
  49. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_pki.py +5 -4
  50. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_proxyi.py +159 -0
  51. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_recovery.py +217 -0
  52. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_server.py +197 -0
  53. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_ws.py +75 -0
  54. wsbuilder-1.2.10/src/wsbuilder/headers.py +0 -52
  55. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/LICENSE +0 -0
  56. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/MANIFEST.in +0 -0
  57. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/README.md +0 -0
  58. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/404.html +0 -0
  59. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/CNAME +0 -0
  60. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/advanced.md +0 -0
  61. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/ai-predict.md +0 -0
  62. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/architecture.md +0 -0
  63. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/assets/wsbuilder-mark.svg +0 -0
  64. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/beginners.md +0 -0
  65. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/cache.md +0 -0
  66. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/capabilities.md +0 -0
  67. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/full-project.md +0 -0
  68. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/getting-started.md +0 -0
  69. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/help/index.md +0 -0
  70. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/ia.md +0 -0
  71. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/index.md +0 -0
  72. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/install.md +0 -0
  73. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/intermediate.md +0 -0
  74. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/mdns.md +0 -0
  75. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/observability-tasks.md +0 -0
  76. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/observability.md +0 -0
  77. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/persistence.md +0 -0
  78. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/security.md +0 -0
  79. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/stylesheets/extra.css +0 -0
  80. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/tasks.md +0 -0
  81. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/docs/tls-certificates.md +0 -0
  82. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/.gitignore +0 -0
  83. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/README.md +0 -0
  84. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/pyproject.toml +0 -0
  85. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/examples/full-project/upstream.py +0 -0
  86. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/mkdocs.yml +0 -0
  87. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/setup.cfg +0 -0
  88. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/_coerce.py +0 -0
  89. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/constants.py +0 -0
  90. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/cookies.py +0 -0
  91. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/framework.py +0 -0
  92. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/hpack.py +0 -0
  93. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/http3_websocket.py +0 -0
  94. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/ia.py +0 -0
  95. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/logs.py +0 -0
  96. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/mdns.py +0 -0
  97. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/metrics.py +0 -0
  98. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/pki.py +0 -0
  99. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/predicts.py +0 -0
  100. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/qpack.py +0 -0
  101. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/__init__.py +0 -0
  102. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/address.py +0 -0
  103. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/crypto.py +0 -0
  104. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/packet.py +0 -0
  105. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/recovery.py +0 -0
  106. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/tls.py +0 -0
  107. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/quic/varint.py +0 -0
  108. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/security.py +0 -0
  109. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder/tasks.py +0 -0
  110. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/dependency_links.txt +0 -0
  111. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/entry_points.txt +0 -0
  112. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/requires.txt +0 -0
  113. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/src/wsbuilder.egg-info/top_level.txt +0 -0
  114. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_contributing_policy.py +0 -0
  115. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_demo_monitor.py +0 -0
  116. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_docs.py +0 -0
  117. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_documentation_files.py +0 -0
  118. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_hpack.py +0 -0
  119. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http1.py +0 -0
  120. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http3_server.py +0 -0
  121. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_http3_streaming_udp.py +0 -0
  122. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_ia.py +0 -0
  123. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_logs.py +0 -0
  124. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_mdns.py +0 -0
  125. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_metrics.py +0 -0
  126. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_orm_replicas.py +0 -0
  127. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_pr_identity_policy.py +0 -0
  128. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_predicts.py +0 -0
  129. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_proxyi_routing.py +0 -0
  130. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_address.py +0 -0
  131. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_crypto.py +0 -0
  132. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_protocol.py +0 -0
  133. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_quic_tls.py +0 -0
  134. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_security.py +0 -0
  135. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_server_errors.py +0 -0
  136. {wsbuilder-1.2.10 → wsbuilder-1.2.12}/tests/test_tasks.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: wsbuilder
3
- Version: 1.2.10
3
+ Version: 1.2.12
4
4
  Summary: Lightweight HTTP + WebSocket framework for Python.
5
5
  Author: wsbuilder Authors
6
6
  License-Expression: MIT
@@ -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`.
@@ -208,6 +208,7 @@ Utilidades incluidas:
208
208
  - `get_header`
209
209
  - `has_header`
210
210
  - `set_header`
211
+ - `add_header`
211
212
  - `parse_cookie_header`
212
213
  - `get_cookie`
213
214
  - `build_set_cookie`
@@ -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 build_set_cookie, get_cookie, get_header, has_header, normalize_header_name, set_header
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
- note = Note.create(
248
- app.db,
249
- title=title,
250
- body=str(payload.get("body", "")),
251
- tags=tags,
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
- x_value = float(request.query.get("x", "5"))
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,
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "wsbuilder"
7
- version = "1.2.10"
7
+ version = "1.2.12"
8
8
  description = "Lightweight HTTP + WebSocket framework for Python."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
@@ -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: # pragma: no cover - depends on the install
116
- raise ImportError(
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
- return sorted(set(globals()) | _PKI_EXPORTS)
150
+ names = set(globals())
151
+ if _TLS_EXTRA_AVAILABLE:
152
+ names |= _PKI_EXPORTS
153
+ return sorted(names)
128
154
 
129
- __version__ = "1.2.10"
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
- security = getattr(self, "security", None)
1243
- if security:
1244
- decision = security.evaluate(request)
1245
- if not decision.allowed:
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
- # Headers hold one value per name, so a cookie the handler set wins
1354
- # over the affinity cookie instead of being replaced by it.
1355
- if thread_info is not None and not any(
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
- resp.headers["Set-Cookie"] = build_set_cookie(
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(f"PRAGMA {key}={value}")
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(): str(value)
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] = str(value)
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
- self._log(f"PRAGMA {key}={value}")
258
- self._conn.execute(f"PRAGMA {key}={value}")
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
- from .orm import validate_identifier
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)