Release Notes¶

Frigid 3.0 (2025-03-04)¶

Add metaclasses for immutable dataclasses including Dataclass, CompleteDataclass, ProtocolDataclass, and CompleteProtocolDataclass. These factory classes combine Python’s dataclass functionality with immutable behavior for type-safe, attribute-stable data containers.
Enhance the immutable decorator to accept optional parameters including docstring for setting or overriding class documentation and mutables for specifying attributes that should remain modifiable after initial assignment.

Add one function which produces 1-element tuples. Cleaner to read than the 1-element tuple syntax and is useful for some functional programming contexts. Also, add install function to install one as a Python, if desired.
Support mutables argument when using metaclasses from frigid.classes. Allows for selective mutability of class attributes.
⚠️ BREAKING CHANGES! ⚠️ Improve reclassify_modules to constrain reclassification to only package modules and not other modules outside of package. Alter interface to make recursion through subpackages optional. Accept module objects and module names in addition to module attributes dictionaries. Attributes dictionaries must contain __package__ or __name__ attribute now.

Add @immutable decorator for making instances of existing classes immutable after initialization. Compatible with most classes except those defining their own __setattr__ or __delattr__ methods.
Add Module class and reclassify_modules function for creating and converting to immutable modules. This prevents runtime modification of module attributes, helping ensure interface stability.
Add Namespace class providing a completely immutable alternative to types.SimpleNamespace. All attributes must be set during initialization and cannot be modified afterward.
Add Object base class for creating objects with immutable attributes. Derived classes must set attributes in __init__ before calling super().__init__().
Add immutable dictionaries, which have additional methods, such as copy and with_data, additional operations, such as union (|) and intersection (&):
- Dictionary for simple immutable mappings
- ValidatorDictionary which uses a provided validator function
Add metaclasses for creating classes with immutable class attributes:
- Class for standard classes
- ABCFactory for abstract base classes
- ProtocolClass for protocol classes
Add qualified aliases in qaliases module with “Immutable” prefix for all core classes, helping avoid namespace conflicts.