Struct pace_core::TomlActivityStorage

pub struct TomlActivityStorage { /* private fields */ }

In-memory backed TOML activity storage

This storage is backed by an in-memory cache and a TOML file on disk for persistence.

Implementations

impl TomlActivityStorage

pub fn new(path: impl AsRef<Path>) -> PaceResult<Self>

Create a new TomlActivityStorage

Arguments

• path - The path to the TOML file

Errors

Returns an error if the path is not a valid file path.

Returns

Returns a new TomlActivityStorage

pub fn sync_to_file(&self) -> PaceResult<()>

Sync the in-memory cache to the TOML file

This will write the in-memory cache to the TOML file on disk

Errors

Returns an error if the cache cannot be written to the file

Returns

Returns Ok(()) if the cache is written successfully

Trait Implementations

impl ActivityQuerying for TomlActivityStorage

fn list_activities_by_id( &self ) -> PaceOptResult<BTreeMap<ActivityGuid, Activity>>

Get all activities by their ID.

fn most_recent_active_activity(&self) -> PaceOptResult<ActivityItem>

Get the latest active activity.

fn group_activities_by_duration_range( &self ) -> PaceOptResult<BTreeMap<PaceDurationRange, Vec<ActivityItem>>>

Group activities by predefined duration ranges (e.g., short, medium, long).

fn group_activities_by_start_date( &self ) -> PaceOptResult<BTreeMap<PaceDate, Vec<ActivityItem>>>

Group activities by their start date. This can help in analyzing how activities are distributed over time.

fn list_activities_with_intermissions( &self ) -> PaceOptResult<BTreeMap<ActivityGuid, Vec<ActivityItem>>>

Retrieve activities that have one or more intermissions, useful for identifying potential inefficiencies or breaks.

fn group_activities_by_keywords( &self, keyword_opts: KeywordOptions ) -> PaceOptResult<BTreeMap<String, Vec<ActivityItem>>>

Group activities based on keywords, e.g., category, tags, etc.

fn group_activities_by_kind( &self ) -> PaceOptResult<BTreeMap<ActivityKind, Vec<ActivityItem>>>

Group activities based on their kind (e.g., Task, Intermission).

fn list_activities_by_time_range( &self, time_range_opts: TimeRangeOptions ) -> PaceOptResult<Vec<ActivityGuid>>

List activities by time range from the storage backend.

fn group_activities_by_status( &self ) -> PaceOptResult<BTreeMap<ActivityStatus, Vec<ActivityItem>>>

Group activities by their status from the storage backend.

fn list_current_activities( &self, filter: ActivityFilterKind ) -> PaceOptResult<Vec<ActivityGuid>>

List all current activities from the storage backend matching an ActivityFilter.

fn list_active_intermissions(&self) -> PaceOptResult<Vec<ActivityGuid>>

List all active intermissions from the storage backend.

fn list_most_recent_activities( &self, count: usize ) -> PaceOptResult<Vec<ActivityGuid>>

List the most recent activities from the storage backend.

fn is_activity_active(&self, activity_id: ActivityGuid) -> PaceResult<bool>

Check if an activity is currently active.

fn list_intermissions_for_activity_id( &self, activity_id: ActivityGuid ) -> PaceOptResult<Vec<ActivityItem>>

List all intermissions for an activity id from the storage backend.

fn list_active_intermissions_for_activity_id( &self, activity_id: ActivityGuid ) -> PaceOptResult<Vec<ActivityGuid>>

Check if an activity currently has one or more active intermissions.

fn most_recent_held_activity(&self) -> PaceOptResult<ActivityItem>

Get the latest held activity.

impl ActivityReadOps for TomlActivityStorage

fn read_activity(&self, activity_id: ActivityGuid) -> PaceResult<ActivityItem>

Read an activity from the storage backend.

fn list_activities( &self, filter: ActivityFilterKind ) -> PaceOptResult<FilteredActivities>

List activities from the storage backend.

impl ActivityStateManagement for TomlActivityStorage

fn end_all_activities( &self, end_opts: EndOptions ) -> PaceOptResult<Vec<ActivityItem>>

End all activities in the storage backend.

fn end_last_unfinished_activity( &self, end_opts: EndOptions ) -> PaceOptResult<ActivityItem>

End the last unfinished activity in the storage backend.

fn end_activity( &self, activity_id: ActivityGuid, end_opts: EndOptions ) -> PaceResult<ActivityItem>

End an activity in the storage backend.

fn hold_most_recent_active_activity( &self, hold_opts: HoldOptions ) -> PaceOptResult<ActivityItem>

Hold the most recent activity that is active in the storage backend.

fn end_all_active_intermissions( &self, end_opts: EndOptions ) -> PaceOptResult<Vec<ActivityGuid>>

End all active intermissions in the storage backend.

fn resume_activity( &self, activity_id: ActivityGuid, resume_opts: ResumeOptions ) -> PaceResult<ActivityItem>

Resume an activity in the storage backend.

fn hold_activity( &self, activity_id: ActivityGuid, hold_opts: HoldOptions ) -> PaceResult<ActivityItem>

Hold an activity in the storage backend.

fn resume_most_recent_activity( &self, resume_opts: ResumeOptions ) -> PaceOptResult<ActivityItem>

Resume the most recent activity in the storage backend.

fn begin_activity(&self, activity: Activity) -> PaceResult<ActivityItem>

Begin an activity in the storage backend. This makes the activity active.

impl ActivityStorage for TomlActivityStorage

fn setup_storage(&self) -> PaceResult<()>

Setup the storage backend. This is called once when the application starts.

impl ActivityWriteOps for TomlActivityStorage

fn create_activity(&self, activity: Activity) -> PaceResult<ActivityItem>

Create an activity in the storage backend.

fn update_activity( &self, activity_id: ActivityGuid, updated_activity: Activity, update_opts: UpdateOptions ) -> PaceResult<ActivityItem>

Update an existing activity in the storage backend.

fn delete_activity( &self, activity_id: ActivityGuid, delete_opts: DeleteOptions ) -> PaceResult<ActivityItem>

Delete an activity from the storage backend.

impl From<TomlActivityStorage> for StorageKind

fn from(v: TomlActivityStorage) -> StorageKind

Converts to this type from the input type.

impl SyncStorage for TomlActivityStorage

fn sync(&self) -> PaceResult<()>

Sync the storage to a persistent medium.

impl TryInto<TomlActivityStorage> for StorageKind

type Error = &'static str

The type returned in the event of a conversion error.

fn try_into( self ) -> Result<TomlActivityStorage, <Self as TryInto<TomlActivityStorage>>::Error>

Performs the conversion.