General undo/redo framework for Python
Project description
collections-undo
General undo/redo implementation in Python.
Installation
pip install -U collections-undo
Basic usage
You'll have to create reversible functions using UndoManager
.
from collections_undo import UndoManager
class A:
mgr = UndoManager()
@mgr.undoable # create a reversible function
def f(self, x):
print("do", x)
@f.undo_def # define undo
def f(self, x):
print("undo", x)
a = A()
a.f(0) # Out: "do" 0
a.mgr.undo() # Out: "undo" 0
a.mgr.redo() # Out: "do" 0
ABC-like undo implementation
To avoid careless errors, ABC-like interface will be useful.
from collections_undo.abc import UndoableABC, undoablemethod, undo_def
class A(UndoableABC):
@undoablemethod
def f(self, x):
print("do", x)
@undo_def(f)
def f(self, x):
print("undo", x)
a = A() # OK
a.f(0) # Out: "do" 0
a.undo() # Out: "undo" 0
a.redo() # Out: "do" 0
If undo is not defined, construction fails.
class A(UndoableABC):
@undoablemethod
def f(self, x):
...
a = A() # TypeError
class B(A):
@undo_def(A.f)
def f(self, x):
...
b = B() # OK
Builtin undoable objects
These mutable classes have undo
and redo
method to handle operations that mutate the object.
-
Ready-to-use classes
UndoableList
...insert
,__setitem__
,extend
etc. are undoable.UndoableDict
...__setitem__
,update
etc. are undoable.UndoableSet
...add
,discard
etc. are undoable.
-
Abstract classes
AbstractUndoableList
AbstractUndoableDict
AbstractUndoableSet
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
collections-undo-0.0.3.tar.gz
(14.8 kB
view hashes)
Built Distribution
Close
Hashes for collections_undo-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5785d13a31b57ce4d03011d59c15a1a9f43f47d8c6aed6d098327a4305efd8f1 |
|
MD5 | 701217a35e5f09636e8a04163c821e69 |
|
BLAKE2b-256 | 3ae4d11105eaa1b44428a9554ce86796b81af46657c0cae9ab18d6746fa69827 |