sqlite-containers 2.0.0

SQLite-based containers for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

SQLite-based containers for Rust
================================

![SQLite-based containers for Rust](https://raw.githubusercontent.com/danieltrick/sqlite-containers/refs/heads/main/etc/images/sqlite-containers-small.png)

[**`sqlite-containers`**](https://github.com/danieltrick/sqlite-containers) provides [*map*](https://en.wikipedia.org/wiki/Associative_array) and [*set*](https://en.wikipedia.org/wiki/Set_(abstract_data_type)) implementations that are backed by **SQLite** [in-memory](https://www.sqlite.org/inmemorydb.html) databases. It is designed as a drop-in replacement for [`HashMap`](std::collections::HashMap) and [`HashSet`](std::collections::HashSet). Leveraging the power of the SQLite engine, [`SQLiteMap`](https://docs.rs/sqlite-containers/latest/sqlite_containers/struct.SQLiteMap.html) and [`SQLiteSet`](https://docs.rs/sqlite-containers/latest/sqlite_containers/struct.SQLiteSet.html) efficiently store billions of elements!


Quick Start
-----------

This example demonstrates how to use **`SQLiteSet`**:

```rust
use sqlite_containers::SQLiteSet;
type SQLiteStringSet = SQLiteSet<String>;

let mut sqlite_set = SQLiteStringSet::new().unwrap();
let mut tx = sqlite_set.transaction().unwrap();

println!("Inserting elements, please wait...");

for n in 0..1_000_000u64 {
    tx.insert(&format!("{:016X}", n)).unwrap();
}

tx.commit();
println!("{} elements.", sqlite_set.len().unwrap());
```


Acknowledgement
---------------

This project is based on [**SQLite**](https://www.sqlite.org/) and the [**Rusqlite**](https://crates.io/crates/rusqlite) wrapper &#128571;

SQLite’s code and documentation are dedicated to the [public domain](https://sqlite.org/copyright.html).

Rusqlite is available under the MIT license.


License
-------

“SQLite-based Containers for Rust” is published under the [Unlicense](<https://unlicense.org/>).

∎