skip to navigation
skip to content

bunch 1.0.0

A dot-accessible dictionary (a la JavaScript objects)

Latest Version: 1.0.1

Bunch is a dictionary that supports attribute-style access, a la JavaScript.

>>> b = Bunch()
>>> b.hello = 'world'
>>> b.hello
>>> b['hello'] += "!"
>>> b.hello
>>> = Bunch(lol=True)
>>> is b['foo']

Dictionary Methods

A Bunch is a subclass of dict; it supports all the methods a dict does:

>>> b.keys()
['foo', 'hello']

Including update():

>>> b.update({ 'ponies': 'are pretty!' }, hello=42)
>>> print repr(b)
Bunch(foo=Bunch(lol=True), hello=42, ponies='are pretty!')

As well as iteration:

>>> [ (k,b[k]) for k in b ]
[('ponies', 'are pretty!'), ('foo', Bunch(lol=True)), ('hello', 42)]

And “splats”:

>>> "The {knights} who say {ni}!".format(**Bunch(knights='lolcats', ni='can haz'))
'The lolcats who say can haz!'


  • Bunch converts easily to (unbunchify, Bunch.toDict) and from (bunchify, Bunch.fromDict) a normal dict, making it easy to cleanly serialize them to JSON or YAML.

  • It is safe to import * from this module. You’ll get: Bunch, bunchify, and unbunchify.

  • Tests:

    $ python -m bunch.test -v


Open a ticket at or send me an email at .

File Type Py Version Uploaded on Size
bunch-1.0.0.tar.gz (md5) Source 2010-01-26 5KB (md5) Source 2010-01-26 8KB