jangada.mixin.Nameable.name

Nameable.name: str

Human-readable display name.

A string for labeling and display purposes. Less restrictive than tags - can contain spaces, special characters, and Unicode. Intended for user-facing contexts like UI labels, reports, and logs.

See also

Taggable.tag

Symbolic identifier for namespace access

Describable.description

Extended description text

Notes

Use names for display and human consumption. For programmatic identifiers that work in attribute access, use tags from Taggable.

Names are mutable and have no uniqueness constraints. Very long names may need truncation for display purposes.

Examples

Basic usage:

obj.name = "Temperature Sensor"
obj.name = "Sensor #1 (Main)"
obj.name = "Test-Case-A"

Unicode support:

obj.name = "Tëst Nämé"
obj.name = "测试名称"
obj.name = "📊 Data Dashboard"

Normalization:

obj.name = "  Name  "
assert obj.name == "Name"

obj.name = "   "
assert obj.name is None

obj.name = ""
assert obj.name is None

Type conversion:

obj.name = 123
assert obj.name == "123"