YIDL Undoable

Make an edit to a Python model, undo it, and redo it. Declare which fields belong to history; Undoable supplies guarded transactions and a shared history for the root objects and their managed descendants. You do not need to write YIDL.

from yidl_undoable import UndoRedoManager, managed, undoable

@undoable
class Document:
    title: str = managed(default="Draft")

history = UndoRedoManager()
document = Document(transaction_manager=history)
history.initialize(document)
with history.begin():
    document.title = "Ready"
assert history.undo() and document.title == "Draft"
assert history.redo() and document.title == "Ready"

Install with python -m pip install yidl-undoable. The package targets CPython 3.12–3.15; see the installation qualification for platform/dependency limits.

Start with your first undo, then learn frames and views, collections, and nested objects. The public API gives the complete contract. The searchable documentation site is owebeeone.github.io/yidl-undoable.

History is in memory and linear. A new commit after undo discards redo. Only managed data is restored; caches, ordinary fields and external resources are not rewound. Live handles follow the selected frame; use a snapshot to retain old committed managed values.

Version 0.1.2 adds field-specific generated accessors and optional compiled-builder caching. Version 0.1.1 does not include these additions; the transaction API remains the same. The original experiment, accessor experiment and cache probe preserve separate evidence and measurement limits. Contributor details live in CONTRIBUTING.md; releases use Gearu.