easydotdict

Navigate nested dictionaries with the simplicity of attribute access.
Zero dependencies. Python 3.8+.

from easydotdict import dotdict

d = dotdict({"user": {"profile": {"name": "Alice"}}})

# Read deeply with dot notation
print(d.user.profile.name)   # Alice
print(d["user"].profile.name)  # same, dual access

# Safe missing-key access — no exceptions
print(d.user.email)          # None

# Auto-create nested paths on assignment
d.config.database.host = "localhost"

# Scalar auto-conversion — string becomes a key
d.name = "Alice"
d.name.character = 5  # {"name": {"Alice": {"character": 5}}}

# Deep path string methods
d.put("server.port", 8080)
print(d.dig("user.name"))    # Alice

# Compare, diff, and migrate
v1 = dotdict({"app": {"debug": True}})
v2 = dotdict({"app": {"debug": False, "version": "2.0"}})
changes = v1.diff(v2)
v1.patch(changes)            # v1 now matches v2

# Recursive flatten and restore
flat = d.flatten()
restored = dotdict.unflatten(flat)

# Deep merge with key preservation
d.merge({"settings": {"theme": "dark"}})

# Pretty-printed JSON output
print(d)

Features

Install

pip install easydotdict

Documentation

Full API reference, edge case table, and decorator guide: docs.md

Real-world examples:

• api_response.py — consume a JSON API endpoint
• app_config.py — load, edit, and persist application configuration
• product_catalog.py — enrich GitHub repository data
• config_manager.py — validate, watch, freeze, and bulk-override settings
• data_migration.py — diff, patch, find, and validate between data versions
• github_stars.py — analyse repository metadata with find, diff, cursor, and expect

License

MIT