Enum Properties

Add properties to Python enumeration values with a simple declarative syntax. Enum Properties is a lightweight extension to Python's Enum class. Example:

import typing as t
from enum_properties import EnumProperties
from enum import auto


class Color(EnumProperties):

    rgb: t.Tuple[int, int, int]
    hex: str

    # name   value      rgb       hex
    RED    = auto(), (1, 0, 0), 'ff0000'
    GREEN  = auto(), (0, 1, 0), '00ff00'
    BLUE   = auto(), (0, 0, 1), '0000ff'

# the type hints on the Enum class become properties on
# each value, matching the order in which they are specified


assert Color.RED.rgb   == (1, 0, 0)
assert Color.GREEN.rgb == (0, 1, 0)
assert Color.BLUE.rgb  == (0, 0, 1)

assert Color.RED.hex   == 'ff0000'
assert Color.GREEN.hex == '00ff00'
assert Color.BLUE.hex  == '0000ff'

Properties may also be symmetrically mapped to enumeration values using annotated type hints:

import typing as t
from enum_properties import EnumProperties, Symmetric
from enum import auto


class Color(EnumProperties):

    rgb: t.Annotated[t.Tuple[int, int, int], Symmetric()]
    hex: t.Annotated[str, Symmetric(case_fold=True)]

    RED    = auto(), (1, 0, 0), 'ff0000'
    GREEN  = auto(), (0, 1, 0), '00ff00'
    BLUE   = auto(), (0, 0, 1), '0000ff'

# Enumeration instances may be instantiated from any Symmetric property
# values. Use case_fold for case insensitive matching


assert Color((1, 0, 0)) is Color.RED
assert Color((0, 1, 0)) is Color.GREEN
assert Color((0, 0, 1)) is Color.BLUE

assert Color('ff0000') is Color.RED
assert Color('FF0000') is Color.RED  # case_fold makes mapping case insensitive
assert Color('00ff00') is Color.GREEN
assert Color('00FF00') is Color.GREEN
assert Color('0000ff') is Color.BLUE
assert Color('0000FF') is Color.BLUE

assert Color.RED.hex == 'ff0000'

Member functions may also be specialized to each enumeration value, using the @specialize decorator.

from enum_properties import EnumProperties as Enum, specialize


class SpecializedEnum(Enum):

    ONE   = 1
    TWO   = 2
    THREE = 3

    @specialize(ONE)
    def method(self):
        return 'method_one()'

    @specialize(TWO)
    def method(self):
        return 'method_two()'

    @specialize(THREE)
    def method(self):
        return 'method_three()'

assert SpecializedEnum.ONE.method() == 'method_one()'
assert SpecializedEnum.TWO.method() == 'method_two()'
assert SpecializedEnum.THREE.method() == 'method_three()'

Please report bugs and discuss features on the issues page.

Contributions are encouraged!

Full documentation at read the docs.

Installation

Clone enum-properties from GitHub or install a release off PyPI:

       pip install enum-properties

Metadata

Release files for enum-properties 2.8.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for enum-properties 2.8.2
File	Size	Uploaded
enum_properties-2.8.2.tar.gz	80.9 kB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for enum-properties 2.8.2
File	Interpreter	ABI	Platform	Reset
enum_properties-2.8.2-py3-none-any.whl 16.0 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 96.9 kB

Release files / enum_properties-2.8.2.tar.gz

Download URL	enum_properties-2.8.2.tar.gz
Size	80.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`c26e8f3f9bbd8d85a20e8cb69e6fcd454fad25f66eba3777042bce5443b5a1e9`
BLAKE2b-256 checksum How to use checksums	`0dd16b9b04c1c515223783cb41153005fb4d6796069c4d24196b0270967c0533`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bckohan/enum-properties
Publishing commit: github.com/bckohan/enum-properties/tree/97d4eb57e75639c4d4ea8d72b3a11cfea68a406d

Workflow

Publishing configuration: github.com/bckohan/enum-properties/blob/97d4eb57e75639c4d4ea8d72b3a11cfea68a406d/.github/workflows/release.yml
Publishing logs: github.com/bckohan/enum-properties/actions/runs/36668809152/attempts/1

Artifact

Subject: enum_properties-2.8.2.tar.gz
SHA-256 checksum: c26e8f3f9bbd8d85a20e8cb69e6fcd454fad25f66eba3777042bce5443b5a1e9 Verifying attestations

Release files / enum_properties-2.8.2-py3-none-any.whl

Download URL	enum_properties-2.8.2-py3-none-any.whl
Size	16.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`67eb39832936412a6056b1dc366e70ebfccb55426a3b9fba33a7f83e248b2ad7`
BLAKE2b-256 checksum How to use checksums	`998cea56faee7ea18306781b93693388fdd400b8ad7d68c484474fe8acf2eec6`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bckohan/enum-properties
Publishing commit: github.com/bckohan/enum-properties/tree/97d4eb57e75639c4d4ea8d72b3a11cfea68a406d

Workflow

Publishing configuration: github.com/bckohan/enum-properties/blob/97d4eb57e75639c4d4ea8d72b3a11cfea68a406d/.github/workflows/release.yml
Publishing logs: github.com/bckohan/enum-properties/actions/runs/36668809152/attempts/1

Artifact

Subject: enum_properties-2.8.2-py3-none-any.whl
SHA-256 checksum: 67eb39832936412a6056b1dc366e70ebfccb55426a3b9fba33a7f83e248b2ad7 Verifying attestations