exonware-xwentity 0.6.0.5

Unified entity model with schema, actions, data, metadata, caching, and performance features

xwentity

Unified entity layer. Ties schema (xwschema), actions (xwaction), and data (xwdata) together with metadata, caching, state, and XWNode. Used by xwmodels, xwbase, and the rest of the eXonware stack. Details live in docs/.

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

---

Install

pip install exonware-xwentity
pip install exonware-xwentity[lazy]
# Full stack used by xwentity flows
pip install exonware-xwentity[full]

[full] pulls the full variants of: xwsystem, xwaction, xwdata, xwquery, xwschema, and xwnode.

---

Quick start

from exonware.xwentity import XWEntity
from exonware.xwschema import XWSchema

schema = XWSchema({"type": "object", "properties": {"name": {"type": "string"}, "age": {"type": "integer"}}})
entity = XWEntity(schema=schema, data={"name": "Alice", "age": 30})
print(entity.data["name"])

See docs/ for metadata, state, and REF_* files.

---

What you get

Area	What's in it
Entity	One class for schema, actions, data, metadata, caching.
Integration	xwschema, xwaction, xwdata, XWNode.
Lifecycle	State and property discovery.

Core model (explicit roles)

• XWEntity (entity.py) composes XWSchema + XWAction + XWData: validation contract, entity-scoped behavior, and multi-format data payloads.
• XWCollection (collection.py) is a logical, storage-agnostic collection of entities of the same type, with collection-level actions (search/bulk operations).
• XWGroup (group.py) manages multiple collections and supports nested parent/child groups, forming a tree structure for organization.
• Shared foundation: XWCollection and XWGroup directly extend XWObject (xwsystem), and XWEntity extends AEntity which extends XWObject, so all core entity types inherit the same lightweight identity/object base.

---

Docs and tests

• Start: docs/INDEX.md or docs/.
• Tests: From repo root, follow the layout in this package (pytest or project runner).

---

License and links

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

Async Support

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

Version: 0.6.0.5 | Updated: 31-Mar-2026

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