Configuration Snapshot System

A configuration management utility that captures and preserves application configuration data in a completely immutable format, including all nested structures.

Capabilities

Immutable Configuration Capture

Creates fully immutable snapshots of configuration dictionaries with nested data structures, ensuring all levels are frozen.

• Given a configuration dict with nested lists, dicts, and sets, creates a completely immutable snapshot where no level can be modified @test
• Given an empty configuration dict, creates an immutable empty snapshot @test

Custom Type Handling

Supports freezing custom configuration objects through type converter registration.

• Given a custom ConfigSection class with attributes, registers a converter and creates an immutable snapshot @test

Conversion Inspection

Provides visibility into the type conversion mappings used during freezing.

• Returns the current freeze conversion map showing all registered type converters @test

Implementation

@generates

API

def create_snapshot(config):
    """
    Create a completely immutable snapshot of a configuration dictionary.

    All nested mutable structures (dicts, lists, sets) are recursively
    converted to their immutable counterparts (frozendict, tuple, frozenset).

    Parameters:
    - config: dict, the configuration dictionary to snapshot

    Returns:
    An immutable version of the configuration with all nested structures frozen
    """
    pass

def register_config_type(type_class, converter_func):
    """
    Register a custom type converter for configuration objects.

    Allows custom configuration types to be properly frozen during snapshot creation.

    Parameters:
    - type_class: type, the custom type to register
    - converter_func: callable, function that converts instances to immutable form

    Returns:
    None
    """
    pass

def get_converter_info():
    """
    Get information about currently registered type converters.

    Returns:
    dict: Mapping of types to their converter functions
    """
    pass

Dependencies { .dependencies }

frozendict { .dependency }

Provides recursive immutability conversion for nested data structures.

@satisfied-by