pyfect-dev 0.1.0__py3-none-any.whl

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 (1265) hide show
  1. pyfect/__init__.py +729 -0
  2. pyfect/_all.py +242 -0
  3. pyfect/_background.py +28 -0
  4. pyfect/_binary_codecs.py +124 -0
  5. pyfect/_cached.py +165 -0
  6. pyfect/_catch.py +128 -0
  7. pyfect/_catch_reason.py +574 -0
  8. pyfect/_concurrency.py +291 -0
  9. pyfect/_context_effects.py +163 -0
  10. pyfect/_context_managers.py +76 -0
  11. pyfect/_core.py +368 -0
  12. pyfect/_digits.py +71 -0
  13. pyfect/_effect_args.py +46 -0
  14. pyfect/_effect_base.py +71 -0
  15. pyfect/_effect_concurrency.py +133 -0
  16. pyfect/_effect_eager.py +103 -0
  17. pyfect/_effect_errors.py +344 -0
  18. pyfect/_effect_folding.py +110 -0
  19. pyfect/_effect_hash.py +140 -0
  20. pyfect/_effect_logging.py +57 -0
  21. pyfect/_effect_metrics.py +102 -0
  22. pyfect/_effect_resources.py +179 -0
  23. pyfect/_effect_services.py +25 -0
  24. pyfect/_effect_timing.py +199 -0
  25. pyfect/_effect_tracing.py +99 -0
  26. pyfect/_equal.py +195 -0
  27. pyfect/_extras.py +43 -0
  28. pyfect/_fiber.py +969 -0
  29. pyfect/_fiber_all.py +134 -0
  30. pyfect/_fiber_collections.py +106 -0
  31. pyfect/_fn.py +706 -0
  32. pyfect/_hamt.py +174 -0
  33. pyfect/_interrupt_reason.py +33 -0
  34. pyfect/_isaac.py +149 -0
  35. pyfect/_iterables.py +231 -0
  36. pyfect/_js.py +263 -0
  37. pyfect/_js_date.py +87 -0
  38. pyfect/_json_text.py +286 -0
  39. pyfect/_json_value.py +9 -0
  40. pyfect/_layer_core.py +403 -0
  41. pyfect/_layer_for_life.py +33 -0
  42. pyfect/_layer_tracing.py +70 -0
  43. pyfect/_locked_ref.py +147 -0
  44. pyfect/_loop_thread.py +152 -0
  45. pyfect/_metric_ref.py +29 -0
  46. pyfect/_one_or_many.py +14 -0
  47. pyfect/_os_wait.py +118 -0
  48. pyfect/_path_posix.py +129 -0
  49. pyfect/_primitives.py +434 -0
  50. pyfect/_public.py +36 -0
  51. pyfect/_reasons.py +64 -0
  52. pyfect/_released.py +67 -0
  53. pyfect/_root.py +87 -0
  54. pyfect/_round_robin.py +73 -0
  55. pyfect/_some.py +17 -0
  56. pyfect/_stack.py +52 -0
  57. pyfect/_stack_frame.py +114 -0
  58. pyfect/_string_hash.py +35 -0
  59. pyfect/_subscriber_queue.py +47 -0
  60. pyfect/_tags.py +14 -0
  61. pyfect/_tracer_ref.py +21 -0
  62. pyfect/_tx_ops.py +77 -0
  63. pyfect/_unsubscripted.py +23 -0
  64. pyfect/_url.py +54 -0
  65. pyfect/_waiters.py +127 -0
  66. pyfect/_wake_tracking.py +98 -0
  67. pyfect/_wire_codec.py +123 -0
  68. pyfect/ai/__init__.py +73 -0
  69. pyfect/ai/_approvals.py +249 -0
  70. pyfect/ai/_decision_answers.py +185 -0
  71. pyfect/ai/_generated_client.py +298 -0
  72. pyfect/ai/_generated_support.py +84 -0
  73. pyfect/ai/_mcp/__init__.py +1 -0
  74. pyfect/ai/_mcp/batch.py +68 -0
  75. pyfect/ai/_mcp/client_transport.py +412 -0
  76. pyfect/ai/_mcp/client_wire.py +284 -0
  77. pyfect/ai/_mcp/core.py +490 -0
  78. pyfect/ai/_mcp/dispatch.py +1048 -0
  79. pyfect/ai/_mcp/http.py +462 -0
  80. pyfect/ai/_mcp/http_admission.py +269 -0
  81. pyfect/ai/_mcp/http_status.py +27 -0
  82. pyfect/ai/_mcp/input_wire.py +226 -0
  83. pyfect/ai/_mcp/log_levels.py +55 -0
  84. pyfect/ai/_mcp/param_headers.py +63 -0
  85. pyfect/ai/_mcp/projection.py +248 -0
  86. pyfect/ai/_mcp/register.py +683 -0
  87. pyfect/ai/_mcp/reverse_policy.py +155 -0
  88. pyfect/ai/_mcp/routing_header.py +24 -0
  89. pyfect/ai/_mcp/sessions.py +114 -0
  90. pyfect/ai/_mcp/stdio.py +110 -0
  91. pyfect/ai/_mcp/subscriptions.py +134 -0
  92. pyfect/ai/_mcp/tool_schema.py +35 -0
  93. pyfect/ai/_noul_answers.py +64 -0
  94. pyfect/ai/_openai_all_of.py +137 -0
  95. pyfect/ai/_openai_errors.py +233 -0
  96. pyfect/ai/_provider.py +439 -0
  97. pyfect/ai/_provider_tools.py +129 -0
  98. pyfect/ai/_stream_resolution.py +231 -0
  99. pyfect/ai/_structured_output_checks.py +138 -0
  100. pyfect/ai/_structured_output_codec.py +229 -0
  101. pyfect/ai/_structured_output_json.py +109 -0
  102. pyfect/ai/_tool_call_ids.py +80 -0
  103. pyfect/ai/ai_error.py +785 -0
  104. pyfect/ai/anthropic/__init__.py +28 -0
  105. pyfect/ai/anthropic/_errors.py +164 -0
  106. pyfect/ai/anthropic/_prompt.py +375 -0
  107. pyfect/ai/anthropic/_response.py +443 -0
  108. pyfect/ai/anthropic/_schema.py +206 -0
  109. pyfect/ai/anthropic/_stream.py +377 -0
  110. pyfect/ai/anthropic/_tools.py +248 -0
  111. pyfect/ai/anthropic/client.py +289 -0
  112. pyfect/ai/anthropic/config.py +32 -0
  113. pyfect/ai/anthropic/error.py +27 -0
  114. pyfect/ai/anthropic/language_model.py +366 -0
  115. pyfect/ai/anthropic/telemetry.py +51 -0
  116. pyfect/ai/anthropic/tool.py +570 -0
  117. pyfect/ai/anthropic_structured_output.py +138 -0
  118. pyfect/ai/chat.py +548 -0
  119. pyfect/ai/cloudflare/__init__.py +15 -0
  120. pyfect/ai/cloudflare/_errors.py +108 -0
  121. pyfect/ai/cloudflare/client.py +174 -0
  122. pyfect/ai/cloudflare/decision_model.py +117 -0
  123. pyfect/ai/cloudflare/schema.py +144 -0
  124. pyfect/ai/decision.py +290 -0
  125. pyfect/ai/decision_model.py +283 -0
  126. pyfect/ai/embedding_model.py +177 -0
  127. pyfect/ai/id_generator.py +79 -0
  128. pyfect/ai/language_model.py +1077 -0
  129. pyfect/ai/mcp_client.py +682 -0
  130. pyfect/ai/mcp_client_error.py +223 -0
  131. pyfect/ai/mcp_protocol.py +205 -0
  132. pyfect/ai/mcp_schema.py +1300 -0
  133. pyfect/ai/mcp_server.py +404 -0
  134. pyfect/ai/model.py +56 -0
  135. pyfect/ai/openai/__init__.py +49 -0
  136. pyfect/ai/openai/_errors.py +89 -0
  137. pyfect/ai/openai/_prompt.py +527 -0
  138. pyfect/ai/openai/_requests.py +34 -0
  139. pyfect/ai/openai/_response.py +569 -0
  140. pyfect/ai/openai/_schema.py +769 -0
  141. pyfect/ai/openai/_stream.py +771 -0
  142. pyfect/ai/openai/_tools.py +128 -0
  143. pyfect/ai/openai/_web_socket.py +295 -0
  144. pyfect/ai/openai/client.py +296 -0
  145. pyfect/ai/openai/client_generated.py +123 -0
  146. pyfect/ai/openai/config.py +34 -0
  147. pyfect/ai/openai/decision_model.py +177 -0
  148. pyfect/ai/openai/embedding_model.py +116 -0
  149. pyfect/ai/openai/error.py +8 -0
  150. pyfect/ai/openai/generated/__init__.py +7213 -0
  151. pyfect/ai/openai/generated/_recursive.py +18 -0
  152. pyfect/ai/openai/generated/_schemas_0.py +1015 -0
  153. pyfect/ai/openai/generated/_schemas_1.py +1016 -0
  154. pyfect/ai/openai/generated/_schemas_2.py +1017 -0
  155. pyfect/ai/openai/generated/_schemas_3.py +615 -0
  156. pyfect/ai/openai/generated/client.py +5298 -0
  157. pyfect/ai/openai/generated/types.py +8123 -0
  158. pyfect/ai/openai/language_model.py +304 -0
  159. pyfect/ai/openai/telemetry.py +19 -0
  160. pyfect/ai/openai/tool.py +391 -0
  161. pyfect/ai/openai_compat/__init__.py +25 -0
  162. pyfect/ai/openai_compat/_prompt.py +191 -0
  163. pyfect/ai/openai_compat/_request.py +153 -0
  164. pyfect/ai/openai_compat/_response.py +407 -0
  165. pyfect/ai/openai_compat/_schema.py +97 -0
  166. pyfect/ai/openai_compat/client.py +234 -0
  167. pyfect/ai/openai_compat/config.py +32 -0
  168. pyfect/ai/openai_compat/embedding_model.py +139 -0
  169. pyfect/ai/openai_compat/error.py +7 -0
  170. pyfect/ai/openai_compat/language_model.py +245 -0
  171. pyfect/ai/openai_compat/telemetry.py +51 -0
  172. pyfect/ai/openai_structured_output.py +118 -0
  173. pyfect/ai/openrouter/__init__.py +36 -0
  174. pyfect/ai/openrouter/_errors.py +186 -0
  175. pyfect/ai/openrouter/_prompt.py +272 -0
  176. pyfect/ai/openrouter/_response.py +226 -0
  177. pyfect/ai/openrouter/_stream.py +320 -0
  178. pyfect/ai/openrouter/client.py +283 -0
  179. pyfect/ai/openrouter/config.py +36 -0
  180. pyfect/ai/openrouter/decision_model.py +161 -0
  181. pyfect/ai/openrouter/error.py +23 -0
  182. pyfect/ai/openrouter/generated/__init__.py +3029 -0
  183. pyfect/ai/openrouter/generated/_recursive.py +15 -0
  184. pyfect/ai/openrouter/generated/_schemas_0.py +1015 -0
  185. pyfect/ai/openrouter/generated/_schemas_1.py +522 -0
  186. pyfect/ai/openrouter/generated/client.py +1445 -0
  187. pyfect/ai/openrouter/generated/types.py +4769 -0
  188. pyfect/ai/openrouter/language_model.py +345 -0
  189. pyfect/ai/openrouter/schema.py +165 -0
  190. pyfect/ai/prompt.py +664 -0
  191. pyfect/ai/response.py +768 -0
  192. pyfect/ai/response_id_tracker.py +82 -0
  193. pyfect/ai/telemetry.py +126 -0
  194. pyfect/ai/tokenizer.py +61 -0
  195. pyfect/ai/tool.py +536 -0
  196. pyfect/ai/toolkit.py +490 -0
  197. pyfect/ai/typesafe/__init__.py +17 -0
  198. pyfect/ai/typesafe/_errors.py +120 -0
  199. pyfect/ai/typesafe/client.py +146 -0
  200. pyfect/ai/typesafe/config.py +34 -0
  201. pyfect/ai/typesafe/decision_model.py +90 -0
  202. pyfect/ai/typesafe/schema.py +140 -0
  203. pyfect/batching/__init__.py +58 -0
  204. pyfect/batching/_api.py +71 -0
  205. pyfect/batching/_engine.py +229 -0
  206. pyfect/batching/_from_effect.py +76 -0
  207. pyfect/batching/_persisted.py +98 -0
  208. pyfect/batching/_request.py +133 -0
  209. pyfect/batching/_resolver.py +477 -0
  210. pyfect/batching/_with_cache.py +90 -0
  211. pyfect/big_decimal.py +500 -0
  212. pyfect/brand.py +114 -0
  213. pyfect/byte_size.py +354 -0
  214. pyfect/cache/__init__.py +29 -0
  215. pyfect/cache/_cache.py +426 -0
  216. pyfect/cache/_expiry.py +69 -0
  217. pyfect/cache/_scoped_cache.py +546 -0
  218. pyfect/case.py +174 -0
  219. pyfect/cause.py +462 -0
  220. pyfect/channel/__init__.py +155 -0
  221. pyfect/channel/_base.py +92 -0
  222. pyfect/channel/_catch.py +158 -0
  223. pyfect/channel/_catch_reason.py +572 -0
  224. pyfect/channel/_channel.py +158 -0
  225. pyfect/channel/_combinators.py +220 -0
  226. pyfect/channel/_concurrency_methods.py +217 -0
  227. pyfect/channel/_concurrent_map.py +118 -0
  228. pyfect/channel/_constructors.py +349 -0
  229. pyfect/channel/_context.py +232 -0
  230. pyfect/channel/_error_methods.py +336 -0
  231. pyfect/channel/_errors.py +180 -0
  232. pyfect/channel/_filters.py +225 -0
  233. pyfect/channel/_lifecycle.py +71 -0
  234. pyfect/channel/_lifecycle_methods.py +206 -0
  235. pyfect/channel/_loop.py +100 -0
  236. pyfect/channel/_merge.py +246 -0
  237. pyfect/channel/_repeat.py +154 -0
  238. pyfect/channel/_run.py +149 -0
  239. pyfect/channel/_run_methods.py +341 -0
  240. pyfect/channel/_sinks.py +88 -0
  241. pyfect/channel/_sources.py +238 -0
  242. pyfect/channel/_text.py +176 -0
  243. pyfect/channel/_transform_methods.py +415 -0
  244. pyfect/channel/_upstream.py +67 -0
  245. pyfect/channel_schema.py +131 -0
  246. pyfect/cli/__init__.py +79 -0
  247. pyfect/cli/_ansi.py +82 -0
  248. pyfect/cli/_command.py +469 -0
  249. pyfect/cli/_config.py +164 -0
  250. pyfect/cli/_environment.py +10 -0
  251. pyfect/cli/_help.py +195 -0
  252. pyfect/cli/_lexer.py +81 -0
  253. pyfect/cli/_parser.py +465 -0
  254. pyfect/cli/_settings.py +85 -0
  255. pyfect/cli/_suggest.py +33 -0
  256. pyfect/cli/_width.py +134 -0
  257. pyfect/cli/_wizard.py +317 -0
  258. pyfect/cli/argument.py +212 -0
  259. pyfect/cli/cli_config.py +40 -0
  260. pyfect/cli/cli_error.py +242 -0
  261. pyfect/cli/cli_output.py +305 -0
  262. pyfect/cli/command.py +440 -0
  263. pyfect/cli/completions/__init__.py +50 -0
  264. pyfect/cli/completions/_completer.ps1 +190 -0
  265. pyfect/cli/completions/_descriptor.py +182 -0
  266. pyfect/cli/completions/bash.py +300 -0
  267. pyfect/cli/completions/fish.py +164 -0
  268. pyfect/cli/completions/powershell.py +156 -0
  269. pyfect/cli/completions/zsh.py +189 -0
  270. pyfect/cli/flag.py +246 -0
  271. pyfect/cli/global_flag.py +99 -0
  272. pyfect/cli/help_doc.py +63 -0
  273. pyfect/cli/param.py +789 -0
  274. pyfect/cli/primitive.py +308 -0
  275. pyfect/cli/prompt/__init__.py +75 -0
  276. pyfect/cli/prompt/_auto_complete.py +205 -0
  277. pyfect/cli/prompt/_choices.py +104 -0
  278. pyfect/cli/prompt/_confirm.py +195 -0
  279. pyfect/cli/prompt/_core.py +512 -0
  280. pyfect/cli/prompt/_date.py +173 -0
  281. pyfect/cli/prompt/_date_parts.py +387 -0
  282. pyfect/cli/prompt/_file.py +372 -0
  283. pyfect/cli/prompt/_multi_select.py +204 -0
  284. pyfect/cli/prompt/_number.py +257 -0
  285. pyfect/cli/prompt/_select.py +117 -0
  286. pyfect/cli/prompt/_text.py +239 -0
  287. pyfect/cli/terminal_capabilities.py +118 -0
  288. pyfect/clock.py +150 -0
  289. pyfect/cluster/__init__.py +155 -0
  290. pyfect/cluster/_cluster_abandon.py +36 -0
  291. pyfect/cluster/_cluster_layer.py +122 -0
  292. pyfect/cluster/_entity_activation.py +16 -0
  293. pyfect/cluster/_entity_manager/__init__.py +22 -0
  294. pyfect/cluster/_entity_manager/_activation.py +540 -0
  295. pyfect/cluster/_entity_manager/_core.py +186 -0
  296. pyfect/cluster/_entity_manager/_decode.py +60 -0
  297. pyfect/cluster/_entity_manager/_manager.py +423 -0
  298. pyfect/cluster/_entity_manager/_state.py +113 -0
  299. pyfect/cluster/_entity_reaper.py +94 -0
  300. pyfect/cluster/_hash.py +13 -0
  301. pyfect/cluster/_interruptors.py +88 -0
  302. pyfect/cluster/_resource_map.py +179 -0
  303. pyfect/cluster/_resource_ref.py +266 -0
  304. pyfect/cluster/_shard_lock.py +14 -0
  305. pyfect/cluster/cluster_cron.py +230 -0
  306. pyfect/cluster/cluster_error.py +81 -0
  307. pyfect/cluster/cluster_http.py +210 -0
  308. pyfect/cluster/cluster_metrics.py +54 -0
  309. pyfect/cluster/cluster_schema.py +137 -0
  310. pyfect/cluster/cluster_socket.py +197 -0
  311. pyfect/cluster/cluster_workflow_engine/__init__.py +24 -0
  312. pyfect/cluster/cluster_workflow_engine/_engine.py +1099 -0
  313. pyfect/cluster/cluster_workflow_engine/_entities.py +298 -0
  314. pyfect/cluster/deliver_at.py +31 -0
  315. pyfect/cluster/entity/__init__.py +39 -0
  316. pyfect/cluster/entity/_entity.py +332 -0
  317. pyfect/cluster/entity/_handlers.py +168 -0
  318. pyfect/cluster/entity/_keep_alive.py +74 -0
  319. pyfect/cluster/entity/_queue.py +103 -0
  320. pyfect/cluster/entity/_request.py +34 -0
  321. pyfect/cluster/entity/_services.py +23 -0
  322. pyfect/cluster/entity/_test_client.py +237 -0
  323. pyfect/cluster/entity_address.py +25 -0
  324. pyfect/cluster/entity_id.py +20 -0
  325. pyfect/cluster/entity_proxy.py +161 -0
  326. pyfect/cluster/entity_proxy_server.py +103 -0
  327. pyfect/cluster/entity_resource.py +122 -0
  328. pyfect/cluster/entity_type.py +20 -0
  329. pyfect/cluster/envelope.py +307 -0
  330. pyfect/cluster/http_runner.py +254 -0
  331. pyfect/cluster/k8s_http_client.py +281 -0
  332. pyfect/cluster/k8s_types.py +1394 -0
  333. pyfect/cluster/machine_id.py +21 -0
  334. pyfect/cluster/message.py +219 -0
  335. pyfect/cluster/message_storage/__init__.py +67 -0
  336. pyfect/cluster/message_storage/_encoded.py +393 -0
  337. pyfect/cluster/message_storage/_memory.py +386 -0
  338. pyfect/cluster/message_storage/_noop.py +109 -0
  339. pyfect/cluster/message_storage/_service.py +388 -0
  340. pyfect/cluster/reply.py +236 -0
  341. pyfect/cluster/runner.py +32 -0
  342. pyfect/cluster/runner_address.py +23 -0
  343. pyfect/cluster/runner_health.py +93 -0
  344. pyfect/cluster/runner_server.py +286 -0
  345. pyfect/cluster/runner_storage.py +212 -0
  346. pyfect/cluster/runners/__init__.py +55 -0
  347. pyfect/cluster/runners/_local.py +460 -0
  348. pyfect/cluster/runners/_noop.py +57 -0
  349. pyfect/cluster/runners/_rpc.py +290 -0
  350. pyfect/cluster/runners/_service.py +113 -0
  351. pyfect/cluster/shard_id.py +39 -0
  352. pyfect/cluster/sharding/__init__.py +12 -0
  353. pyfect/cluster/sharding/_acquisition.py +490 -0
  354. pyfect/cluster/sharding/_clients.py +271 -0
  355. pyfect/cluster/sharding/_make.py +388 -0
  356. pyfect/cluster/sharding/_routing.py +296 -0
  357. pyfect/cluster/sharding/_runners_sync.py +198 -0
  358. pyfect/cluster/sharding/_service.py +91 -0
  359. pyfect/cluster/sharding/_singletons.py +183 -0
  360. pyfect/cluster/sharding/_state.py +296 -0
  361. pyfect/cluster/sharding/_storage_loop.py +421 -0
  362. pyfect/cluster/sharding_config.py +230 -0
  363. pyfect/cluster/sharding_registration_event.py +28 -0
  364. pyfect/cluster/single_runner.py +49 -0
  365. pyfect/cluster/singleton.py +36 -0
  366. pyfect/cluster/singleton_address.py +20 -0
  367. pyfect/cluster/snowflake.py +133 -0
  368. pyfect/cluster/socket_runner.py +67 -0
  369. pyfect/cluster/sql_message_storage.py +1001 -0
  370. pyfect/cluster/sql_runner_storage.py +841 -0
  371. pyfect/cluster/test_runner.py +23 -0
  372. pyfect/config/__init__.py +93 -0
  373. pyfect/config/_all.py +96 -0
  374. pyfect/config/_collections.py +291 -0
  375. pyfect/config/_config.py +261 -0
  376. pyfect/config/_constructors.py +106 -0
  377. pyfect/config/_error.py +27 -0
  378. pyfect/config/_leaf.py +92 -0
  379. pyfect/config/_scalars.py +193 -0
  380. pyfect/config/_schema.py +340 -0
  381. pyfect/config_provider/__init__.py +60 -0
  382. pyfect/config_provider/_dir.py +84 -0
  383. pyfect/config_provider/_dotenv.py +127 -0
  384. pyfect/config_provider/_env.py +79 -0
  385. pyfect/config_provider/_layers.py +80 -0
  386. pyfect/config_provider/_node.py +90 -0
  387. pyfect/config_provider/_provider.py +118 -0
  388. pyfect/config_provider/_unknown.py +62 -0
  389. pyfect/console/__init__.py +63 -0
  390. pyfect/console/_effects.py +134 -0
  391. pyfect/console/_live.py +156 -0
  392. pyfect/console/_service.py +49 -0
  393. pyfect/console/_table.py +90 -0
  394. pyfect/context.py +414 -0
  395. pyfect/cron/__init__.py +30 -0
  396. pyfect/cron/_model.py +183 -0
  397. pyfect/cron/_search.py +268 -0
  398. pyfect/cron/_text.py +202 -0
  399. pyfect/cron/_wall.py +42 -0
  400. pyfect/crypto.py +257 -0
  401. pyfect/date_time/__init__.py +77 -0
  402. pyfect/date_time/_calendar.py +209 -0
  403. pyfect/date_time/_current.py +118 -0
  404. pyfect/date_time/_epoch.py +22 -0
  405. pyfect/date_time/_iso.py +80 -0
  406. pyfect/date_time/_zones.py +135 -0
  407. pyfect/date_time/intl.py +144 -0
  408. pyfect/deferred.py +145 -0
  409. pyfect/devtools/__init__.py +24 -0
  410. pyfect/devtools/client.py +323 -0
  411. pyfect/devtools/layers.py +32 -0
  412. pyfect/devtools/schema.py +301 -0
  413. pyfect/devtools/server.py +72 -0
  414. pyfect/duration.py +295 -0
  415. pyfect/effect.py +565 -0
  416. pyfect/effectable.py +37 -0
  417. pyfect/encoding/__init__.py +62 -0
  418. pyfect/encoding/_archive.py +197 -0
  419. pyfect/encoding/_json_array_scanner.py +477 -0
  420. pyfect/encoding/base64.py +23 -0
  421. pyfect/encoding/base64_url.py +19 -0
  422. pyfect/encoding/encoding_error.py +17 -0
  423. pyfect/encoding/hex.py +28 -0
  424. pyfect/encoding/ini.py +188 -0
  425. pyfect/encoding/json_array.py +246 -0
  426. pyfect/encoding/ndjson.py +461 -0
  427. pyfect/encoding/schema_binary/__init__.py +257 -0
  428. pyfect/encoding/schema_binary/_channels.py +173 -0
  429. pyfect/encoding/schema_binary/_compile.py +584 -0
  430. pyfect/encoding/schema_binary/_decode.py +848 -0
  431. pyfect/encoding/schema_binary/_dictionary.py +90 -0
  432. pyfect/encoding/schema_binary/_encode.py +838 -0
  433. pyfect/encoding/schema_binary/_fingerprint.py +168 -0
  434. pyfect/encoding/schema_binary/_layout.py +350 -0
  435. pyfect/encoding/schema_binary/_literals.py +47 -0
  436. pyfect/encoding/schema_binary/_parser.py +163 -0
  437. pyfect/encoding/schema_binary/_reader.py +148 -0
  438. pyfect/encoding/schema_binary/_target.py +310 -0
  439. pyfect/encoding/schema_binary/_values.py +133 -0
  440. pyfect/encoding/schema_binary/_wire.py +253 -0
  441. pyfect/encoding/sse.py +476 -0
  442. pyfect/encoding/tar/__init__.py +396 -0
  443. pyfect/encoding/tar/_decoder.py +220 -0
  444. pyfect/encoding/tar/_encoder.py +83 -0
  445. pyfect/encoding/tar/_header.py +494 -0
  446. pyfect/encoding/tar/_model.py +82 -0
  447. pyfect/encoding/toml.py +375 -0
  448. pyfect/encoding/xml/__init__.py +222 -0
  449. pyfect/encoding/xml/_chars.py +119 -0
  450. pyfect/encoding/xml/_collector.py +106 -0
  451. pyfect/encoding/xml/_inputs.py +126 -0
  452. pyfect/encoding/xml/_model.py +114 -0
  453. pyfect/encoding/xml/_parser.py +694 -0
  454. pyfect/encoding/xml/_scanner.py +180 -0
  455. pyfect/encoding/xml/_writer.py +238 -0
  456. pyfect/encoding/yaml.py +739 -0
  457. pyfect/encoding/zip/__init__.py +392 -0
  458. pyfect/encoding/zip/_decoder.py +378 -0
  459. pyfect/encoding/zip/_format.py +122 -0
  460. pyfect/encoding/zip/_inflate.py +65 -0
  461. pyfect/encoding/zip/_model.py +86 -0
  462. pyfect/encoding/zip/_writer.py +311 -0
  463. pyfect/error_reporter.py +240 -0
  464. pyfect/errors.py +321 -0
  465. pyfect/eventlog/__init__.py +77 -0
  466. pyfect/eventlog/_conflicts.py +94 -0
  467. pyfect/eventlog/_crypto.py +64 -0
  468. pyfect/eventlog/_identity.py +26 -0
  469. pyfect/eventlog/_identity_derivation.py +79 -0
  470. pyfect/eventlog/_transferable_bytes.py +55 -0
  471. pyfect/eventlog/_uuid.py +33 -0
  472. pyfect/eventlog/event.py +115 -0
  473. pyfect/eventlog/event_group.py +55 -0
  474. pyfect/eventlog/event_journal.py +630 -0
  475. pyfect/eventlog/event_log.py +1039 -0
  476. pyfect/eventlog/event_log_encryption.py +219 -0
  477. pyfect/eventlog/event_log_message.py +357 -0
  478. pyfect/eventlog/event_log_remote.py +465 -0
  479. pyfect/eventlog/event_log_server.py +442 -0
  480. pyfect/eventlog/event_log_server_encrypted.py +322 -0
  481. pyfect/eventlog/event_log_server_unencrypted.py +814 -0
  482. pyfect/eventlog/event_log_session_auth.py +250 -0
  483. pyfect/eventlog/event_row.py +423 -0
  484. pyfect/eventlog/sql_event_journal.py +692 -0
  485. pyfect/eventlog/sql_event_log_server_encrypted.py +440 -0
  486. pyfect/eventlog/sql_event_log_server_unencrypted.py +568 -0
  487. pyfect/execution_plan/__init__.py +42 -0
  488. pyfect/execution_plan/_events.py +128 -0
  489. pyfect/execution_plan/_model.py +108 -0
  490. pyfect/execution_plan/_run.py +176 -0
  491. pyfect/exit.py +205 -0
  492. pyfect/fiber_handle.py +305 -0
  493. pyfect/fiber_map.py +350 -0
  494. pyfect/fiber_set.py +232 -0
  495. pyfect/file_system/__init__.py +69 -0
  496. pyfect/file_system/_copy.py +116 -0
  497. pyfect/file_system/_errors.py +32 -0
  498. pyfect/file_system/_file.py +177 -0
  499. pyfect/file_system/_live.py +351 -0
  500. pyfect/file_system/_model.py +72 -0
  501. pyfect/file_system/_noop.py +189 -0
  502. pyfect/file_system/_service.py +336 -0
  503. pyfect/file_system/_stat.py +69 -0
  504. pyfect/file_system/_watch.py +107 -0
  505. pyfect/filters.py +245 -0
  506. pyfect/graph/__init__.py +101 -0
  507. pyfect/graph/_all_pairs.py +150 -0
  508. pyfect/graph/_combine.py +259 -0
  509. pyfect/graph/_compact.py +143 -0
  510. pyfect/graph/_components.py +200 -0
  511. pyfect/graph/_cycles.py +144 -0
  512. pyfect/graph/_enumerate.py +168 -0
  513. pyfect/graph/_errors.py +51 -0
  514. pyfect/graph/_flow.py +164 -0
  515. pyfect/graph/_forest.py +109 -0
  516. pyfect/graph/_graph.py +269 -0
  517. pyfect/graph/_lowlink.py +98 -0
  518. pyfect/graph/_matching.py +101 -0
  519. pyfect/graph/_mutate.py +211 -0
  520. pyfect/graph/_query.py +138 -0
  521. pyfect/graph/_records.py +119 -0
  522. pyfect/graph/_render.py +109 -0
  523. pyfect/graph/_shortest.py +274 -0
  524. pyfect/graph/_snapshot.py +50 -0
  525. pyfect/graph/_store.py +136 -0
  526. pyfect/graph/_traverse.py +289 -0
  527. pyfect/graph/_view.py +384 -0
  528. pyfect/graph/_walker.py +70 -0
  529. pyfect/graphql/__init__.py +87 -0
  530. pyfect/graphql/_codec.py +117 -0
  531. pyfect/graphql/_http.py +309 -0
  532. pyfect/graphql/_schemas.py +39 -0
  533. pyfect/graphql/_slices.py +110 -0
  534. pyfect/graphql/_template.py +111 -0
  535. pyfect/graphql/_types.py +115 -0
  536. pyfect/graphql/_ws.py +395 -0
  537. pyfect/graphql/_ws_messages.py +120 -0
  538. pyfect/graphql/client.py +428 -0
  539. pyfect/graphql/client_error.py +285 -0
  540. pyfect/graphql/group.py +142 -0
  541. pyfect/graphql/middleware.py +98 -0
  542. pyfect/graphql/operation.py +409 -0
  543. pyfect/graphql/protocol.py +119 -0
  544. pyfect/graphql/resolver.py +574 -0
  545. pyfect/graphql/template.py +61 -0
  546. pyfect/hash_map.py +317 -0
  547. pyfect/hash_ring.py +206 -0
  548. pyfect/hash_set.py +163 -0
  549. pyfect/http/__init__.py +125 -0
  550. pyfect/http/_asgi_listener.py +272 -0
  551. pyfect/http/_authority.py +63 -0
  552. pyfect/http/_brotli.py +27 -0
  553. pyfect/http/_compression.py +52 -0
  554. pyfect/http/_field.py +18 -0
  555. pyfect/http/_foreign_path.py +27 -0
  556. pyfect/http/_form_data.py +34 -0
  557. pyfect/http/_httpx_options.py +120 -0
  558. pyfect/http/_in_memory.py +76 -0
  559. pyfect/http/_request_state.py +59 -0
  560. pyfect/http/_vary.py +14 -0
  561. pyfect/http/abort.py +65 -0
  562. pyfect/http/asgi/__init__.py +59 -0
  563. pyfect/http/asgi/_app.py +155 -0
  564. pyfect/http/asgi/_http.py +201 -0
  565. pyfect/http/asgi/_mount.py +263 -0
  566. pyfect/http/asgi/_scope.py +86 -0
  567. pyfect/http/asgi/_serve.py +72 -0
  568. pyfect/http/asgi/_types.py +13 -0
  569. pyfect/http/asgi/_web_socket.py +325 -0
  570. pyfect/http/body.py +437 -0
  571. pyfect/http/client/__init__.py +111 -0
  572. pyfect/http/client/_circuit_breaker.py +113 -0
  573. pyfect/http/client/_cookie_jar.py +120 -0
  574. pyfect/http/client/_make.py +252 -0
  575. pyfect/http/client/_rate_limit.py +423 -0
  576. pyfect/http/client/_redirects.py +93 -0
  577. pyfect/http/client/_retry.py +115 -0
  578. pyfect/http/client/_service.py +497 -0
  579. pyfect/http/cookies.py +444 -0
  580. pyfect/http/error.py +188 -0
  581. pyfect/http/etag.py +96 -0
  582. pyfect/http/file_like.py +49 -0
  583. pyfect/http/find_my_way/__init__.py +10 -0
  584. pyfect/http/find_my_way/_nodes.py +186 -0
  585. pyfect/http/find_my_way/_paths.py +43 -0
  586. pyfect/http/find_my_way/_query_string.py +67 -0
  587. pyfect/http/find_my_way/_router.py +401 -0
  588. pyfect/http/headers.py +343 -0
  589. pyfect/http/http_effect.py +198 -0
  590. pyfect/http/httpx_client.py +291 -0
  591. pyfect/http/hypercorn_server.py +122 -0
  592. pyfect/http/incoming_message.py +140 -0
  593. pyfect/http/live_server/__init__.py +191 -0
  594. pyfect/http/live_server/_body.py +164 -0
  595. pyfect/http/live_server/_exchange.py +321 -0
  596. pyfect/http/live_server/_head.py +194 -0
  597. pyfect/http/live_server/_inbound.py +156 -0
  598. pyfect/http/live_server/_listener.py +211 -0
  599. pyfect/http/live_server/_serve.py +225 -0
  600. pyfect/http/live_server/_timers.py +20 -0
  601. pyfect/http/live_server/_upgrade.py +108 -0
  602. pyfect/http/live_server/_websocket.py +286 -0
  603. pyfect/http/live_server/_ws_frames.py +242 -0
  604. pyfect/http/method.py +30 -0
  605. pyfect/http/middleware/__init__.py +61 -0
  606. pyfect/http/middleware/_compression.py +156 -0
  607. pyfect/http/middleware/_cors.py +129 -0
  608. pyfect/http/middleware/_decompression.py +274 -0
  609. pyfect/http/middleware/_forwarded.py +113 -0
  610. pyfect/http/middleware/_logger.py +73 -0
  611. pyfect/http/middleware/_search_params.py +34 -0
  612. pyfect/http/middleware/_tracer.py +153 -0
  613. pyfect/http/middleware/_types.py +16 -0
  614. pyfect/http/mime/__init__.py +69 -0
  615. pyfect/http/mime/_types.py +361 -0
  616. pyfect/http/multipart.py +613 -0
  617. pyfect/http/multipart_parser/__init__.py +348 -0
  618. pyfect/http/multipart_parser/_content_type.py +109 -0
  619. pyfect/http/multipart_parser/_headers.py +206 -0
  620. pyfect/http/multipart_parser/_search.py +85 -0
  621. pyfect/http/origin.py +146 -0
  622. pyfect/http/platform.py +593 -0
  623. pyfect/http/prometheus.py +34 -0
  624. pyfect/http/request.py +384 -0
  625. pyfect/http/response.py +474 -0
  626. pyfect/http/router/__init__.py +82 -0
  627. pyfect/http/router/_api.py +462 -0
  628. pyfect/http/router/_in_memory.py +76 -0
  629. pyfect/http/router/_markers.py +47 -0
  630. pyfect/http/router/_middleware.py +181 -0
  631. pyfect/http/router/_middleware_stack.py +51 -0
  632. pyfect/http/router/_provided.py +31 -0
  633. pyfect/http/router/_route.py +114 -0
  634. pyfect/http/router/_router.py +308 -0
  635. pyfect/http/schema.py +276 -0
  636. pyfect/http/server.py +199 -0
  637. pyfect/http/server_error.py +261 -0
  638. pyfect/http/server_request.py +729 -0
  639. pyfect/http/server_respondable.py +77 -0
  640. pyfect/http/server_response.py +569 -0
  641. pyfect/http/static_server/__init__.py +257 -0
  642. pyfect/http/static_server/_conditional.py +72 -0
  643. pyfect/http/static_server/_mime.py +55 -0
  644. pyfect/http/static_server/_range.py +53 -0
  645. pyfect/http/status.py +51 -0
  646. pyfect/http/template.py +161 -0
  647. pyfect/http/trace_context.py +91 -0
  648. pyfect/http/url.py +442 -0
  649. pyfect/http/url_params.py +304 -0
  650. pyfect/http/uvicorn_server.py +119 -0
  651. pyfect/http/web.py +171 -0
  652. pyfect/http/web_handler.py +463 -0
  653. pyfect/http/wire.py +209 -0
  654. pyfect/http_api/__init__.py +83 -0
  655. pyfect/http_api/_assets/scalar.js +8 -0
  656. pyfect/http_api/_assets/swagger-ui.css +3 -0
  657. pyfect/http_api/_assets/swagger-ui.js +4 -0
  658. pyfect/http_api/_client_method.py +220 -0
  659. pyfect/http_api/_client_payload.py +144 -0
  660. pyfect/http_api/_client_response.py +377 -0
  661. pyfect/http_api/_handlers.py +282 -0
  662. pyfect/http_api/_html.py +38 -0
  663. pyfect/http_api/_media_type.py +6 -0
  664. pyfect/http_api/_openapi_responses.py +164 -0
  665. pyfect/http_api/_openapi_schemas.py +163 -0
  666. pyfect/http_api/_path.py +102 -0
  667. pyfect/http_api/_payload.py +260 -0
  668. pyfect/http_api/_response.py +363 -0
  669. pyfect/http_api/_security.py +174 -0
  670. pyfect/http_api/api.py +265 -0
  671. pyfect/http_api/builder.py +447 -0
  672. pyfect/http_api/client.py +474 -0
  673. pyfect/http_api/endpoint.py +969 -0
  674. pyfect/http_api/error.py +280 -0
  675. pyfect/http_api/group.py +215 -0
  676. pyfect/http_api/middleware.py +232 -0
  677. pyfect/http_api/openapi.py +396 -0
  678. pyfect/http_api/scalar.py +143 -0
  679. pyfect/http_api/schema.py +713 -0
  680. pyfect/http_api/security.py +91 -0
  681. pyfect/http_api/swagger.py +69 -0
  682. pyfect/http_api/test.py +105 -0
  683. pyfect/json_patch.py +255 -0
  684. pyfect/json_pointer.py +100 -0
  685. pyfect/json_schema/__init__.py +66 -0
  686. pyfect/json_schema/_api.py +96 -0
  687. pyfect/json_schema/_converter.py +258 -0
  688. pyfect/json_schema/_draft04.py +198 -0
  689. pyfect/json_schema/_draft07.py +203 -0
  690. pyfect/json_schema/_keywords.py +202 -0
  691. pyfect/json_schema/_model.py +201 -0
  692. pyfect/json_schema/_openapi.py +208 -0
  693. pyfect/latch.py +127 -0
  694. pyfect/layer.py +479 -0
  695. pyfect/layer_map.py +279 -0
  696. pyfect/layer_ref.py +208 -0
  697. pyfect/logger/__init__.py +91 -0
  698. pyfect/logger/_batched.py +49 -0
  699. pyfect/logger/_console.py +116 -0
  700. pyfect/logger/_file.py +31 -0
  701. pyfect/logger/_formats.py +104 -0
  702. pyfect/logger/_layer.py +50 -0
  703. pyfect/logger/_level.py +53 -0
  704. pyfect/logger/_log.py +142 -0
  705. pyfect/logger/_model.py +163 -0
  706. pyfect/logger/_refs.py +78 -0
  707. pyfect/logger/_stdlib.py +54 -0
  708. pyfect/logger/_text.py +263 -0
  709. pyfect/logger/_tracer.py +35 -0
  710. pyfect/managed_runtime.py +393 -0
  711. pyfect/metric/__init__.py +119 -0
  712. pyfect/metric/_boundaries.py +27 -0
  713. pyfect/metric/_kinds.py +417 -0
  714. pyfect/metric/_metric.py +302 -0
  715. pyfect/metric/_prometheus.py +150 -0
  716. pyfect/metric/_refs.py +78 -0
  717. pyfect/metric/_runtime.py +75 -0
  718. pyfect/metric/_snapshot.py +97 -0
  719. pyfect/metric/_state.py +74 -0
  720. pyfect/msgspec.py +98 -0
  721. pyfect/mutable_hash_map.py +140 -0
  722. pyfect/mutable_hash_set.py +95 -0
  723. pyfect/net/__init__.py +18 -0
  724. pyfect/net/_errors.py +29 -0
  725. pyfect/net/address_resolver.py +179 -0
  726. pyfect/net/dns/__init__.py +92 -0
  727. pyfect/net/dns/_error.py +43 -0
  728. pyfect/net/dns/_records.py +335 -0
  729. pyfect/net/dns/_service.py +287 -0
  730. pyfect/net/dns/_system.py +89 -0
  731. pyfect/net/host.py +311 -0
  732. pyfect/net/ip_interface.py +202 -0
  733. pyfect/net/ip_network.py +250 -0
  734. pyfect/net/net_address/__init__.py +245 -0
  735. pyfect/net/net_address/_inet.py +412 -0
  736. pyfect/net/net_address/_ip.py +348 -0
  737. pyfect/net/net_address/_mac.py +119 -0
  738. pyfect/optic/__init__.py +50 -0
  739. pyfect/optic/_builtins.py +90 -0
  740. pyfect/optic/_data.py +97 -0
  741. pyfect/optic/_optic.py +422 -0
  742. pyfect/optic/_steps.py +151 -0
  743. pyfect/option.py +362 -0
  744. pyfect/otel/__init__.py +22 -0
  745. pyfect/otel/_attributes.py +67 -0
  746. pyfect/otel/_producer.py +322 -0
  747. pyfect/otel/_shutdown.py +26 -0
  748. pyfect/otel/_span.py +292 -0
  749. pyfect/otel/_wrapper.py +92 -0
  750. pyfect/otel/logger.py +154 -0
  751. pyfect/otel/metrics.py +126 -0
  752. pyfect/otel/resource.py +111 -0
  753. pyfect/otel/sdk.py +195 -0
  754. pyfect/otel/tracer.py +157 -0
  755. pyfect/partitioned_semaphore.py +211 -0
  756. pyfect/path.py +304 -0
  757. pyfect/persistence/__init__.py +77 -0
  758. pyfect/persistence/_columns.py +32 -0
  759. pyfect/persistence/_error.py +14 -0
  760. pyfect/persistence/_seconds.py +68 -0
  761. pyfect/persistence/_sql_keys.py +47 -0
  762. pyfect/persistence/circuit_breaker/__init__.py +120 -0
  763. pyfect/persistence/circuit_breaker/_breaker.py +317 -0
  764. pyfect/persistence/circuit_breaker/_errors.py +67 -0
  765. pyfect/persistence/circuit_breaker/_memory.py +243 -0
  766. pyfect/persistence/circuit_breaker/_redis.py +509 -0
  767. pyfect/persistence/circuit_breaker/_store.py +60 -0
  768. pyfect/persistence/circuit_breaker/_types.py +191 -0
  769. pyfect/persistence/key_value_store/__init__.py +51 -0
  770. pyfect/persistence/key_value_store/_layers.py +216 -0
  771. pyfect/persistence/key_value_store/_schema_store.py +91 -0
  772. pyfect/persistence/key_value_store/_sql.py +197 -0
  773. pyfect/persistence/key_value_store/_store.py +212 -0
  774. pyfect/persistence/persistable.py +164 -0
  775. pyfect/persistence/persisted_cache.py +159 -0
  776. pyfect/persistence/persisted_queue/__init__.py +75 -0
  777. pyfect/persistence/persisted_queue/_error.py +42 -0
  778. pyfect/persistence/persisted_queue/_mailbox.py +101 -0
  779. pyfect/persistence/persisted_queue/_memory.py +182 -0
  780. pyfect/persistence/persisted_queue/_queue.py +272 -0
  781. pyfect/persistence/persisted_queue/_redis.py +455 -0
  782. pyfect/persistence/persisted_queue/_redis_scripts.py +395 -0
  783. pyfect/persistence/persisted_queue/_sql.py +334 -0
  784. pyfect/persistence/persisted_queue/_sql_migrations.py +319 -0
  785. pyfect/persistence/persisted_queue/_sql_statements.py +441 -0
  786. pyfect/persistence/persisted_queue/_store.py +147 -0
  787. pyfect/persistence/persistence/__init__.py +84 -0
  788. pyfect/persistence/persistence/_kvs.py +135 -0
  789. pyfect/persistence/persistence/_memory.py +62 -0
  790. pyfect/persistence/persistence/_redis.py +162 -0
  791. pyfect/persistence/persistence/_service.py +276 -0
  792. pyfect/persistence/persistence/_sql.py +499 -0
  793. pyfect/persistence/rate_limiter/__init__.py +82 -0
  794. pyfect/persistence/rate_limiter/_errors.py +59 -0
  795. pyfect/persistence/rate_limiter/_limiter.py +325 -0
  796. pyfect/persistence/rate_limiter/_memory.py +217 -0
  797. pyfect/persistence/rate_limiter/_redis.py +485 -0
  798. pyfect/persistence/rate_limiter/_store.py +89 -0
  799. pyfect/persistence/redis/__init__.py +52 -0
  800. pyfect/persistence/redis/_error.py +12 -0
  801. pyfect/persistence/redis/_make.py +234 -0
  802. pyfect/persistence/redis/_script.py +78 -0
  803. pyfect/persistence/redis/_service.py +104 -0
  804. pyfect/persistence/redis_py.py +303 -0
  805. pyfect/persistence/user_directories.py +195 -0
  806. pyfect/platform.py +26 -0
  807. pyfect/platform_error.py +256 -0
  808. pyfect/pool/__init__.py +36 -0
  809. pyfect/pool/_pool.py +707 -0
  810. pyfect/pool/_state.py +161 -0
  811. pyfect/pool/_ttl.py +105 -0
  812. pyfect/pool/_waiters.py +116 -0
  813. pyfect/primary_key.py +35 -0
  814. pyfect/process/__init__.py +82 -0
  815. pyfect/process/_child.py +213 -0
  816. pyfect/process/_command.py +358 -0
  817. pyfect/process/_handle.py +77 -0
  818. pyfect/process/_live.py +455 -0
  819. pyfect/process/_os.py +78 -0
  820. pyfect/process/_pipes.py +291 -0
  821. pyfect/process/_spawner.py +75 -0
  822. pyfect/pubsub/__init__.py +33 -0
  823. pyfect/pubsub/_atomic.py +181 -0
  824. pyfect/pubsub/_hub.py +214 -0
  825. pyfect/pubsub/_pubsub.py +214 -0
  826. pyfect/pubsub/_replay.py +107 -0
  827. pyfect/pubsub/_subscription.py +226 -0
  828. pyfect/pull.py +132 -0
  829. pyfect/py.typed +0 -0
  830. pyfect/pydantic.py +188 -0
  831. pyfect/queue/__init__.py +33 -0
  832. pyfect/queue/_queue.py +525 -0
  833. pyfect/queue/_state.py +111 -0
  834. pyfect/queue/_views.py +55 -0
  835. pyfect/random.py +146 -0
  836. pyfect/rc_map.py +363 -0
  837. pyfect/rc_ref.py +271 -0
  838. pyfect/reactivity/__init__.py +53 -0
  839. pyfect/reactivity/_async_result_schema.py +227 -0
  840. pyfect/reactivity/_hydration.py +18 -0
  841. pyfect/reactivity/_live.py +21 -0
  842. pyfect/reactivity/_reactivity.py +256 -0
  843. pyfect/reactivity/_result_effect.py +17 -0
  844. pyfect/reactivity/_time.py +11 -0
  845. pyfect/reactivity/async_result.py +679 -0
  846. pyfect/reactivity/atom/__init__.py +143 -0
  847. pyfect/reactivity/atom/_combinators.py +223 -0
  848. pyfect/reactivity/atom/_constructors.py +80 -0
  849. pyfect/reactivity/atom/_conversions.py +79 -0
  850. pyfect/reactivity/atom/_effect.py +252 -0
  851. pyfect/reactivity/atom/_fn.py +341 -0
  852. pyfect/reactivity/atom/_kvs.py +101 -0
  853. pyfect/reactivity/atom/_optimistic.py +162 -0
  854. pyfect/reactivity/atom/_runtime.py +323 -0
  855. pyfect/reactivity/atom/_serializable.py +65 -0
  856. pyfect/reactivity/atom/_subscription_ref.py +102 -0
  857. pyfect/reactivity/atom/_swr.py +69 -0
  858. pyfect/reactivity/atom/_types.py +435 -0
  859. pyfect/reactivity/atom_http_api.py +667 -0
  860. pyfect/reactivity/atom_ref.py +260 -0
  861. pyfect/reactivity/atom_registry/__init__.py +219 -0
  862. pyfect/reactivity/atom_registry/_batch.py +96 -0
  863. pyfect/reactivity/atom_registry/_dispatcher.py +60 -0
  864. pyfect/reactivity/atom_registry/_lifetime.py +202 -0
  865. pyfect/reactivity/atom_registry/_node.py +423 -0
  866. pyfect/reactivity/atom_registry/_registry.py +380 -0
  867. pyfect/reactivity/atom_rpc.py +283 -0
  868. pyfect/reactivity/hydration.py +200 -0
  869. pyfect/redacted.py +83 -0
  870. pyfect/ref.py +129 -0
  871. pyfect/resource.py +98 -0
  872. pyfect/result.py +306 -0
  873. pyfect/rpc/__init__.py +64 -0
  874. pyfect/rpc/_encoded_schema.py +86 -0
  875. pyfect/rpc/_json_rpc.py +246 -0
  876. pyfect/rpc/_methods.py +177 -0
  877. pyfect/rpc/_rpc.py +498 -0
  878. pyfect/rpc/client/__init__.py +100 -0
  879. pyfect/rpc/client/_core.py +449 -0
  880. pyfect/rpc/client/_http.py +257 -0
  881. pyfect/rpc/client/_protocol.py +171 -0
  882. pyfect/rpc/client/_serialized.py +321 -0
  883. pyfect/rpc/client/_transports.py +328 -0
  884. pyfect/rpc/client/_worker.py +283 -0
  885. pyfect/rpc/client_error.py +35 -0
  886. pyfect/rpc/group.py +296 -0
  887. pyfect/rpc/message.py +299 -0
  888. pyfect/rpc/middleware.py +182 -0
  889. pyfect/rpc/schema.py +89 -0
  890. pyfect/rpc/serialization.py +366 -0
  891. pyfect/rpc/server/__init__.py +181 -0
  892. pyfect/rpc/server/_core.py +549 -0
  893. pyfect/rpc/server/_protocol.py +123 -0
  894. pyfect/rpc/server/_serialized.py +363 -0
  895. pyfect/rpc/server/_stdio.py +101 -0
  896. pyfect/rpc/server/_transports.py +427 -0
  897. pyfect/rpc/server/_worker.py +108 -0
  898. pyfect/rpc/test.py +74 -0
  899. pyfect/rpc/worker.py +92 -0
  900. pyfect/run.py +393 -0
  901. pyfect/schedule/__init__.py +91 -0
  902. pyfect/schedule/_combinators.py +168 -0
  903. pyfect/schedule/_constructors.py +223 -0
  904. pyfect/schedule/_cron.py +49 -0
  905. pyfect/schedule/_drive.py +191 -0
  906. pyfect/schedule/_model.py +405 -0
  907. pyfect/scheduler.py +575 -0
  908. pyfect/schema/__init__.py +866 -0
  909. pyfect/schema/_adapters.py +39 -0
  910. pyfect/schema/_arbitrary_constraint.py +242 -0
  911. pyfect/schema/_arbitrary_graph.py +325 -0
  912. pyfect/schema/_arbitrary_links.py +179 -0
  913. pyfect/schema/_arbitrary_number.py +112 -0
  914. pyfect/schema/_arrays.py +287 -0
  915. pyfect/schema/_assignable.py +118 -0
  916. pyfect/schema/_boolean_literals.py +31 -0
  917. pyfect/schema/_checks_number.py +216 -0
  918. pyfect/schema/_checks_order.py +140 -0
  919. pyfect/schema/_checks_size.py +277 -0
  920. pyfect/schema/_checks_string.py +241 -0
  921. pyfect/schema/_class.py +569 -0
  922. pyfect/schema/_codec_derivation.py +227 -0
  923. pyfect/schema/_codec_links.py +221 -0
  924. pyfect/schema/_codecs.py +316 -0
  925. pyfect/schema/_collections.py +172 -0
  926. pyfect/schema/_constructor_default.py +89 -0
  927. pyfect/schema/_data.py +440 -0
  928. pyfect/schema/_data_codecs.py +145 -0
  929. pyfect/schema/_decimal_regexp.py +243 -0
  930. pyfect/schema/_declare.py +68 -0
  931. pyfect/schema/_derive.py +292 -0
  932. pyfect/schema/_duration_codecs.py +27 -0
  933. pyfect/schema/_ecma_pattern.py +416 -0
  934. pyfect/schema/_error.py +26 -0
  935. pyfect/schema/_error_instance.py +222 -0
  936. pyfect/schema/_graph.py +271 -0
  937. pyfect/schema/_instances.py +240 -0
  938. pyfect/schema/_jsonschema/__init__.py +90 -0
  939. pyfect/schema/_jsonschema/_annotations.py +114 -0
  940. pyfect/schema/_jsonschema/_checks.py +253 -0
  941. pyfect/schema/_jsonschema/_compile.py +346 -0
  942. pyfect/schema/_jsonschema/_exact.py +19 -0
  943. pyfect/schema/_jsonschema/_merge.py +211 -0
  944. pyfect/schema/_jsonschema/_objects.py +231 -0
  945. pyfect/schema/_jsonschema/_references.py +221 -0
  946. pyfect/schema/_jsonschema/_template.py +69 -0
  947. pyfect/schema/_literals.py +147 -0
  948. pyfect/schema/_middleware.py +209 -0
  949. pyfect/schema/_net.py +522 -0
  950. pyfect/schema/_options.py +49 -0
  951. pyfect/schema/_parse.py +351 -0
  952. pyfect/schema/_parsed_text.py +37 -0
  953. pyfect/schema/_primitives.py +48 -0
  954. pyfect/schema/_record.py +41 -0
  955. pyfect/schema/_refine.py +81 -0
  956. pyfect/schema/_schema.py +158 -0
  957. pyfect/schema/_semver.py +144 -0
  958. pyfect/schema/_strategy/__init__.py +258 -0
  959. pyfect/schema/_strategy/_big_decimal.py +203 -0
  960. pyfect/schema/_strategy/_composites.py +119 -0
  961. pyfect/schema/_strategy/_leaves.py +94 -0
  962. pyfect/schema/_strategy/_net.py +133 -0
  963. pyfect/schema/_struct.py +87 -0
  964. pyfect/schema/_struct_keys.py +128 -0
  965. pyfect/schema/_tagged.py +254 -0
  966. pyfect/schema/_template_literal.py +172 -0
  967. pyfect/schema/_to_codec_array_from_single.py +115 -0
  968. pyfect/schema/_to_codec_go_json.py +174 -0
  969. pyfect/schema/_to_codec_json.py +73 -0
  970. pyfect/schema/_to_codec_string_tree.py +115 -0
  971. pyfect/schema/_to_differ_json_patch.py +44 -0
  972. pyfect/schema/_to_encoder_xml.py +119 -0
  973. pyfect/schema/_to_equivalence.py +186 -0
  974. pyfect/schema/_to_formatter.py +180 -0
  975. pyfect/schema/_to_iso.py +73 -0
  976. pyfect/schema/_to_strategy.py +31 -0
  977. pyfect/schema/_transform.py +210 -0
  978. pyfect/schema/_tree.py +27 -0
  979. pyfect/schema/_type_walk.py +53 -0
  980. pyfect/schema/_undefined.py +58 -0
  981. pyfect/schema/_value_codecs.py +84 -0
  982. pyfect/schema/_values.py +123 -0
  983. pyfect/schema/_void.py +86 -0
  984. pyfect/schema/ast/__init__.py +227 -0
  985. pyfect/schema/ast/_annotations.py +43 -0
  986. pyfect/schema/ast/_arrays.py +210 -0
  987. pyfect/schema/ast/_base.py +295 -0
  988. pyfect/schema/ast/_candidates.py +309 -0
  989. pyfect/schema/ast/_check.py +181 -0
  990. pyfect/schema/ast/_class.py +159 -0
  991. pyfect/schema/ast/_constructors.py +65 -0
  992. pyfect/schema/ast/_declaration.py +97 -0
  993. pyfect/schema/ast/_encoding.py +111 -0
  994. pyfect/schema/ast/_json.py +129 -0
  995. pyfect/schema/ast/_keywords.py +125 -0
  996. pyfect/schema/ast/_literal.py +157 -0
  997. pyfect/schema/ast/_objects.py +356 -0
  998. pyfect/schema/ast/_record.py +36 -0
  999. pyfect/schema/ast/_result.py +116 -0
  1000. pyfect/schema/ast/_steps.py +209 -0
  1001. pyfect/schema/ast/_suspend.py +65 -0
  1002. pyfect/schema/ast/_template_literal.py +256 -0
  1003. pyfect/schema/ast/_union.py +172 -0
  1004. pyfect/schema/getter/__init__.py +136 -0
  1005. pyfect/schema/getter/_binary.py +104 -0
  1006. pyfect/schema/getter/_coerce.py +196 -0
  1007. pyfect/schema/getter/_getter.py +243 -0
  1008. pyfect/schema/getter/_make.py +151 -0
  1009. pyfect/schema/getter/_text.py +141 -0
  1010. pyfect/schema/getter/_tree_record.py +170 -0
  1011. pyfect/schema/issue.py +420 -0
  1012. pyfect/schema/model/__init__.py +120 -0
  1013. pyfect/schema/model/_class.py +245 -0
  1014. pyfect/schema/model/_dates.py +103 -0
  1015. pyfect/schema/model/_fields.py +77 -0
  1016. pyfect/schema/model/_toolkit.py +114 -0
  1017. pyfect/schema/model/_uuid.py +69 -0
  1018. pyfect/schema/representation/__init__.py +424 -0
  1019. pyfect/schema/representation/_builtin_revivers.py +331 -0
  1020. pyfect/schema/representation/_code.py +106 -0
  1021. pyfect/schema/representation/_code_builtins.py +281 -0
  1022. pyfect/schema/representation/_code_document.py +563 -0
  1023. pyfect/schema/representation/_code_sort.py +111 -0
  1024. pyfect/schema/representation/_from.py +278 -0
  1025. pyfect/schema/representation/_import/__init__.py +78 -0
  1026. pyfect/schema/representation/_import/_finalize.py +121 -0
  1027. pyfect/schema/representation/_import/_intersect.py +467 -0
  1028. pyfect/schema/representation/_import/_js_order.py +66 -0
  1029. pyfect/schema/representation/_import/_keywords.py +224 -0
  1030. pyfect/schema/representation/_import/_nodes.py +199 -0
  1031. pyfect/schema/representation/_import/_translate.py +455 -0
  1032. pyfect/schema/representation/_json.py +520 -0
  1033. pyfect/schema/representation/_json_schema.py +178 -0
  1034. pyfect/schema/representation/_model.py +284 -0
  1035. pyfect/schema/representation/_revivers.py +89 -0
  1036. pyfect/schema/representation/_to.py +249 -0
  1037. pyfect/schema/transformation/__init__.py +99 -0
  1038. pyfect/schema/transformation/_builtins.py +314 -0
  1039. pyfect/schema/transformation/_durations.py +150 -0
  1040. pyfect/schema/transformation/_transformation.py +177 -0
  1041. pyfect/schema/variant_schema/__init__.py +69 -0
  1042. pyfect/schema/variant_schema/_class.py +188 -0
  1043. pyfect/schema/variant_schema/_defaults.py +30 -0
  1044. pyfect/schema/variant_schema/_field.py +32 -0
  1045. pyfect/schema/variant_schema/_struct.py +130 -0
  1046. pyfect/schema/variant_schema/_toolkit.py +160 -0
  1047. pyfect/scope.py +374 -0
  1048. pyfect/scoped_ref.py +124 -0
  1049. pyfect/semaphore.py +276 -0
  1050. pyfect/semver.py +403 -0
  1051. pyfect/semver_range.py +420 -0
  1052. pyfect/sink/__init__.py +131 -0
  1053. pyfect/sink/_combinators.py +151 -0
  1054. pyfect/sink/_constructors.py +187 -0
  1055. pyfect/sink/_context.py +87 -0
  1056. pyfect/sink/_folds.py +336 -0
  1057. pyfect/sink/_for_each.py +87 -0
  1058. pyfect/sink/_sink.py +265 -0
  1059. pyfect/sink/_steps.py +34 -0
  1060. pyfect/sink/_taking.py +183 -0
  1061. pyfect/socket/__init__.py +146 -0
  1062. pyfect/socket/_accepted.py +65 -0
  1063. pyfect/socket/_connection.py +384 -0
  1064. pyfect/socket/_errors.py +135 -0
  1065. pyfect/socket/_loop.py +66 -0
  1066. pyfect/socket/_net.py +281 -0
  1067. pyfect/socket/_socket.py +245 -0
  1068. pyfect/socket/_tls.py +88 -0
  1069. pyfect/socket/_tls_session.py +117 -0
  1070. pyfect/socket/_web_socket.py +555 -0
  1071. pyfect/socket/datagram/__init__.py +110 -0
  1072. pyfect/socket/datagram/_core.py +460 -0
  1073. pyfect/socket/datagram/_errors.py +102 -0
  1074. pyfect/socket/datagram/_live.py +675 -0
  1075. pyfect/socket/datagram/_model.py +217 -0
  1076. pyfect/socket/server.py +258 -0
  1077. pyfect/socket/ws.py +484 -0
  1078. pyfect/sql/__init__.py +60 -0
  1079. pyfect/sql/_loop.py +134 -0
  1080. pyfect/sql/clickhouse/__init__.py +74 -0
  1081. pyfect/sql/clickhouse/_connection.py +237 -0
  1082. pyfect/sql/clickhouse/_rows.py +87 -0
  1083. pyfect/sql/clickhouse/client.py +322 -0
  1084. pyfect/sql/clickhouse/config.py +241 -0
  1085. pyfect/sql/clickhouse/driver.py +434 -0
  1086. pyfect/sql/clickhouse/error.py +106 -0
  1087. pyfect/sql/clickhouse/migrator.py +47 -0
  1088. pyfect/sql/clickhouse/params.py +168 -0
  1089. pyfect/sql/client/__init__.py +35 -0
  1090. pyfect/sql/client/_client.py +309 -0
  1091. pyfect/sql/client/_sqlite_acquirers.py +130 -0
  1092. pyfect/sql/client/_transaction.py +410 -0
  1093. pyfect/sql/connection.py +87 -0
  1094. pyfect/sql/d1/__init__.py +48 -0
  1095. pyfect/sql/d1/api.py +270 -0
  1096. pyfect/sql/d1/client.py +344 -0
  1097. pyfect/sql/d1/config.py +55 -0
  1098. pyfect/sql/error.py +311 -0
  1099. pyfect/sql/libsql/__init__.py +58 -0
  1100. pyfect/sql/libsql/_connection.py +110 -0
  1101. pyfect/sql/libsql/_hrana.py +258 -0
  1102. pyfect/sql/libsql/_local.py +251 -0
  1103. pyfect/sql/libsql/_targets.py +28 -0
  1104. pyfect/sql/libsql/_values.py +46 -0
  1105. pyfect/sql/libsql/client.py +225 -0
  1106. pyfect/sql/libsql/config.py +170 -0
  1107. pyfect/sql/libsql/migrator.py +43 -0
  1108. pyfect/sql/libsql/sdk.py +123 -0
  1109. pyfect/sql/migrator.py +434 -0
  1110. pyfect/sql/model.py +324 -0
  1111. pyfect/sql/mssql/__init__.py +79 -0
  1112. pyfect/sql/mssql/_connection.py +169 -0
  1113. pyfect/sql/mssql/_driver.py +103 -0
  1114. pyfect/sql/mssql/_names.py +9 -0
  1115. pyfect/sql/mssql/_pool.py +125 -0
  1116. pyfect/sql/mssql/_tds.py +447 -0
  1117. pyfect/sql/mssql/_tds_params.py +155 -0
  1118. pyfect/sql/mssql/_worker.py +155 -0
  1119. pyfect/sql/mssql/client.py +344 -0
  1120. pyfect/sql/mssql/config.py +118 -0
  1121. pyfect/sql/mssql/error.py +111 -0
  1122. pyfect/sql/mssql/migrator.py +43 -0
  1123. pyfect/sql/mssql/parameter.py +44 -0
  1124. pyfect/sql/mssql/procedure.py +119 -0
  1125. pyfect/sql/mssql/types.py +137 -0
  1126. pyfect/sql/mysql/__init__.py +60 -0
  1127. pyfect/sql/mysql/_asyncmy.py +168 -0
  1128. pyfect/sql/mysql/_bind.py +76 -0
  1129. pyfect/sql/mysql/_connection.py +156 -0
  1130. pyfect/sql/mysql/_pool.py +63 -0
  1131. pyfect/sql/mysql/_session.py +262 -0
  1132. pyfect/sql/mysql/client.py +244 -0
  1133. pyfect/sql/mysql/config.py +108 -0
  1134. pyfect/sql/mysql/error.py +104 -0
  1135. pyfect/sql/mysql/migrator.py +44 -0
  1136. pyfect/sql/pg/__init__.py +82 -0
  1137. pyfect/sql/pg/_resolve.py +284 -0
  1138. pyfect/sql/pg/_session.py +380 -0
  1139. pyfect/sql/pg/client.py +398 -0
  1140. pyfect/sql/pg/config.py +142 -0
  1141. pyfect/sql/pg/connection.py +585 -0
  1142. pyfect/sql/pg/error.py +131 -0
  1143. pyfect/sql/pg/migrator.py +139 -0
  1144. pyfect/sql/pg/pool.py +265 -0
  1145. pyfect/sql/resolver.py +294 -0
  1146. pyfect/sql/result.py +24 -0
  1147. pyfect/sql/schema.py +116 -0
  1148. pyfect/sql/sqlite/__init__.py +26 -0
  1149. pyfect/sql/sqlite/_connection.py +230 -0
  1150. pyfect/sql/sqlite/_worker.py +71 -0
  1151. pyfect/sql/sqlite/client.py +248 -0
  1152. pyfect/sql/sqlite/migrator.py +43 -0
  1153. pyfect/sql/statement/__init__.py +144 -0
  1154. pyfect/sql/statement/_compiler.py +384 -0
  1155. pyfect/sql/statement/_segments.py +487 -0
  1156. pyfect/sql/statement/_statement.py +526 -0
  1157. pyfect/sql/statement/_transforms.py +93 -0
  1158. pyfect/sql/stream.py +88 -0
  1159. pyfect/stdio.py +206 -0
  1160. pyfect/stream/__init__.py +151 -0
  1161. pyfect/stream/_async_iterable.py +129 -0
  1162. pyfect/stream/_base.py +69 -0
  1163. pyfect/stream/_bridge_methods.py +139 -0
  1164. pyfect/stream/_catch.py +135 -0
  1165. pyfect/stream/_catch_reason.py +558 -0
  1166. pyfect/stream/_channel_methods.py +61 -0
  1167. pyfect/stream/_chunk_methods.py +169 -0
  1168. pyfect/stream/_chunking.py +310 -0
  1169. pyfect/stream/_concat.py +65 -0
  1170. pyfect/stream/_constructors.py +341 -0
  1171. pyfect/stream/_context.py +147 -0
  1172. pyfect/stream/_error_methods.py +254 -0
  1173. pyfect/stream/_execution_plan.py +199 -0
  1174. pyfect/stream/_fanout.py +154 -0
  1175. pyfect/stream/_fanout_methods.py +183 -0
  1176. pyfect/stream/_filter_methods.py +203 -0
  1177. pyfect/stream/_grouping.py +168 -0
  1178. pyfect/stream/_many.py +65 -0
  1179. pyfect/stream/_map_methods.py +233 -0
  1180. pyfect/stream/_mapping.py +126 -0
  1181. pyfect/stream/_run.py +114 -0
  1182. pyfect/stream/_run_methods.py +114 -0
  1183. pyfect/stream/_service_methods.py +36 -0
  1184. pyfect/stream/_sink_methods.py +151 -0
  1185. pyfect/stream/_sinking.py +277 -0
  1186. pyfect/stream/_sources.py +124 -0
  1187. pyfect/stream/_stream.py +162 -0
  1188. pyfect/stream/_taking.py +330 -0
  1189. pyfect/stream/_text.py +43 -0
  1190. pyfect/stream/_timing.py +294 -0
  1191. pyfect/stream/_timing_methods.py +252 -0
  1192. pyfect/stream/_zip_methods.py +279 -0
  1193. pyfect/stream/_zipping.py +213 -0
  1194. pyfect/subscription_ref.py +66 -0
  1195. pyfect/synchronized_ref.py +38 -0
  1196. pyfect/take.py +36 -0
  1197. pyfect/terminal/__init__.py +41 -0
  1198. pyfect/terminal/_keys.py +113 -0
  1199. pyfect/terminal/_live.py +223 -0
  1200. pyfect/terminal/_service.py +73 -0
  1201. pyfect/testing/__init__.py +122 -0
  1202. pyfect/testing/_assertions.py +92 -0
  1203. pyfect/testing/_clock.py +309 -0
  1204. pyfect/testing/_console.py +164 -0
  1205. pyfect/testing/_crypto.py +44 -0
  1206. pyfect/testing/_decorators.py +211 -0
  1207. pyfect/testing/_flaky.py +34 -0
  1208. pyfect/testing/_layers.py +153 -0
  1209. pyfect/testing/_prop.py +255 -0
  1210. pyfect/testing/_runners.py +84 -0
  1211. pyfect/testing/_runtime.py +174 -0
  1212. pyfect/testing/_schema.py +238 -0
  1213. pyfect/testing/plugin.py +59 -0
  1214. pyfect/tracer/__init__.py +107 -0
  1215. pyfect/tracer/_model.py +176 -0
  1216. pyfect/tracer/_native.py +172 -0
  1217. pyfect/tracer/_refs.py +87 -0
  1218. pyfect/tracer/_spans.py +269 -0
  1219. pyfect/transaction.py +340 -0
  1220. pyfect/trie.py +317 -0
  1221. pyfect/tx_chunk.py +127 -0
  1222. pyfect/tx_deferred.py +75 -0
  1223. pyfect/tx_hash_map.py +265 -0
  1224. pyfect/tx_hash_set.py +151 -0
  1225. pyfect/tx_priority_queue.py +224 -0
  1226. pyfect/tx_pubsub.py +194 -0
  1227. pyfect/tx_queue/__init__.py +27 -0
  1228. pyfect/tx_queue/_queue.py +359 -0
  1229. pyfect/tx_queue/_views.py +60 -0
  1230. pyfect/tx_reentrant_lock.py +201 -0
  1231. pyfect/tx_ref.py +79 -0
  1232. pyfect/tx_semaphore.py +136 -0
  1233. pyfect/tx_subscription_ref.py +118 -0
  1234. pyfect/workers/__init__.py +62 -0
  1235. pyfect/workers/_frames.py +82 -0
  1236. pyfect/workers/_mailbox.py +51 -0
  1237. pyfect/workers/_port.py +106 -0
  1238. pyfect/workers/_process.py +155 -0
  1239. pyfect/workers/_thread.py +100 -0
  1240. pyfect/workers/python_worker.py +133 -0
  1241. pyfect/workers/python_worker_runner.py +112 -0
  1242. pyfect/workers/transferable.py +103 -0
  1243. pyfect/workers/worker.py +273 -0
  1244. pyfect/workers/worker_error.py +86 -0
  1245. pyfect/workers/worker_runner.py +85 -0
  1246. pyfect/workflow/__init__.py +78 -0
  1247. pyfect/workflow/_crypto.py +23 -0
  1248. pyfect/workflow/_encoded.py +381 -0
  1249. pyfect/workflow/_memory.py +424 -0
  1250. pyfect/workflow/_result.py +43 -0
  1251. pyfect/workflow/_services.py +241 -0
  1252. pyfect/workflow/_suspension.py +153 -0
  1253. pyfect/workflow/activity.py +427 -0
  1254. pyfect/workflow/durable_clock.py +72 -0
  1255. pyfect/workflow/durable_deferred.py +403 -0
  1256. pyfect/workflow/durable_queue.py +259 -0
  1257. pyfect/workflow/workflow.py +509 -0
  1258. pyfect/workflow/workflow_engine.py +42 -0
  1259. pyfect/workflow/workflow_proxy.py +161 -0
  1260. pyfect/workflow/workflow_proxy_server.py +146 -0
  1261. pyfect_dev-0.1.0.dist-info/METADATA +296 -0
  1262. pyfect_dev-0.1.0.dist-info/RECORD +1265 -0
  1263. pyfect_dev-0.1.0.dist-info/WHEEL +4 -0
  1264. pyfect_dev-0.1.0.dist-info/entry_points.txt +3 -0
  1265. pyfect_dev-0.1.0.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,1039 @@
1
+ """Event logs (Effect's ``eventlog/EventLog``): events written to a
2
+ journal, each handled once when written and again when a remote sends
3
+ it, with the stored entries it conflicts with.
4
+
5
+ Handlers are registered per group::
6
+
7
+ UsersLive = event_log.group(Users, lambda handlers: handlers
8
+ .handle(UserCreated, lambda h: save_user(h.payload)))
9
+
10
+ EventLogLive = event_log.layer(event_log.schema(Users), UsersLive).pipe(
11
+ fx.provide(event_journal.layer_memory)
12
+ )
13
+
14
+ ``write`` writes one event under the store's lock and runs its handler in
15
+ the ``HandlerTransaction``; remotes registered with the ``Registry`` (see
16
+ ``event_log_remote``) receive the journal's new entries and send theirs,
17
+ which are compacted by the registered compactors, then replayed.
18
+ """
19
+
20
+ from __future__ import annotations
21
+
22
+ from collections.abc import Callable, Mapping, Sequence
23
+ from dataclasses import dataclass
24
+ from typing import TYPE_CHECKING, Any, Never, Protocol, cast, overload
25
+
26
+ from pyfect import _json_text
27
+ from pyfect._concurrency import for_each
28
+ from pyfect._core import Effect
29
+ from pyfect._layer_core import require_layer
30
+ from pyfect.cause import Cause
31
+ from pyfect.clock import sleep
32
+ from pyfect.context import Context, Reference, Tag
33
+ from pyfect.effect import (
34
+ context,
35
+ die,
36
+ gen,
37
+ provide_context,
38
+ provide_service,
39
+ succeed,
40
+ suspend,
41
+ sync,
42
+ )
43
+ from pyfect.eventlog._conflicts import set_anchor
44
+ from pyfect.eventlog._identity import Identity, IdentityService
45
+ from pyfect.eventlog.event import AnyEvent, AnyWrite, Event, Write
46
+ from pyfect.eventlog.event_group import EventGroup
47
+ from pyfect.eventlog.event_journal import (
48
+ Entry,
49
+ EntryInput,
50
+ EntryWithConflicts,
51
+ EventJournal,
52
+ EventJournalError,
53
+ EventJournalService,
54
+ RemoteAck,
55
+ RemoteEntry,
56
+ RemoteId,
57
+ StoreId,
58
+ WithLock,
59
+ make_entry_id_unsafe,
60
+ )
61
+ from pyfect.eventlog.event_log_encryption import EventLogEncryption
62
+ from pyfect.fiber_map import FiberMap
63
+ from pyfect.layer import Layer, provide_merge
64
+ from pyfect.layer import effect as layer_effect
65
+ from pyfect.layer import effect_discard as layer_effect_discard
66
+ from pyfect.layer import provide as layer_provide
67
+ from pyfect.logger._log import log_debug, log_error
68
+ from pyfect.logger._refs import CurrentLogAnnotations
69
+ from pyfect.queue import Queue
70
+ from pyfect.reactivity import Reactivity, ReactivityService
71
+ from pyfect.reactivity import layer as reactivity_layer
72
+ from pyfect.redacted import make as redacted
73
+ from pyfect.redacted import value as reveal
74
+ from pyfect.result import Ok
75
+ from pyfect.schedule import exponential, spaced
76
+ from pyfect.schedule import min as schedule_min
77
+ from pyfect.schema import decode_effect, encode_effect
78
+ from pyfect.schema.getter._binary import (
79
+ base64_decode,
80
+ base64_encode,
81
+ base64_url_decode,
82
+ base64_url_encode,
83
+ )
84
+ from pyfect.scope import Scope, acquire_release, add_finalizer, scoped
85
+
86
+ if TYPE_CHECKING:
87
+ from pyfect.eventlog.event_log_message import WriteAck
88
+ from pyfect.eventlog.event_log_remote import EventLogRemoteError, EventLogRemoteService
89
+
90
+ __all__ = [
91
+ "BatchCompaction",
92
+ "CompactFn",
93
+ "CompactWrite",
94
+ "Compaction",
95
+ "CompactionItem",
96
+ "Conflict",
97
+ "CurrentStoreId",
98
+ "EventJournalError",
99
+ "EventLog",
100
+ "EventLogSchema",
101
+ "EventLogService",
102
+ "HandlerFn",
103
+ "HandlerInput",
104
+ "HandlerItem",
105
+ "HandlerTransaction",
106
+ "Handlers",
107
+ "Identity",
108
+ "IdentityService",
109
+ "RegisteredCompactor",
110
+ "Registry",
111
+ "RegistryService",
112
+ "TaggedPayload",
113
+ "Transaction",
114
+ "WriteClient",
115
+ "WriteEvent",
116
+ "decode_identity_string",
117
+ "encode_identity_string",
118
+ "group",
119
+ "group_batch_compaction",
120
+ "group_compaction",
121
+ "group_reactivity",
122
+ "layer",
123
+ "layer_event_log",
124
+ "layer_registry",
125
+ "make_client",
126
+ "make_identity",
127
+ "make_replay_from_remote",
128
+ "schema",
129
+ ]
130
+
131
+
132
+ # --- handlers ------------------------------------------------------------------------
133
+
134
+
135
+ @dataclass(frozen=True, slots=True)
136
+ class Conflict[P]:
137
+ """A stored entry newer than the one being handled, with its payload."""
138
+
139
+ entry: Entry
140
+ payload: P
141
+
142
+
143
+ @dataclass(frozen=True, slots=True)
144
+ class HandlerInput[P]:
145
+ """What a handler gets: the store, the decoded payload, the entry and
146
+ its conflicts (stored entries of the same event and primary key with
147
+ greater ids, oldest first)."""
148
+
149
+ store_id: StoreId
150
+ payload: P
151
+ entry: Entry
152
+ conflicts: tuple[Conflict[P], ...] = ()
153
+
154
+
155
+ type HandlerFn = Callable[[HandlerInput[object]], Effect[object, object, object]]
156
+ """A registered handler, its payload and result types erased (Effect's
157
+ ``unknown``); ``Handlers.handle`` checks them against the event."""
158
+
159
+
160
+ @dataclass(frozen=True, slots=True)
161
+ class HandlerItem:
162
+ """A registered handler: its event, the services of the layer that
163
+ registered it, and the function."""
164
+
165
+ event: AnyEvent
166
+ context: Context[Never]
167
+ handler: HandlerFn
168
+
169
+
170
+ class Handlers[R = Never]:
171
+ """The handlers of a group so far, needing ``R``. Immutable: ``handle``
172
+ gives a new one."""
173
+
174
+ __slots__ = ("_by_tag", "_context", "group")
175
+
176
+ def __init__(
177
+ self, group: EventGroup[AnyEvent], by_tag: Mapping[str, HandlerFn], context: Context[Never]
178
+ ) -> None:
179
+ self.group = group
180
+ self._by_tag = dict(by_tag)
181
+ self._context = context
182
+
183
+ @property
184
+ def by_tag(self) -> Mapping[str, HandlerItem]:
185
+ return {
186
+ tag: HandlerItem(self.group.events[tag], self._context, fn)
187
+ for tag, fn in self._by_tag.items()
188
+ }
189
+
190
+ @overload
191
+ def handle[P, A, E, R1 = Never](
192
+ self,
193
+ event: Event[P, A, E],
194
+ handler: Callable[[HandlerInput[P]], Effect[A, E, R1]],
195
+ /,
196
+ ) -> Handlers[R | R1]: ...
197
+ @overload
198
+ def handle[R1 = Never](
199
+ self,
200
+ event: str,
201
+ handler: Callable[[HandlerInput[Never]], Effect[object, object, R1]],
202
+ /,
203
+ ) -> Handlers[R | R1]: ...
204
+ def handle(
205
+ self,
206
+ event: AnyEvent | str,
207
+ handler: Callable[..., Effect[object, object, object]],
208
+ /,
209
+ ) -> Handlers[object]:
210
+ """Handle ``event`` (or the event of that tag) with ``handler``. The
211
+ log provides its ``Identity`` to the handler."""
212
+ tag = event if isinstance(event, str) else event.tag
213
+ found = self.group.events.get(tag)
214
+ if found is None or (not isinstance(event, str) and found is not event):
215
+ raise ValueError(f"{tag!r} is not an event of {self.group!r}")
216
+ # The overloads tie the handler's payload to the event's.
217
+ erased = cast("HandlerFn", handler)
218
+ return Handlers(self.group, {**self._by_tag, tag: erased}, self._context)
219
+
220
+
221
+ # --- registry ------------------------------------------------------------------------
222
+
223
+
224
+ type CompactWrite = Callable[[Entry, Entry | None], Effect[None]]
225
+ """A compactor's output: an entry and, optionally, the input entry it
226
+ replaces (its anchor during remote replay; without one a matching id
227
+ keeps its position and a new id takes the group's start)."""
228
+
229
+ type CompactFn = Callable[[Sequence[Entry], CompactWrite], Effect[None]]
230
+
231
+
232
+ @dataclass(frozen=True, slots=True)
233
+ class RegisteredCompactor:
234
+ """A compactor of ``events``."""
235
+
236
+ events: frozenset[str]
237
+ effect: CompactFn
238
+
239
+
240
+ class RegistryService:
241
+ """Handlers, compactors, remotes and reactivity keys of an event log
242
+ (Effect's ``EventLog.Registry``)."""
243
+
244
+ def __init__(self, remote_fibers: FiberMap[RemoteId, Any, Any]) -> None:
245
+ self.handlers: dict[str, HandlerItem] = {}
246
+ self.compactors: dict[str, RegisteredCompactor] = {}
247
+ self.reactivity_keys: dict[str, Sequence[str]] = {}
248
+ self._remote_fibers = remote_fibers
249
+ self._remotes: dict[RemoteId, EventLogRemoteService] = {}
250
+ self._remote_handler: Callable[[EventLogRemoteService], Effect[None]] = lambda _: succeed(
251
+ None
252
+ )
253
+
254
+ def register_handler_unsafe(self, event: str, handler: HandlerItem) -> None:
255
+ self.handlers[event] = handler
256
+
257
+ def register_compaction(
258
+ self, events: Sequence[str], effect: CompactFn
259
+ ) -> Effect[None, Never, Scope]:
260
+ def register() -> None:
261
+ compactor = RegisteredCompactor(frozenset(events), effect)
262
+ for event in events:
263
+ self.compactors[event] = compactor
264
+
265
+ return sync(register)
266
+
267
+ def register_remote(self, remote: EventLogRemoteService) -> Effect[None, Never, Scope]:
268
+ """Run the log's remote handler on ``remote`` until the scope
269
+ closes."""
270
+
271
+ def acquire() -> Effect[None]:
272
+ self._remotes[remote.id] = remote
273
+ return self._remote_fibers.run(remote.id, self._remote_handler(remote)).as_void()
274
+
275
+ def release(_: object, __: object) -> Effect[None]:
276
+ self._remotes.pop(remote.id, None)
277
+ return self._remote_fibers.remove(remote.id)
278
+
279
+ return acquire_release(suspend(acquire), release)
280
+
281
+ @property
282
+ def remotes(self) -> Sequence[EventLogRemoteService]:
283
+ """The remotes registered now."""
284
+ return tuple(self._remotes.values())
285
+
286
+ def handle_remote(
287
+ self, handler: Callable[[EventLogRemoteService], Effect[None]]
288
+ ) -> Effect[None]:
289
+ """Run ``handler`` on each remote, registered now or later."""
290
+ from pyfect._concurrency import for_each
291
+
292
+ self._remote_handler = handler
293
+ return for_each(
294
+ list(self._remotes.items()),
295
+ lambda item: self._remote_fibers.run(item[0], handler(item[1])),
296
+ ).as_void()
297
+
298
+ def register_reactivity(self, keys: Mapping[str, Sequence[str]]) -> Effect[None, Never, Scope]:
299
+ return sync(lambda: self.reactivity_keys.update(keys))
300
+
301
+
302
+ class Registry(Tag[RegistryService], key="effect/eventlog/EventLog/Registry"):
303
+ """The registry of the event log."""
304
+
305
+
306
+ def _make_registry():
307
+ fibers = yield from FiberMap[RemoteId, Any, Any].make()
308
+ return RegistryService(fibers)
309
+
310
+
311
+ layer_registry: Layer[Registry] = layer_effect(Registry, gen(_make_registry))
312
+ """A fresh ``Registry``."""
313
+
314
+
315
+ class CurrentStoreId(Reference[StoreId], key="effect/eventlog/EventLog/CurrentStoreId"):
316
+ """The store the event log writes to (``"default"``)."""
317
+
318
+ @classmethod
319
+ def default(cls) -> StoreId:
320
+ return StoreId("default")
321
+
322
+
323
+ class Transaction(Protocol):
324
+ """Wraps an effect, keeping its types (a database transaction, say)."""
325
+
326
+ def __call__[A, E, R](self, effect: Effect[A, E, R], /) -> Effect[A, E, R]: ...
327
+
328
+
329
+ def _no_transaction[A, E, R](effect: Effect[A, E, R], /) -> Effect[A, E, R]:
330
+ return effect
331
+
332
+
333
+ class HandlerTransaction(Reference[Transaction], key="effect/eventlog/EventLog/HandlerTransaction"):
334
+ """Wraps the handlers of each write and each remote batch (a database
335
+ transaction, say); by default runs them as they are."""
336
+
337
+ @classmethod
338
+ def default(cls) -> Transaction:
339
+ return _no_transaction
340
+
341
+
342
+ # --- identities ----------------------------------------------------------------------
343
+
344
+
345
+ def encode_identity_string(identity: IdentityService) -> str:
346
+ """The identity as base64url JSON text (its private key as base64)."""
347
+ text = _json_text.stringify(
348
+ {
349
+ "publicKey": identity.public_key,
350
+ "privateKey": base64_encode(reveal(identity.private_key)),
351
+ }
352
+ )
353
+ return base64_url_encode(text)
354
+
355
+
356
+ def decode_identity_string(value: str) -> IdentityService:
357
+ """The identity of ``encode_identity_string``'s text; ``ValueError``
358
+ when it is not one."""
359
+ text = base64_url_decode(value)
360
+ try:
361
+ decoded: Any = _json_text.parse(b"" if text is None else text)
362
+ public_key = decoded["publicKey"]
363
+ private_key = base64_decode(decoded["privateKey"])
364
+ except (ValueError, KeyError, TypeError, AttributeError) as cause:
365
+ raise ValueError("Invalid identity string") from cause
366
+ if text is None or not isinstance(public_key, str) or private_key is None:
367
+ raise ValueError("Invalid identity string")
368
+ return IdentityService(public_key, redacted(private_key))
369
+
370
+
371
+ make_identity: Effect[IdentityService, Never, EventLogEncryption] = EventLogEncryption().flat_map(
372
+ lambda encryption: encryption.generate_identity
373
+ )
374
+ """A new identity from the ``EventLogEncryption``."""
375
+
376
+
377
+ # --- schemas and groups --------------------------------------------------------------
378
+
379
+
380
+ @dataclass(frozen=True, slots=True)
381
+ class EventLogSchema[G]:
382
+ """The groups of an event log."""
383
+
384
+ groups: tuple[G, ...]
385
+
386
+
387
+ def schema[G: EventGroup[AnyEvent]](*groups: G) -> EventLogSchema[G]:
388
+ """The schema of an event log of ``groups``."""
389
+ return EventLogSchema(groups)
390
+
391
+
392
+ def _under[A, E](services: Context[Never], effect: Effect[A, E, object]) -> Effect[A, E]:
393
+ # ``services`` beneath the caller's context: the caller's win. They are
394
+ # the services of the layer that registered the handler, which needs no
395
+ # more (``group`` puts what it needs in the layer's requirements).
396
+ provided = context().flat_map(
397
+ lambda current: effect.pipe(provide_context(services.merge(current)))
398
+ )
399
+ return cast("Effect[A, E]", provided)
400
+
401
+
402
+ def group[Ev: AnyEvent, RR = Never, EX = Never](
403
+ group: EventGroup[Ev],
404
+ build: Callable[[Handlers[Never]], Handlers[RR] | Effect[Handlers[RR], EX, RR]],
405
+ ) -> Layer[Never, EX, RR | Registry]:
406
+ """Register the handlers ``build`` gives (directly or from an effect)
407
+ for every event of ``group``; a missing handler is a ``ValueError``.
408
+ Each handler runs with the services of the layer's context."""
409
+
410
+ def register():
411
+ registry = yield from Registry()
412
+ services = yield from context()
413
+ services = Context({t: s for t, s in services.map_unsafe.items() if t is not Scope})
414
+ built = build(Handlers(group, {}, services))
415
+ handlers: Handlers[RR] = (yield from built) if isinstance(built, Effect) else built
416
+ missing = [tag for tag in group.events if tag not in handlers.by_tag]
417
+ if missing:
418
+ raise ValueError(f"Event not handled: {', '.join(missing)}")
419
+ for tag, item in handlers.by_tag.items():
420
+ registry.register_handler_unsafe(tag, item)
421
+
422
+ return layer_effect_discard(gen(register))
423
+
424
+
425
+ @dataclass(frozen=True, slots=True)
426
+ class TaggedPayload:
427
+ """A decoded event: its tag and payload (Effect's ``TaggedPayload``)."""
428
+
429
+ tag: str
430
+ payload: object
431
+
432
+
433
+ @dataclass(frozen=True, slots=True)
434
+ class CompactionItem:
435
+ """An entry given to a batch compactor, with its decoded event
436
+ (``None`` when its payload does not decode)."""
437
+
438
+ entry: Entry
439
+ event: TaggedPayload | None
440
+
441
+
442
+ class WriteEvent(Protocol):
443
+ """Writes a replacement event: its payload checked against the event,
444
+ or any payload for a tag."""
445
+
446
+ @overload
447
+ def __call__[P, A, E](self, event: Event[P, A, E], payload: P, /) -> Effect[None]: ...
448
+ @overload
449
+ def __call__(self, event: str, payload: object, /) -> Effect[None]: ...
450
+
451
+
452
+ @dataclass(frozen=True, slots=True)
453
+ class BatchCompaction:
454
+ """What a batch compactor gets: the group's entries in order, ``write``
455
+ for a replacement event and ``forward`` to keep an entry unchanged."""
456
+
457
+ entries: tuple[CompactionItem, ...]
458
+ write: WriteEvent
459
+ forward: Callable[[Entry], Effect[None]]
460
+
461
+
462
+ @dataclass(frozen=True, slots=True)
463
+ class Compaction:
464
+ """What a compactor gets for one primary key: its decodable entries,
465
+ their events, ``write`` and ``forward``."""
466
+
467
+ primary_key: str
468
+ entries: tuple[Entry, ...]
469
+ events: tuple[TaggedPayload, ...]
470
+ write: WriteEvent
471
+ forward: Callable[[Entry], Effect[None]]
472
+
473
+
474
+ type _WriteFrom = Callable[[Entry, AnyEvent | str, Any], Effect[None]]
475
+
476
+
477
+ def _register_batch_compaction[R](
478
+ group: EventGroup[Any],
479
+ effect: Callable[
480
+ [tuple[CompactionItem, ...], _WriteFrom, Callable[[Entry], Effect[None]]],
481
+ Effect[None, Never, R],
482
+ ],
483
+ ) -> Layer[Never, Never, R | Registry]:
484
+ def register():
485
+ registry = yield from Registry()
486
+ services = yield from context()
487
+
488
+ def compact(entries: Sequence[Entry], write: CompactWrite) -> Effect[None]:
489
+ def write_from(source: Entry, event: AnyEvent | str, payload: Any) -> Effect[None]:
490
+ found = group.events[event if isinstance(event, str) else event.tag]
491
+
492
+ def body():
493
+ encoded = yield from encode_effect(found.payload_codec)(payload).or_die()
494
+ entry = Entry(
495
+ id=make_entry_id_unsafe(msecs=source.created_at_millis),
496
+ event=found.tag,
497
+ primary_key=found.primary_key(payload),
498
+ payload=encoded,
499
+ )
500
+ yield from write(entry, source)
501
+
502
+ return _under(services, gen(body))
503
+
504
+ def body():
505
+ batch: list[CompactionItem] = []
506
+ for entry in entries:
507
+ found = group.events.get(entry.event)
508
+ if found is None:
509
+ continue
510
+ decoded = yield from _under(
511
+ services, decode_effect(found.payload_codec)(entry.payload)
512
+ ).result()
513
+ batch.append(
514
+ CompactionItem(
515
+ entry,
516
+ TaggedPayload(entry.event, decoded.value)
517
+ if isinstance(decoded, Ok)
518
+ else None,
519
+ )
520
+ )
521
+ # The layer's services provide R.
522
+ compaction = effect(tuple(batch), write_from, lambda entry: write(entry, None))
523
+ yield from _under(services, cast("Effect[None]", compaction))
524
+
525
+ return gen(body)
526
+
527
+ yield from registry.register_compaction(list(group.events), compact)
528
+
529
+ return cast("Layer[Never, Never, R | Registry]", layer_effect_discard(gen(register)))
530
+
531
+
532
+ def group_batch_compaction[R = Never](
533
+ group: EventGroup[AnyEvent], effect: Callable[[BatchCompaction], Effect[None, Never, R]]
534
+ ) -> Layer[Never, Never, R | Registry]:
535
+ """Compact the group's entries a remote sends, all in one call.
536
+ Replacements written with ``write`` take the first entry's place."""
537
+
538
+ def run(
539
+ entries: tuple[CompactionItem, ...],
540
+ write_from: _WriteFrom,
541
+ forward: Callable[[Entry], Effect[None]],
542
+ ) -> Effect[None, Never, R]:
543
+ def write(event: AnyEvent | str, payload: object) -> Effect[None]:
544
+ return write_from(entries[0].entry, event, payload)
545
+
546
+ return effect(BatchCompaction(entries, write, forward))
547
+
548
+ return _register_batch_compaction(group, run)
549
+
550
+
551
+ def group_compaction[R = Never](
552
+ group: EventGroup[AnyEvent], effect: Callable[[Compaction], Effect[None, Never, R]]
553
+ ) -> Layer[Never, Never, R | Registry]:
554
+ """Compact the group's entries a remote sends, one call per primary
555
+ key with the decodable entries; undecodable ones are forwarded
556
+ unchanged. Replacements take the key's first entry's place."""
557
+
558
+ def run(
559
+ entries: tuple[CompactionItem, ...],
560
+ write_from: _WriteFrom,
561
+ forward: Callable[[Entry], Effect[None]],
562
+ ) -> Effect[None, Never, R]:
563
+ def body():
564
+ by_key: dict[str, tuple[list[Entry], list[TaggedPayload]]] = {}
565
+ for item in entries:
566
+ if item.event is None:
567
+ yield from forward(item.entry)
568
+ continue
569
+ keyed = by_key.setdefault(item.entry.primary_key, ([], []))
570
+ keyed[0].append(item.entry)
571
+ keyed[1].append(item.event)
572
+ for primary_key, (keyed_entries, events) in by_key.items():
573
+
574
+ def write(
575
+ event: AnyEvent | str, payload: object, first: Entry = keyed_entries[0]
576
+ ) -> Effect[None]:
577
+ return write_from(first, event, payload)
578
+
579
+ yield from effect(
580
+ Compaction(primary_key, tuple(keyed_entries), tuple(events), write, forward)
581
+ )
582
+
583
+ return gen(body)
584
+
585
+ return _register_batch_compaction(group, run)
586
+
587
+
588
+ def group_reactivity(
589
+ group: EventGroup[AnyEvent], keys: Mapping[str, Sequence[str]] | Sequence[str]
590
+ ) -> Layer[Never, Never, Registry]:
591
+ """Invalidate the reactivity ``keys`` (per event tag, or for every
592
+ event of the group) with each entry's primary key when it is handled."""
593
+
594
+ def register():
595
+ registry = yield from Registry()
596
+ if isinstance(keys, Mapping):
597
+ yield from registry.register_reactivity(keys)
598
+ else:
599
+ yield from registry.register_reactivity({tag: keys for tag in group.events})
600
+
601
+ return layer_effect_discard(gen(register))
602
+
603
+
604
+ # --- replay --------------------------------------------------------------------------
605
+
606
+
607
+ def _invalidate_entry(
608
+ reactivity: ReactivityService, keys: Mapping[str, Sequence[str]], entry: Entry
609
+ ) -> Effect[None]:
610
+ found = keys.get(entry.event)
611
+ if not found:
612
+ return succeed(None)
613
+
614
+ def body():
615
+ for key in found:
616
+ yield from reactivity.invalidate({key: [entry.primary_key]})
617
+
618
+ return gen(body)
619
+
620
+
621
+ @dataclass(slots=True)
622
+ class _ReplayBatch:
623
+ context: Context[Any]
624
+ handler_contexts: dict[int, Context[Any]]
625
+ decoded_conflicts: dict[int, Conflict[Any]]
626
+
627
+
628
+ def _with_entry_annotations(services: Context[Any], entry_context: Context[Any]) -> Context[Any]:
629
+ # An entry's context is the batch context plus its log annotations, so
630
+ # only the annotations need copying into the merged handler context.
631
+ return services.add(CurrentLogAnnotations, entry_context.get(CurrentLogAnnotations))
632
+
633
+
634
+ def _make_replay_entry(
635
+ handlers: Mapping[str, HandlerItem],
636
+ *,
637
+ store_id: StoreId,
638
+ identity: IdentityService,
639
+ reactivity: ReactivityService,
640
+ reactivity_keys: Mapping[str, Sequence[str]],
641
+ log_annotations: Mapping[str, str],
642
+ ) -> Callable[[EntryWithConflicts, _ReplayBatch], Effect[None, Any]]:
643
+ def context_for(batch: _ReplayBatch, handler: HandlerItem) -> Context[Any]:
644
+ found = batch.handler_contexts.get(id(handler))
645
+ if found is None:
646
+ found = batch.handler_contexts[id(handler)] = handler.context.merge(batch.context)
647
+ return found
648
+
649
+ def replay(item: EntryWithConflicts, batch: _ReplayBatch) -> Effect[None, Any]:
650
+ entry = item.entry
651
+
652
+ def body():
653
+ handler = handlers.get(entry.event)
654
+ if handler is None:
655
+ yield from log_debug(f'Event handler not found for: "{entry.event}"')
656
+ return
657
+ decode = decode_effect(handler.event.payload_codec)
658
+ services = context_for(batch, handler)
659
+ entry_context = yield from context()
660
+ with_annotations = _with_entry_annotations(services, entry_context)
661
+ conflicts: list[Conflict[Any]] = []
662
+ for conflict in item.conflicts:
663
+ decoded = batch.decoded_conflicts.get(id(conflict))
664
+ if decoded is None:
665
+ payload = yield from decode(conflict.payload).pipe(
666
+ provide_context(with_annotations)
667
+ )
668
+ decoded = batch.decoded_conflicts[id(conflict)] = Conflict(conflict, payload)
669
+ conflicts.append(decoded)
670
+ # Conflicts decode with the caller's Identity; the payload and
671
+ # the handler use the log's.
672
+ with_identity = with_annotations.add(Identity, identity)
673
+ payload = yield from decode(entry.payload).pipe(provide_context(with_identity))
674
+ yield from handler.handler(
675
+ HandlerInput(store_id, payload, entry, tuple(conflicts))
676
+ ).pipe(provide_context(with_identity))
677
+ yield from _invalidate_entry(reactivity, reactivity_keys, entry)
678
+
679
+ def log_failure(cause: Cause[Any]) -> Effect[None]:
680
+ return log_error(cause)
681
+
682
+ return (
683
+ gen(body)
684
+ .tap_cause_if(lambda cause: not cause.has_interrupts_only, log_failure)
685
+ .annotate_logs({**log_annotations, "entryId": entry.id_string})
686
+ )
687
+
688
+ return replay
689
+
690
+
691
+ def make_replay_from_remote(
692
+ *,
693
+ handlers: Mapping[str, HandlerItem],
694
+ store_id: StoreId,
695
+ identity: IdentityService,
696
+ reactivity: ReactivityService,
697
+ reactivity_keys: Mapping[str, Sequence[str]],
698
+ log_annotations: Mapping[str, str],
699
+ ) -> Callable[[Sequence[EntryWithConflicts]], Effect[None, object]]:
700
+ """Replay a batch of remote entries with their handlers: payloads and
701
+ conflicts decoded (a conflict once per batch), each handler run with
702
+ its layer's services under the batch's, and the log's ``Identity``."""
703
+ replay = _make_replay_entry(
704
+ handlers,
705
+ store_id=store_id,
706
+ identity=identity,
707
+ reactivity=reactivity,
708
+ reactivity_keys=reactivity_keys,
709
+ log_annotations=log_annotations,
710
+ )
711
+
712
+ def replay_batch(batch: Sequence[EntryWithConflicts]) -> Effect[None, object]:
713
+ def body():
714
+ services = yield from context()
715
+ state = _ReplayBatch(services, {}, {})
716
+ for item in batch:
717
+ yield from replay(item, state)
718
+
719
+ return gen(body)
720
+
721
+ return replay_batch
722
+
723
+
724
+ _REMOTE_RETRY = schedule_min(exponential(0.2, 1.5), spaced(10))
725
+ _SYNCED_POLL = 0.01
726
+
727
+
728
+ # --- the log -------------------------------------------------------------------------
729
+
730
+
731
+ class EventLogService:
732
+ """What an event log does (Effect's ``EventLog`` service)."""
733
+
734
+ def __init__(
735
+ self,
736
+ write_events: Callable[[Sequence[tuple[str, object]]], Effect[list[object], object]],
737
+ entries: Effect[list[Entry], EventJournalError],
738
+ destroy: Effect[None, EventJournalError],
739
+ synced: Effect[None, EventJournalError | EventLogRemoteError],
740
+ ) -> None:
741
+ self._write_events = write_events
742
+ self.entries = entries
743
+ self.destroy = destroy
744
+ self.synced = synced
745
+ """Succeeds once every registered remote has acknowledged the
746
+ entries written so far and the log has applied the remote's
747
+ changes up to the latest it stored when asked (a pyfect addition).
748
+ A remote that cannot tell its latest sequence is only uploaded to."""
749
+
750
+ @overload
751
+ def write[P, A, E](
752
+ self, event: Event[P, A, E], payload: P, /
753
+ ) -> Effect[A, E | EventJournalError]: ...
754
+ @overload
755
+ def write(self, event: str, payload: object, /) -> Effect[object, object]: ...
756
+ def write(self, event: AnyEvent | str, payload: object, /) -> Effect[object, object]:
757
+ """Write ``event`` with ``payload`` and run its handler, succeeding
758
+ with its result."""
759
+ tag = event if isinstance(event, str) else event.tag
760
+ return self._write_events([(tag, payload)]).map(lambda results: results[0])
761
+
762
+ def write_many[A, E](
763
+ self, writes: Sequence[AnyWrite[A, E]], /
764
+ ) -> Effect[list[A], E | EventJournalError]:
765
+ """Write the (non-empty) ``writes`` under one lock and handler
766
+ transaction, succeeding with their results in order."""
767
+ # Each Write ties its payload to its event; the handlers give A or E.
768
+ written = self._write_events([(w.event.tag, w.payload) for w in writes])
769
+ return cast("Effect[list[A], E | EventJournalError]", written)
770
+
771
+
772
+ class EventLog(Tag[EventLogService], key="effect/eventlog/EventLog"):
773
+ """The event log."""
774
+
775
+
776
+ def _compact_remote(
777
+ compactors: Mapping[str, RegisteredCompactor],
778
+ ) -> Callable[[Sequence[RemoteEntry]], Effect[list[Entry], Any]]:
779
+ """Run the compactors over a remote batch, anchoring each output to its
780
+ source entry."""
781
+
782
+ def compact_remote(remote_entries: Sequence[RemoteEntry]) -> Effect[list[Entry], Any]:
783
+ # The journal sorts the batch by anchor, so output order is irrelevant.
784
+ def body():
785
+ output: list[Entry] = []
786
+ inputs: dict[bytes, Entry] = {}
787
+ output_counts: dict[int, int] = {}
788
+ compactable: dict[int, tuple[CompactFn, list[Entry]]] = {}
789
+ for remote_entry in remote_entries:
790
+ entry = remote_entry.entry
791
+ inputs[entry.id] = entry
792
+ compactor = compactors.get(entry.event)
793
+ if compactor is None:
794
+ output.append(entry)
795
+ continue
796
+ compactable.setdefault(id(compactor), (compactor.effect, []))[1].append(entry)
797
+ for compact, entries in compactable.values():
798
+
799
+ def write(
800
+ entry: Entry, source: Entry | None, entries: list[Entry] = entries
801
+ ) -> Effect[None]:
802
+ def record() -> None:
803
+ # Each output is ordered and conflict-checked by its
804
+ # source, then by write order, not by its own fresh
805
+ # id. An output without a known source stands for
806
+ # the group's first entry.
807
+ anchor = inputs.get((source or entry).id, entries[0])
808
+ index = output_counts.get(id(anchor), 0)
809
+ output_counts[id(anchor)] = index + 1
810
+ set_anchor(entry, anchor, index)
811
+ output.append(entry)
812
+
813
+ return sync(record)
814
+
815
+ yield from compact(entries, write)
816
+ return output
817
+
818
+ return gen(body)
819
+
820
+ return compact_remote
821
+
822
+
823
+ type _Upload = Callable[
824
+ [EventLogRemoteService], Effect[object, EventJournalError | EventLogRemoteError]
825
+ ]
826
+
827
+
828
+ def _uploader(
829
+ journal: EventJournalService, identity: IdentityService, store_id: StoreId, with_lock: WithLock
830
+ ) -> _Upload:
831
+ """Sends the entries a remote has not seen and records its acks."""
832
+
833
+ def upload_to(
834
+ remote: EventLogRemoteService,
835
+ ) -> Effect[object, EventJournalError | EventLogRemoteError]:
836
+ def acknowledge(acks: Sequence[WriteAck] | None) -> Effect[None, EventJournalError]:
837
+ if not acks:
838
+ return succeed(None)
839
+ return with_lock(
840
+ journal.write_remote_acks(
841
+ remote_id=remote.id,
842
+ acks=[RemoteAck(ack.entry_id, ack.sequence) for ack in acks],
843
+ first_sequence=remote.first_sequence,
844
+ )
845
+ )
846
+
847
+ return journal.with_remote_uncommitted(
848
+ remote.id,
849
+ lambda entries: remote.write(
850
+ identity=identity, store_id=store_id, entries=entries
851
+ ).flat_map(acknowledge),
852
+ )
853
+
854
+ return upload_to
855
+
856
+
857
+ def _synced(
858
+ registry: RegistryService,
859
+ journal: EventJournalService,
860
+ identity: IdentityService,
861
+ store_id: StoreId,
862
+ upload_to: _Upload,
863
+ ) -> Effect[None, EventJournalError | EventLogRemoteError]:
864
+ def sync_remote(
865
+ remote: EventLogRemoteService,
866
+ ) -> Effect[None, EventJournalError | EventLogRemoteError]:
867
+ latest_sequence = remote.latest_sequence
868
+
869
+ def body():
870
+ # Uploaded first, so the latest sequence covers this log's entries.
871
+ yield from upload_to(remote)
872
+ if latest_sequence is None:
873
+ return
874
+ latest = yield from latest_sequence(identity=identity, store_id=store_id)
875
+ if latest is None:
876
+ return
877
+ while (yield from journal.next_remote_sequence(remote.id)) <= latest:
878
+ yield from sleep(_SYNCED_POLL)
879
+
880
+ return gen(body)
881
+
882
+ return suspend(lambda: for_each(registry.remotes, sync_remote).as_void())
883
+
884
+
885
+ def _make():
886
+ store_id = yield from CurrentStoreId()
887
+ identity = yield from Identity()
888
+ journal = yield from EventJournal()
889
+ registry = yield from Registry()
890
+ reactivity = yield from Reactivity()
891
+ transaction = yield from HandlerTransaction()
892
+ replay_from_remote = make_replay_from_remote(
893
+ handlers=registry.handlers,
894
+ store_id=store_id,
895
+ identity=identity,
896
+ reactivity=reactivity,
897
+ reactivity_keys=registry.reactivity_keys,
898
+ log_annotations={"service": "EventLog", "effect": "writeFromRemote"},
899
+ )
900
+ with_lock = journal.with_lock(store_id)
901
+
902
+ def invalidate_all(entries: Sequence[Entry]) -> Effect[None]:
903
+ def body():
904
+ for entry in entries:
905
+ yield from _invalidate_entry(reactivity, registry.reactivity_keys, entry)
906
+
907
+ return gen(body)
908
+
909
+ compact_remote = _compact_remote(registry.compactors)
910
+ upload_to = _uploader(journal, identity, store_id, with_lock)
911
+
912
+ def run_remote(remote: EventLogRemoteService) -> Effect[None]:
913
+ def consume():
914
+ start_sequence = yield from journal.next_remote_sequence(remote.id)
915
+ changes = yield from remote.changes(
916
+ identity=identity,
917
+ store_id=store_id,
918
+ start_sequence=start_sequence,
919
+ known_entries=journal.entries_by_id,
920
+ )
921
+ while True:
922
+ entries = yield from changes.take_all()
923
+ written = journal.write_from_remote(
924
+ remote_id=remote.id,
925
+ entries=entries,
926
+ compact=compact_remote if registry.compactors else None,
927
+ # A failed batch is not committed, so the remote
928
+ # redelivers it on retry.
929
+ effect=lambda batch: transaction(replay_from_remote(batch)).or_die(),
930
+ ).flat_map(invalidate_all)
931
+ # Outside the lock, so queries re-run after the journal
932
+ # transaction commits.
933
+ yield from reactivity.with_batch(with_lock(written))
934
+
935
+ consumer = (
936
+ scoped(gen(consume))
937
+ .catch_cause(log_error)
938
+ .repeat(_REMOTE_RETRY)
939
+ .annotate_logs({"service": "EventLog", "effect": "runRemote consume"})
940
+ )
941
+
942
+ write = upload_to(remote)
943
+ write_until_success = write.tap_cause(log_debug).retry(_REMOTE_RETRY)
944
+
945
+ def body():
946
+ yield from consumer.fork_scoped()
947
+ yield from add_finalizer(lambda _: write.ignore())
948
+ subscription = yield from journal.changes
949
+ signal = yield from Queue[None, Never].dropping(1)
950
+ yield from subscription.take_all().and_then(signal.offer(None)).forever().fork_scoped()
951
+ yield from write_until_success
952
+ yield from signal.take().and_then(write_until_success).catch_cause(log_error).forever()
953
+
954
+ return scoped(gen(body)).pipe(provide_service(Identity, identity)).or_die()
955
+
956
+ def write_events(events: Sequence[tuple[str, Any]]) -> Effect[list[Any], Any]:
957
+ def body():
958
+ prepared: list[tuple[HandlerItem, Any, EntryInput]] = []
959
+ for tag, payload in events:
960
+ handler = registry.handlers.get(tag)
961
+ if handler is None:
962
+ return (yield from die(LookupError(f'Event handler not found for: "{tag}"')))
963
+ encoded = yield from encode_effect(handler.event.payload_codec)(payload).or_die()
964
+ prepared.append(
965
+ (handler, payload, EntryInput(tag, handler.event.primary_key(payload), encoded))
966
+ )
967
+
968
+ def run_handlers(written: list[Entry]) -> Effect[list[Any], Any]:
969
+ def run(index: int) -> Effect[Any, Any]:
970
+ handler, payload, _ = prepared[index]
971
+ entry = written[index]
972
+ return _under(
973
+ handler.context,
974
+ handler.handler(HandlerInput(store_id, payload, entry)).pipe(
975
+ provide_service(Identity, identity)
976
+ ),
977
+ ).tap(lambda _: _invalidate_entry(reactivity, registry.reactivity_keys, entry))
978
+
979
+ return transaction(for_each(range(len(written)), run))
980
+
981
+ written = journal.write_many([item[2] for item in prepared], run_handlers)
982
+ # Outside the lock, so queries re-run after the handler
983
+ # transaction and the journal commit.
984
+ return (yield from reactivity.with_batch(with_lock(written)))
985
+
986
+ return gen(body)
987
+
988
+ yield from registry.handle_remote(run_remote)
989
+ synced = _synced(registry, journal, identity, store_id, upload_to)
990
+ return EventLogService(write_events, journal.entries, journal.destroy, synced)
991
+
992
+
993
+ layer_event_log: Layer[EventLog | Registry, Never, EventJournal | Identity] = (
994
+ layer_effect(EventLog, gen(_make))
995
+ .pipe(layer_provide(reactivity_layer))
996
+ .pipe(provide_merge(layer_registry))
997
+ )
998
+ """The event log over the ``EventJournal``, writing as the ``Identity``."""
999
+
1000
+
1001
+ @overload
1002
+ def layer[E = Never](
1003
+ schema: EventLogSchema[EventGroup[AnyEvent]], handlers: Layer[Never, E, Registry | EventLog]
1004
+ ) -> Layer[EventLog | Registry, E, EventJournal | Identity]: ...
1005
+ @overload
1006
+ def layer[E = Never, R = Never](
1007
+ schema: EventLogSchema[EventGroup[AnyEvent]], handlers: Layer[Never, E, R | Registry | EventLog]
1008
+ ) -> Layer[EventLog | Registry, E, R | EventJournal | Identity]: ...
1009
+ def layer[E = Never, R = Never](
1010
+ schema: EventLogSchema[EventGroup[AnyEvent]], handlers: Layer[Never, E, R | Registry | EventLog]
1011
+ ) -> Layer[EventLog | Registry, E, R | EventJournal | Identity]:
1012
+ """The event log of ``schema`` with the group ``handlers`` (layers of
1013
+ ``group``), which get the log's ``Registry`` (and ``EventLog``): the
1014
+ result needs what else they need (Effect's ``Exclude<R, EventLog |
1015
+ Registry>``)."""
1016
+ require_layer(handlers, "handlers")
1017
+ del schema
1018
+ return handlers.pipe(provide_merge(layer_event_log))
1019
+
1020
+
1021
+ class WriteClient(Protocol):
1022
+ """Writes one event, keeping its success and error types."""
1023
+
1024
+ def __call__[P, A, E](self, write: Write[P, A, E], /) -> Effect[A, E | EventJournalError]: ...
1025
+
1026
+
1027
+ def make_client(
1028
+ schema: EventLogSchema[EventGroup[AnyEvent]],
1029
+ ) -> Effect[WriteClient, Never, EventLog]:
1030
+ """A function writing one event to the ``EventLog``."""
1031
+ del schema
1032
+
1033
+ def client(log: EventLogService) -> WriteClient:
1034
+ def write[P, A, E](item: Write[P, A, E], /) -> Effect[A, E | EventJournalError]:
1035
+ return log.write(item.event, item.payload)
1036
+
1037
+ return write
1038
+
1039
+ return EventLog().map(client)