Struct libhealth::core::Database

pub struct Database { /* private fields */ }

Helper class to add and retrieve data to and from the Tracker Database.

Implementations

impl Database

pub fn connect_activities_updated<F: Fn(&Self) + 'static>( &self, callback: F ) -> SignalHandlerId

Connect to the activities-updated signal.

Arguments

• callback - The callback which should be invoked when activities-update is emitted.

Returns

A glib::SignalHandlerId that can be used for disconnecting the signal if so desired.

pub fn connect_weights_updated<F: Fn(&Self) + 'static>( &self, callback: F ) -> SignalHandlerId

Connect to the weights-updated signal.

Arguments

• callback - The callback which should be invoked when weights-update is emitted.

Returns

A glib::SignalHandlerId that can be used for disconnecting the signal if so desired.

pub fn connect_user_updated<F: Fn(&Self) + 'static>( &self, callback: F ) -> SignalHandlerId

Connect to the user-updated signal.

Arguments

• callback - The callback which should be invoked when user-update is emitted.

Returns

A glib::SignalHandlerId that can be used for disconnecting the signal if so desired.

pub fn connect_version_updated<F: Fn(&Self) + 'static>( &self, callback: F ) -> SignalHandlerId

Connect to the version-updated signal.

Arguments

• callback - The callback which should be invoked when version-update is emitted.

Returns

A glib::SignalHandlerId that can be used for disconnecting the signal if so desired.

pub fn load_statement_from_gresource(&self, name: &str) -> SparqlStatement

pub async fn activities(&self) -> Result<Vec<Activity>>

Get activities.

Returns

An array of Activitys, or a glib::Error if querying the DB goes wrong.

pub async fn activities_min(&self, date_min: DateTime) -> Result<Vec<Activity>>

Get activities.

Arguments

• date_opt - If Some, only get activities that are more recent than date_opt.

Returns

An array of Activitys that are within the given timeframe (if set), or a glib::Error if querying the DB goes wrong.

pub async fn activities_min_max( &self, date_min: DateTime, date_max: DateTime ) -> Result<Vec<Activity>>

Get activities.

Arguments

• date_opt - If Some, only get activities that are more recent than date_opt.

Returns

An array of Activitys that are within the given timeframe (if set), or a glib::Error if querying the DB goes wrong.

pub async fn calories(&self, minimum_date: DateTime) -> Result<Vec<SplitBar>>

Get calories.

Arguments

• minimum_date - Only get calorie data (in SplitBar format) that are more recent than minimum_date.

Returns

An array of SplitBars that are within the given timeframe or a glib::Error if querying the DB goes wrong.

pub async fn most_frequent_activities( &self, minimum_date: DateTime ) -> Result<Vec<ActivityType>>

Get activities.

Arguments

• minimum_date - most frequent activities in desc order: on or after aminimum_date.

Returns

An array of most frequent ActivityTypes that are within the given timeframe, or a glib::Error if querying the DB goes wrong.

pub async fn has_activities(&self) -> Result<bool>

pub fn instance() -> Self

pub async fn steps(&self, date: DateTime) -> Result<Vec<Steps>>

Get steps.

Arguments

• date_opt - If Some, only get steps that are more recent than date_opt.

Returns

An array of Stepss that are within the given timeframe (if set), or a glib::Error if querying the DB goes wrong.

pub async fn todays_steps(&self) -> Result<i64>

Get today’s steps.

Returns

An array of Stepss that are within the given timeframe (if set), or a glib::Error if querying the DB goes wrong.

pub async fn weights(&self, date_opt: Option<DateTime>) -> Result<Vec<Weight>>

Get weights.

Arguments

• date_opt - If Some, only get weights that are more recent than date_opt

Returns

An array of Weights that are within the given timeframe (if set), or a glib::Error if querying the DB goes wrong.

pub async fn weight_exists_on_date(&self, date: DateTime) -> Result<bool>

Check if a Weight exists on a given date

Arguments

• date - The date which should be checked

Returns

True if a Weight exists on the date, or glib::Error if querying the DB goes wrong.

pub async fn import_steps(&self, steps: &[Steps]) -> Result<()>

Import an array of Steps into the DB (e.g. when doing the initial sync with a sync provider)

Arguments

• steps - An array of steps to add to the DB.

Returns

An error if querying the DB goes wrong.

pub async fn import_weights(&self, weights: &[Weight]) -> Result<()>

Import an array of Weight into the DB (e.g. when doing the initial sync with a sync provider)

Arguments

• weight - An array of weight to add to the DB.

Returns

An error if querying the DB goes wrong.

pub async fn user(&self, user_id: i64) -> Result<User>

Get user with a particular user ID.

Arguments

• id - Get a user with the particular user ID.

Returns

An array of Users or a User with a particular user ID, or a glib::Error if querying the DB goes wrong.

pub async fn users(&self) -> Result<Vec<User>>

Get users.

Arguments

• id_opt - If Some, only get a user with the particular user ID.

Returns

An array of Users or a User with a particular user ID, or a glib::Error if querying the DB goes wrong.

pub async fn get_top_unused_user_id(&self) -> Result<i64>

Get top unused user ID.

Returns

An integer with the top unused user ID to assign to the new users, or a glib::Error if querying the DB goes wrong.

pub async fn has_users(&self) -> Result<bool>

Check if the users’ model exists.

Returns

A boolean after checking if the user schema exists in the database, or a glib::Error if querying the DB goes wrong.

pub async fn update_user(&self, user: User) -> Result<()>

Update User.

Returns

A boolean after checking if the user schema exists in the database, or a glib::Error if querying the DB goes wrong.

pub async fn get_version(&self) -> Result<i64>

Get the current version of the database.

Returns

An integer denoting the current Database Version, or a glib::Error if querying the DB goes wrong.

pub async fn update_version(&self) -> Result<()>

Update the database version.

Returns

An error if querying the DB goes wrong.

pub async fn has_version(&self) -> Result<bool>

Check if the version exists.

Returns

A boolean if the Version schema exists in the Database, or a glib::Error if querying the DB goes wrong.

pub async fn create_version(&self) -> Result<()>

Create a database Version for handling migration.

Returns

An error if querying the DB goes wrong.

pub async fn migrate(&self) -> Result<()>

Migrate from an older DB version to a newer one. The migration is one-way (as in you can’t switch back to older versions). This can be called multiple times without problems, the migration just won’t do anything afterwards. A DB_VERSION is set to a particular integer depicting the current version of the DB. If the version is less than the set DB_VERSION, we do the migration. Note: Currently, we just care about adding the version so an if-else statement seems fine, but later on we should change it to a switch statement.

Returns

An error if querying the DB goes wrong.

pub async fn migrate_activities_date_datetime(&self) -> Result<()>

Migrate Activitys from xsd:date to xsd:dateTime. This will set all entries where a date is set to the date at 00:00:00 at the local datetime.

Returns

Am error if querying the DB goes wrong.

pub async fn migrate_weight_date_datetime(&self) -> Result<()>

Migrate Weights from date to dateTime. This will set all entries where a date is set to the date at 00:00:00 at the local datetime.

Returns

An error if querying the DB goes wrong.

pub async fn migrate_user_to_database(&self) -> Result<()>

Migrate Users to the database. This will create an initial user from the GSettings file.

Returns

An error if querying the DB goes wrong.

pub async fn migrate_activity_user_id(&self) -> Result<()>

Migrate Activitys to add a user ID. This will add an initial user ID of 1 to each activity entries..

Returns

An error if querying the DB goes wrong.

pub async fn migrate_weight_user_id(&self) -> Result<()>

Migrate Weights to add a user ID. This will add an initial user ID of 1 to each weight entries..

Returns

An error if querying the DB goes wrong.

pub async fn reset(&self) -> Result<()>

Reset the DB (as in delete all entries in it).

Returns

Returns an error if querying the DB goes wrong.

pub async fn save_activity(&self, activity: Activity) -> Result<()>

Save an Activity to the database.

Arguments

• activity - The Activity which should be saved.

Returns

An error if querying the DB goes wrong.

pub async fn save_weight(&self, weight: Weight) -> Result<()>

Save a Weight to the database.

Arguments

• weight - The Weight which should be saved.

Returns

An error if querying the DB goes wrong.

pub async fn create_user(&self, user: User) -> Result<()>

Save a User to the database.

Arguments

• user - The User which should be saved.

Returns

An error if querying the DB goes wrong.

Trait Implementations

impl Clone for Database

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Database

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Database

fn default() -> Self

Returns the “default value” for a type.

impl HasParamSpec for Database

type ParamSpec = ParamSpecObject

type SetValue = Database

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, Database>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for Database

fn hash<H>(&self, state: &mut H)where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl ObjectSubclassIs for Database

type Subclass = Database

impl Ord for Database

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for Database

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for Database

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for Database

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Database

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Database