Skip to main content

Get a python_frozen reference to an object.

Project description


Frozen creates an immutable reference to an object. This works (lazily) recursive: mutable members are also frozen upon access. It keeps the original object mutable, returning a proxy class that behaves just like the object except being uneditable. If the underlying object changes, the proxy will reflect this automatically. As such it is immutable in the sense that the reference can’t be used to change it, not in the sense that it cannot be changed at all (you could of course discard the original mutable reference). Frozen objects can not be used as dictionary keys.


  1. pip install frozenobj

  2. profit


Usage is very simple:

from frozenobj import frozen
immutable_obj = frozen(mutable_obj)

As a simple example:

class Cls:
        def __init__(self):
       = [37, 42]
original = Cls()
freezered = frozen(original)   # works  # ImmutableError

Have a look at for more examples.


  • Someone really determined to change your proxy object can find ways to do so. This is not a security measure, it’s just a way to enforce your interface (in the purely imaginary case that people don’t read or follow the manual saying they shouldn’t change things).

  • It should work for most objects. It works for classes, class instances, modules, lists, sets, dictionaries and some types derived from them. It implicitly works for ints, floats, strings and tuples which are always immutable (they are returned, not proxied). Functions and methods are also considered constants.

  • The frozen method is idempotent and uses caching: if you call it twice on the same object, either successively or in parallel, you get the same proxy.

  • The recursive freezing on access, while not completely free, should have fairly low computational cost (you need store only values that are accessed a great many times).

  • Heavily relies on the lazy-object-proxy package, which is nice.


Frozen is available under the revised BSD license, see LICENSE.txt. You can do anything as long as you include the license, don’t use my name for promotion and are aware that there is no warranty.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

frozenobj-1.0.tar.gz (4.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page