This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Making Immutable and stateless data structures

Project Description

Changeless is a set of functions and objects to help convert your data into a set stateless or immutable data objects.


from changeless.types import FancyHash, FancyModel, ImmutableHash, ImmutableModel

Fancy Types take a dict object and replaces the dereferencing operator ([]) with the dot operator. So the object

an_obj= FancyHash({"name":"me"})

will allow us to retrieve the attribute ‘name’ with

print "the object's name: " +
>the object's name: matt

Model Types take a Django ORM QueueSet and converts it to a comparable api. This uses the Fancy type as a base after converting the QuerySet to a dict. Foreign keys and many to many relationships are converted to nested dicts and lists of dicts(respectively) to aid in the objects behaving as similarly as possible.

Note that Model Types retrieve all of data at once which includes by default relationships directly adjacent. This might incur more queries than expected. Choose your data carefully and scale back when necessary.

  • FancyHash(a_dictonary)
  • FancyModel(a_model, depth=1)
  • ImmutableHash(a_dictonary)
  • ImmutableModel(a_model, depth=1)

Just pass the correct object into the type constructor to convert your data.


from changeless.decorators import fancy_list

def get_books():
    return Book.objects.all()

Place the following decorators before functions that return a Django ORM QueueSet to convert it to the correct changeless object. Decorators are the preferred way to use the changeless library. Using the decorators promote readability by keeping the conversion away from the ORM call, as well as providing an easy to way to turn the changeless conversion on and off. Notice that the _gen decorators will return a generator that will lazily convert each object in the list. Generators may be more efficient for long lists.

The following generators are available.
* fancy_list * fancy_gen * immutable_list * immutable_gen


I’ve found the following functions useful. ###fuzzyEquals### from import fuzzyEquals

i_obj = FancyHash({"name":'test name',
                   'sub_dict':{'name':'sub name', 'attrib':'sub attr value'}
second_i_obj = FancyHash({"name":'test name',
                          'sub_dict':{'name':'sub name', 'attrib':'sub attr value' }})
self.assertTrue( fuzzyEquals(
     second_i_obj ))

fuzzyEquals will find attributes that the changeless objects have in common and compare only that union. This also inspects nested relationships for shared attributes. ###to_dict### from changeless.methods import to_dict to_dict is the reverse conversion from a base fancy_object to its dictionary representation.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
changeless-0.1.27.macosx-10.8-intel.exe (76.3 kB) Copy SHA256 Checksum SHA256 any Windows Installer Aug 14, 2013
changeless-0.1.27.tar.gz (8.2 kB) Copy SHA256 Checksum SHA256 Source Aug 14, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting