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

Dict that lazily populates itself with items from the iterator it was constructed with as keys are accessed

Project Description

# Haven’t you always wanted an infinite dict?

IterDicts are similar to regular Python dicts except that they’re only populated upon demand. This gives them most of the same advantages of generators, such as the ability to operator on very large (or infinite!) datasets.

## Accessing keys that aren’t populated yet

When the get or __getitem__ methods are called, an IterDict tries to fetch a key in the normal manner. If that fails, it starts consuming the iterator it was constructed with and adding those items to itself until it finds the key (or the universe dies of heat death):

>>> d = IterDict((a, a) for a in xrange(1000000000000000))  # 1 quadrillion (US)
>>> d[10]
>>> list(d)
[you're going to be here a while]

## Important differences

A dict consumes its iterator at initialization, and in the case of duplicates the last value wins:

>>> d = dict([(1,1),(1,2)])
>>> d
{1: 2}
>>> del d[1]
>>> d

IterDicts differ in that they stop consuming their iterators as soon as the first instance of a requested key is found:

>>> i = IterDict([(1,1), (1,2)])
>>> i
IterDict<{}, fed by <listiterator object at 0x105bab8d0>>
>>> i[1]
>>> i
IterDict<{1: 1}, fed by <listiterator object at 0x105bab8d0>>

For space, time, and complexity reasons, IterDicts don’t track keys that were present at one point and have been since deleted. This means that keys may reappear after deletion if the IterDict’s iterator yields them again. Continuing the previous example:

>>> del i[1]
>>> i
IterDict<{}, fed by <listiterator object at 0x105bab890>>
>>> i[1]
>>> i
IterDict<{1: 2}, fed by <listiterator object at 0x105bab890>>
Release History

Release History

This version
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
IterDict-0.2.0.tar.gz (5.7 kB) Copy SHA256 Checksum SHA256 Source May 14, 2012

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