Struct libsql::Builder

pub struct Builder<T = ()> { /* private fields */ }

A builder for Database. This struct can be used to build all variants of Database. These variants include:

• new_local/Local which means a Database that is just a local libsql database it does no networking and does not connect to any remote database.
• new_remote_replica/RemoteReplica creates an embedded replica database that will be able to sync from the remote url and delegate writes to the remote primary.
• new_local_replica/LocalReplica creates an embedded replica similar to the remote version except you must use Database::sync_frames to sync with the remote. This version also includes the ability to delegate writes to a remote primary.
• new_remote/Remote creates a database that does not create anything locally but will instead run all queries on the remote database. This is essentially the pure HTTP api.

Note

Embedded replica’s require a clean database (no database file) or a previously synced database or else it will throw an error to prevent any misuse. To work around this error a user can delete the database and let it resync and create the wal_index metadata file.

Implementations

impl Builder<()>

pub fn new_local(path: impl AsRef<Path>) -> Builder<Local>

Available on crate feature core only.

Create a new local database.

pub fn new_remote_replica( path: impl AsRef<Path>, url: String, auth_token: String ) -> Builder<RemoteReplica>

Available on crate feature replication only.

Create a new remote embedded replica.

pub fn new_local_replica(path: impl AsRef<Path>) -> Builder<LocalReplica>

Available on crate feature replication only.

Create a new local replica.

pub fn new_remote(url: String, auth_token: String) -> Builder<Remote>

Available on crate feature remote only.

Create a new remote database.

impl Builder<Local>

pub fn flags(self, flags: OpenFlags) -> Builder<Local>

Available on crate feature core only.

Set [OpenFlags] for this database.

pub fn encryption_config( self, encryption_config: EncryptionConfig ) -> Builder<Local>

Available on crate feature core only.

Set an encryption config that will encrypt the local database.

pub async fn build(self) -> Result<Database>

Available on crate feature core only.

Build the local database.

impl Builder<RemoteReplica>

pub fn connector<C>(self, connector: C) -> Builder<RemoteReplica>

where C: Service<Uri> + Send + Clone + Sync + 'static, C::Response: Socket, C::Future: Send + 'static, C::Error: Into<Box<dyn Error + Send + Sync>>,

Available on crate feature replication only.

Provide a custom http connector that will be used to create http connections.

pub fn encryption_config( self, encryption_config: EncryptionConfig ) -> Builder<RemoteReplica>

Available on crate feature replication only.

Set an encryption key that will encrypt the local database.

pub fn read_your_writes(self, read_your_writes: bool) -> Builder<RemoteReplica>

Available on crate feature replication only.

Set weather you want writes to be visible locally before the write query returns. This means that you will be able to read your own writes if this is set to true.

Default

This defaults to true.

pub fn sync_interval(self, duration: Duration) -> Builder<RemoteReplica>

Available on crate feature replication only.

Set the duration at which the replicator will automatically call sync in the background. The sync will continue for the duration that the resulted Database type is alive for, once it is dropped the background task will get dropped and stop.

pub fn http_request_callback<F>(self, f: F) -> Builder<RemoteReplica>

where F: Fn(&mut Request<()>) + Send + Sync + 'static,

Available on crate feature replication only.

pub async fn build(self) -> Result<Database>

Available on crate feature replication only.

Build the remote embedded replica database.

impl Builder<LocalReplica>

pub fn flags(self, flags: OpenFlags) -> Builder<LocalReplica>

Available on crate feature replication only.

Set [OpenFlags] for this database.

pub fn http_request_callback<F>(self, f: F) -> Builder<LocalReplica>

where F: Fn(&mut Request<()>) + Send + Sync + 'static,

Available on crate feature replication only.

pub async fn build(self) -> Result<Database>

Available on crate feature replication only.

Build the local embedded replica database.

impl Builder<Remote>

pub fn connector<C>(self, connector: C) -> Builder<Remote>

where C: Service<Uri> + Send + Clone + Sync + 'static, C::Response: Socket, C::Future: Send + 'static, C::Error: Into<Box<dyn Error + Send + Sync>>,

Available on crate feature remote only.

Provide a custom http connector that will be used to create http connections.

pub async fn build(self) -> Result<Database>

Available on crate feature remote only.

Build the remote database client.