Struct libsql_client::workers::Client

pub struct Client {
    pub inner: ClientInner,
}

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

Fields

inner: ClientInner

Implementations

impl Client

pub async fn new( url: impl Into<String>, token: impl Into<String> ) -> Result<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

Trait Implementations

impl DatabaseClient for Client

fn raw_batch<'life0, 'async_trait>( &'life0 self, stmts: impl 'async_trait + IntoIterator<Item = impl 'async_trait + Into<Statement>> ) -> Pin<Box<dyn Future<Output = Result<BatchResult>> + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait,

Executes a batch of SQL statements. Each statement is going to run in its own transaction, unless they’re wrapped in BEGIN and END

fn execute<'life0, 'async_trait>( &'life0 self, stmt: impl 'async_trait + Into<Statement> ) -> Pin<Box<dyn Future<Output = Result<ResultSet>> + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait,

Executes a single SQL statement

fn batch<'life0, 'async_trait>( &'life0 self, stmts: impl 'async_trait + IntoIterator<Item = impl 'async_trait + Into<Statement>> ) -> Pin<Box<dyn Future<Output = Result<Vec<ResultSet>>> + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait,

Executes a batch of SQL statements, wrapped in “BEGIN”, “END”, transaction-style. Each statement is going to run in its own transaction, unless they’re wrapped in BEGIN and END

fn transaction<'a, 'async_trait>( &'a self ) -> Pin<Box<dyn Future<Output = Result<Transaction<'a, Self>>> + 'async_trait>>where Self: 'async_trait, 'a: 'async_trait,

Starts an interactive transaction and returns a Transaction object. The object can be later used to execute(), commit() or rollback() the interactive transaction.

fn execute_in_transaction<'life0, 'async_trait>( &'life0 self, _tx_id: u64, stmt: Statement ) -> Pin<Box<dyn Future<Output = Result<ResultSet>> + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait,

fn commit_transaction<'life0, 'async_trait>( &'life0 self, _tx_id: u64 ) -> Pin<Box<dyn Future<Output = Result<()>> + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait,

fn rollback_transaction<'life0, 'async_trait>( &'life0 self, _tx_id: u64 ) -> Pin<Box<dyn Future<Output = Result<()>> + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait,

impl Debug for Client

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

Formats the value using the given formatter.