5 Best Ways to Implement Immutable Data Structures in Python

Rate this post

πŸ’‘ Problem Formulation: Mutable data structures in Python, such as lists and dictionaries, can lead to unexpected bugs when their contents change unintentionally. This article explores different methods to implement immutable versions of these structures. For instance, converting a list that can be altered [1, 2, 3] to an immutable structure that, once created, cannot be changed.

Method 1: Using tuples Instead of lists

Tuples in Python are the simplest form of immutable sequences. Any data that you might usually store in a list can be stored in a tuple if you don’t need to modify it after creation. This method is native to Python, easy to use, and recommended for cases where the list’s contents are known and fixed ahead of time.

Here’s an example:

my_tuple = (1, 2, 3)
    my_tuple[0] = 4
except TypeError as e:

This code tries to alter a tuple, which raises a TypeError because tuples do not support item assignment.

By attempting to change the first element of the tuple, we trigger an exception handling mechanism that confirms the immutability of the structure: Attempt to change item assignment will result in a raised exception, preserving data integrity.

Method 2: Using frozenset for Set Immunity

A frozenset is an immutable version of a Python set. Any data that can be stored in a set can be stored in a frozenset if you require that the collection of unique items remains constant after its creation. This is ideal for fixed collections of unique items.

Here’s an example:

my_frozenset = frozenset([1, 2, 3])
except AttributeError as e:

The output here would be an AttributeError indicating that ‘frozenset' object has no attribute ‘add’.

Attempting to add an element to a frozenset will not succeed since frozenset objects do not have an add method, ensuring that the set of data remains unchanged.

Method 3: Using the pyrsistent Library

For a more complex and feature-rich approach to immutability, the pyrsistent library provides immutable data structures. The library offers several immutable variants like v for lists and m for dictionaries, with more advanced features than Python’s native structures.

Here’s an example:

from pyrsistent import pvector
pvec = pvector([1, 2, 3])
pvec = pvec.set(0, 4)

The output will be pvector([4, 2, 3]).

This code uses pyrsistent‘s persistent vector to attempt to change an item. Instead of mutating the vector, the set method returns a new vector with the updated value, leaving the original untouched.

Method 4: Using Named Tuples

Named tuples, accessible from Python’s collections module, extend the functionality of tuples by allowing you to access values by name. They are immutable and can be used as light-weight object alternatives.

Here’s an example:

from collections import namedtuple
Point = namedtuple('Point', ['x', 'y'])
p = Point(x=1, y=2)
    p.x = 3
except AttributeError as e:

The error that results from attempting to change the property is: can't set attribute.

Named tuples provide clarity by using meaningful names for accessing tuple components. The immutability ensures consistency, as attempting to set new values to named tuple fields will raise an AttributeError.

Bonus One-Liner Method 5: String Interpolation for Simple Immutable Strings

String interpolation in Python 3.6+ introduces a succinct way to create formatted strings that are by their nature immutable. These can be used to reliably construct messages and labels.

Here’s an example:

name = 'World'
greeting = f'Hello, {name}!'

The output will be: Hello, World!

Formatted string literals (f-strings) offer an easy-to-read method for creating strings and reinforce immutability because strings in Python cannot be changed once they are created.


  • Method 1: Tuples. Simple and built-in. Not suited for complex structures.
  • Method 2: Frozenset. Ideal for immutable unique item collections. Limited functionality compared to mutable sets.
  • Method 3: pyrsistent. Provides rich functionality. Requires learning additional APIs and third-party library.
  • Method 4: Named Tuples. Readability with label access, but lacks features for complex data structures.
  • Bonus Method 5: String Interpolation. Quick for strings but not applicable to other mutable types.