Struct libsql_client::reqwest::Connection

pub struct Connection { /* private fields */ }

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

Implementations

impl Connection

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

Establishes a database connection with JWT authentication.

Arguments

• url - URL of the database endpoint
• username - database username
• pass - user’s password

pub fn connect_with_credentials( url: impl Into<String>, username: impl Into<String>, pass: impl Into<String> ) -> Self

Establishes a database connection with Basic HTTP authentication.

Arguments

• url - URL of the database endpoint
• username - database username
• pass - user’s password

pub fn connect_from_url(url: &Url) -> Result<Connection>

Establishes a database connection, 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 = Connection::connect_from_url(&url).unwrap();

pub fn connect_from_env() -> Result<Connection>

Trait Implementations

impl Clone for Connection

fn clone(&self) -> Connection

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Connection for Connection

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<QueryResult>>> + '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<QueryResult>> + 'async_trait>>where Self: 'async_trait, 'life0: 'async_trait,

Executes a single SQL statement

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

Executes an SQL transaction. Does not support nested transactions - do not use BEGIN or END inside a transaction.

impl Debug for Connection

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

Formats the value using the given formatter.