generate_unique_label

generate_unique_label(arg)

Generate unique hash-based labels.

Convenience function that calls generate_label with unique_id=True. Useful for automatically generating deterministic labels without manual naming.

Parameters

Name Type Description Default
arg str | dict[Hashable, Any] Label input (str or dict) required

Returns

Name Type Description
str | dict[Hashable, str] Formatted label(s) with unique hash-based identifiers

Examples

from keecas import symbols, generate_unique_label

# String label
label = generate_unique_label("my-key")
label.startswith("eq-")  # Returns: True
True
# Dict label with subscripted symbols
F, A_load = symbols(r"F, A_{load}")
labels = generate_unique_label({F: "force", A_load: "area"})
all(v.startswith("eq-") for v in labels.values())  # Returns: True
True
# Can be used with partial functions
from functools import partial
auto_labeler = partial(generate_unique_label)
auto_labeler("test")  # Returns: 'eq-...' (hash-based ID)
'eq-2d1au1zm'

See Also

Notes

  • Generates deterministic hash-based IDs
  • Same input always produces same ID
  • Useful for automatic label generation in Dataframes