https://github.com/stainless-steel/sqlite

Interface to SQLite
https://github.com/stainless-steel/sqlite

bindings database

Last synced: 3 months ago
JSON representation

Interface to SQLite

• Host: GitHub
• URL: https://github.com/stainless-steel/sqlite
• Owner: stainless-steel
• License: other
• Created: 2015-05-28T21:22:19.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2024-04-25T07:22:50.000Z (7 months ago)
• Last Synced: 2024-04-25T13:46:47.567Z (7 months ago)
• Topics: bindings, database
• Language: Rust
• Homepage:
• Size: 449 KB
• Stars: 216
• Watchers: 5
• Forks: 45
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# SQLite [![Package][package-img]][package-url] [![Documentation][documentation-img]][documentation-url] [![Build][build-img]][build-url]

The package provides an interface to [SQLite].

## Example

Open a connection, create a table, and insert a few rows:

```rust

let connection = sqlite::open(":memory:").unwrap();

let query = "

    CREATE TABLE users (name TEXT, age INTEGER);

    INSERT INTO users VALUES ('Alice', 42);

    INSERT INTO users VALUES ('Bob', 69);

";

connection.execute(query).unwrap();

```

Select some rows and process them one by one as plain text, which is generally

not efficient:

```rust

let query = "SELECT * FROM users WHERE age > 50";

connection

    .iterate(query, |pairs| {

        for &(name, value) in pairs.iter() {

            println!("{} = {}", name, value.unwrap());

        }

        true

    })

    .unwrap();

```

Run the same query but using a prepared statement, which is much more efficient

than the previous technique:

```rust

use sqlite::State;

let query = "SELECT * FROM users WHERE age > ?";

let mut statement = connection.prepare(query).unwrap();

statement.bind((1, 50)).unwrap();

while let Ok(State::Row) = statement.next() {

    println!("name = {}", statement.read::("name").unwrap());

    println!("age = {}", statement.read::("age").unwrap());

}

```

Run the same query but using a cursor, which is iterable:

```rust

let query = "SELECT * FROM users WHERE age > ?";

for row in connection

    .prepare(query)

    .unwrap()

    .into_iter()

    .bind((1, 50))

    .unwrap()

    .map(|row| row.unwrap())

{

    println!("name = {}", row.read::<&str, _>("name"));

    println!("age = {}", row.read::("age"));

}

```

## Contribution

Your contribution is highly appreciated. Do not hesitate to open an issue or a

pull request. Note that any contribution submitted for inclusion in the project

will be licensed according to the terms given in [LICENSE.md](LICENSE.md).

[SQLite]: https://www.sqlite.org

[build-img]: https://github.com/stainless-steel/sqlite/workflows/build/badge.svg

[build-url]: https://github.com/stainless-steel/sqlite/actions/workflows/build.yml

[documentation-img]: https://docs.rs/sqlite/badge.svg

[documentation-url]: https://docs.rs/sqlite

[package-img]: https://img.shields.io/crates/v/sqlite.svg

[package-url]: https://crates.io/crates/sqlite