qua

Python bindings for the Quarb query engine. Quarb reads structured text as an arbor — a tree-spanned graph — and runs one query language over all of it, generalizing what XPath does for XML and jq does for JSON to JSON, YAML, TOML, CSV/TSV, XML, HTML, and Markdown alike. Try it live in the playground.

Install

pip install quarb

This installs the quarb Python module and the qua command (the language is Quarb; qua is its CLI).

Wheels are published for Linux (x86_64, aarch64), macOS (arm64, x86_64), and Windows (x86_64). The extension is built against PyO3's stable ABI (abi3-py38); a single wheel covers CPython 3.8 and later.

The `qua` command

The entry point covers what the bindings cover — one query over a text document:

qua '/books/*[/price:: > 20]/title::' store.json
echo '{"users":[{"name":"ada"}]}' | qua -f json '/users/*/name::'

Beyond text, quarb.open(path) dispatches on kind over the full local fleet — SQLite, kaiv (typed units), the filesystem (descend=True grafts parseable leaves), git (git:PATH), archives, XLSX, and source code — and quarb.mount([a, b, ...]) mounts several sources under one root so a single query joins across them (a YAML file <=> a SQLite database). The networked adapters — Postgres, MySQL, BigQuery, Neo4j, object stores, mail — and DuckDB live in the Rust binary: cargo install qua.

Quick start

import quarb

doc = quarb.loads("""{
  "books": [
    {"title": "Sapiens", "price": 25},
    {"title": "Cosmos",  "price": 18}
  ]
}""", "json")

doc.values('/books/*[/price:: > 20]/title::')
# ['Sapiens']

doc.value('/books/*/price:: @| mean')
# 21.5

doc.records('/books/* | rec("t", /title::, "p", /price::)')
# [{'t': 'Sapiens', 'p': 25}, {'t': 'Cosmos', 'p': 18}]

loads(text, format) / load(path) parse once into a Document, queried many times. Results come back typed: ints, floats, strings, None for null, tz-aware datetime for instants, timedelta for durations, Quantity for unit-carrying values, dicts for records. Formats: json, yaml, toml, csv, tsv, xml, html, markdown.

The lower-level quarb.run(query, text, format) and quarb.run_file(query, path) return the result lines as strings — exactly what the qua CLI prints. All errors raise ValueError with the engine's message.

For the query language itself — steps, criteria, readings, patterns, joins — see the user guide and spec.

License

Licensed under either of Apache License, Version 2.0 or the MIT license at your option. Both texts are bundled in the package.

Jupyter

%load_ext quarb.ipython
%quarb_mount fleet.daiv
%quarb /@hosts/*[::power > 0.2kW]::name

%%quarb [NAME] runs a cell-sized query against a named mount; results render as HTML tables, iterate as typed values (quantities keep magnitude + unit), and convert with .df / .df_magnitudes().

For a notebook where every cell is a query, install the dedicated kernel and pick Quarb in the launcher:

python -m quarb.kernel install
python -m quarb.kernel demo      # writes quarb-demo.ipynb to try

Cells are queries; %mount, %connect, %use, %docs, %translate, and %python (an escape hatch — the rest of the cell is Python, with the live session and the last result _ in scope) are the directives. Tab-completion offers the mounted arbor's real child names, and the bundled JupyterLab extension highlights Quarb syntax in cells automatically. %connect NAME PATH... (magic: %quarb_connect) attaches to a qua --resident daemon — for arbors too large to rebuild per notebook, queried from a standing session. pip install quarb[jupyter] pulls IPython, pandas, and the kernel runtime.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

quarb-0.11.0.tar.gz (794.5 kB view details)

Uploaded Jul 26, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

quarb-0.11.0-cp38-abi3-win_amd64.whl (10.1 MB view details)

Uploaded Jul 26, 2026 CPython 3.8+Windows x86-64

quarb-0.11.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (10.5 MB view details)

Uploaded Jul 26, 2026 CPython 3.8+manylinux: glibc 2.17+ x86-64

quarb-0.11.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (10.0 MB view details)

Uploaded Jul 26, 2026 CPython 3.8+manylinux: glibc 2.17+ ARM64

quarb-0.11.0-cp38-abi3-macosx_11_0_arm64.whl (9.4 MB view details)

Uploaded Jul 26, 2026 CPython 3.8+macOS 11.0+ ARM64

quarb-0.11.0-cp38-abi3-macosx_10_12_x86_64.whl (9.8 MB view details)

Uploaded Jul 26, 2026 CPython 3.8+macOS 10.12+ x86-64

File details

Details for the file quarb-0.11.0.tar.gz.

File metadata

Download URL: quarb-0.11.0.tar.gz
Upload date: Jul 26, 2026
Size: 794.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for quarb-0.11.0.tar.gz
Algorithm	Hash digest
SHA256	`d42c6c99281ae864ea17b6a300b5f27a317902a77f86dcd6d3ea345c26bd1380`
MD5	`8447d7e7429e2b7f0ceef407326745fb`
BLAKE2b-256	`d831a3756a4e60490556b5c17ea4b003948ef0b9a5061508a2d90838fe04c470`

See more details on using hashes here.

Provenance

The following attestation bundles were made for quarb-0.11.0.tar.gz:

Publisher: publish-pypi.yml on deyanovich/quarb-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: quarb-0.11.0.tar.gz
- Subject digest: d42c6c99281ae864ea17b6a300b5f27a317902a77f86dcd6d3ea345c26bd1380
- Sigstore transparency entry: 2255228488
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: deyanovich/quarb-rs@fc0b9cef2944e3938b8d13d98d38b636431da795
- Branch / Tag: refs/tags/py/v0.11.0
- Owner: https://github.com/deyanovich
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@fc0b9cef2944e3938b8d13d98d38b636431da795
- Trigger Event: push

File details

Details for the file quarb-0.11.0-cp38-abi3-win_amd64.whl.

File metadata

Download URL: quarb-0.11.0-cp38-abi3-win_amd64.whl
Upload date: Jul 26, 2026
Size: 10.1 MB
Tags: CPython 3.8+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for quarb-0.11.0-cp38-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`bb744d0e374e599ec786fd8e9a1846687872994c1239e080ae0f5bdaba5977b4`
MD5	`e3455877f721c006785705e9024661da`
BLAKE2b-256	`3a3759bec9d3d3ed4685fb9fb44b1da0cb93daa0774311001f2458e596a8fd19`

See more details on using hashes here.

Provenance

The following attestation bundles were made for quarb-0.11.0-cp38-abi3-win_amd64.whl:

Publisher: publish-pypi.yml on deyanovich/quarb-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: quarb-0.11.0-cp38-abi3-win_amd64.whl
- Subject digest: bb744d0e374e599ec786fd8e9a1846687872994c1239e080ae0f5bdaba5977b4
- Sigstore transparency entry: 2255228499
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: deyanovich/quarb-rs@fc0b9cef2944e3938b8d13d98d38b636431da795
- Branch / Tag: refs/tags/py/v0.11.0
- Owner: https://github.com/deyanovich
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@fc0b9cef2944e3938b8d13d98d38b636431da795
- Trigger Event: push

File details

Details for the file quarb-0.11.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: quarb-0.11.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 26, 2026
Size: 10.5 MB
Tags: CPython 3.8+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for quarb-0.11.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`2fe0f9bec778159743dd567b7ff268254d99daaf49706f62ee34efcff8d49b71`
MD5	`def05e288898a9cd5e1133d12f5d316d`
BLAKE2b-256	`2200ef60b1cda2f8033af3ff30d9ebad10ef1a9926c430202bf73a92ec0a79bb`

See more details on using hashes here.

Provenance

The following attestation bundles were made for quarb-0.11.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: publish-pypi.yml on deyanovich/quarb-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: quarb-0.11.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: 2fe0f9bec778159743dd567b7ff268254d99daaf49706f62ee34efcff8d49b71
- Sigstore transparency entry: 2255228515
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: deyanovich/quarb-rs@fc0b9cef2944e3938b8d13d98d38b636431da795
- Branch / Tag: refs/tags/py/v0.11.0
- Owner: https://github.com/deyanovich
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@fc0b9cef2944e3938b8d13d98d38b636431da795
- Trigger Event: push

File details

Details for the file quarb-0.11.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: quarb-0.11.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jul 26, 2026
Size: 10.0 MB
Tags: CPython 3.8+, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for quarb-0.11.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`098b363e347a27c108a0cc546587b234e58587e119225880d3af032441b2c7dd`
MD5	`8191daf3389e7ab5f9e105d60303f7a8`
BLAKE2b-256	`987f2c3d84c87ccb06329803c97cc3fa95b83366599432480be99e2dab7b976b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for quarb-0.11.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: publish-pypi.yml on deyanovich/quarb-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: quarb-0.11.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: 098b363e347a27c108a0cc546587b234e58587e119225880d3af032441b2c7dd
- Sigstore transparency entry: 2255228494
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: deyanovich/quarb-rs@fc0b9cef2944e3938b8d13d98d38b636431da795
- Branch / Tag: refs/tags/py/v0.11.0
- Owner: https://github.com/deyanovich
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@fc0b9cef2944e3938b8d13d98d38b636431da795
- Trigger Event: push

File details

Details for the file quarb-0.11.0-cp38-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: quarb-0.11.0-cp38-abi3-macosx_11_0_arm64.whl
Upload date: Jul 26, 2026
Size: 9.4 MB
Tags: CPython 3.8+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for quarb-0.11.0-cp38-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`fc54c21ae655a0ab91761ef6993cdf37847e238431ea7a59773173f01f2f2fc3`
MD5	`183290d11b0c2894cf045dd5f46fba35`
BLAKE2b-256	`5a89e33e87bb56c097258a3cafc3301753ba2c97bee9cb27764df4645a9ceebb`

See more details on using hashes here.

Provenance

The following attestation bundles were made for quarb-0.11.0-cp38-abi3-macosx_11_0_arm64.whl:

Publisher: publish-pypi.yml on deyanovich/quarb-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: quarb-0.11.0-cp38-abi3-macosx_11_0_arm64.whl
- Subject digest: fc54c21ae655a0ab91761ef6993cdf37847e238431ea7a59773173f01f2f2fc3
- Sigstore transparency entry: 2255228509
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: deyanovich/quarb-rs@fc0b9cef2944e3938b8d13d98d38b636431da795
- Branch / Tag: refs/tags/py/v0.11.0
- Owner: https://github.com/deyanovich
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@fc0b9cef2944e3938b8d13d98d38b636431da795
- Trigger Event: push

File details

Details for the file quarb-0.11.0-cp38-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: quarb-0.11.0-cp38-abi3-macosx_10_12_x86_64.whl
Upload date: Jul 26, 2026
Size: 9.8 MB
Tags: CPython 3.8+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for quarb-0.11.0-cp38-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`344750cf8e51e89a8839894ffd4277bf935b8271f424c21c6ea2d0301139616d`
MD5	`72852f6e0afb5f0bc75cd3084ec03ecc`
BLAKE2b-256	`33b67e1fa3bc664510c0ffd4bcd0c9d52ebaacf6e7fb6875ec9e4d5b65bc9356`

See more details on using hashes here.

Provenance

The following attestation bundles were made for quarb-0.11.0-cp38-abi3-macosx_10_12_x86_64.whl:

Publisher: publish-pypi.yml on deyanovich/quarb-rs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: quarb-0.11.0-cp38-abi3-macosx_10_12_x86_64.whl
- Subject digest: 344750cf8e51e89a8839894ffd4277bf935b8271f424c21c6ea2d0301139616d
- Sigstore transparency entry: 2255228491
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: deyanovich/quarb-rs@fc0b9cef2944e3938b8d13d98d38b636431da795
- Branch / Tag: refs/tags/py/v0.11.0
- Owner: https://github.com/deyanovich
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@fc0b9cef2944e3938b8d13d98d38b636431da795
- Trigger Event: push