# xwmodels

**Collections and groups of entities.** Build robust entity models and relationships on top of xwentity; used across the eXonware stack. Per project docs.

**Company:** eXonware.com · **Author:** eXonware Backend Team · **Email:** connect@exonware.com  
**Version:** (see pyproject) · **Updated:** See [version.py](src/exonware/xwmodels/version.py) (`__date__`)

[![Status](https://img.shields.io/badge/status-alpha-orange.svg)](https://exonware.com)
[![Python](https://img.shields.io/badge/python-3.12%2B-blue.svg)](https://www.python.org)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

---

## Install

```bash
pip install exonware-xwmodels
```

---

## Quick start

```python
from exonware.xwmodels import *
# Or: import xwmodels
# Your xwmodels code here — collections/groups of entities
```

See [docs/](docs/) for REF_* and examples when present.

---

## What you get

| Area | What's in it |
|------|----------------|
| **Models** | Entity collections and groups built on xwentity. |
| **Integration** | Tighter ecosystem integration with xwentity, xwstorage, xwaction. |
| **Production** | Tools and utilities for scalable solutions. |

---

## Docs and tests

- **Start:** [docs/INDEX.md](docs/INDEX.md) or [docs/](docs/).
- **Tests:** Run from project root (e.g. `python tests/runner.py`) per project layout.

---

## License and links

MIT — see [LICENSE](LICENSE). **Homepage:** https://exonware.com · **Repository:** https://github.com/exonware/xwmodels  

Contributing → CONTRIBUTING.md · Security → SECURITY.md (when present).

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