Struct TransactionTicket 

pub struct TransactionTicket<'t, 's> { /* private fields */ }

An active ticket for a semi-entered transaction.

A TransactionTicket manages the lifecycle of the Transaction, allowing for explicit commit or rollback operations. It ensures that any changes made within the transaction are properly finalized or reverted.

Generic Lifetimes

• 't: Lifetime of the referenced Transaction.
• 's: Lifetime of the SQLx transaction.

Implementations

impl<'t> TransactionTicket<'t, '_>

pub async fn commit(&mut self) -> Result<&'t Transaction, FinanceError>

Validates the inputs and commits the transaction, finalizing all changes.

Returns

A reference to the original Transaction if the commit is successful.

Errors

Returns a FinanceError if the ticket is empty or the commit operation fails.

pub async fn rollback(&mut self) -> Result<&'t Transaction, FinanceError>

Rolls back the transaction, reverting all changes.

Returns

A reference to the original Transaction if the rollback is successful.

Errors

Returns a FinanceError if the ticket is empty or the rollback operation fails.

pub async fn add_splits( &mut self, splits: &[&Split], ) -> Result<&'t Transaction, FinanceError>

pub async fn add_conversions( &mut self, prices: &[&Price], ) -> Result<&'t Transaction, FinanceError>

pub async fn add_tags( &mut self, tags: &[&Tag], ) -> Result<&'t Transaction, FinanceError>

pub async fn add_split_tags( &mut self, split_tags: &[(Uuid, Tag)], ) -> Result<&'t Transaction, FinanceError>

pub async fn execute<F, Fut, T>(&mut self, f: F) -> Result<T, FinanceError>

where F: FnOnce(&mut PgConnection) -> Fut, Fut: Future<Output = Result<T, Error>>,

Execute an arbitrary async operation within this ticket’s DB transaction.

This enables custom operations (like adding split tags) without adding specific methods for each entity type.