`wove.runtime`¶

wove.runtime owns process-wide configuration. It stores default environments, environment definitions, and global execution defaults used when a weave starts.

The wove.runtime reference covers project config discovery, environment registration, default execution options, and the runtime snapshot used when a weave starts.

Configuration Entry Point¶

Most users call the public alias:

import wove

wove.config(
    default_environment="default",
    environments={
        "default": {"executor": "local"},
    },
)

Calling wove.config() with no arguments attempts to load wove_config.py from the current directory or one of its parents. Missing config files are ignored during autoload, so projects can opt in gradually.

Settings Stored Here¶

Environment registry: default_environment, environments.
Execution defaults: max_workers, background, fork, retries, timeout, workers, limit_per_minute, max_pending, error_mode.
Delivery defaults: delivery_timeout, delivery_idempotency_key, delivery_cancel_mode, delivery_heartbeat_seconds, delivery_max_in_flight, delivery_orphan_policy.

API Details¶

class wove.runtime.RuntimeConfig[source]¶

Bases: object

Process-wide runtime configuration singleton for Wove.

configure(*, config_file=None, default_environment=None, environments=None, max_workers=None, background=None, fork=None, retries=None, timeout=None, workers=None, limit_per_minute=None, max_pending=None, error_mode=None, delivery_timeout=None, delivery_idempotency_key=None, delivery_cancel_mode=None, delivery_heartbeat_seconds=None, delivery_max_in_flight=None, delivery_orphan_policy=None)[source]¶

Parameters:

config_file (str | None)
default_environment (str | None)
environments (Dict[str, Dict[str, Any]] | None)
max_workers (int | None)
background (bool | None)
fork (bool | None)
retries (int | None)
timeout (float | None)
workers (int | None)
limit_per_minute (int | None)
max_pending (int | None)
error_mode (str | None)
delivery_timeout (float | None)
delivery_idempotency_key (Any | None)
delivery_cancel_mode (str | None)
delivery_heartbeat_seconds (float | None)
delivery_max_in_flight (int | None)
delivery_orphan_policy (str | None)

Return type:

RuntimeConfig

resolve_environment_name(requested)[source]¶

Parameters:: requested (str | None)
Return type:: str

resolve_environment_settings(environment_name)[source]¶

Parameters:: environment_name (str)
Return type:: Dict[str, Any]

snapshot()[source]¶

Return type:: Dict[str, Any]

wove.runtime.config(*, config_file=None, default_environment=None, environments=None, max_workers=None, background=None, fork=None, retries=None, timeout=None, workers=None, limit_per_minute=None, max_pending=None, error_mode=None, delivery_timeout=None, delivery_idempotency_key=None, delivery_cancel_mode=None, delivery_heartbeat_seconds=None, delivery_max_in_flight=None, delivery_orphan_policy=None)[source]¶

Configure process-wide Wove runtime behavior.

Calling wove.config() with no args attempts to autoload wove_config.py from the current working directory or one of its parents.