glyff 0.12.0

Guaranteed Lightweight Yieldable Function Foundation for checkpointed and resumable task execution.

glyff

Guaranteed Lightweight Yieldable Function Foundation.

A primitive for pausing async functions across process and request boundaries, and resuming them later from the same point.

Install

pip install glyff

glyff has no dependencies beyond the Python standard library.

Behavior

• Marked function calls are recorded in a session-scoped store, keyed by function identity, arguments, and call position.
• Re-invoking the same completed call within the same session returns the recorded result instead of re-executing.
• Exceptions raised by a call are non-terminal by default: completed work is committed, the interrupted call remains STARTED, and the original exception propagates so the caller can decide whether to resume later.
• To pause a session intentionally, raise an application-owned exception and catch it outside the Session block.

Public API

Name	Description
engrave	Decorator that marks an async function for recording.
Session	Async context manager that scopes a sequence of engraved calls.
ExecutionId	Identifier for a recorded function execution.
ExecutionRecord	Persisted execution state and result.
ExecutionStatus	Enum: STARTED, COMPLETED, FAILED.
SessionStore	Protocol for storage backends.
Serializer	Protocol for value serialization.
ArgsHasher	Protocol for argument hashing.

Extending

• For persistent storage, see glyff-file-store.
• For Pydantic-typed serialization, see glyff-pydantic.
• Custom backends can be written by implementing the SessionStore, Serializer, and ArgsHasher protocols.

Status

Early development. APIs may change before v1.0.

License

MIT