#history #undo #track #transaction

macro cset-derive

Fine-grained and reversible struct transactions

2 releases

0.1.1 Dec 24, 2022
0.1.0 Dec 22, 2022

#42 in #undo

31 downloads per month
Used in cset

MIT/Apache

14KB
272 lines

drates.io docs.rs

cset

Fine-grained and reversible struct transactions.

This crate offers a Track macro that structs can derive to generate the plumbing needed to precisely track changes to fields. Calling Trackable::edit() returns a Draft that stores edits separately from the underyling struct, such that no values are written.

When .commit() is called on the draft, edits are applied to the base struct. Each replaced value is returned to the caller as a Change in a ChangeSet. This changeset can then be re-applied to a struct of the same type, which replaces fields with values from the ChangeSet. This operation produces a new ChangeSet, allowing for the implementation of an undo-redo paradigm.

Project status

This project is early in development and API changes should be expected.

Dependencies

~1.5MB
~33K SLoC