Struct libqaul::Qaul

pub struct Qaul { /* fields omitted */ }

Primary context structure for libqaul

Handles user state, secret storage, network state, I/O and services. Check api for the extended service API

Bootstrapping

Starting an instance of libqaul requires several steps. For one, it needs to be initialised with a valid config for the routing-layer (RATMAN). This requires choosing of network backends and client configuration.

Secondly, libqaul by itself does very little, except handle service requests. The service API exposes various workloads available, but the consuming services also need to be configured, externally to libqaul and this instance.

A bootstrapping procedure should thus look as follows:

1. RATMAN + netmod initialisation
2. libqaul startup (this struct, call new(...))
3. Initialise services with a libqaul instance reference
4. Your application is now ready for use

Implementations

impl Qaul

pub fn new(router: Arc<Router>) -> QaulRef

Create new qaul context, with pre-initialised Router

This function sets up discovery and API handler threads, as well as local storage. Stopping a qaul instance is currently not possible (woops). This call is non-blocking and assumes that the main thread will take over execution of some other application loop so to enable further API abstractions to hook into the service API.

pub fn messages(&self) -> Messages<'_>

Get messages function scope

pub fn users(&self) -> Users<'_>

Get users function scope

pub fn contacts(&self) -> Contacts<'_>

Get contact book function scope

pub fn services(&self) -> Services<'_>

Get service management function scope

Trait Implementations

impl Clone for Qaul

fn clone(&self) -> Qaul

Returns a copy of the value.

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

Performs copy-assignment from source.