nd = NestedDict(data)

# String path with delimiter
nd.get("users->alice->age")              # 30

# List/tuple of keys
nd.get(["users", "alice", "age"])         # 30
nd.get(("users", "alice", "hobbies", 0)) # 'reading'

# Integer key (for lists)
nl = NestedList([10, 20, 30])
nl.get(1)                                # 20

# Default value if not found
nd.get("users->charlie->age", default=0) # 0

nd["users->alice->age"]          # 30
nd[["users", "bob", "hobbies"]]  # NestedList(['gaming', 'cooking'])

nd.users.alice.age       # 30
nd.users.bob.hobbies     # NestedList(['gaming', 'cooking'])

Note: dot notation only works with string keys that are valid Python identifiers.

# Get value
nd("users->alice->age")                    # 30

# Get with default
nd("users->charlie->age", default="N/A")   # 'N/A'

# Set value (pass value as second argument)
nd("users->alice->age", 31)               # sets age to 31

nd.set("users->alice->age", 31)
nd.set(["users", "bob", "age"], 26)

nd["users->alice->age"] = 31
nd[["users", "bob", "age"]] = 26

nd.users.alice.age = 31
nd.users.bob.age = 26

nd("users->alice->age", 31)
nd("users->bob->hobbies->0", "swimming")

Works with falsy values too — 0, "", False, [], {} are all valid:

nd("users->alice->active", False)   # sets to False, not a get
nd("users->alice->score", 0)        # sets to 0

Default delimiter is "->". Change it in the constructor:

nd = NestedDict(data, delimiter=".")
nd.get("users.alice.age")     # 30
nd["users.bob.hobbies.0"]     # 'gaming'

nd2 = NestedDict(data, delimiter="/")
nd2.get("users/alice/age")    # 30

By default, get() wraps dicts/lists/tuples in Nested objects. Use modify=True to get the raw value:

# Returns NestedDict (wrapped)
nd.get("users->alice")
# NestedDict({'age': 30, 'hobbies': ['reading', 'coding']})

# Returns plain dict (raw)
nd.get("users->alice", modify=True)
# {'age': 30, 'hobbies': ['reading', 'coding']}

Extends dict with nested path access. Supports all dict methods plus nested get/set:

from digin import NestedDict

nd = NestedDict({"a": {"b": {"c": 1}}})
nd.get("a->b->c")  # 1
nd.keys()           # dict_keys(['a'])
len(nd)             # 1

Extends list with nested path access:

from digin import NestedList

nl = NestedList([{"name": "Alice"}, {"name": "Bob"}])
nl.get("0->name")  # 'Alice'
nl[1]               # {'name': 'Bob'}
len(nl)             # 2

Extends tuple with nested path access (read-only):

from digin import NestedTuple

nt = NestedTuple(({"a": 1}, {"b": 2}))
nt.get("0->a")  # 1
nt[0]            # {'a': 1}