tagid 1.2.0

Defines a newtype labeled tagging for different types of ids.
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
48
49
50
51
52
53
54

//! Basic ID Generation with Provenance.
//!
//! This example shows how to use `Generated` provenance for IDs created
//! internally by your application.

use tagid::{
    Entity, Id, Label, MakeLabeling, Sourced,
    id::{Generated, strategies},
};

// Define an entity type.
#[allow(dead_code)]
struct User;

impl Label for User {
    type Labeler = MakeLabeling<Self>;
    fn labeler() -> Self::Labeler {
        MakeLabeling::default()
    }
}

// Implement Entity to enable ID generation.
// Note: Requires "uuid" feature for UuidGenerator.
#[cfg(feature = "uuid")]
impl Entity for User {
    type IdGen = tagid::UuidGenerator;
}

#[cfg(feature = "uuid")]
type UserId = Id<Sourced<User, Generated<strategies::UuidV7>>, ::uuid::Uuid>;

fn main() {
    #[cfg(feature = "uuid")]
    {
        // Generate a new ID.
        let user_id = UserId::new();

        // Canonical display (always label-free)
        println!("Canonical ID: {}", user_id);

        // Human-facing labeled display (respects LabelPolicy::EntityNameDefault)
        // For Generated sources, this defaults to Short mode: "Entity::value"
        println!("Labeled (default): {}", user_id.labeled());

        // Explicitly request Full mode: "Entity@provenance::value"
        println!(
            "Labeled (full):    {}",
            user_id.labeled().mode(tagid::LabelMode::Full)
        );
    }

    #[cfg(not(feature = "uuid"))]
    println!("This example requires the 'uuid' feature.");
}