Skip to main content

ordered, dynamically-expandable dot-access dictionary

Project description

DotMap is a dot-access dict subclass that

  • has dynamic child creation

  • can be initialized with keys

  • easily initializes from dict

  • easily converts to dict

  • is ordered by insertion

The key feature is exactly what you want: dot-access

from dotmap import DotMap
m = DotMap()
m.name = 'Joe'
print 'Hello ' + m.name
# Hello Joe

However, DotMap is a dict and you can treat it like a dict as needed

print m['name']
# Joe
m.name += ' Smith'
m['name'] += ' Jr'
print m.name
# Joe Smith Jr

It also has fast, automatic hierarchy (which can be deactivated by initializing with DotMap(_dynamic=False))

m = DotMap()
m.people.steve.age = 31

And key initialization

m = DotMap(a=1, b=2)

You can initialize it from dict and convert it to dict

d = {'a':1, 'b':2}

m = DotMap(d)
print m
# DotMap(a=1, b=2)

print m.toDict()
# {'a': 1, 'b': 2}

And it has iteration that is ordered by insertion

m = DotMap()

m.people.john.age = 32
m.people.john.job = 'programmer'
m.people.mary.age = 24
m.people.mary.job = 'designer'
m.people.dave.age = 55
m.people.dave.job = 'manager'

for k, v in m.people.items():
        print k, v
print

# john DotMap(age=32, job='programmer')
# mary DotMap(age=24, job='designer')
# dave DotMap(age=55, job='manager')

There is also built-in pprint as dict for debugging a large DotMap

m.pprint()
# {'people': {'dave': {'age': 55, 'job': 'manager'},
#             'john': {'age': 32, 'job': 'programmer'},
#             'mary': {'age': 24, 'job': 'designer'}}}

And many other features involving dots and dictionaries that will be immediately intuitive when used.

Project details


Release history Release notifications | RSS feed

This version

1.2.5

Download files

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

Source Distribution

dotmap-1.2.5.tar.gz (4.2 kB view details)

Uploaded Source

File details

Details for the file dotmap-1.2.5.tar.gz.

File metadata

  • Download URL: dotmap-1.2.5.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for dotmap-1.2.5.tar.gz
Algorithm Hash digest
SHA256 9b1601418af474f6fcdcc9facd44a4295301385965a6288ba170c0886a54d45d
MD5 69113900405c3509d0ea3d399a93e3e0
BLAKE2b-256 e61cfba53e2a9cb8962d64e8c42582cbdbd429634a2419b4b47a282458310e78

See more details on using hashes here.

Supported by

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