super-collections

What it is and what it does

Super Collections provides SuperDict and SuperList classes that wrap Python dictionaries and lists to enable dot-notation attribute access instead of bracket syntax. When you load JSON or YAML data, you can access nested values as `document.author` instead of `document['author']`, and chain access through lists like `document.blocks[3].name` instead of `document['blocks'][3]['name']`. The conversion is recursive—nested dictionaries within lists are automatically converted to SuperDicts, ensuring consistent dot notation throughout the entire structure.

The package targets the common friction point of working with structured data loaded from files: standard Python dicts and lists require bracket notation, which becomes verbose and error-prone in deeply nested structures. SuperDict and SuperList maintain full compatibility with standard dict and list methods while adding the convenience of attribute access. It depends only on hjson for serialization and supports Python 3.8 through 3.13.

Use it for:

• Loading JSON configuration files and accessing settings via dot notation (e.g., config.database.host instead of config['database']['host'])
• Processing API responses with nested objects to avoid repeated bracket indexing and improve readability
• Working with YAML data structures where attribute access is more intuitive than dictionary keys
• Building quick prototypes that consume structured data without defining custom dataclasses for each schema
• Navigating complex nested lists of dictionaries (e.g., from a JSON array of records) with consistent dot syntax

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Converts nested JSON and YAML data into Python objects with dot-notation attribute access, replacing bracket syntax for dictionary and list navigation.

Yes, if you frequently work with nested JSON/YAML data and prefer dot notation over bracket syntax. Install friction is minimal and the license is permissive. However, the project is aging with limited maintenance activity (2 stars, infrequent commits), so consider it for scripts and prototypes rather than mission-critical infrastructure. No known vulnerabilities.

Install

super-collections on PyPI

pip install super-collections

uv add super-collections

poetry add super-collections

Installing super-collections

Before you install

Low install friction with a single runtime dependency (hjson). Maintenance status is aging—last commit was 2025-09-30 but the project has only 2 stars and receives infrequent updates, suggesting limited active development.

License in practice

MIT license is permissive, allowing use in commercial and private projects with minimal restrictions.

Quickstart

import json
from super_collections import SuperDict

with open('data.json', 'r') as f:
    data = json.load(f)

doc = SuperDict(data)
print(doc.author)  # instead of doc['author']
for item in doc.items:
    print(item.name)  # instead of item['name']

Verify before relying

• Whether SuperDict and SuperList preserve all standard dict/list methods without behavioral surprises in edge cases
• Performance characteristics when working with very large or deeply nested structures
• Compatibility with type checkers (mypy, pyright) given the dynamic attribute access pattern

Package facts

Evidence: super_collections-0.6.2-py3-none-any.whl

Tags

More Utilities packages