genro-bag 0.7.5

Modernized bag system for the Genropy framework - hierarchical data container with XML serialization

genro-bag

An intermediate representation for structured data in Python.

What is Bag?

A Bag is an abstraction that bridges the gap between how humans think about structured data and how software implements it.

When you work with configuration files, API responses, form data, or document structures, they all share the same fundamental shape: named things containing values, organized in a hierarchy, with additional properties attached.

Yet in code, we scatter this across dictionaries, classes, JSON, XML, database rows—each with its own access patterns and limitations.

A Bag unifies these patterns into a single, consistent model:

• Nodes — Named containers that hold a value
• Hierarchy — Nodes can contain other nodes, forming a tree
• Attributes — Each node carries metadata alongside its value
• Paths — Navigate the tree with familiar dot notation

The Layered Design

Bag provides progressive capability. Start simple, add layers when needed:

Layer	Purpose
Core Bag	The fundamental container: paths, values, attributes
Resolvers	Values that compute themselves: lazy loading, API calls
Subscriptions	React to changes: validation, logging, computed properties
Builders	Domain-specific languages: HTML, Markdown, XML schemas

Install

pip install genro-bag

Documentation

Full documentation with examples: genro-bag.readthedocs.io

Section	Description
Getting Started	Learn the three core concepts
Core Bag	Basic usage, paths, attributes, serialization
Resolvers	Lazy loading, API calls, computed values
Subscriptions	React to changes, validation, logging
Builders	Domain-specific languages (HTML, Markdown, XSD)

Development

pip install -e ".[dev]"
pytest

1500+ tests, 88%+ coverage.

License

Apache License 2.0 - see LICENSE for details.

Copyright 2025 Softwell S.r.l. - Genropy Team