Skip to content

Uuid utils

concat_ids(*ids)

Concatenate multiple ID components.

Parameters:

Name Type Description Default
*ids

ID components to concatenate

 ()

Returns:

Type Description
str

Concatenated ID string
Source code in blue/utils/uuid_utils.py 
66
67
68
69
70
71
72
73
74
75
def concat_ids(*ids):
    """Concatenate multiple ID components.

    Parameters:
        *ids: ID components to concatenate

    Returns:
        (str): Concatenated ID string
    """
    return Separator.ID.join(ids)

create_uuid()

Create a unique identifier.

Returns:

Type Description
str

Unique identifier string
Source code in blue/utils/uuid_utils.py 
 6
 7
 8
 9
10
11
12
def create_uuid():
    """Create a unique identifier.

    Returns:
        (str): Unique identifier string
    """
    return str(hex(uuid.uuid4().fields[0]))[2:]

extract_name_id(canonical_id)

Extract the name and ID from a canonical ID.

Parameters:

Name Type Description Default
canonical_id str

Canonical ID string

 required

Returns:

Type Description
(str, str)

Tuple of (name, ID)
Source code in blue/utils/uuid_utils.py 
39
40
41
42
43
44
45
46
47
48
def extract_name_id(canonical_id):
    """Extract the name and ID from a canonical ID.

    Parameters:
        canonical_id (str): Canonical ID string

    Returns:
        ((str, str)): Tuple of (name, ID)
    """
    return split_ids(canonical_id)[-2:]

extract_prefix(canonical_id)

Extract the prefix from a canonical ID.

Parameters:

Name Type Description Default
canonical_id str

Canonical ID string

 required

Returns:

Type Description
str

Prefix string or None if not available
Source code in blue/utils/uuid_utils.py 
51
52
53
54
55
56
57
58
59
60
61
62
63
def extract_prefix(canonical_id):
    """Extract the prefix from a canonical ID.

    Parameters:
        canonical_id (str): Canonical ID string

    Returns:
        (str): Prefix string or None if not available
    """
    splits = split_ids(canonical_id)
    if len(splits) > 2:
        return Separator.ID.join(splits[:-2])
    return None

extract_sid(canonical_id)

Extract the SID (short ID) from a canonical ID.

Parameters:

Name Type Description Default
canonical_id str

Canonical ID string

 required

Returns:

Type Description
str

SID string
Source code in blue/utils/uuid_utils.py 
27
28
29
30
31
32
33
34
35
36
def extract_sid(canonical_id):
    """Extract the SID (short ID) from a canonical ID.

    Parameters:
        canonical_id (str): Canonical ID string

    Returns:
        (str): SID string
    """
    return Separator.ID.join(extract_name_id(canonical_id))

split_ids(canonical_id)

Split a canonical id into its components.

Parameters:

Name Type Description Default
canonical_id str

Canonical ID string

 required

Returns:

Type Description
list[str]

List of ID components
Source code in blue/utils/uuid_utils.py 
15
16
17
18
19
20
21
22
23
24
def split_ids(canonical_id):
    """Split a canonical id into its components.

    Parameters:
        canonical_id (str): Canonical ID string

    Returns:
        (list[str]): List of ID components
    """
    return canonical_id.split(Separator.ID)
Last update: 2025-10-05