xwmodels 0.6.0.6

Convenience wrapper for exonware-xwmodels - provides 'import xwmodels' alias

xwmodels

Entity collections and groups on top of xwentity, wired for the rest of the eXonware stack. Details live in per-project REF docs.

Company: eXonware.com · Author: eXonware Backend Team · Email: [e-mail]

---

Install

pip install exonware-xwmodels
pip install exonware-xwmodels[lazy]
pip install exonware-xwmodels[full]

---

Quick start

from exonware.xwmodels import *
# Or: import xwmodels
# Collections and groups of entities - see docs for patterns

See docs/ for REF_* files and examples.

---

What you get

Area	Contents
Models	Entity collections and groups built on xwentity.
Integration	Hooks for xwentity, xwstorage, xwaction.
Tooling	Utilities aimed at larger, consistent model graphs.

Core model roles

• XWModelEntity (entity_compat.py) is the xwmodels compatibility facade over exonware.xwentity.XWEntity (data-first ergonomics + model-facing helpers).
• XWModelCollection (collection.py) manages many entities of one type and adds persistence-aware collection behavior via storage contracts.
• XWModelGroup (group.py) manages multiple collections, supports nested subgroups (tree hierarchy), and coordinates group-level save/load through providers.
• Shared foundation: model collection and model group inherit XWObject from xwsystem for lightweight identity/object semantics; entity behavior is inherited from core xwentity.
• Compatibility alias: XWEntity remains exported as an alias to XWModelEntity for backward compatibility.

Model management layer in practice

• Base systems: use one XWModelGroup per bounded system (for example auth, catalog, billing, content) and keep each system's collections under that group.
• Domain partitioning: map each aggregate/root model to one XWModelCollection (users, roles, invoices, products), with one schema contract and many entities.
• Nested environments: create subgroups for dev / staging / prod, tenant spaces, or regional shards while preserving one management API.
• Provider orchestration: plug storage/auth providers at group level so save/load and access control policies are consistent across all collections in that system.
• App composition: xwbase-style systems can compose multiple groups to build complete application backbones while reusing the same entity/collection/group semantics.

---

Docs and tests

• Start: docs/INDEX.md or docs/.
• Tests: From repo root, e.g. python tests/runner.py, per project layout.

---

License and links

MIT - see LICENSE. Homepage: https://exonware.com · Repository: https://github.com/exonware/xwmodels

Async Support

• xwmodels includes asynchronous execution paths in production code.
• Source validation: 9 async def definitions and 2 await usages under src/.
• Use async APIs for I/O-heavy or concurrent workloads to improve throughput and responsiveness.

Version: 0.6.0.6 | Updated: 31-Mar-2026

Built with ❤️ by eXonware.com - Revolutionizing Python Development Since 2025