119 releases (31 breaking)

0.33.4 Jan 25, 2024
0.33.2 Nov 24, 2023
0.31.8 Jul 11, 2023
0.16.2 Mar 31, 2023

#91 in HTTP client

Download history 119/week @ 2024-07-15 178/week @ 2024-07-22 149/week @ 2024-07-29 245/week @ 2024-08-05 109/week @ 2024-08-12 89/week @ 2024-08-19 101/week @ 2024-08-26 54/week @ 2024-09-02 96/week @ 2024-09-09 105/week @ 2024-09-16 347/week @ 2024-09-23 84/week @ 2024-09-30 90/week @ 2024-10-07 49/week @ 2024-10-14 35/week @ 2024-10-21 42/week @ 2024-10-28

220 downloads per month
Used in 2 crates

Apache-2.0

77KB
1.5K SLoC

Rust libSQL client library

libSQL Rust client library can be used to communicate with sqld natively over HTTP protocol with native Rust interface.

At the moment the library works with the following backends:

  • local
  • reqwest
  • hrana
  • Cloudflare Workers environment (optional)

Quickstart

In order to use the database in your project, just call libsql_client::Client::from_env(), or any of the other constructors:

let db = libsql_client::Client::from_env().await?;

The only thing you need to provide is an env variable with the database URL, e.g.

export LIBSQL_CLIENT_URL="file:////tmp/example.db"

for a local database stored in a file, or

export LIBSQL_CLIENT_URL="https://example.turso.io"

for a remote database connection.

You can also explicitly use a specific backend. Examples of that are covered in the next paragraphs.

Local

In order to connect to the database, set up the URL to point to a local path:

export LIBSQL_CLIENT_URL = "/tmp/example.db"

local_backend feature is enabled by default, so add the dependency like this:

cargo add libsql-client

Example for how to connect to the database and perform a query:

    let db = libsql_client::local::Client::from_env()?;
    let response = db
        .execute("SELECT * FROM table WHERE key = 'key1'")
        .await?;
    (...)

Cloudflare Workers

In order to connect to the database, set up the following variables in .dev.vars, or register them as secrets:

LIBSQL_CLIENT_URL = "https://your-db-url.example.com"
LIBSQL_CLIENT_TOKEN = "<your-jwt>"

Add it as dependency with workers_backend backend enabled. Turn off default features, as they are not guaranteed to compile to wasm32-unknown-unknown, which is required in this environment:

cargo add libsql-client --no-default-features -F workers_backend

Example for how to connect to the database and perform a query from a GET handler:

router.get_async("/", |_, ctx| async move {
    let db = libsql_client::workers::Client::from_ctx(&ctx).await?;
    let response = db
        .execute("SELECT * FROM table WHERE key = 'key1'")
        .await?;
    (...)

Dependencies

~6–20MB
~312K SLoC