RecursiveNamespaceV2 Documentation

RecursiveNamespaceV2 is a Python library that extends Python’s built-in SimpleNamespace class to provide enhanced functionality for working with nested namespaces and dictionaries.

Features

  • Automatic Recursive Conversion: Converts nested dictionaries to namespaces automatically

  • Dual Access Pattern: Access elements using both dictionary keys and namespace attributes

  • Chain-Key Access: Advanced key access using dot notation (e.g., rns._.val_get("a.b.c"))

  • Array Indexing: Special syntax for arrays (key[].# for append, key[].0 for index access)

  • Type-Safe: Fully typed with mypy support

  • Zero Dependencies: Pure Python implementation

  • Flexible Serialization: Easy conversion between dict and namespace

Quick Start

Installation:

pip install RecursiveNamespaceV2
# or with uv
uv pip install RecursiveNamespaceV2

Basic Usage:

from recursivenamespace import RNS

data = {
    'name': 'John',
    'address': {
        'city': 'Anytown',
        'street': '123 Main St'
    }
}

rn = RNS(data)
print(rn.address.city)  # Anytown

# Convert back to dict
data_dict = rn._.to_dict()

Note

Deprecation notice (Phase 1). Direct calls to public methods on an RNS instance — rn.to_dict(), rn.items(), rn.val_set(), etc. — still work but emit DeprecationWarning and will be removed in v0.1.0 (the first stable release). Use the obj._ proxy instead: rn._.to_dict(), rn._.items(), rn._.val_set(...).

Data keys that collide with a method name (e.g. RNS({"items": ...})) emit FutureWarning — a louder category, visible under Python’s default filter — because the collision is caused by user data and should not require -W default to surface.

See Method Proxy (obj._) for the full migration plan.

Contents

User Guide

API Reference

Indices and tables