Struct libsql_client::workers::Client

pub struct Client { /* private fields */ }

Database client. This is the main structure used to communicate with the database.

Implementations

impl Client

pub fn new(url: impl Into<String>, token: impl Into<String>) -> Self

Creates a database client with JWT authentication.

Arguments

• url - URL of the database endpoint
• token - auth token

pub async fn from_config(config: Config) -> Result<Self>

Creates a database client from a Config object.

pub async fn from_url<T: TryInto<Url>>(url: T) -> Result<Client>where <T as TryInto<Url>>::Error: Display,

Creates a database client, given a Url

Arguments

• url - Url object of the database endpoint. This cannot be a relative URL;

Examples

use url::Url;

let url  = Url::parse("https://foo:bar@localhost:8080").unwrap();
let db = Client::from_url(url).unwrap();

pub async fn from_ctx<D>(ctx: &RouteContext<D>) -> Result<Self>

Establishes a database client from Cloudflare Workers context. Expects the context to contain the following secrets defined:

• LIBSQL_CLIENT_URL
• LIBSQL_CLIENT_USER
• LIBSQL_CLIENT_PASS

Arguments

• ctx - Cloudflare Workers route context

impl Client

pub async fn raw_batch( &self, stmts: impl IntoIterator<Item = impl Into<Statement>> ) -> Result<BatchResult>

pub async fn execute(&self, stmt: impl Into<Statement>) -> Result<ResultSet>

pub async fn execute_in_transaction( &self, tx_id: u64, stmt: Statement ) -> Result<ResultSet>

pub async fn commit_transaction(&self, tx_id: u64) -> Result<()>

pub async fn rollback_transaction(&self, tx_id: u64) -> Result<()>

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.