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.
- pyfect/__init__.py +729 -0
- pyfect/_all.py +242 -0
- pyfect/_background.py +28 -0
- pyfect/_binary_codecs.py +124 -0
- pyfect/_cached.py +165 -0
- pyfect/_catch.py +128 -0
- pyfect/_catch_reason.py +574 -0
- pyfect/_concurrency.py +291 -0
- pyfect/_context_effects.py +163 -0
- pyfect/_context_managers.py +76 -0
- pyfect/_core.py +368 -0
- pyfect/_digits.py +71 -0
- pyfect/_effect_args.py +46 -0
- pyfect/_effect_base.py +71 -0
- pyfect/_effect_concurrency.py +133 -0
- pyfect/_effect_eager.py +103 -0
- pyfect/_effect_errors.py +344 -0
- pyfect/_effect_folding.py +110 -0
- pyfect/_effect_hash.py +140 -0
- pyfect/_effect_logging.py +57 -0
- pyfect/_effect_metrics.py +102 -0
- pyfect/_effect_resources.py +179 -0
- pyfect/_effect_services.py +25 -0
- pyfect/_effect_timing.py +199 -0
- pyfect/_effect_tracing.py +99 -0
- pyfect/_equal.py +195 -0
- pyfect/_extras.py +43 -0
- pyfect/_fiber.py +969 -0
- pyfect/_fiber_all.py +134 -0
- pyfect/_fiber_collections.py +106 -0
- pyfect/_fn.py +706 -0
- pyfect/_hamt.py +174 -0
- pyfect/_interrupt_reason.py +33 -0
- pyfect/_isaac.py +149 -0
- pyfect/_iterables.py +231 -0
- pyfect/_js.py +263 -0
- pyfect/_js_date.py +87 -0
- pyfect/_json_text.py +286 -0
- pyfect/_json_value.py +9 -0
- pyfect/_layer_core.py +403 -0
- pyfect/_layer_for_life.py +33 -0
- pyfect/_layer_tracing.py +70 -0
- pyfect/_locked_ref.py +147 -0
- pyfect/_loop_thread.py +152 -0
- pyfect/_metric_ref.py +29 -0
- pyfect/_one_or_many.py +14 -0
- pyfect/_os_wait.py +118 -0
- pyfect/_path_posix.py +129 -0
- pyfect/_primitives.py +434 -0
- pyfect/_public.py +36 -0
- pyfect/_reasons.py +64 -0
- pyfect/_released.py +67 -0
- pyfect/_root.py +87 -0
- pyfect/_round_robin.py +73 -0
- pyfect/_some.py +17 -0
- pyfect/_stack.py +52 -0
- pyfect/_stack_frame.py +114 -0
- pyfect/_string_hash.py +35 -0
- pyfect/_subscriber_queue.py +47 -0
- pyfect/_tags.py +14 -0
- pyfect/_tracer_ref.py +21 -0
- pyfect/_tx_ops.py +77 -0
- pyfect/_unsubscripted.py +23 -0
- pyfect/_url.py +54 -0
- pyfect/_waiters.py +127 -0
- pyfect/_wake_tracking.py +98 -0
- pyfect/_wire_codec.py +123 -0
- pyfect/ai/__init__.py +73 -0
- pyfect/ai/_approvals.py +249 -0
- pyfect/ai/_decision_answers.py +185 -0
- pyfect/ai/_generated_client.py +298 -0
- pyfect/ai/_generated_support.py +84 -0
- pyfect/ai/_mcp/__init__.py +1 -0
- pyfect/ai/_mcp/batch.py +68 -0
- pyfect/ai/_mcp/client_transport.py +412 -0
- pyfect/ai/_mcp/client_wire.py +284 -0
- pyfect/ai/_mcp/core.py +490 -0
- pyfect/ai/_mcp/dispatch.py +1048 -0
- pyfect/ai/_mcp/http.py +462 -0
- pyfect/ai/_mcp/http_admission.py +269 -0
- pyfect/ai/_mcp/http_status.py +27 -0
- pyfect/ai/_mcp/input_wire.py +226 -0
- pyfect/ai/_mcp/log_levels.py +55 -0
- pyfect/ai/_mcp/param_headers.py +63 -0
- pyfect/ai/_mcp/projection.py +248 -0
- pyfect/ai/_mcp/register.py +683 -0
- pyfect/ai/_mcp/reverse_policy.py +155 -0
- pyfect/ai/_mcp/routing_header.py +24 -0
- pyfect/ai/_mcp/sessions.py +114 -0
- pyfect/ai/_mcp/stdio.py +110 -0
- pyfect/ai/_mcp/subscriptions.py +134 -0
- pyfect/ai/_mcp/tool_schema.py +35 -0
- pyfect/ai/_noul_answers.py +64 -0
- pyfect/ai/_openai_all_of.py +137 -0
- pyfect/ai/_openai_errors.py +233 -0
- pyfect/ai/_provider.py +439 -0
- pyfect/ai/_provider_tools.py +129 -0
- pyfect/ai/_stream_resolution.py +231 -0
- pyfect/ai/_structured_output_checks.py +138 -0
- pyfect/ai/_structured_output_codec.py +229 -0
- pyfect/ai/_structured_output_json.py +109 -0
- pyfect/ai/_tool_call_ids.py +80 -0
- pyfect/ai/ai_error.py +785 -0
- pyfect/ai/anthropic/__init__.py +28 -0
- pyfect/ai/anthropic/_errors.py +164 -0
- pyfect/ai/anthropic/_prompt.py +375 -0
- pyfect/ai/anthropic/_response.py +443 -0
- pyfect/ai/anthropic/_schema.py +206 -0
- pyfect/ai/anthropic/_stream.py +377 -0
- pyfect/ai/anthropic/_tools.py +248 -0
- pyfect/ai/anthropic/client.py +289 -0
- pyfect/ai/anthropic/config.py +32 -0
- pyfect/ai/anthropic/error.py +27 -0
- pyfect/ai/anthropic/language_model.py +366 -0
- pyfect/ai/anthropic/telemetry.py +51 -0
- pyfect/ai/anthropic/tool.py +570 -0
- pyfect/ai/anthropic_structured_output.py +138 -0
- pyfect/ai/chat.py +548 -0
- pyfect/ai/cloudflare/__init__.py +15 -0
- pyfect/ai/cloudflare/_errors.py +108 -0
- pyfect/ai/cloudflare/client.py +174 -0
- pyfect/ai/cloudflare/decision_model.py +117 -0
- pyfect/ai/cloudflare/schema.py +144 -0
- pyfect/ai/decision.py +290 -0
- pyfect/ai/decision_model.py +283 -0
- pyfect/ai/embedding_model.py +177 -0
- pyfect/ai/id_generator.py +79 -0
- pyfect/ai/language_model.py +1077 -0
- pyfect/ai/mcp_client.py +682 -0
- pyfect/ai/mcp_client_error.py +223 -0
- pyfect/ai/mcp_protocol.py +205 -0
- pyfect/ai/mcp_schema.py +1300 -0
- pyfect/ai/mcp_server.py +404 -0
- pyfect/ai/model.py +56 -0
- pyfect/ai/openai/__init__.py +49 -0
- pyfect/ai/openai/_errors.py +89 -0
- pyfect/ai/openai/_prompt.py +527 -0
- pyfect/ai/openai/_requests.py +34 -0
- pyfect/ai/openai/_response.py +569 -0
- pyfect/ai/openai/_schema.py +769 -0
- pyfect/ai/openai/_stream.py +771 -0
- pyfect/ai/openai/_tools.py +128 -0
- pyfect/ai/openai/_web_socket.py +295 -0
- pyfect/ai/openai/client.py +296 -0
- pyfect/ai/openai/client_generated.py +123 -0
- pyfect/ai/openai/config.py +34 -0
- pyfect/ai/openai/decision_model.py +177 -0
- pyfect/ai/openai/embedding_model.py +116 -0
- pyfect/ai/openai/error.py +8 -0
- pyfect/ai/openai/generated/__init__.py +7213 -0
- pyfect/ai/openai/generated/_recursive.py +18 -0
- pyfect/ai/openai/generated/_schemas_0.py +1015 -0
- pyfect/ai/openai/generated/_schemas_1.py +1016 -0
- pyfect/ai/openai/generated/_schemas_2.py +1017 -0
- pyfect/ai/openai/generated/_schemas_3.py +615 -0
- pyfect/ai/openai/generated/client.py +5298 -0
- pyfect/ai/openai/generated/types.py +8123 -0
- pyfect/ai/openai/language_model.py +304 -0
- pyfect/ai/openai/telemetry.py +19 -0
- pyfect/ai/openai/tool.py +391 -0
- pyfect/ai/openai_compat/__init__.py +25 -0
- pyfect/ai/openai_compat/_prompt.py +191 -0
- pyfect/ai/openai_compat/_request.py +153 -0
- pyfect/ai/openai_compat/_response.py +407 -0
- pyfect/ai/openai_compat/_schema.py +97 -0
- pyfect/ai/openai_compat/client.py +234 -0
- pyfect/ai/openai_compat/config.py +32 -0
- pyfect/ai/openai_compat/embedding_model.py +139 -0
- pyfect/ai/openai_compat/error.py +7 -0
- pyfect/ai/openai_compat/language_model.py +245 -0
- pyfect/ai/openai_compat/telemetry.py +51 -0
- pyfect/ai/openai_structured_output.py +118 -0
- pyfect/ai/openrouter/__init__.py +36 -0
- pyfect/ai/openrouter/_errors.py +186 -0
- pyfect/ai/openrouter/_prompt.py +272 -0
- pyfect/ai/openrouter/_response.py +226 -0
- pyfect/ai/openrouter/_stream.py +320 -0
- pyfect/ai/openrouter/client.py +283 -0
- pyfect/ai/openrouter/config.py +36 -0
- pyfect/ai/openrouter/decision_model.py +161 -0
- pyfect/ai/openrouter/error.py +23 -0
- pyfect/ai/openrouter/generated/__init__.py +3029 -0
- pyfect/ai/openrouter/generated/_recursive.py +15 -0
- pyfect/ai/openrouter/generated/_schemas_0.py +1015 -0
- pyfect/ai/openrouter/generated/_schemas_1.py +522 -0
- pyfect/ai/openrouter/generated/client.py +1445 -0
- pyfect/ai/openrouter/generated/types.py +4769 -0
- pyfect/ai/openrouter/language_model.py +345 -0
- pyfect/ai/openrouter/schema.py +165 -0
- pyfect/ai/prompt.py +664 -0
- pyfect/ai/response.py +768 -0
- pyfect/ai/response_id_tracker.py +82 -0
- pyfect/ai/telemetry.py +126 -0
- pyfect/ai/tokenizer.py +61 -0
- pyfect/ai/tool.py +536 -0
- pyfect/ai/toolkit.py +490 -0
- pyfect/ai/typesafe/__init__.py +17 -0
- pyfect/ai/typesafe/_errors.py +120 -0
- pyfect/ai/typesafe/client.py +146 -0
- pyfect/ai/typesafe/config.py +34 -0
- pyfect/ai/typesafe/decision_model.py +90 -0
- pyfect/ai/typesafe/schema.py +140 -0
- pyfect/batching/__init__.py +58 -0
- pyfect/batching/_api.py +71 -0
- pyfect/batching/_engine.py +229 -0
- pyfect/batching/_from_effect.py +76 -0
- pyfect/batching/_persisted.py +98 -0
- pyfect/batching/_request.py +133 -0
- pyfect/batching/_resolver.py +477 -0
- pyfect/batching/_with_cache.py +90 -0
- pyfect/big_decimal.py +500 -0
- pyfect/brand.py +114 -0
- pyfect/byte_size.py +354 -0
- pyfect/cache/__init__.py +29 -0
- pyfect/cache/_cache.py +426 -0
- pyfect/cache/_expiry.py +69 -0
- pyfect/cache/_scoped_cache.py +546 -0
- pyfect/case.py +174 -0
- pyfect/cause.py +462 -0
- pyfect/channel/__init__.py +155 -0
- pyfect/channel/_base.py +92 -0
- pyfect/channel/_catch.py +158 -0
- pyfect/channel/_catch_reason.py +572 -0
- pyfect/channel/_channel.py +158 -0
- pyfect/channel/_combinators.py +220 -0
- pyfect/channel/_concurrency_methods.py +217 -0
- pyfect/channel/_concurrent_map.py +118 -0
- pyfect/channel/_constructors.py +349 -0
- pyfect/channel/_context.py +232 -0
- pyfect/channel/_error_methods.py +336 -0
- pyfect/channel/_errors.py +180 -0
- pyfect/channel/_filters.py +225 -0
- pyfect/channel/_lifecycle.py +71 -0
- pyfect/channel/_lifecycle_methods.py +206 -0
- pyfect/channel/_loop.py +100 -0
- pyfect/channel/_merge.py +246 -0
- pyfect/channel/_repeat.py +154 -0
- pyfect/channel/_run.py +149 -0
- pyfect/channel/_run_methods.py +341 -0
- pyfect/channel/_sinks.py +88 -0
- pyfect/channel/_sources.py +238 -0
- pyfect/channel/_text.py +176 -0
- pyfect/channel/_transform_methods.py +415 -0
- pyfect/channel/_upstream.py +67 -0
- pyfect/channel_schema.py +131 -0
- pyfect/cli/__init__.py +79 -0
- pyfect/cli/_ansi.py +82 -0
- pyfect/cli/_command.py +469 -0
- pyfect/cli/_config.py +164 -0
- pyfect/cli/_environment.py +10 -0
- pyfect/cli/_help.py +195 -0
- pyfect/cli/_lexer.py +81 -0
- pyfect/cli/_parser.py +465 -0
- pyfect/cli/_settings.py +85 -0
- pyfect/cli/_suggest.py +33 -0
- pyfect/cli/_width.py +134 -0
- pyfect/cli/_wizard.py +317 -0
- pyfect/cli/argument.py +212 -0
- pyfect/cli/cli_config.py +40 -0
- pyfect/cli/cli_error.py +242 -0
- pyfect/cli/cli_output.py +305 -0
- pyfect/cli/command.py +440 -0
- pyfect/cli/completions/__init__.py +50 -0
- pyfect/cli/completions/_completer.ps1 +190 -0
- pyfect/cli/completions/_descriptor.py +182 -0
- pyfect/cli/completions/bash.py +300 -0
- pyfect/cli/completions/fish.py +164 -0
- pyfect/cli/completions/powershell.py +156 -0
- pyfect/cli/completions/zsh.py +189 -0
- pyfect/cli/flag.py +246 -0
- pyfect/cli/global_flag.py +99 -0
- pyfect/cli/help_doc.py +63 -0
- pyfect/cli/param.py +789 -0
- pyfect/cli/primitive.py +308 -0
- pyfect/cli/prompt/__init__.py +75 -0
- pyfect/cli/prompt/_auto_complete.py +205 -0
- pyfect/cli/prompt/_choices.py +104 -0
- pyfect/cli/prompt/_confirm.py +195 -0
- pyfect/cli/prompt/_core.py +512 -0
- pyfect/cli/prompt/_date.py +173 -0
- pyfect/cli/prompt/_date_parts.py +387 -0
- pyfect/cli/prompt/_file.py +372 -0
- pyfect/cli/prompt/_multi_select.py +204 -0
- pyfect/cli/prompt/_number.py +257 -0
- pyfect/cli/prompt/_select.py +117 -0
- pyfect/cli/prompt/_text.py +239 -0
- pyfect/cli/terminal_capabilities.py +118 -0
- pyfect/clock.py +150 -0
- pyfect/cluster/__init__.py +155 -0
- pyfect/cluster/_cluster_abandon.py +36 -0
- pyfect/cluster/_cluster_layer.py +122 -0
- pyfect/cluster/_entity_activation.py +16 -0
- pyfect/cluster/_entity_manager/__init__.py +22 -0
- pyfect/cluster/_entity_manager/_activation.py +540 -0
- pyfect/cluster/_entity_manager/_core.py +186 -0
- pyfect/cluster/_entity_manager/_decode.py +60 -0
- pyfect/cluster/_entity_manager/_manager.py +423 -0
- pyfect/cluster/_entity_manager/_state.py +113 -0
- pyfect/cluster/_entity_reaper.py +94 -0
- pyfect/cluster/_hash.py +13 -0
- pyfect/cluster/_interruptors.py +88 -0
- pyfect/cluster/_resource_map.py +179 -0
- pyfect/cluster/_resource_ref.py +266 -0
- pyfect/cluster/_shard_lock.py +14 -0
- pyfect/cluster/cluster_cron.py +230 -0
- pyfect/cluster/cluster_error.py +81 -0
- pyfect/cluster/cluster_http.py +210 -0
- pyfect/cluster/cluster_metrics.py +54 -0
- pyfect/cluster/cluster_schema.py +137 -0
- pyfect/cluster/cluster_socket.py +197 -0
- pyfect/cluster/cluster_workflow_engine/__init__.py +24 -0
- pyfect/cluster/cluster_workflow_engine/_engine.py +1099 -0
- pyfect/cluster/cluster_workflow_engine/_entities.py +298 -0
- pyfect/cluster/deliver_at.py +31 -0
- pyfect/cluster/entity/__init__.py +39 -0
- pyfect/cluster/entity/_entity.py +332 -0
- pyfect/cluster/entity/_handlers.py +168 -0
- pyfect/cluster/entity/_keep_alive.py +74 -0
- pyfect/cluster/entity/_queue.py +103 -0
- pyfect/cluster/entity/_request.py +34 -0
- pyfect/cluster/entity/_services.py +23 -0
- pyfect/cluster/entity/_test_client.py +237 -0
- pyfect/cluster/entity_address.py +25 -0
- pyfect/cluster/entity_id.py +20 -0
- pyfect/cluster/entity_proxy.py +161 -0
- pyfect/cluster/entity_proxy_server.py +103 -0
- pyfect/cluster/entity_resource.py +122 -0
- pyfect/cluster/entity_type.py +20 -0
- pyfect/cluster/envelope.py +307 -0
- pyfect/cluster/http_runner.py +254 -0
- pyfect/cluster/k8s_http_client.py +281 -0
- pyfect/cluster/k8s_types.py +1394 -0
- pyfect/cluster/machine_id.py +21 -0
- pyfect/cluster/message.py +219 -0
- pyfect/cluster/message_storage/__init__.py +67 -0
- pyfect/cluster/message_storage/_encoded.py +393 -0
- pyfect/cluster/message_storage/_memory.py +386 -0
- pyfect/cluster/message_storage/_noop.py +109 -0
- pyfect/cluster/message_storage/_service.py +388 -0
- pyfect/cluster/reply.py +236 -0
- pyfect/cluster/runner.py +32 -0
- pyfect/cluster/runner_address.py +23 -0
- pyfect/cluster/runner_health.py +93 -0
- pyfect/cluster/runner_server.py +286 -0
- pyfect/cluster/runner_storage.py +212 -0
- pyfect/cluster/runners/__init__.py +55 -0
- pyfect/cluster/runners/_local.py +460 -0
- pyfect/cluster/runners/_noop.py +57 -0
- pyfect/cluster/runners/_rpc.py +290 -0
- pyfect/cluster/runners/_service.py +113 -0
- pyfect/cluster/shard_id.py +39 -0
- pyfect/cluster/sharding/__init__.py +12 -0
- pyfect/cluster/sharding/_acquisition.py +490 -0
- pyfect/cluster/sharding/_clients.py +271 -0
- pyfect/cluster/sharding/_make.py +388 -0
- pyfect/cluster/sharding/_routing.py +296 -0
- pyfect/cluster/sharding/_runners_sync.py +198 -0
- pyfect/cluster/sharding/_service.py +91 -0
- pyfect/cluster/sharding/_singletons.py +183 -0
- pyfect/cluster/sharding/_state.py +296 -0
- pyfect/cluster/sharding/_storage_loop.py +421 -0
- pyfect/cluster/sharding_config.py +230 -0
- pyfect/cluster/sharding_registration_event.py +28 -0
- pyfect/cluster/single_runner.py +49 -0
- pyfect/cluster/singleton.py +36 -0
- pyfect/cluster/singleton_address.py +20 -0
- pyfect/cluster/snowflake.py +133 -0
- pyfect/cluster/socket_runner.py +67 -0
- pyfect/cluster/sql_message_storage.py +1001 -0
- pyfect/cluster/sql_runner_storage.py +841 -0
- pyfect/cluster/test_runner.py +23 -0
- pyfect/config/__init__.py +93 -0
- pyfect/config/_all.py +96 -0
- pyfect/config/_collections.py +291 -0
- pyfect/config/_config.py +261 -0
- pyfect/config/_constructors.py +106 -0
- pyfect/config/_error.py +27 -0
- pyfect/config/_leaf.py +92 -0
- pyfect/config/_scalars.py +193 -0
- pyfect/config/_schema.py +340 -0
- pyfect/config_provider/__init__.py +60 -0
- pyfect/config_provider/_dir.py +84 -0
- pyfect/config_provider/_dotenv.py +127 -0
- pyfect/config_provider/_env.py +79 -0
- pyfect/config_provider/_layers.py +80 -0
- pyfect/config_provider/_node.py +90 -0
- pyfect/config_provider/_provider.py +118 -0
- pyfect/config_provider/_unknown.py +62 -0
- pyfect/console/__init__.py +63 -0
- pyfect/console/_effects.py +134 -0
- pyfect/console/_live.py +156 -0
- pyfect/console/_service.py +49 -0
- pyfect/console/_table.py +90 -0
- pyfect/context.py +414 -0
- pyfect/cron/__init__.py +30 -0
- pyfect/cron/_model.py +183 -0
- pyfect/cron/_search.py +268 -0
- pyfect/cron/_text.py +202 -0
- pyfect/cron/_wall.py +42 -0
- pyfect/crypto.py +257 -0
- pyfect/date_time/__init__.py +77 -0
- pyfect/date_time/_calendar.py +209 -0
- pyfect/date_time/_current.py +118 -0
- pyfect/date_time/_epoch.py +22 -0
- pyfect/date_time/_iso.py +80 -0
- pyfect/date_time/_zones.py +135 -0
- pyfect/date_time/intl.py +144 -0
- pyfect/deferred.py +145 -0
- pyfect/devtools/__init__.py +24 -0
- pyfect/devtools/client.py +323 -0
- pyfect/devtools/layers.py +32 -0
- pyfect/devtools/schema.py +301 -0
- pyfect/devtools/server.py +72 -0
- pyfect/duration.py +295 -0
- pyfect/effect.py +565 -0
- pyfect/effectable.py +37 -0
- pyfect/encoding/__init__.py +62 -0
- pyfect/encoding/_archive.py +197 -0
- pyfect/encoding/_json_array_scanner.py +477 -0
- pyfect/encoding/base64.py +23 -0
- pyfect/encoding/base64_url.py +19 -0
- pyfect/encoding/encoding_error.py +17 -0
- pyfect/encoding/hex.py +28 -0
- pyfect/encoding/ini.py +188 -0
- pyfect/encoding/json_array.py +246 -0
- pyfect/encoding/ndjson.py +461 -0
- pyfect/encoding/schema_binary/__init__.py +257 -0
- pyfect/encoding/schema_binary/_channels.py +173 -0
- pyfect/encoding/schema_binary/_compile.py +584 -0
- pyfect/encoding/schema_binary/_decode.py +848 -0
- pyfect/encoding/schema_binary/_dictionary.py +90 -0
- pyfect/encoding/schema_binary/_encode.py +838 -0
- pyfect/encoding/schema_binary/_fingerprint.py +168 -0
- pyfect/encoding/schema_binary/_layout.py +350 -0
- pyfect/encoding/schema_binary/_literals.py +47 -0
- pyfect/encoding/schema_binary/_parser.py +163 -0
- pyfect/encoding/schema_binary/_reader.py +148 -0
- pyfect/encoding/schema_binary/_target.py +310 -0
- pyfect/encoding/schema_binary/_values.py +133 -0
- pyfect/encoding/schema_binary/_wire.py +253 -0
- pyfect/encoding/sse.py +476 -0
- pyfect/encoding/tar/__init__.py +396 -0
- pyfect/encoding/tar/_decoder.py +220 -0
- pyfect/encoding/tar/_encoder.py +83 -0
- pyfect/encoding/tar/_header.py +494 -0
- pyfect/encoding/tar/_model.py +82 -0
- pyfect/encoding/toml.py +375 -0
- pyfect/encoding/xml/__init__.py +222 -0
- pyfect/encoding/xml/_chars.py +119 -0
- pyfect/encoding/xml/_collector.py +106 -0
- pyfect/encoding/xml/_inputs.py +126 -0
- pyfect/encoding/xml/_model.py +114 -0
- pyfect/encoding/xml/_parser.py +694 -0
- pyfect/encoding/xml/_scanner.py +180 -0
- pyfect/encoding/xml/_writer.py +238 -0
- pyfect/encoding/yaml.py +739 -0
- pyfect/encoding/zip/__init__.py +392 -0
- pyfect/encoding/zip/_decoder.py +378 -0
- pyfect/encoding/zip/_format.py +122 -0
- pyfect/encoding/zip/_inflate.py +65 -0
- pyfect/encoding/zip/_model.py +86 -0
- pyfect/encoding/zip/_writer.py +311 -0
- pyfect/error_reporter.py +240 -0
- pyfect/errors.py +321 -0
- pyfect/eventlog/__init__.py +77 -0
- pyfect/eventlog/_conflicts.py +94 -0
- pyfect/eventlog/_crypto.py +64 -0
- pyfect/eventlog/_identity.py +26 -0
- pyfect/eventlog/_identity_derivation.py +79 -0
- pyfect/eventlog/_transferable_bytes.py +55 -0
- pyfect/eventlog/_uuid.py +33 -0
- pyfect/eventlog/event.py +115 -0
- pyfect/eventlog/event_group.py +55 -0
- pyfect/eventlog/event_journal.py +630 -0
- pyfect/eventlog/event_log.py +1039 -0
- pyfect/eventlog/event_log_encryption.py +219 -0
- pyfect/eventlog/event_log_message.py +357 -0
- pyfect/eventlog/event_log_remote.py +465 -0
- pyfect/eventlog/event_log_server.py +442 -0
- pyfect/eventlog/event_log_server_encrypted.py +322 -0
- pyfect/eventlog/event_log_server_unencrypted.py +814 -0
- pyfect/eventlog/event_log_session_auth.py +250 -0
- pyfect/eventlog/event_row.py +423 -0
- pyfect/eventlog/sql_event_journal.py +692 -0
- pyfect/eventlog/sql_event_log_server_encrypted.py +440 -0
- pyfect/eventlog/sql_event_log_server_unencrypted.py +568 -0
- pyfect/execution_plan/__init__.py +42 -0
- pyfect/execution_plan/_events.py +128 -0
- pyfect/execution_plan/_model.py +108 -0
- pyfect/execution_plan/_run.py +176 -0
- pyfect/exit.py +205 -0
- pyfect/fiber_handle.py +305 -0
- pyfect/fiber_map.py +350 -0
- pyfect/fiber_set.py +232 -0
- pyfect/file_system/__init__.py +69 -0
- pyfect/file_system/_copy.py +116 -0
- pyfect/file_system/_errors.py +32 -0
- pyfect/file_system/_file.py +177 -0
- pyfect/file_system/_live.py +351 -0
- pyfect/file_system/_model.py +72 -0
- pyfect/file_system/_noop.py +189 -0
- pyfect/file_system/_service.py +336 -0
- pyfect/file_system/_stat.py +69 -0
- pyfect/file_system/_watch.py +107 -0
- pyfect/filters.py +245 -0
- pyfect/graph/__init__.py +101 -0
- pyfect/graph/_all_pairs.py +150 -0
- pyfect/graph/_combine.py +259 -0
- pyfect/graph/_compact.py +143 -0
- pyfect/graph/_components.py +200 -0
- pyfect/graph/_cycles.py +144 -0
- pyfect/graph/_enumerate.py +168 -0
- pyfect/graph/_errors.py +51 -0
- pyfect/graph/_flow.py +164 -0
- pyfect/graph/_forest.py +109 -0
- pyfect/graph/_graph.py +269 -0
- pyfect/graph/_lowlink.py +98 -0
- pyfect/graph/_matching.py +101 -0
- pyfect/graph/_mutate.py +211 -0
- pyfect/graph/_query.py +138 -0
- pyfect/graph/_records.py +119 -0
- pyfect/graph/_render.py +109 -0
- pyfect/graph/_shortest.py +274 -0
- pyfect/graph/_snapshot.py +50 -0
- pyfect/graph/_store.py +136 -0
- pyfect/graph/_traverse.py +289 -0
- pyfect/graph/_view.py +384 -0
- pyfect/graph/_walker.py +70 -0
- pyfect/graphql/__init__.py +87 -0
- pyfect/graphql/_codec.py +117 -0
- pyfect/graphql/_http.py +309 -0
- pyfect/graphql/_schemas.py +39 -0
- pyfect/graphql/_slices.py +110 -0
- pyfect/graphql/_template.py +111 -0
- pyfect/graphql/_types.py +115 -0
- pyfect/graphql/_ws.py +395 -0
- pyfect/graphql/_ws_messages.py +120 -0
- pyfect/graphql/client.py +428 -0
- pyfect/graphql/client_error.py +285 -0
- pyfect/graphql/group.py +142 -0
- pyfect/graphql/middleware.py +98 -0
- pyfect/graphql/operation.py +409 -0
- pyfect/graphql/protocol.py +119 -0
- pyfect/graphql/resolver.py +574 -0
- pyfect/graphql/template.py +61 -0
- pyfect/hash_map.py +317 -0
- pyfect/hash_ring.py +206 -0
- pyfect/hash_set.py +163 -0
- pyfect/http/__init__.py +125 -0
- pyfect/http/_asgi_listener.py +272 -0
- pyfect/http/_authority.py +63 -0
- pyfect/http/_brotli.py +27 -0
- pyfect/http/_compression.py +52 -0
- pyfect/http/_field.py +18 -0
- pyfect/http/_foreign_path.py +27 -0
- pyfect/http/_form_data.py +34 -0
- pyfect/http/_httpx_options.py +120 -0
- pyfect/http/_in_memory.py +76 -0
- pyfect/http/_request_state.py +59 -0
- pyfect/http/_vary.py +14 -0
- pyfect/http/abort.py +65 -0
- pyfect/http/asgi/__init__.py +59 -0
- pyfect/http/asgi/_app.py +155 -0
- pyfect/http/asgi/_http.py +201 -0
- pyfect/http/asgi/_mount.py +263 -0
- pyfect/http/asgi/_scope.py +86 -0
- pyfect/http/asgi/_serve.py +72 -0
- pyfect/http/asgi/_types.py +13 -0
- pyfect/http/asgi/_web_socket.py +325 -0
- pyfect/http/body.py +437 -0
- pyfect/http/client/__init__.py +111 -0
- pyfect/http/client/_circuit_breaker.py +113 -0
- pyfect/http/client/_cookie_jar.py +120 -0
- pyfect/http/client/_make.py +252 -0
- pyfect/http/client/_rate_limit.py +423 -0
- pyfect/http/client/_redirects.py +93 -0
- pyfect/http/client/_retry.py +115 -0
- pyfect/http/client/_service.py +497 -0
- pyfect/http/cookies.py +444 -0
- pyfect/http/error.py +188 -0
- pyfect/http/etag.py +96 -0
- pyfect/http/file_like.py +49 -0
- pyfect/http/find_my_way/__init__.py +10 -0
- pyfect/http/find_my_way/_nodes.py +186 -0
- pyfect/http/find_my_way/_paths.py +43 -0
- pyfect/http/find_my_way/_query_string.py +67 -0
- pyfect/http/find_my_way/_router.py +401 -0
- pyfect/http/headers.py +343 -0
- pyfect/http/http_effect.py +198 -0
- pyfect/http/httpx_client.py +291 -0
- pyfect/http/hypercorn_server.py +122 -0
- pyfect/http/incoming_message.py +140 -0
- pyfect/http/live_server/__init__.py +191 -0
- pyfect/http/live_server/_body.py +164 -0
- pyfect/http/live_server/_exchange.py +321 -0
- pyfect/http/live_server/_head.py +194 -0
- pyfect/http/live_server/_inbound.py +156 -0
- pyfect/http/live_server/_listener.py +211 -0
- pyfect/http/live_server/_serve.py +225 -0
- pyfect/http/live_server/_timers.py +20 -0
- pyfect/http/live_server/_upgrade.py +108 -0
- pyfect/http/live_server/_websocket.py +286 -0
- pyfect/http/live_server/_ws_frames.py +242 -0
- pyfect/http/method.py +30 -0
- pyfect/http/middleware/__init__.py +61 -0
- pyfect/http/middleware/_compression.py +156 -0
- pyfect/http/middleware/_cors.py +129 -0
- pyfect/http/middleware/_decompression.py +274 -0
- pyfect/http/middleware/_forwarded.py +113 -0
- pyfect/http/middleware/_logger.py +73 -0
- pyfect/http/middleware/_search_params.py +34 -0
- pyfect/http/middleware/_tracer.py +153 -0
- pyfect/http/middleware/_types.py +16 -0
- pyfect/http/mime/__init__.py +69 -0
- pyfect/http/mime/_types.py +361 -0
- pyfect/http/multipart.py +613 -0
- pyfect/http/multipart_parser/__init__.py +348 -0
- pyfect/http/multipart_parser/_content_type.py +109 -0
- pyfect/http/multipart_parser/_headers.py +206 -0
- pyfect/http/multipart_parser/_search.py +85 -0
- pyfect/http/origin.py +146 -0
- pyfect/http/platform.py +593 -0
- pyfect/http/prometheus.py +34 -0
- pyfect/http/request.py +384 -0
- pyfect/http/response.py +474 -0
- pyfect/http/router/__init__.py +82 -0
- pyfect/http/router/_api.py +462 -0
- pyfect/http/router/_in_memory.py +76 -0
- pyfect/http/router/_markers.py +47 -0
- pyfect/http/router/_middleware.py +181 -0
- pyfect/http/router/_middleware_stack.py +51 -0
- pyfect/http/router/_provided.py +31 -0
- pyfect/http/router/_route.py +114 -0
- pyfect/http/router/_router.py +308 -0
- pyfect/http/schema.py +276 -0
- pyfect/http/server.py +199 -0
- pyfect/http/server_error.py +261 -0
- pyfect/http/server_request.py +729 -0
- pyfect/http/server_respondable.py +77 -0
- pyfect/http/server_response.py +569 -0
- pyfect/http/static_server/__init__.py +257 -0
- pyfect/http/static_server/_conditional.py +72 -0
- pyfect/http/static_server/_mime.py +55 -0
- pyfect/http/static_server/_range.py +53 -0
- pyfect/http/status.py +51 -0
- pyfect/http/template.py +161 -0
- pyfect/http/trace_context.py +91 -0
- pyfect/http/url.py +442 -0
- pyfect/http/url_params.py +304 -0
- pyfect/http/uvicorn_server.py +119 -0
- pyfect/http/web.py +171 -0
- pyfect/http/web_handler.py +463 -0
- pyfect/http/wire.py +209 -0
- pyfect/http_api/__init__.py +83 -0
- pyfect/http_api/_assets/scalar.js +8 -0
- pyfect/http_api/_assets/swagger-ui.css +3 -0
- pyfect/http_api/_assets/swagger-ui.js +4 -0
- pyfect/http_api/_client_method.py +220 -0
- pyfect/http_api/_client_payload.py +144 -0
- pyfect/http_api/_client_response.py +377 -0
- pyfect/http_api/_handlers.py +282 -0
- pyfect/http_api/_html.py +38 -0
- pyfect/http_api/_media_type.py +6 -0
- pyfect/http_api/_openapi_responses.py +164 -0
- pyfect/http_api/_openapi_schemas.py +163 -0
- pyfect/http_api/_path.py +102 -0
- pyfect/http_api/_payload.py +260 -0
- pyfect/http_api/_response.py +363 -0
- pyfect/http_api/_security.py +174 -0
- pyfect/http_api/api.py +265 -0
- pyfect/http_api/builder.py +447 -0
- pyfect/http_api/client.py +474 -0
- pyfect/http_api/endpoint.py +969 -0
- pyfect/http_api/error.py +280 -0
- pyfect/http_api/group.py +215 -0
- pyfect/http_api/middleware.py +232 -0
- pyfect/http_api/openapi.py +396 -0
- pyfect/http_api/scalar.py +143 -0
- pyfect/http_api/schema.py +713 -0
- pyfect/http_api/security.py +91 -0
- pyfect/http_api/swagger.py +69 -0
- pyfect/http_api/test.py +105 -0
- pyfect/json_patch.py +255 -0
- pyfect/json_pointer.py +100 -0
- pyfect/json_schema/__init__.py +66 -0
- pyfect/json_schema/_api.py +96 -0
- pyfect/json_schema/_converter.py +258 -0
- pyfect/json_schema/_draft04.py +198 -0
- pyfect/json_schema/_draft07.py +203 -0
- pyfect/json_schema/_keywords.py +202 -0
- pyfect/json_schema/_model.py +201 -0
- pyfect/json_schema/_openapi.py +208 -0
- pyfect/latch.py +127 -0
- pyfect/layer.py +479 -0
- pyfect/layer_map.py +279 -0
- pyfect/layer_ref.py +208 -0
- pyfect/logger/__init__.py +91 -0
- pyfect/logger/_batched.py +49 -0
- pyfect/logger/_console.py +116 -0
- pyfect/logger/_file.py +31 -0
- pyfect/logger/_formats.py +104 -0
- pyfect/logger/_layer.py +50 -0
- pyfect/logger/_level.py +53 -0
- pyfect/logger/_log.py +142 -0
- pyfect/logger/_model.py +163 -0
- pyfect/logger/_refs.py +78 -0
- pyfect/logger/_stdlib.py +54 -0
- pyfect/logger/_text.py +263 -0
- pyfect/logger/_tracer.py +35 -0
- pyfect/managed_runtime.py +393 -0
- pyfect/metric/__init__.py +119 -0
- pyfect/metric/_boundaries.py +27 -0
- pyfect/metric/_kinds.py +417 -0
- pyfect/metric/_metric.py +302 -0
- pyfect/metric/_prometheus.py +150 -0
- pyfect/metric/_refs.py +78 -0
- pyfect/metric/_runtime.py +75 -0
- pyfect/metric/_snapshot.py +97 -0
- pyfect/metric/_state.py +74 -0
- pyfect/msgspec.py +98 -0
- pyfect/mutable_hash_map.py +140 -0
- pyfect/mutable_hash_set.py +95 -0
- pyfect/net/__init__.py +18 -0
- pyfect/net/_errors.py +29 -0
- pyfect/net/address_resolver.py +179 -0
- pyfect/net/dns/__init__.py +92 -0
- pyfect/net/dns/_error.py +43 -0
- pyfect/net/dns/_records.py +335 -0
- pyfect/net/dns/_service.py +287 -0
- pyfect/net/dns/_system.py +89 -0
- pyfect/net/host.py +311 -0
- pyfect/net/ip_interface.py +202 -0
- pyfect/net/ip_network.py +250 -0
- pyfect/net/net_address/__init__.py +245 -0
- pyfect/net/net_address/_inet.py +412 -0
- pyfect/net/net_address/_ip.py +348 -0
- pyfect/net/net_address/_mac.py +119 -0
- pyfect/optic/__init__.py +50 -0
- pyfect/optic/_builtins.py +90 -0
- pyfect/optic/_data.py +97 -0
- pyfect/optic/_optic.py +422 -0
- pyfect/optic/_steps.py +151 -0
- pyfect/option.py +362 -0
- pyfect/otel/__init__.py +22 -0
- pyfect/otel/_attributes.py +67 -0
- pyfect/otel/_producer.py +322 -0
- pyfect/otel/_shutdown.py +26 -0
- pyfect/otel/_span.py +292 -0
- pyfect/otel/_wrapper.py +92 -0
- pyfect/otel/logger.py +154 -0
- pyfect/otel/metrics.py +126 -0
- pyfect/otel/resource.py +111 -0
- pyfect/otel/sdk.py +195 -0
- pyfect/otel/tracer.py +157 -0
- pyfect/partitioned_semaphore.py +211 -0
- pyfect/path.py +304 -0
- pyfect/persistence/__init__.py +77 -0
- pyfect/persistence/_columns.py +32 -0
- pyfect/persistence/_error.py +14 -0
- pyfect/persistence/_seconds.py +68 -0
- pyfect/persistence/_sql_keys.py +47 -0
- pyfect/persistence/circuit_breaker/__init__.py +120 -0
- pyfect/persistence/circuit_breaker/_breaker.py +317 -0
- pyfect/persistence/circuit_breaker/_errors.py +67 -0
- pyfect/persistence/circuit_breaker/_memory.py +243 -0
- pyfect/persistence/circuit_breaker/_redis.py +509 -0
- pyfect/persistence/circuit_breaker/_store.py +60 -0
- pyfect/persistence/circuit_breaker/_types.py +191 -0
- pyfect/persistence/key_value_store/__init__.py +51 -0
- pyfect/persistence/key_value_store/_layers.py +216 -0
- pyfect/persistence/key_value_store/_schema_store.py +91 -0
- pyfect/persistence/key_value_store/_sql.py +197 -0
- pyfect/persistence/key_value_store/_store.py +212 -0
- pyfect/persistence/persistable.py +164 -0
- pyfect/persistence/persisted_cache.py +159 -0
- pyfect/persistence/persisted_queue/__init__.py +75 -0
- pyfect/persistence/persisted_queue/_error.py +42 -0
- pyfect/persistence/persisted_queue/_mailbox.py +101 -0
- pyfect/persistence/persisted_queue/_memory.py +182 -0
- pyfect/persistence/persisted_queue/_queue.py +272 -0
- pyfect/persistence/persisted_queue/_redis.py +455 -0
- pyfect/persistence/persisted_queue/_redis_scripts.py +395 -0
- pyfect/persistence/persisted_queue/_sql.py +334 -0
- pyfect/persistence/persisted_queue/_sql_migrations.py +319 -0
- pyfect/persistence/persisted_queue/_sql_statements.py +441 -0
- pyfect/persistence/persisted_queue/_store.py +147 -0
- pyfect/persistence/persistence/__init__.py +84 -0
- pyfect/persistence/persistence/_kvs.py +135 -0
- pyfect/persistence/persistence/_memory.py +62 -0
- pyfect/persistence/persistence/_redis.py +162 -0
- pyfect/persistence/persistence/_service.py +276 -0
- pyfect/persistence/persistence/_sql.py +499 -0
- pyfect/persistence/rate_limiter/__init__.py +82 -0
- pyfect/persistence/rate_limiter/_errors.py +59 -0
- pyfect/persistence/rate_limiter/_limiter.py +325 -0
- pyfect/persistence/rate_limiter/_memory.py +217 -0
- pyfect/persistence/rate_limiter/_redis.py +485 -0
- pyfect/persistence/rate_limiter/_store.py +89 -0
- pyfect/persistence/redis/__init__.py +52 -0
- pyfect/persistence/redis/_error.py +12 -0
- pyfect/persistence/redis/_make.py +234 -0
- pyfect/persistence/redis/_script.py +78 -0
- pyfect/persistence/redis/_service.py +104 -0
- pyfect/persistence/redis_py.py +303 -0
- pyfect/persistence/user_directories.py +195 -0
- pyfect/platform.py +26 -0
- pyfect/platform_error.py +256 -0
- pyfect/pool/__init__.py +36 -0
- pyfect/pool/_pool.py +707 -0
- pyfect/pool/_state.py +161 -0
- pyfect/pool/_ttl.py +105 -0
- pyfect/pool/_waiters.py +116 -0
- pyfect/primary_key.py +35 -0
- pyfect/process/__init__.py +82 -0
- pyfect/process/_child.py +213 -0
- pyfect/process/_command.py +358 -0
- pyfect/process/_handle.py +77 -0
- pyfect/process/_live.py +455 -0
- pyfect/process/_os.py +78 -0
- pyfect/process/_pipes.py +291 -0
- pyfect/process/_spawner.py +75 -0
- pyfect/pubsub/__init__.py +33 -0
- pyfect/pubsub/_atomic.py +181 -0
- pyfect/pubsub/_hub.py +214 -0
- pyfect/pubsub/_pubsub.py +214 -0
- pyfect/pubsub/_replay.py +107 -0
- pyfect/pubsub/_subscription.py +226 -0
- pyfect/pull.py +132 -0
- pyfect/py.typed +0 -0
- pyfect/pydantic.py +188 -0
- pyfect/queue/__init__.py +33 -0
- pyfect/queue/_queue.py +525 -0
- pyfect/queue/_state.py +111 -0
- pyfect/queue/_views.py +55 -0
- pyfect/random.py +146 -0
- pyfect/rc_map.py +363 -0
- pyfect/rc_ref.py +271 -0
- pyfect/reactivity/__init__.py +53 -0
- pyfect/reactivity/_async_result_schema.py +227 -0
- pyfect/reactivity/_hydration.py +18 -0
- pyfect/reactivity/_live.py +21 -0
- pyfect/reactivity/_reactivity.py +256 -0
- pyfect/reactivity/_result_effect.py +17 -0
- pyfect/reactivity/_time.py +11 -0
- pyfect/reactivity/async_result.py +679 -0
- pyfect/reactivity/atom/__init__.py +143 -0
- pyfect/reactivity/atom/_combinators.py +223 -0
- pyfect/reactivity/atom/_constructors.py +80 -0
- pyfect/reactivity/atom/_conversions.py +79 -0
- pyfect/reactivity/atom/_effect.py +252 -0
- pyfect/reactivity/atom/_fn.py +341 -0
- pyfect/reactivity/atom/_kvs.py +101 -0
- pyfect/reactivity/atom/_optimistic.py +162 -0
- pyfect/reactivity/atom/_runtime.py +323 -0
- pyfect/reactivity/atom/_serializable.py +65 -0
- pyfect/reactivity/atom/_subscription_ref.py +102 -0
- pyfect/reactivity/atom/_swr.py +69 -0
- pyfect/reactivity/atom/_types.py +435 -0
- pyfect/reactivity/atom_http_api.py +667 -0
- pyfect/reactivity/atom_ref.py +260 -0
- pyfect/reactivity/atom_registry/__init__.py +219 -0
- pyfect/reactivity/atom_registry/_batch.py +96 -0
- pyfect/reactivity/atom_registry/_dispatcher.py +60 -0
- pyfect/reactivity/atom_registry/_lifetime.py +202 -0
- pyfect/reactivity/atom_registry/_node.py +423 -0
- pyfect/reactivity/atom_registry/_registry.py +380 -0
- pyfect/reactivity/atom_rpc.py +283 -0
- pyfect/reactivity/hydration.py +200 -0
- pyfect/redacted.py +83 -0
- pyfect/ref.py +129 -0
- pyfect/resource.py +98 -0
- pyfect/result.py +306 -0
- pyfect/rpc/__init__.py +64 -0
- pyfect/rpc/_encoded_schema.py +86 -0
- pyfect/rpc/_json_rpc.py +246 -0
- pyfect/rpc/_methods.py +177 -0
- pyfect/rpc/_rpc.py +498 -0
- pyfect/rpc/client/__init__.py +100 -0
- pyfect/rpc/client/_core.py +449 -0
- pyfect/rpc/client/_http.py +257 -0
- pyfect/rpc/client/_protocol.py +171 -0
- pyfect/rpc/client/_serialized.py +321 -0
- pyfect/rpc/client/_transports.py +328 -0
- pyfect/rpc/client/_worker.py +283 -0
- pyfect/rpc/client_error.py +35 -0
- pyfect/rpc/group.py +296 -0
- pyfect/rpc/message.py +299 -0
- pyfect/rpc/middleware.py +182 -0
- pyfect/rpc/schema.py +89 -0
- pyfect/rpc/serialization.py +366 -0
- pyfect/rpc/server/__init__.py +181 -0
- pyfect/rpc/server/_core.py +549 -0
- pyfect/rpc/server/_protocol.py +123 -0
- pyfect/rpc/server/_serialized.py +363 -0
- pyfect/rpc/server/_stdio.py +101 -0
- pyfect/rpc/server/_transports.py +427 -0
- pyfect/rpc/server/_worker.py +108 -0
- pyfect/rpc/test.py +74 -0
- pyfect/rpc/worker.py +92 -0
- pyfect/run.py +393 -0
- pyfect/schedule/__init__.py +91 -0
- pyfect/schedule/_combinators.py +168 -0
- pyfect/schedule/_constructors.py +223 -0
- pyfect/schedule/_cron.py +49 -0
- pyfect/schedule/_drive.py +191 -0
- pyfect/schedule/_model.py +405 -0
- pyfect/scheduler.py +575 -0
- pyfect/schema/__init__.py +866 -0
- pyfect/schema/_adapters.py +39 -0
- pyfect/schema/_arbitrary_constraint.py +242 -0
- pyfect/schema/_arbitrary_graph.py +325 -0
- pyfect/schema/_arbitrary_links.py +179 -0
- pyfect/schema/_arbitrary_number.py +112 -0
- pyfect/schema/_arrays.py +287 -0
- pyfect/schema/_assignable.py +118 -0
- pyfect/schema/_boolean_literals.py +31 -0
- pyfect/schema/_checks_number.py +216 -0
- pyfect/schema/_checks_order.py +140 -0
- pyfect/schema/_checks_size.py +277 -0
- pyfect/schema/_checks_string.py +241 -0
- pyfect/schema/_class.py +569 -0
- pyfect/schema/_codec_derivation.py +227 -0
- pyfect/schema/_codec_links.py +221 -0
- pyfect/schema/_codecs.py +316 -0
- pyfect/schema/_collections.py +172 -0
- pyfect/schema/_constructor_default.py +89 -0
- pyfect/schema/_data.py +440 -0
- pyfect/schema/_data_codecs.py +145 -0
- pyfect/schema/_decimal_regexp.py +243 -0
- pyfect/schema/_declare.py +68 -0
- pyfect/schema/_derive.py +292 -0
- pyfect/schema/_duration_codecs.py +27 -0
- pyfect/schema/_ecma_pattern.py +416 -0
- pyfect/schema/_error.py +26 -0
- pyfect/schema/_error_instance.py +222 -0
- pyfect/schema/_graph.py +271 -0
- pyfect/schema/_instances.py +240 -0
- pyfect/schema/_jsonschema/__init__.py +90 -0
- pyfect/schema/_jsonschema/_annotations.py +114 -0
- pyfect/schema/_jsonschema/_checks.py +253 -0
- pyfect/schema/_jsonschema/_compile.py +346 -0
- pyfect/schema/_jsonschema/_exact.py +19 -0
- pyfect/schema/_jsonschema/_merge.py +211 -0
- pyfect/schema/_jsonschema/_objects.py +231 -0
- pyfect/schema/_jsonschema/_references.py +221 -0
- pyfect/schema/_jsonschema/_template.py +69 -0
- pyfect/schema/_literals.py +147 -0
- pyfect/schema/_middleware.py +209 -0
- pyfect/schema/_net.py +522 -0
- pyfect/schema/_options.py +49 -0
- pyfect/schema/_parse.py +351 -0
- pyfect/schema/_parsed_text.py +37 -0
- pyfect/schema/_primitives.py +48 -0
- pyfect/schema/_record.py +41 -0
- pyfect/schema/_refine.py +81 -0
- pyfect/schema/_schema.py +158 -0
- pyfect/schema/_semver.py +144 -0
- pyfect/schema/_strategy/__init__.py +258 -0
- pyfect/schema/_strategy/_big_decimal.py +203 -0
- pyfect/schema/_strategy/_composites.py +119 -0
- pyfect/schema/_strategy/_leaves.py +94 -0
- pyfect/schema/_strategy/_net.py +133 -0
- pyfect/schema/_struct.py +87 -0
- pyfect/schema/_struct_keys.py +128 -0
- pyfect/schema/_tagged.py +254 -0
- pyfect/schema/_template_literal.py +172 -0
- pyfect/schema/_to_codec_array_from_single.py +115 -0
- pyfect/schema/_to_codec_go_json.py +174 -0
- pyfect/schema/_to_codec_json.py +73 -0
- pyfect/schema/_to_codec_string_tree.py +115 -0
- pyfect/schema/_to_differ_json_patch.py +44 -0
- pyfect/schema/_to_encoder_xml.py +119 -0
- pyfect/schema/_to_equivalence.py +186 -0
- pyfect/schema/_to_formatter.py +180 -0
- pyfect/schema/_to_iso.py +73 -0
- pyfect/schema/_to_strategy.py +31 -0
- pyfect/schema/_transform.py +210 -0
- pyfect/schema/_tree.py +27 -0
- pyfect/schema/_type_walk.py +53 -0
- pyfect/schema/_undefined.py +58 -0
- pyfect/schema/_value_codecs.py +84 -0
- pyfect/schema/_values.py +123 -0
- pyfect/schema/_void.py +86 -0
- pyfect/schema/ast/__init__.py +227 -0
- pyfect/schema/ast/_annotations.py +43 -0
- pyfect/schema/ast/_arrays.py +210 -0
- pyfect/schema/ast/_base.py +295 -0
- pyfect/schema/ast/_candidates.py +309 -0
- pyfect/schema/ast/_check.py +181 -0
- pyfect/schema/ast/_class.py +159 -0
- pyfect/schema/ast/_constructors.py +65 -0
- pyfect/schema/ast/_declaration.py +97 -0
- pyfect/schema/ast/_encoding.py +111 -0
- pyfect/schema/ast/_json.py +129 -0
- pyfect/schema/ast/_keywords.py +125 -0
- pyfect/schema/ast/_literal.py +157 -0
- pyfect/schema/ast/_objects.py +356 -0
- pyfect/schema/ast/_record.py +36 -0
- pyfect/schema/ast/_result.py +116 -0
- pyfect/schema/ast/_steps.py +209 -0
- pyfect/schema/ast/_suspend.py +65 -0
- pyfect/schema/ast/_template_literal.py +256 -0
- pyfect/schema/ast/_union.py +172 -0
- pyfect/schema/getter/__init__.py +136 -0
- pyfect/schema/getter/_binary.py +104 -0
- pyfect/schema/getter/_coerce.py +196 -0
- pyfect/schema/getter/_getter.py +243 -0
- pyfect/schema/getter/_make.py +151 -0
- pyfect/schema/getter/_text.py +141 -0
- pyfect/schema/getter/_tree_record.py +170 -0
- pyfect/schema/issue.py +420 -0
- pyfect/schema/model/__init__.py +120 -0
- pyfect/schema/model/_class.py +245 -0
- pyfect/schema/model/_dates.py +103 -0
- pyfect/schema/model/_fields.py +77 -0
- pyfect/schema/model/_toolkit.py +114 -0
- pyfect/schema/model/_uuid.py +69 -0
- pyfect/schema/representation/__init__.py +424 -0
- pyfect/schema/representation/_builtin_revivers.py +331 -0
- pyfect/schema/representation/_code.py +106 -0
- pyfect/schema/representation/_code_builtins.py +281 -0
- pyfect/schema/representation/_code_document.py +563 -0
- pyfect/schema/representation/_code_sort.py +111 -0
- pyfect/schema/representation/_from.py +278 -0
- pyfect/schema/representation/_import/__init__.py +78 -0
- pyfect/schema/representation/_import/_finalize.py +121 -0
- pyfect/schema/representation/_import/_intersect.py +467 -0
- pyfect/schema/representation/_import/_js_order.py +66 -0
- pyfect/schema/representation/_import/_keywords.py +224 -0
- pyfect/schema/representation/_import/_nodes.py +199 -0
- pyfect/schema/representation/_import/_translate.py +455 -0
- pyfect/schema/representation/_json.py +520 -0
- pyfect/schema/representation/_json_schema.py +178 -0
- pyfect/schema/representation/_model.py +284 -0
- pyfect/schema/representation/_revivers.py +89 -0
- pyfect/schema/representation/_to.py +249 -0
- pyfect/schema/transformation/__init__.py +99 -0
- pyfect/schema/transformation/_builtins.py +314 -0
- pyfect/schema/transformation/_durations.py +150 -0
- pyfect/schema/transformation/_transformation.py +177 -0
- pyfect/schema/variant_schema/__init__.py +69 -0
- pyfect/schema/variant_schema/_class.py +188 -0
- pyfect/schema/variant_schema/_defaults.py +30 -0
- pyfect/schema/variant_schema/_field.py +32 -0
- pyfect/schema/variant_schema/_struct.py +130 -0
- pyfect/schema/variant_schema/_toolkit.py +160 -0
- pyfect/scope.py +374 -0
- pyfect/scoped_ref.py +124 -0
- pyfect/semaphore.py +276 -0
- pyfect/semver.py +403 -0
- pyfect/semver_range.py +420 -0
- pyfect/sink/__init__.py +131 -0
- pyfect/sink/_combinators.py +151 -0
- pyfect/sink/_constructors.py +187 -0
- pyfect/sink/_context.py +87 -0
- pyfect/sink/_folds.py +336 -0
- pyfect/sink/_for_each.py +87 -0
- pyfect/sink/_sink.py +265 -0
- pyfect/sink/_steps.py +34 -0
- pyfect/sink/_taking.py +183 -0
- pyfect/socket/__init__.py +146 -0
- pyfect/socket/_accepted.py +65 -0
- pyfect/socket/_connection.py +384 -0
- pyfect/socket/_errors.py +135 -0
- pyfect/socket/_loop.py +66 -0
- pyfect/socket/_net.py +281 -0
- pyfect/socket/_socket.py +245 -0
- pyfect/socket/_tls.py +88 -0
- pyfect/socket/_tls_session.py +117 -0
- pyfect/socket/_web_socket.py +555 -0
- pyfect/socket/datagram/__init__.py +110 -0
- pyfect/socket/datagram/_core.py +460 -0
- pyfect/socket/datagram/_errors.py +102 -0
- pyfect/socket/datagram/_live.py +675 -0
- pyfect/socket/datagram/_model.py +217 -0
- pyfect/socket/server.py +258 -0
- pyfect/socket/ws.py +484 -0
- pyfect/sql/__init__.py +60 -0
- pyfect/sql/_loop.py +134 -0
- pyfect/sql/clickhouse/__init__.py +74 -0
- pyfect/sql/clickhouse/_connection.py +237 -0
- pyfect/sql/clickhouse/_rows.py +87 -0
- pyfect/sql/clickhouse/client.py +322 -0
- pyfect/sql/clickhouse/config.py +241 -0
- pyfect/sql/clickhouse/driver.py +434 -0
- pyfect/sql/clickhouse/error.py +106 -0
- pyfect/sql/clickhouse/migrator.py +47 -0
- pyfect/sql/clickhouse/params.py +168 -0
- pyfect/sql/client/__init__.py +35 -0
- pyfect/sql/client/_client.py +309 -0
- pyfect/sql/client/_sqlite_acquirers.py +130 -0
- pyfect/sql/client/_transaction.py +410 -0
- pyfect/sql/connection.py +87 -0
- pyfect/sql/d1/__init__.py +48 -0
- pyfect/sql/d1/api.py +270 -0
- pyfect/sql/d1/client.py +344 -0
- pyfect/sql/d1/config.py +55 -0
- pyfect/sql/error.py +311 -0
- pyfect/sql/libsql/__init__.py +58 -0
- pyfect/sql/libsql/_connection.py +110 -0
- pyfect/sql/libsql/_hrana.py +258 -0
- pyfect/sql/libsql/_local.py +251 -0
- pyfect/sql/libsql/_targets.py +28 -0
- pyfect/sql/libsql/_values.py +46 -0
- pyfect/sql/libsql/client.py +225 -0
- pyfect/sql/libsql/config.py +170 -0
- pyfect/sql/libsql/migrator.py +43 -0
- pyfect/sql/libsql/sdk.py +123 -0
- pyfect/sql/migrator.py +434 -0
- pyfect/sql/model.py +324 -0
- pyfect/sql/mssql/__init__.py +79 -0
- pyfect/sql/mssql/_connection.py +169 -0
- pyfect/sql/mssql/_driver.py +103 -0
- pyfect/sql/mssql/_names.py +9 -0
- pyfect/sql/mssql/_pool.py +125 -0
- pyfect/sql/mssql/_tds.py +447 -0
- pyfect/sql/mssql/_tds_params.py +155 -0
- pyfect/sql/mssql/_worker.py +155 -0
- pyfect/sql/mssql/client.py +344 -0
- pyfect/sql/mssql/config.py +118 -0
- pyfect/sql/mssql/error.py +111 -0
- pyfect/sql/mssql/migrator.py +43 -0
- pyfect/sql/mssql/parameter.py +44 -0
- pyfect/sql/mssql/procedure.py +119 -0
- pyfect/sql/mssql/types.py +137 -0
- pyfect/sql/mysql/__init__.py +60 -0
- pyfect/sql/mysql/_asyncmy.py +168 -0
- pyfect/sql/mysql/_bind.py +76 -0
- pyfect/sql/mysql/_connection.py +156 -0
- pyfect/sql/mysql/_pool.py +63 -0
- pyfect/sql/mysql/_session.py +262 -0
- pyfect/sql/mysql/client.py +244 -0
- pyfect/sql/mysql/config.py +108 -0
- pyfect/sql/mysql/error.py +104 -0
- pyfect/sql/mysql/migrator.py +44 -0
- pyfect/sql/pg/__init__.py +82 -0
- pyfect/sql/pg/_resolve.py +284 -0
- pyfect/sql/pg/_session.py +380 -0
- pyfect/sql/pg/client.py +398 -0
- pyfect/sql/pg/config.py +142 -0
- pyfect/sql/pg/connection.py +585 -0
- pyfect/sql/pg/error.py +131 -0
- pyfect/sql/pg/migrator.py +139 -0
- pyfect/sql/pg/pool.py +265 -0
- pyfect/sql/resolver.py +294 -0
- pyfect/sql/result.py +24 -0
- pyfect/sql/schema.py +116 -0
- pyfect/sql/sqlite/__init__.py +26 -0
- pyfect/sql/sqlite/_connection.py +230 -0
- pyfect/sql/sqlite/_worker.py +71 -0
- pyfect/sql/sqlite/client.py +248 -0
- pyfect/sql/sqlite/migrator.py +43 -0
- pyfect/sql/statement/__init__.py +144 -0
- pyfect/sql/statement/_compiler.py +384 -0
- pyfect/sql/statement/_segments.py +487 -0
- pyfect/sql/statement/_statement.py +526 -0
- pyfect/sql/statement/_transforms.py +93 -0
- pyfect/sql/stream.py +88 -0
- pyfect/stdio.py +206 -0
- pyfect/stream/__init__.py +151 -0
- pyfect/stream/_async_iterable.py +129 -0
- pyfect/stream/_base.py +69 -0
- pyfect/stream/_bridge_methods.py +139 -0
- pyfect/stream/_catch.py +135 -0
- pyfect/stream/_catch_reason.py +558 -0
- pyfect/stream/_channel_methods.py +61 -0
- pyfect/stream/_chunk_methods.py +169 -0
- pyfect/stream/_chunking.py +310 -0
- pyfect/stream/_concat.py +65 -0
- pyfect/stream/_constructors.py +341 -0
- pyfect/stream/_context.py +147 -0
- pyfect/stream/_error_methods.py +254 -0
- pyfect/stream/_execution_plan.py +199 -0
- pyfect/stream/_fanout.py +154 -0
- pyfect/stream/_fanout_methods.py +183 -0
- pyfect/stream/_filter_methods.py +203 -0
- pyfect/stream/_grouping.py +168 -0
- pyfect/stream/_many.py +65 -0
- pyfect/stream/_map_methods.py +233 -0
- pyfect/stream/_mapping.py +126 -0
- pyfect/stream/_run.py +114 -0
- pyfect/stream/_run_methods.py +114 -0
- pyfect/stream/_service_methods.py +36 -0
- pyfect/stream/_sink_methods.py +151 -0
- pyfect/stream/_sinking.py +277 -0
- pyfect/stream/_sources.py +124 -0
- pyfect/stream/_stream.py +162 -0
- pyfect/stream/_taking.py +330 -0
- pyfect/stream/_text.py +43 -0
- pyfect/stream/_timing.py +294 -0
- pyfect/stream/_timing_methods.py +252 -0
- pyfect/stream/_zip_methods.py +279 -0
- pyfect/stream/_zipping.py +213 -0
- pyfect/subscription_ref.py +66 -0
- pyfect/synchronized_ref.py +38 -0
- pyfect/take.py +36 -0
- pyfect/terminal/__init__.py +41 -0
- pyfect/terminal/_keys.py +113 -0
- pyfect/terminal/_live.py +223 -0
- pyfect/terminal/_service.py +73 -0
- pyfect/testing/__init__.py +122 -0
- pyfect/testing/_assertions.py +92 -0
- pyfect/testing/_clock.py +309 -0
- pyfect/testing/_console.py +164 -0
- pyfect/testing/_crypto.py +44 -0
- pyfect/testing/_decorators.py +211 -0
- pyfect/testing/_flaky.py +34 -0
- pyfect/testing/_layers.py +153 -0
- pyfect/testing/_prop.py +255 -0
- pyfect/testing/_runners.py +84 -0
- pyfect/testing/_runtime.py +174 -0
- pyfect/testing/_schema.py +238 -0
- pyfect/testing/plugin.py +59 -0
- pyfect/tracer/__init__.py +107 -0
- pyfect/tracer/_model.py +176 -0
- pyfect/tracer/_native.py +172 -0
- pyfect/tracer/_refs.py +87 -0
- pyfect/tracer/_spans.py +269 -0
- pyfect/transaction.py +340 -0
- pyfect/trie.py +317 -0
- pyfect/tx_chunk.py +127 -0
- pyfect/tx_deferred.py +75 -0
- pyfect/tx_hash_map.py +265 -0
- pyfect/tx_hash_set.py +151 -0
- pyfect/tx_priority_queue.py +224 -0
- pyfect/tx_pubsub.py +194 -0
- pyfect/tx_queue/__init__.py +27 -0
- pyfect/tx_queue/_queue.py +359 -0
- pyfect/tx_queue/_views.py +60 -0
- pyfect/tx_reentrant_lock.py +201 -0
- pyfect/tx_ref.py +79 -0
- pyfect/tx_semaphore.py +136 -0
- pyfect/tx_subscription_ref.py +118 -0
- pyfect/workers/__init__.py +62 -0
- pyfect/workers/_frames.py +82 -0
- pyfect/workers/_mailbox.py +51 -0
- pyfect/workers/_port.py +106 -0
- pyfect/workers/_process.py +155 -0
- pyfect/workers/_thread.py +100 -0
- pyfect/workers/python_worker.py +133 -0
- pyfect/workers/python_worker_runner.py +112 -0
- pyfect/workers/transferable.py +103 -0
- pyfect/workers/worker.py +273 -0
- pyfect/workers/worker_error.py +86 -0
- pyfect/workers/worker_runner.py +85 -0
- pyfect/workflow/__init__.py +78 -0
- pyfect/workflow/_crypto.py +23 -0
- pyfect/workflow/_encoded.py +381 -0
- pyfect/workflow/_memory.py +424 -0
- pyfect/workflow/_result.py +43 -0
- pyfect/workflow/_services.py +241 -0
- pyfect/workflow/_suspension.py +153 -0
- pyfect/workflow/activity.py +427 -0
- pyfect/workflow/durable_clock.py +72 -0
- pyfect/workflow/durable_deferred.py +403 -0
- pyfect/workflow/durable_queue.py +259 -0
- pyfect/workflow/workflow.py +509 -0
- pyfect/workflow/workflow_engine.py +42 -0
- pyfect/workflow/workflow_proxy.py +161 -0
- pyfect/workflow/workflow_proxy_server.py +146 -0
- pyfect_dev-0.1.0.dist-info/METADATA +296 -0
- pyfect_dev-0.1.0.dist-info/RECORD +1265 -0
- pyfect_dev-0.1.0.dist-info/WHEEL +4 -0
- pyfect_dev-0.1.0.dist-info/entry_points.txt +3 -0
- 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)
|