diesel-ulid

Crates.iodiesel-ulid
lib.rsdiesel-ulid
version0.3.2
sourcesrc
created_at2023-04-13 14:03:50.704337
updated_at2024-07-09 09:54:15.128792
descriptionDiesel-rs & tokio_postgres adapter for Ulid (rusty-ulid) to Postgres UUIDs
homepage
repositoryhttps://github.com/ArunaStorage/diesel-ulid
max_upload_size
id838328
size33,331
Sebastian Beyvers (St4NNi)

documentation

README

Rust License CI Codecov docs.rs Dependency status Safety Dance


diesel-ulid

Ulid mapping for diesel-rs and . This crate contains custom mapping for the Ulid implementation from rusty-ulid to diesel::sql_types::Uuid. With this adapter you can use these types in Diesel and tokio_postgres as regular Postgres UUID type.

Import

cargo add diesel-ulid

or add:

diesel-ulid = 0.3.1

to your Cargo.toml. While this crate was iniated for diesel-rs it can also be used with the rust-postgres driver. You can use the postgres or diesel feature to enable the corresponding adapter.

Usage

This is an adaptation of the Getting started section from diesel-rs.

Assuming you have the following schema.rs file:


diesel::table! {
    posts (id) {
        id -> Uuid,
        title -> Varchar,
        body -> Text,
        published -> Bool,
    }
}

you could use diesel-ulid as follows:

use diesel::prelude::*;
use diesel_ulid::DieselUlid as Ulid;

#[derive(Queryable)]
pub struct Post {
    pub id: Ulid,
    pub title: String,
    pub body: String,
    pub published: bool,
}

The Postgres UUID will be automatically mapped to a corresponding Ulid and vice-versa. This works because UUID and Ulid are both represented as 16 byte (128 bit) data struct.

License

Licensed under either of

at your option.

Licensing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 42

cargo fmt