Getting Started¶

# Install from PyPI (once published)
pip install dotsuite

# Or install from source
git clone https://github.com/yourusername/dotsuite.git
cd dotsuite
pip install -e .

# After pip install dotsuite:
from dotsuite.depth.dotget import get
from dotsuite.depth.dotstar import search
from dotsuite.shape.dotmod import set_

# Or if using source install:
# from depth.dotget.core import get
# from depth.dotstar.core import search
# from shape.dotmod.core import set_

# Your nested data
data = {
    "users": [
        {"name": "Alice", "age": 30, "role": "admin"},
        {"name": "Bob", "age": 25, "role": "user"}
    ]
}

# Get a specific value
name = get(data, "users.0.name")  # "Alice"

# Search with wildcards
all_names = search(data, "users.*.name")  # ["Alice", "Bob"]

# Modify data (returns new copy)
new_data = set_(data, "users.0.role", "superadmin")

# Development setup with testing tools
make install-dev
make test
make docs-serve  # View docs at http://127.0.0.1:8000