ltx

ltx

Lightweight logical transactions.

Overview

A logical transactions is a sequence of operations that can be undone if something goes wrong. This is useful for managing resources that need to be cleaned up in case of failure, such as temporary files, third party mutations or other side effects.

The ltx API mimics database/sql transactions with BeginTx, Commit, and Rollback and adds Cleanup from testing to register callbacks that run on rollback.

Install

go get github.com/olahol/ltx

Usage

tx, err := ltx.BeginTx(ctx)
if err != nil {
    return err
}
defer tx.Rollback() // safe to call even after commit

resource, err := createResource()
if err != nil {
    return err
}
tx.Cleanup(func(ctx context.Context) error {
    return deleteResource(resource)
})

err = registerService(resource)
if err != nil {
    return err // rollback deletes the resource
}
tx.Cleanup(func(ctx context.Context) error {
    return deregisterService(resource)
})

tx.Commit()

License

MIT