---
id: super-collections
version: "0.6.2"
license: MIT
license_treatment: permissive
maintenance: aging
---

# super-collections — file: README.md

License: permissive · Maintenance: aging · Downloads: 2.4M/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 2.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dot notation for dictionaries, json to object conversion, nested data structure access, attribute-based dict access, yaml to python objects, deep nested data navigation, dictionary attribute syntax, data-structures, json-yaml, convenience-wrapper

[View on SkillFed](https://skillfed.io/packages/super-collections) · [View on PyPI](https://pypi.org/project/super-collections/)