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.4

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.4
File	Size	Uploaded
enum_properties-2.8.4.tar.gz	81.1 kB	Oct 1, 2026	Details

Built distribution (wheel)

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

Total release size: 97.1 kB

Release files / enum_properties-2.8.4.tar.gz

Download URL	enum_properties-2.8.4.tar.gz
Size	81.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`de4227566935bb172ee6f5e249b793d0e8f116e7288218992e0413fee561a98a`
BLAKE2b-256 checksum How to use checksums	`a8e810811baf98c58de6f5e133da5d7706f9065ee38ee39fb3c3506b01293e9e`
Upload date	Oct 1, 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/ac606c0ea90be961a84055074140049b1997c3ad

Workflow

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

Artifact

Subject: enum_properties-2.8.4.tar.gz
SHA-256 checksum: de4227566935bb172ee6f5e249b793d0e8f116e7288218992e0413fee561a98a Verifying attestations

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

Download URL	enum_properties-2.8.4-py3-none-any.whl
Size	16.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`100811215819f5e28d7639180fc4378d8ed7d0ef8b86344e1aa504e35c67f017`
BLAKE2b-256 checksum How to use checksums	`9648cc3a7616d74bc69e7ad11e90bf3e48cb1feb2da62ed635c935db3949a8fe`
Upload date	Oct 1, 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/ac606c0ea90be961a84055074140049b1997c3ad

Workflow

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

Artifact

Subject: enum_properties-2.8.4-py3-none-any.whl
SHA-256 checksum: 100811215819f5e28d7639180fc4378d8ed7d0ef8b86344e1aa504e35c67f017 Verifying attestations