exonware-xwquery 0.9.0.5

Universal query language for data structures - 50+ operations, 35+ format converters

xwquery

One universal query language. Execute on Python data or convert between SQL, GraphQL, Cypher, and 35+ formats with a single engine. One script (XWQS) for the zone; used by xwstorage, xwaction, xwbase.

Company: eXonware.com · Author: eXonware Backend Team · Email: [e-mail]
Version: version.py (__version__, __date__)

---

Install

pip install exonware-xwquery

Requires xwsystem; xwsyntax for grammars. See docs/GUIDE_01_USAGE.md for details.

---

Quick start

from exonware.xwquery import XWQuery

data = {'users': [
    {'name': 'Alice', 'age': 30, 'city': 'NYC'},
    {'name': 'Bob', 'age': 25, 'city': 'LA'},
    {'name': 'Charlie', 'age': 35, 'city': 'NYC'},
]}

result = XWQuery.execute("""
    SELECT name, age
    FROM users
    WHERE age > 25 AND city = 'NYC'
""", data)
# result.data → [{'name': 'Alice', 'age': 30}, {'name': 'Charlie', 'age': 35}]

Convert between formats: XWQuery.convert(sql_string, from_format='sql', to_format='graphql').
Parse only: XWQuery.parse("SELECT * FROM users", source_format='sql').
Key code: REF_14_DX · API: REF_15_API.

---

What you get

Area	Description
Execution	Run queries on any Python data (node or table). Parse → plan → execute; one engine, one contract.
Grammars	35+ formats (SQL, GraphQL, Cypher, SPARQL, MQL, PromQL, JQ, JMESPath, …) via xwsyntax. Parse, generate, validate.
Operations	CRUD, filtering, aggregation, graph (MATCH, PATH), JOIN, UNION, WINDOW, PIPE, and more.
Integration	Consumed by xwstorage, xwaction, xwbase. One universal script (XWQS); zone execution (e.g. S3) converts to XWQS first.

Current phase: Alpha. Executor refactor and doc alignment in progress. Status: REF_22_PROJECT.

---

Docs and tests

• Start: docs/INDEX.md
• Usage: docs/GUIDE_01_USAGE.md
• Requirements and status: REF_01_REQ, REF_22_PROJECT
• API and design: REF_15_API, REF_13_ARCH, REF_14_DX
• Tests: REF_51_TEST. Run from project root (pytest or project test runner).

---

License and links

MIT — LICENSE.
Homepage: https://exonware.com · Repository: https://github.com/exonware/xwquery

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

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