scitex-dict 0.1.2

Dictionary utilities (DotDict, safe_merge) for the SciTeX ecosystem

scitex-dict

Dictionary utilities for the SciTeX ecosystem.

Interfaces: Python ⭐⭐⭐ (primary) · CLI — · MCP — · Skills ⭐ · Hook — · HTTP —

Problem and Solution

#	Problem	Solution
1	YAML config access ergonomics -- CONFIG["MODEL"]["hidden_size"] vs CONFIG.MODEL.hidden_size matters in a notebook	DotDict -- attribute-access dict subclass with recursive .x.y.z; works as a drop-in for the umpteen competing alternatives (addict, easydict, box, dotmap)
2	Merging configs silently overwrites -- {**a, **b} on duplicate keys loses information	safe_merge -- duplicate keys raise; flatten turns nested dicts into dotted-key single-level for logging/CSV

Features

• DotDict -- Dot-access dictionary with recursive nesting, JSON serialization, and full dict protocol
• safe_merge -- Merge multiple dicts with overlap detection
• flatten -- Flatten nested dicts into single-level with separator keys
• listed_dict -- defaultdict(list) factory with optional pre-initialized keys
• pop_keys -- Remove specified keys from a key list
• replace -- Bulk string replacement using a mapping dict
• to_str -- Convert a dict to a compact string representation

Installation

pip install scitex-dict

Usage

from scitex_dict import DotDict, safe_merge

cfg = DotDict({"model": {"lr": 0.001, "epochs": 100}})
print(cfg.model.lr)  # 0.001

merged = safe_merge({"a": 1}, {"b": 2})
# {"a": 1, "b": 2}

License

AGPL-3.0. See LICENSE.