Change Log

v2.7.0 (2026-03-04)

• Implemented Make @symmetric a property if it wraps a plain function.

v2.6.0 (2026-03-04)

• Implemented Support the Enum functional API.

v2.5.1 (2026-02-09)

• Fixed In some inheritance scenarios auto() values are not resolved correctly.

v2.5.0 (2026-02-09)

• Fixed Enum properties derived enums do not inherit type hint interface of Enum.

  • A stub file is now shipped for the public interface.

v2.4.1 (2025-11-09)

• Fixed StrEnumProperties auto() resolves differently across py 3.11 boundary

v2.4.0 (2025-09-21)

• Implemented Support Python 3.14, drop 3.8 support

Warning

Python 3.14 lazily loads type annotations when they are accessed. Since annotations are used to define the properties a significant re-ordering of class creation is required on Python 3.14+. All tests are passing and this version should be interface compatible with all previous versions. However, if you encounter any issues please report them.

v2.3.0 (2025-03-29)

• Implemented Need a way to distinguish symmetric properties from first class aliases.

v2.2.5 (2025-03-22)

• Fix readme badges.

v2.2.4 (2025-03-17)

• Add intersphinx reference points to howto and tutorial doc sections.

v2.2.3 (2025-03-14)

• Documentation correction.

v2.2.2 (2025-03-07)

• Tutorial correction.

v2.2.1 (2025-03-07)

• Changelog correction.

v2.2.0 (2025-03-07)

• Fixed StrEnumProperties is missing from __all__

• Implemented Test all example code in docs.

• Fixed Symmetric dataclass is missing from __all__

• Implemented Decorator to make properties symmetric

• Implemented Move to intersphinx references for stdlib types

• Implemented Update docs to diataxis organization

• Implemented More precise case_fold documentation.

v2.1.0 (2025-03-06)

• Implemented Add macos and windows runners to CI

• Implemented Move to trusted publisher releases.

• Implemented Move from poetry to uv, add standard justfile management interface

v2.0.1 (2024-09-02)

• Misc readme/doc updates.

• Fixed Break tests into smaller files.

v2.0.0 (2024-09-02)

• Implemented Allow properties to be specified through type hints alone without s/p value inheritance

v1.8.1 (2024-08-29)

• Fixed Add missing py.typed

v1.8.0 (2024-08-26)

• Implemented Drop support for Python 3.7

• Implemented Support Python 3.13

• Implemented Move to ruff for linting and formatting.

• Documented Support type hinting for properties

v1.7.0 (2023-10-02)

• Implemented Add a StrEnumProperties type to match StrEnum.

• Fixed Hash equivalency between values and enums is broken.

• Implemented Test mixed primitive type values.

v1.6.0 (2023-08-22)

• Implemented Support dataclasses in enums along with Python 3.12

v1.5.2 (2023-05-06)

• Fixed _missing_ allows exceptions through that are not ValueError, TypeError or KeyError

v1.5.1 (2023-04-17)

• Fixed Symmetric string ‘none’ values enable coercion from None despite match_none=False

v1.5.0 (2023-04-17)

There is one minimally impactful breaking change in the 1.5.0 release:

• Symmetric properties that are None will not map back to the enumeration value by default. To replicate the previous behavior, pass True as the match_none argument when instantiating the property with s().

The 1.5.0 release includes two feature improvements:

• Implemented Configurable behavior for matching none on symmetric fields

• Implemented Allow @specialize to accept a list of enumeration values.

v1.4.0 (2023-04-08)

There are some breaking changes in the 1.4.0 release:

• The enum_properties attribute that lists property names has been changed to the sunder name _properties_.

• Properties on combinations of flag enumerations that are not specified in the members list instead of being None, no longer exist. Accessing them will result in an AttributeError.

The 1.4.0 release includes some significant performance improvements. Property access speed has been improved by over 5x and the memory footprint has been reduced by about 1/3.

• Fixed All utility members added by EnumProperties should be sunder names.

• Fixed auto() broken for flag enums that declare combinations as members of the enum.

• Implemented Performance improvements

• Implemented Provide a decorator to provide function overrides per enum value.

• Fixed Address python 3.11+ deprecation warnings.

• Fixed New flag behavior modifiers break IntFlagProperties in python 3.11+

v1.3.3 (2023-02-15)

• Fixed LICENSE included in source package.

v1.3.2 (2023-02-15)

• Fixed Nested classes are incompatible with EnumProperties.

v1.3.1 (2022-10-25)

• Fixed Remove errant print statement

v1.3.0 (2022-10-25)

• Fixed Initialize Flag enum with empty iterable should resolve to Flag(0) - no selections.

• Added Support for python 3.11.

• Implemented Generally allow composite flag enumerations to be treated as iterables of active flags.

v1.2.2 (2022-10-25)

• Implemented Add convenience property to decompose Flag enumeration values

v1.2.1 (2022-10-25)

• Implemented Allow Flag Enumerations to be created from iterables

v1.2.0 (2022-08-17)

• Implemented Drop support for < Python3.6

• Fixed Add types and support for Flag and IntFlag

v1.1.1 (2022-07-24)

• Fixed SymmetricMixin objects are not hashable

v1.1.0 (2022-07-23)

• Implemented Provide equality comparisons for symmetric property values

v1.0.2 (2022-07-19)

• Fixed Consolidate source files

v1.0.1 (2022-07-18)

• Include readme in package

v1.0.0 (2022-07-18)

• Initial Release (production/stable)