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,130 @@
|
|
|
1
|
+
"""Variant structs (Effect's ``VariantSchema.Struct`` and ``extract``):
|
|
2
|
+
field definitions from which one struct schema per variant is extracted.
|
|
3
|
+
|
|
4
|
+
A definition is a schema (in every variant), a ``Field`` (in the variants
|
|
5
|
+
it names), a nested variant struct or variant class (extracted with the
|
|
6
|
+
same variant), or ``None`` (left out). Extraction is cached on the struct
|
|
7
|
+
itself, so a class never reuses its base's variants.
|
|
8
|
+
"""
|
|
9
|
+
|
|
10
|
+
from __future__ import annotations
|
|
11
|
+
|
|
12
|
+
from collections.abc import Callable, Mapping
|
|
13
|
+
from dataclasses import dataclass
|
|
14
|
+
from typing import Any, Generic, Protocol, TypeIs, TypeVar, cast, runtime_checkable
|
|
15
|
+
|
|
16
|
+
from pyfect.schema import ast
|
|
17
|
+
from pyfect.schema._schema import Bottom, is_schema
|
|
18
|
+
from pyfect.schema._struct import StructSchema
|
|
19
|
+
from pyfect.schema.variant_schema._field import AnyCodec, Field
|
|
20
|
+
|
|
21
|
+
TD_co = TypeVar("TD_co", bound=Mapping[str, object], covariant=True)
|
|
22
|
+
|
|
23
|
+
_AnyBottom = Bottom[Any, Any, Any, Any]
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
@dataclass(frozen=True, slots=True, eq=False)
|
|
27
|
+
class VariantStructSchema(StructSchema[TD_co, Any, Any], Generic[TD_co]):
|
|
28
|
+
"""One variant's struct; its ``make`` fills the keys with a constructor
|
|
29
|
+
default (``with_constructor_default``)."""
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def variant_struct_schema(fields: Mapping[str, AnyCodec]) -> VariantStructSchema[Any]:
|
|
33
|
+
"""The struct of ``fields``, keys in order."""
|
|
34
|
+
schemas = {name: codec.__codec__() for name, codec in fields.items()}
|
|
35
|
+
node = ast.Objects(tuple(ast.PropertySignature(n, s.ast) for n, s in schemas.items()))
|
|
36
|
+
return VariantStructSchema(node, schemas)
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
type Definition = AnyCodec | Field[Any] | HasVariants
|
|
40
|
+
"""What a variant struct's field may be."""
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
@runtime_checkable
|
|
44
|
+
class HasVariants(Protocol):
|
|
45
|
+
"""A variant struct or a variant class: field definitions, and a cache
|
|
46
|
+
of the structs extracted from them."""
|
|
47
|
+
|
|
48
|
+
def __variant_fields__(self) -> Mapping[str, Definition]: ...
|
|
49
|
+
|
|
50
|
+
def __variant_cache__(self, is_default: bool) -> dict[str, Any]: ...
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
class Struct:
|
|
54
|
+
"""Field definitions shared by every variant (Effect's
|
|
55
|
+
``VariantSchema.Struct``); a toolkit's ``extract`` gives one variant's
|
|
56
|
+
struct schema."""
|
|
57
|
+
|
|
58
|
+
__slots__ = ("_caches", "_fields")
|
|
59
|
+
|
|
60
|
+
def __init__(self, fields: Mapping[str, Definition | None]) -> None:
|
|
61
|
+
self._fields = {name: value for name, value in fields.items() if value is not None}
|
|
62
|
+
self._caches: tuple[dict[str, Any], dict[str, Any]] = ({}, {})
|
|
63
|
+
|
|
64
|
+
def __variant_fields__(self) -> Mapping[str, Definition]:
|
|
65
|
+
return self._fields
|
|
66
|
+
|
|
67
|
+
def __variant_cache__(self, is_default: bool) -> dict[str, Any]:
|
|
68
|
+
return self._caches[is_default]
|
|
69
|
+
|
|
70
|
+
def pipe[B](self, f: Callable[[Struct], B], /) -> B:
|
|
71
|
+
return f(self)
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
def is_struct(value: object) -> TypeIs[HasVariants]:
|
|
75
|
+
"""``value`` is a variant struct or a variant class (Effect's
|
|
76
|
+
``isStruct``)."""
|
|
77
|
+
return isinstance(value, HasVariants)
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
def fields(self: HasVariants, /) -> Mapping[str, Definition]:
|
|
81
|
+
"""The field definitions of a variant struct or class (Effect's
|
|
82
|
+
``fields``)."""
|
|
83
|
+
return self.__variant_fields__()
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
def extract(self: HasVariants, variant: str, *, is_default: bool = False) -> Any:
|
|
87
|
+
"""``variant``'s struct schema. With ``is_default``, a variant class is
|
|
88
|
+
its own schema, and so is a variant class nested in it."""
|
|
89
|
+
if is_default and is_schema(self):
|
|
90
|
+
return self
|
|
91
|
+
cache = self.__variant_cache__(is_default)
|
|
92
|
+
found = cache.get(variant)
|
|
93
|
+
if found is not None:
|
|
94
|
+
return found
|
|
95
|
+
selected: dict[str, AnyCodec] = {}
|
|
96
|
+
for key, value in self.__variant_fields__().items():
|
|
97
|
+
if isinstance(value, HasVariants):
|
|
98
|
+
keep = is_default and is_schema(value)
|
|
99
|
+
selected[key] = cast("AnyCodec", value) if keep else extract(value, variant)
|
|
100
|
+
elif isinstance(value, Field):
|
|
101
|
+
schema = value.schemas.get(variant)
|
|
102
|
+
if schema is not None:
|
|
103
|
+
selected[key] = schema
|
|
104
|
+
else:
|
|
105
|
+
selected[key] = value
|
|
106
|
+
schema = variant_struct_schema(selected)
|
|
107
|
+
cache[variant] = schema
|
|
108
|
+
return schema
|
|
109
|
+
|
|
110
|
+
|
|
111
|
+
def schema_of_definition(value: Definition, variant: str) -> AnyCodec | None:
|
|
112
|
+
"""The schema a definition has in ``variant`` (``None``: left out)."""
|
|
113
|
+
if isinstance(value, HasVariants):
|
|
114
|
+
return cast("AnyCodec", value) if is_schema(value) else extract(value, variant)
|
|
115
|
+
if isinstance(value, Field):
|
|
116
|
+
return value.schemas.get(variant)
|
|
117
|
+
return value
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
__all__ = [
|
|
121
|
+
"Definition",
|
|
122
|
+
"HasVariants",
|
|
123
|
+
"Struct",
|
|
124
|
+
"VariantStructSchema",
|
|
125
|
+
"extract",
|
|
126
|
+
"fields",
|
|
127
|
+
"is_struct",
|
|
128
|
+
"schema_of_definition",
|
|
129
|
+
"variant_struct_schema",
|
|
130
|
+
]
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
"""The variant toolkit (Effect's ``VariantSchema.make``): structs, fields,
|
|
2
|
+
classes and unions over one fixed set of variants."""
|
|
3
|
+
|
|
4
|
+
from __future__ import annotations
|
|
5
|
+
|
|
6
|
+
from collections.abc import Callable, Mapping, Sequence
|
|
7
|
+
from dataclasses import dataclass, field
|
|
8
|
+
from typing import Any, overload
|
|
9
|
+
|
|
10
|
+
from pyfect.schema._literals import Union as SchemaUnion
|
|
11
|
+
from pyfect.schema._literals import UnionSchema
|
|
12
|
+
from pyfect.schema._schema import Codec, is_schema
|
|
13
|
+
from pyfect.schema.variant_schema._class import Class as VariantClass
|
|
14
|
+
from pyfect.schema.variant_schema._class import VariantAttribute
|
|
15
|
+
from pyfect.schema.variant_schema._field import AnyCodec
|
|
16
|
+
from pyfect.schema.variant_schema._field import Field as VariantField
|
|
17
|
+
from pyfect.schema.variant_schema._struct import Definition, HasVariants, extract
|
|
18
|
+
from pyfect.schema.variant_schema._struct import Struct as VariantStruct
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
@dataclass(frozen=True, slots=True, eq=False)
|
|
22
|
+
class VariantUnionSchema(UnionSchema[Any, Any, Any, Any]):
|
|
23
|
+
"""A union of the members' default variants (Effect's
|
|
24
|
+
``VariantSchema.Union``); ``variants[name]`` is the union of their
|
|
25
|
+
``name`` variants."""
|
|
26
|
+
|
|
27
|
+
variants: Mapping[str, UnionSchema[Any, Any, Any, Any]]
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
class FieldOnly:
|
|
31
|
+
"""``field_only(keys)(schema)``: ``schema`` in the ``keys`` variants."""
|
|
32
|
+
|
|
33
|
+
__slots__ = ("keys",)
|
|
34
|
+
|
|
35
|
+
def __init__(self, keys: tuple[str, ...]) -> None:
|
|
36
|
+
self.keys = keys
|
|
37
|
+
|
|
38
|
+
def __call__[A](self, schema: Codec[A, Any, Any, Any], /) -> VariantField[A]:
|
|
39
|
+
return VariantField(dict.fromkeys(self.keys, schema))
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
class FieldEvolve:
|
|
43
|
+
"""``field_evolve(mapping)(self)``: each named variant's schema mapped."""
|
|
44
|
+
|
|
45
|
+
__slots__ = ("mapping", "variants")
|
|
46
|
+
|
|
47
|
+
def __init__(
|
|
48
|
+
self, variants: tuple[str, ...], mapping: Mapping[str, Callable[[AnyCodec], AnyCodec]]
|
|
49
|
+
) -> None:
|
|
50
|
+
self.variants = variants
|
|
51
|
+
self.mapping = mapping
|
|
52
|
+
|
|
53
|
+
def __call__(self, field: VariantField[Any] | AnyCodec, /) -> VariantField[Any]:
|
|
54
|
+
schemas = (
|
|
55
|
+
field.schemas
|
|
56
|
+
if isinstance(field, VariantField)
|
|
57
|
+
else dict.fromkeys(self.variants, field)
|
|
58
|
+
)
|
|
59
|
+
evolved = {
|
|
60
|
+
variant: self.mapping[variant](schema) if variant in self.mapping else schema
|
|
61
|
+
for variant, schema in schemas.items()
|
|
62
|
+
}
|
|
63
|
+
return VariantField(evolved)
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
@dataclass(frozen=True, slots=True, eq=False)
|
|
67
|
+
class VariantSchema:
|
|
68
|
+
"""A toolkit for ``variants``, whose ``default_variant`` is the schema
|
|
69
|
+
of its classes. Make one with ``make``."""
|
|
70
|
+
|
|
71
|
+
variants: tuple[str, ...]
|
|
72
|
+
default_variant: str
|
|
73
|
+
Class: type[VariantClass] = field(init=False)
|
|
74
|
+
|
|
75
|
+
def __post_init__(self) -> None:
|
|
76
|
+
attributes: dict[str, object] = {v: VariantAttribute(v) for v in self.variants}
|
|
77
|
+
base = type("Class", (VariantClass,), {"__variant_set__": self, **attributes})
|
|
78
|
+
object.__setattr__(self, "Class", base)
|
|
79
|
+
|
|
80
|
+
def _known(self, keys: Sequence[str]) -> tuple[str, ...]:
|
|
81
|
+
if isinstance(keys, str):
|
|
82
|
+
raise TypeError("variant keys are a sequence of names, not a string")
|
|
83
|
+
unknown = [key for key in keys if key not in self.variants]
|
|
84
|
+
if unknown:
|
|
85
|
+
raise ValueError(f"unknown variant {unknown[0]!r} (variants: {self.variants})")
|
|
86
|
+
return tuple(keys)
|
|
87
|
+
|
|
88
|
+
def Struct(self, fields: Mapping[str, Definition | None], /) -> VariantStruct:
|
|
89
|
+
"""Field definitions (Effect's ``Struct``); ``None`` leaves a key out."""
|
|
90
|
+
for value in fields.values():
|
|
91
|
+
if isinstance(value, VariantField):
|
|
92
|
+
self._known(list(value.schemas))
|
|
93
|
+
return VariantStruct(fields)
|
|
94
|
+
|
|
95
|
+
def Field(self, **schemas: AnyCodec | None) -> VariantField[Any]:
|
|
96
|
+
"""A field's schema per variant; ``None`` or a missing variant
|
|
97
|
+
leaves it out of that variant."""
|
|
98
|
+
self._known(list(schemas))
|
|
99
|
+
return VariantField({k: v for k, v in schemas.items() if v is not None})
|
|
100
|
+
|
|
101
|
+
def field_only(self, keys: Sequence[str], /) -> FieldOnly:
|
|
102
|
+
"""A field in the ``keys`` variants only (Effect's ``FieldOnly``)."""
|
|
103
|
+
return FieldOnly(self._known(keys))
|
|
104
|
+
|
|
105
|
+
def field_except(self, keys: Sequence[str], /) -> FieldOnly:
|
|
106
|
+
"""A field in every variant but ``keys`` (Effect's ``FieldExcept``)."""
|
|
107
|
+
excluded = self._known(keys)
|
|
108
|
+
return FieldOnly(tuple(v for v in self.variants if v not in excluded))
|
|
109
|
+
|
|
110
|
+
@overload
|
|
111
|
+
def field_evolve(
|
|
112
|
+
self, mapping: Mapping[str, Callable[[AnyCodec], AnyCodec]], /
|
|
113
|
+
) -> FieldEvolve: ...
|
|
114
|
+
@overload
|
|
115
|
+
def field_evolve(
|
|
116
|
+
self,
|
|
117
|
+
field: VariantField[Any] | AnyCodec,
|
|
118
|
+
mapping: Mapping[str, Callable[[AnyCodec], AnyCodec]],
|
|
119
|
+
/,
|
|
120
|
+
) -> VariantField[Any]: ...
|
|
121
|
+
def field_evolve(self, *args: Any) -> FieldEvolve | VariantField[Any]:
|
|
122
|
+
"""Each named variant's schema of a field (or of a schema in every
|
|
123
|
+
variant) mapped (Effect's ``fieldEvolve``); a variant the field
|
|
124
|
+
lacks stays out."""
|
|
125
|
+
if len(args) == 1:
|
|
126
|
+
return FieldEvolve(self.variants, self._mapping(args[0]))
|
|
127
|
+
return FieldEvolve(self.variants, self._mapping(args[1]))(args[0])
|
|
128
|
+
|
|
129
|
+
def _mapping(
|
|
130
|
+
self, mapping: Mapping[str, Callable[[AnyCodec], AnyCodec]]
|
|
131
|
+
) -> Mapping[str, Callable[[AnyCodec], AnyCodec]]:
|
|
132
|
+
self._known(list(mapping))
|
|
133
|
+
return mapping
|
|
134
|
+
|
|
135
|
+
def Union(self, members: Sequence[HasVariants], /) -> VariantUnionSchema:
|
|
136
|
+
"""The union of the members' default variants (a class is its own),
|
|
137
|
+
with ``variants`` holding the union of each variant."""
|
|
138
|
+
defaults = [
|
|
139
|
+
m if is_schema(m) else extract(m, self.default_variant, is_default=True)
|
|
140
|
+
for m in members
|
|
141
|
+
]
|
|
142
|
+
union = SchemaUnion(*defaults)
|
|
143
|
+
variants = {v: SchemaUnion(*(extract(m, v) for m in members)) for v in self.variants}
|
|
144
|
+
return VariantUnionSchema(union.ast, union.members, variants)
|
|
145
|
+
|
|
146
|
+
def extract(self, struct: HasVariants, variant: str, /) -> Any:
|
|
147
|
+
"""``variant``'s struct schema; the default variant of a class is
|
|
148
|
+
the class itself."""
|
|
149
|
+
self._known([variant])
|
|
150
|
+
return extract(struct, variant, is_default=variant == self.default_variant)
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
def make(*, variants: Sequence[str], default_variant: str) -> VariantSchema:
|
|
154
|
+
"""A toolkit for ``variants`` (Effect's ``VariantSchema.make``)."""
|
|
155
|
+
if isinstance(variants, str) or default_variant not in variants:
|
|
156
|
+
raise ValueError(f"default_variant {default_variant!r} is not one of {variants!r}")
|
|
157
|
+
return VariantSchema(tuple(variants), default_variant)
|
|
158
|
+
|
|
159
|
+
|
|
160
|
+
__all__ = ["FieldEvolve", "FieldOnly", "VariantSchema", "VariantUnionSchema", "make"]
|
pyfect/scope.py
ADDED
|
@@ -0,0 +1,374 @@
|
|
|
1
|
+
"""Scopes: where resources register their release.
|
|
2
|
+
|
|
3
|
+
``acquire_release`` adds a finalizer to the current ``Scope`` (which joins
|
|
4
|
+
``R``); ``scoped`` creates a scope, runs the effect in it, and closes it
|
|
5
|
+
however the effect ends, removing ``Scope`` from ``R``. For a scope made
|
|
6
|
+
with ``make``, ``eff.pipe(provide(scope))`` runs ``eff`` in it and leaves
|
|
7
|
+
it open; ``eff.pipe(use(scope))`` also closes it when ``eff`` ends. Finalizers run in
|
|
8
|
+
reverse order of registration, uninterruptibly, and all of them run even if
|
|
9
|
+
some fail.
|
|
10
|
+
"""
|
|
11
|
+
# pyright: reportPrivateUsage=false
|
|
12
|
+
|
|
13
|
+
from __future__ import annotations
|
|
14
|
+
|
|
15
|
+
from collections.abc import Callable
|
|
16
|
+
from typing import Any, Literal, Never, overload
|
|
17
|
+
|
|
18
|
+
from pyfect._concurrency import for_each
|
|
19
|
+
from pyfect._core import (
|
|
20
|
+
Effect,
|
|
21
|
+
_AfterStarted,
|
|
22
|
+
_call_user,
|
|
23
|
+
_FailCause,
|
|
24
|
+
_Gen,
|
|
25
|
+
_Locally,
|
|
26
|
+
_Succeed,
|
|
27
|
+
_Suspend,
|
|
28
|
+
_Sync,
|
|
29
|
+
_WithFiber,
|
|
30
|
+
uninterruptible_mask,
|
|
31
|
+
)
|
|
32
|
+
from pyfect._effect_args import require_effect
|
|
33
|
+
from pyfect._fiber import Fiber, Uninterruptible
|
|
34
|
+
from pyfect._interrupt_reason import closed
|
|
35
|
+
from pyfect.cause import merge
|
|
36
|
+
from pyfect.context import Tag
|
|
37
|
+
from pyfect.exit import Exit, Failure
|
|
38
|
+
|
|
39
|
+
type Finalizer = Callable[[Exit[Any, Any]], Effect[object, Never, Any]]
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
type Strategy = Literal["sequential", "parallel"]
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
class CloseableScope:
|
|
46
|
+
"""A scope that can be closed. Use through the ``Scope`` tag.
|
|
47
|
+
|
|
48
|
+
Finalizers are keyed, so whatever registered one can take it back when
|
|
49
|
+
it no longer needs it: a child scope leaves its parent when it closes,
|
|
50
|
+
and a ``fork_scoped`` fiber leaves its scope when it exits. A
|
|
51
|
+
``"parallel"`` scope runs its finalizers concurrently on close."""
|
|
52
|
+
|
|
53
|
+
__slots__ = ("_closed", "_finalizers", "_parent", "_strategy")
|
|
54
|
+
|
|
55
|
+
def __init__(self, strategy: Strategy = "sequential") -> None:
|
|
56
|
+
self._strategy: Strategy = strategy
|
|
57
|
+
self._finalizers: dict[object, Finalizer] = {}
|
|
58
|
+
self._closed: Exit[Any, Any] | None = None
|
|
59
|
+
self._parent: CloseableScope | None = None
|
|
60
|
+
|
|
61
|
+
@property
|
|
62
|
+
def strategy(self) -> Strategy:
|
|
63
|
+
"""How finalizers run on close: one after the other, last added
|
|
64
|
+
first, or all at once."""
|
|
65
|
+
return self._strategy
|
|
66
|
+
|
|
67
|
+
@property
|
|
68
|
+
def finalizer_count(self) -> int:
|
|
69
|
+
"""How many finalizers are registered and not yet run."""
|
|
70
|
+
return len(self._finalizers)
|
|
71
|
+
|
|
72
|
+
@property
|
|
73
|
+
def is_empty(self) -> bool:
|
|
74
|
+
"""Open with no finalizers, so it can be handed on for reuse
|
|
75
|
+
(Effect's ``Empty`` state). A closed scope is never empty."""
|
|
76
|
+
return self._closed is None and not self._finalizers
|
|
77
|
+
|
|
78
|
+
@property
|
|
79
|
+
def is_closed(self) -> bool:
|
|
80
|
+
"""Whether ``close`` has started (later finalizers run at once)."""
|
|
81
|
+
return self._closed is not None
|
|
82
|
+
|
|
83
|
+
def add_finalizer(
|
|
84
|
+
self, f: Callable[[Exit[Any, Any]], Effect[object, Never, Any]]
|
|
85
|
+
) -> Effect[None]:
|
|
86
|
+
"""Register ``f`` to run on close, with the services in scope now.
|
|
87
|
+
If the scope is already closed, ``f`` runs immediately."""
|
|
88
|
+
|
|
89
|
+
def body(fiber: Fiber[Any, Any]) -> Effect[None]:
|
|
90
|
+
ctx = fiber._context
|
|
91
|
+
|
|
92
|
+
# As Effect's ``provideContext``: the closing fiber's services,
|
|
93
|
+
# overridden by those in scope at registration.
|
|
94
|
+
def finalizer(ex: Exit[Any, Any]) -> Effect[object, Never, Any]:
|
|
95
|
+
return _Locally(_call_user(f, ex), lambda current: current.merge(ctx))
|
|
96
|
+
|
|
97
|
+
if self._closed is not None:
|
|
98
|
+
return finalizer(self._closed).as_void()
|
|
99
|
+
self._add(object(), finalizer)
|
|
100
|
+
return _Succeed(None)
|
|
101
|
+
|
|
102
|
+
return _WithFiber(body)
|
|
103
|
+
|
|
104
|
+
def _add(self, key: object, finalizer: Finalizer) -> None:
|
|
105
|
+
"""Register under ``key``, which ``_remove`` takes. The scope must be
|
|
106
|
+
open."""
|
|
107
|
+
self._finalizers[key] = finalizer
|
|
108
|
+
|
|
109
|
+
def _remove(self, key: object) -> None:
|
|
110
|
+
self._finalizers.pop(key, None)
|
|
111
|
+
|
|
112
|
+
def _watch(self, fiber: Fiber[Any, Any]) -> None:
|
|
113
|
+
"""Interrupt ``fiber`` on close (unless it is the fiber closing the
|
|
114
|
+
scope), until it exits. Watching again moves its finalizer last, so
|
|
115
|
+
it runs first. The scope must be open."""
|
|
116
|
+
self._remove(fiber)
|
|
117
|
+
self._add(
|
|
118
|
+
fiber, lambda _: _WithFiber(lambda current: _interrupt_unless_self(fiber, current))
|
|
119
|
+
)
|
|
120
|
+
fiber.add_observer_unsafe(lambda _: self._remove(fiber))
|
|
121
|
+
|
|
122
|
+
def close(self, ex: Exit[Any, Any]) -> Effect[None]:
|
|
123
|
+
"""Run every finalizer, last added first (all at once in a parallel
|
|
124
|
+
scope). Closing twice is a no-op."""
|
|
125
|
+
|
|
126
|
+
# Uninterruptible before the scope is marked closed, so an interrupt
|
|
127
|
+
# can't land between marking it and running its finalizers.
|
|
128
|
+
return _Suspend(lambda: self.close_unsafe(ex) or _Succeed(None)).uninterruptible()
|
|
129
|
+
|
|
130
|
+
def close_unsafe(self, ex: Exit[Any, Any]) -> Effect[None] | None:
|
|
131
|
+
"""Mark the scope closed now and return the effect that runs its
|
|
132
|
+
finalizers, or ``None`` if it was closed already or had none. The
|
|
133
|
+
caller must run the effect uninterruptibly (Effect's ``closeUnsafe``)."""
|
|
134
|
+
if self._closed is not None:
|
|
135
|
+
return None
|
|
136
|
+
self._closed = ex
|
|
137
|
+
if self._parent is not None:
|
|
138
|
+
self._parent._remove(self)
|
|
139
|
+
if not self._finalizers:
|
|
140
|
+
return None
|
|
141
|
+
entries = list(reversed(self._finalizers.items()))
|
|
142
|
+
self._finalizers = {}
|
|
143
|
+
run = _run_parallel if self._strategy == "parallel" else _run_sequential
|
|
144
|
+
return run(entries, ex)
|
|
145
|
+
|
|
146
|
+
def fork(self, strategy: Strategy = "sequential") -> Effect[CloseableScope]:
|
|
147
|
+
"""A child scope, closed when this one closes (if not before). The
|
|
148
|
+
child of a closed scope starts closed."""
|
|
149
|
+
|
|
150
|
+
return _Sync(lambda: self.fork_unsafe(strategy))
|
|
151
|
+
|
|
152
|
+
def fork_unsafe(self, strategy: Strategy = "sequential") -> CloseableScope:
|
|
153
|
+
"""``fork``, run at once."""
|
|
154
|
+
child = CloseableScope(strategy)
|
|
155
|
+
if self._closed is not None:
|
|
156
|
+
child._closed = self._closed
|
|
157
|
+
return child
|
|
158
|
+
child._parent = self
|
|
159
|
+
self._add(child, child.close)
|
|
160
|
+
return child
|
|
161
|
+
|
|
162
|
+
|
|
163
|
+
type _Entries = list[tuple[object, Finalizer]]
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
def _fail_with_all(exits: list[Exit[Any, Never]]) -> Effect[None]:
|
|
167
|
+
cause = merge(*(e.cause for e in exits if isinstance(e, Failure)))
|
|
168
|
+
return _FailCause(cause) if cause.reasons else _Succeed(None)
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
def _run_sequential(entries: _Entries, ex: Exit[Any, Any]) -> Effect[None]:
|
|
172
|
+
def run_all():
|
|
173
|
+
exits: list[Exit[Any, Never]] = []
|
|
174
|
+
for _key, fin in entries:
|
|
175
|
+
exits.append((yield from _call_user(fin, ex).exit()))
|
|
176
|
+
return (yield from _fail_with_all(exits))
|
|
177
|
+
|
|
178
|
+
return _Gen(run_all)
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
def _run_parallel(entries: _Entries, ex: Exit[Any, Any]) -> Effect[None]:
|
|
182
|
+
# The closing fiber skips its own fork_scoped finalizer: running it on
|
|
183
|
+
# another fiber would wait for the closing fiber to exit.
|
|
184
|
+
def body(closing: Fiber[Any, Any]) -> Effect[None]:
|
|
185
|
+
others = [fin for key, fin in entries if key is not closing]
|
|
186
|
+
exits = for_each(
|
|
187
|
+
others,
|
|
188
|
+
lambda fin: _call_user(fin, ex).uninterruptible().exit(),
|
|
189
|
+
concurrency="unbounded",
|
|
190
|
+
)
|
|
191
|
+
return exits.flat_map(_fail_with_all)
|
|
192
|
+
|
|
193
|
+
return _WithFiber(body)
|
|
194
|
+
|
|
195
|
+
|
|
196
|
+
class Scope(Tag[CloseableScope]):
|
|
197
|
+
pass
|
|
198
|
+
|
|
199
|
+
|
|
200
|
+
def make(strategy: Strategy = "sequential") -> Effect[CloseableScope]:
|
|
201
|
+
"""A new open scope (``CloseableScope(strategy)``, made when the effect
|
|
202
|
+
runs)."""
|
|
203
|
+
return _Sync(lambda: CloseableScope(strategy))
|
|
204
|
+
|
|
205
|
+
|
|
206
|
+
class _InScope:
|
|
207
|
+
"""``provide(scope)`` / ``use(scope)``: run in ``scope``, removing
|
|
208
|
+
``Scope`` from ``R``; ``use`` also closes it with the effect's exit."""
|
|
209
|
+
|
|
210
|
+
__slots__ = ("close", "scope")
|
|
211
|
+
|
|
212
|
+
def __init__(self, scope: CloseableScope, *, close: bool) -> None:
|
|
213
|
+
self.scope = scope
|
|
214
|
+
self.close = close
|
|
215
|
+
|
|
216
|
+
@overload
|
|
217
|
+
def __call__[A, E](self, eff: Effect[A, E, Scope]) -> Effect[A, E]: ...
|
|
218
|
+
@overload
|
|
219
|
+
def __call__[A, E, R](self, eff: Effect[A, E, Scope | R]) -> Effect[A, E, R]: ...
|
|
220
|
+
def __call__(self, eff: Effect[Any, Any, Any]) -> Effect[Any, Any, Any]:
|
|
221
|
+
require_effect(eff, "eff")
|
|
222
|
+
scope = self.scope
|
|
223
|
+
inner: Effect[Any, Any, Any] = _Locally(eff, lambda ctx: ctx.add(Scope, scope))
|
|
224
|
+
return inner.on_exit(scope.close) if self.close else inner
|
|
225
|
+
|
|
226
|
+
|
|
227
|
+
def provide(scope: CloseableScope) -> _InScope:
|
|
228
|
+
"""Run an effect in ``scope``, removing ``Scope`` from ``R``; the scope
|
|
229
|
+
stays open::
|
|
230
|
+
|
|
231
|
+
eff.pipe(scope.provide(resources))
|
|
232
|
+
"""
|
|
233
|
+
return _InScope(scope, close=False)
|
|
234
|
+
|
|
235
|
+
|
|
236
|
+
def use(scope: CloseableScope) -> _InScope:
|
|
237
|
+
"""Run an effect in ``scope`` and close the scope with the effect's
|
|
238
|
+
exit, however it ends, removing ``Scope`` from ``R``::
|
|
239
|
+
|
|
240
|
+
eff.pipe(scope.use(resources))
|
|
241
|
+
"""
|
|
242
|
+
return _InScope(scope, close=True)
|
|
243
|
+
|
|
244
|
+
|
|
245
|
+
@overload
|
|
246
|
+
def scoped[A, E](eff: Effect[A, E, Scope]) -> Effect[A, E]: ...
|
|
247
|
+
@overload
|
|
248
|
+
def scoped[A, E, R](eff: Effect[A, E, Scope | R]) -> Effect[A, E, R]: ...
|
|
249
|
+
def scoped(eff: Effect[Any, Any, Any]) -> Effect[Any, Any, Any]:
|
|
250
|
+
"""Run ``eff`` in a new scope and close it when ``eff`` ends."""
|
|
251
|
+
require_effect(eff, "eff")
|
|
252
|
+
|
|
253
|
+
def body() -> Effect[Any, Any, Any]:
|
|
254
|
+
scope = CloseableScope()
|
|
255
|
+
inner: Effect[Any, Any, Any] = _Locally(eff, lambda ctx: ctx.add(Scope, scope))
|
|
256
|
+
return inner.on_exit(scope.close)
|
|
257
|
+
|
|
258
|
+
return _Suspend(body)
|
|
259
|
+
|
|
260
|
+
|
|
261
|
+
def scoped_with[A, E = Never, R = Never](
|
|
262
|
+
f: Callable[[CloseableScope], Effect[A, E, R]],
|
|
263
|
+
) -> Effect[A, E, R]:
|
|
264
|
+
"""Run ``f`` with a new scope and close it when the effect ``f`` gives
|
|
265
|
+
ends."""
|
|
266
|
+
|
|
267
|
+
def body() -> Effect[A, E, R]:
|
|
268
|
+
scope = CloseableScope()
|
|
269
|
+
return _call_user(f, scope).on_exit(scope.close)
|
|
270
|
+
|
|
271
|
+
return _Suspend(body)
|
|
272
|
+
|
|
273
|
+
|
|
274
|
+
def add_finalizer[R = Never](
|
|
275
|
+
f: Callable[[Exit[Any, Any]], Effect[object, Never, R]],
|
|
276
|
+
) -> Effect[None, Never, Scope | R]:
|
|
277
|
+
return Scope().flat_map(lambda scope: scope.add_finalizer(f))
|
|
278
|
+
|
|
279
|
+
|
|
280
|
+
def acquire_release[A, E = Never, RR = Never](
|
|
281
|
+
acquire: Effect[A, E, RR],
|
|
282
|
+
release: Callable[[A, Exit[Any, Any]], Effect[object, Never, RR]],
|
|
283
|
+
) -> Effect[A, E, RR | Scope]:
|
|
284
|
+
"""Acquire uninterruptibly and register ``release`` on the current
|
|
285
|
+
scope."""
|
|
286
|
+
require_effect(acquire, "acquire")
|
|
287
|
+
|
|
288
|
+
def body():
|
|
289
|
+
a = yield from acquire
|
|
290
|
+
scope = yield from Scope()
|
|
291
|
+
yield from scope.add_finalizer(lambda ex: release(a, ex))
|
|
292
|
+
return a
|
|
293
|
+
|
|
294
|
+
return _Gen(body).uninterruptible()
|
|
295
|
+
|
|
296
|
+
|
|
297
|
+
def acquire_use_release[A, B, EE = Never, RR = Never](
|
|
298
|
+
acquire: Effect[A, EE, RR],
|
|
299
|
+
use: Callable[[A], Effect[B, EE, RR]],
|
|
300
|
+
release: Callable[[A, Exit[B, EE]], Effect[object, Never, RR]],
|
|
301
|
+
) -> Effect[B, EE, RR]:
|
|
302
|
+
"""Acquire, use, and always release, without needing a scope."""
|
|
303
|
+
require_effect(acquire, "acquire")
|
|
304
|
+
return uninterruptible_mask(
|
|
305
|
+
lambda restore: acquire.flat_map(
|
|
306
|
+
lambda a: restore(_call_user(use, a)).on_exit(lambda ex: release(a, ex))
|
|
307
|
+
)
|
|
308
|
+
)
|
|
309
|
+
|
|
310
|
+
|
|
311
|
+
def fork_scoped[A, E, R](
|
|
312
|
+
eff: Effect[A, E, R],
|
|
313
|
+
*,
|
|
314
|
+
start_immediately: bool = False,
|
|
315
|
+
uninterruptible: Uninterruptible = False,
|
|
316
|
+
) -> Effect[Fiber[A, E], Never, R | Scope]:
|
|
317
|
+
"""Fork ``eff`` into the current scope (see ``fork_in``)."""
|
|
318
|
+
require_effect(eff, "eff")
|
|
319
|
+
return Scope().flat_map(
|
|
320
|
+
lambda scope: fork_in(
|
|
321
|
+
eff, scope, start_immediately=start_immediately, uninterruptible=uninterruptible
|
|
322
|
+
)
|
|
323
|
+
)
|
|
324
|
+
|
|
325
|
+
|
|
326
|
+
def fork_in[A, E, R](
|
|
327
|
+
eff: Effect[A, E, R],
|
|
328
|
+
scope: CloseableScope,
|
|
329
|
+
*,
|
|
330
|
+
start_immediately: bool = False,
|
|
331
|
+
uninterruptible: Uninterruptible = False,
|
|
332
|
+
) -> Effect[Fiber[A, E], Never, R]:
|
|
333
|
+
"""Fork ``eff`` on a fiber that outlives its parent but is interrupted
|
|
334
|
+
when ``scope`` closes, and leaves the scope when it exits. Into a
|
|
335
|
+
closed scope it gives an already-interrupted fiber that never ran
|
|
336
|
+
``eff``."""
|
|
337
|
+
require_effect(eff, "eff")
|
|
338
|
+
|
|
339
|
+
def body(parent: Fiber[Any, Any]) -> Effect[Fiber[A, E]]:
|
|
340
|
+
if scope._closed is not None:
|
|
341
|
+
unstarted: Fiber[A, E] = Fiber(parent._run_scheduler, parent._context, None)
|
|
342
|
+
unstarted.interrupt_as_unsafe(
|
|
343
|
+
parent.id, closed("Scope", parent._interruptor_annotations())
|
|
344
|
+
)
|
|
345
|
+
return _Succeed(unstarted)
|
|
346
|
+
fiber: Fiber[A, E] = parent._fork(
|
|
347
|
+
eff, daemon=True, start_immediately=start_immediately, uninterruptible=uninterruptible
|
|
348
|
+
)
|
|
349
|
+
scope._watch(fiber)
|
|
350
|
+
return _AfterStarted(fiber)
|
|
351
|
+
|
|
352
|
+
return _WithFiber(body)
|
|
353
|
+
|
|
354
|
+
|
|
355
|
+
def _interrupt_unless_self(fiber: Fiber[Any, Any], current: Fiber[Any, Any]) -> Effect[None]:
|
|
356
|
+
return _Succeed(None) if current is fiber else fiber.interrupt()
|
|
357
|
+
|
|
358
|
+
|
|
359
|
+
__all__ = [
|
|
360
|
+
"CloseableScope",
|
|
361
|
+
"Finalizer",
|
|
362
|
+
"Scope",
|
|
363
|
+
"Strategy",
|
|
364
|
+
"acquire_release",
|
|
365
|
+
"acquire_use_release",
|
|
366
|
+
"add_finalizer",
|
|
367
|
+
"fork_in",
|
|
368
|
+
"fork_scoped",
|
|
369
|
+
"make",
|
|
370
|
+
"provide",
|
|
371
|
+
"scoped",
|
|
372
|
+
"scoped_with",
|
|
373
|
+
"use",
|
|
374
|
+
]
|