Skip to content

ArunaStorage/diesel-ulid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.