Pylon
Async PostgreSQL mapper for the JALDIS platform. Provides a schema definition DSL, an PyQL query language, OpenSearch integration, and vector index support.
Requirements
- Python 3.13+
- PostgreSQL 18+
Installation
pip install pylon-db
For the native Rust client — PyQL queries from Rust, no Python interpreter
involved — add the pylon-db-client crate instead:
[dependencies]
pylon-db-client = "0.7"
It is published as pylon-db-client and imported as pylon_client; see the
Rust client reference.
Configuration
Pylon is configured programmatically via Config and its child dataclasses.
import os
from pylon import Client, Config, DatabaseConfig, SearchConfig, ModelConfig
client = Client(
config=Config(
database=DatabaseConfig(
host="localhost",
port=5432,
name="mydb",
user="myuser",
password=os.environ["PYLON_DB_PASSWORD"],
),
search=SearchConfig(
host="localhost",
port=9200,
password=os.environ["PYLON_SEARCH_PASSWORD"],
),
models=ModelConfig(
api_style="openai",
api_url="https://api.openai.com",
model="text-embedding-3-small",
secret=os.environ["OPENAI_API_KEY"],
),
)
)
A pylon.toml file can be used instead via load_config():
from pylon import Client
from pylon.config import load_config
client = Client(config=load_config())
See the configuration reference for the full pylon.toml schema.
Development
Pylon is a Rust workspace plus a Python package; the two are joined by a
PyO3 extension module (pylon._core) built with maturin.
Building
maturin develop # builds pylon._core into the active virtualenv
pip install -e ./ # maturin develop alone can leave a stale .so behind
The test suite fails fast with a "rebuild it" message if pylon._core is
older than the Python code being tested against it, rather than silently
skipping the affected tests.
Testing
python -m pytest # Python suite (live-DB tests excluded)
cargo test --workspace --exclude pylon-py # Rust suite
--exclude pylon-py is required, and is not the same caveat as excluding it
from linting. PyO3 extension modules link against the interpreter through
build configuration that only maturin supplies, so a plain cargo build or
cargo test on that crate fails at the link step with undefined symbols
(_PyList_New, _Py_NoneStruct, …). It still type-checks fine, which is
why CI runs cargo clippy -p pylon-py --lib separately — that crate is the
only consumer of several pylon-core/pylon-pgcon APIs, so skipping it
entirely would let a signature change break the extension unnoticed.
Live-Postgres tests are opt-in and need a throwaway database:
export PYLON_PGCON_TEST_DSN=postgresql://postgres:postgres@localhost:5432/pylon_live_test
cargo test --workspace --exclude pylon-py -- --ignored --test-threads=1
python -m pytest -m live_db
These create and drop schemas freely — never point them at a real database.
Linting
cargo clippy --workspace --exclude pylon-py --all-targets -- -D warnings
cargo clippy -p pylon-py --lib -- -D warnings
cargo fmt --check
ruff check pylon tests
ruff format --check pylon tests
1 maintainer
Metadata
1 maintainer
Release files for pylon-db 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pylon_db-0.7.0.tar.gz | 1.1 MB | Details |
Built distributions (wheels)
Total release size: 76.8 MB
Release files / pylon_db-0.7.0.tar.gz
| Download URL | pylon_db-0.7.0.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6eba5652b1ec776ea55e42b9403a037387ccc54ef50cf93de57d3d37f5b50476
|
|
BLAKE2b-256 checksum How to use checksums |
2731cc5ad5e1ebcf857f36dc7c9a0c3bc0a06e68366241c1eb9b97090e6fdae3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp315-cp315-win_amd64.whl
| Download URL | pylon_db-0.7.0-cp315-cp315-win_amd64.whl |
|---|---|
| Size | 5.9 MB |
| Tags | CPython 3.15 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
72da52230d196cbf130764ac91eb7ed1f1f4532c4f39adcf291df8b5d6f307c6
|
|
BLAKE2b-256 checksum How to use checksums |
fdd1908718fcff616aff900d7def6b05028c7137530b458d0f427f614c9433f7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp315-cp315-manylinux_2_28_x86_64.whl
| Download URL | pylon_db-0.7.0-cp315-cp315-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.15 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
7f97415a554918298b5c317018280ccc5e9644fed788e0d4f5e67017315c5da1
|
|
BLAKE2b-256 checksum How to use checksums |
e171aea088e3ba9994d6fbe4f7574cb8745c69a7c27b42aa722416ee13c63c21
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp315-cp315-manylinux_2_28_aarch64.whl
| Download URL | pylon_db-0.7.0-cp315-cp315-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | CPython 3.15 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
af51d4c729ad9c21469ee9160164777c30bea0ec59a93114f341eb2ef74cdc76
|
|
BLAKE2b-256 checksum How to use checksums |
dfe25dfc202ec0842d78b9eec0eac824a49601c339d6c9863e6745a31f316510
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp315-cp315-macosx_11_0_arm64.whl
| Download URL | pylon_db-0.7.0-cp315-cp315-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.15 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
9039149c35064f7409032f2da7d6cf6a33545c159bbfcc398103bf5cf1433f62
|
|
BLAKE2b-256 checksum How to use checksums |
0be802895e8efc611ce340523b5c3be85896403dfcd4bdd779b53fb5299878f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp314-cp314-win_amd64.whl
| Download URL | pylon_db-0.7.0-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 5.9 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ae6789ebca6b71db14792f47bc1d02bd11d1ef0e912f11ba3b5df7b665fc00d0
|
|
BLAKE2b-256 checksum How to use checksums |
2d99bb56baac09de4452edddb697eef9f2ee1e3aeb4caf627154d30aa9879af9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp314-cp314-manylinux_2_28_x86_64.whl
| Download URL | pylon_db-0.7.0-cp314-cp314-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.14 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
c615b2f06b0104995d710c82644e2035a91128a7eff52e1673165e189d18bcf3
|
|
BLAKE2b-256 checksum How to use checksums |
83aef319489fd6acbd47bad91f723498a58bc966ad382a2923f0bf63e57676ec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp314-cp314-manylinux_2_28_aarch64.whl
| Download URL | pylon_db-0.7.0-cp314-cp314-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | CPython 3.14 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
a5e5e8a799ef8d85235c7d543b0dc1249c09366a4c5d7a4fa9ff9400d96b8389
|
|
BLAKE2b-256 checksum How to use checksums |
8ee82bb30316576ccb4d45e3b10fde5298b3563b222259f8448ae5441da8693d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | pylon_db-0.7.0-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b8a3454086fa9544fb2362522363167de84f965992bf33c568745cd832c4c5ff
|
|
BLAKE2b-256 checksum How to use checksums |
54c709eff56df0879377696ae8156547471a0f2077cc97b089d92deb4f0e96be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp313-cp313-win_amd64.whl
| Download URL | pylon_db-0.7.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 5.9 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
bbe89422584be1bdae002dc7e60f94d682e5ec8a1c2b785d5326a1aab9543067
|
|
BLAKE2b-256 checksum How to use checksums |
e6c80953431f80476691a3cc54f8ccd1c3984995411a01abfc7b04e739a242b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp313-cp313-manylinux_2_28_x86_64.whl
| Download URL | pylon_db-0.7.0-cp313-cp313-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
86fbe8809f8074b930af0bd346671be93c9c0ccb44c28b4bc2ab1b38c51ce6de
|
|
BLAKE2b-256 checksum How to use checksums |
e721157b3c8054d55bc090d202a6339dea1754dbb9ccaf563f0ff5a3a2055af3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp313-cp313-manylinux_2_28_aarch64.whl
| Download URL | pylon_db-0.7.0-cp313-cp313-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 6.7 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
c7345530d64b574746520aef739cfb4f6d5ad71601290c8f844bc30cf4615112
|
|
BLAKE2b-256 checksum How to use checksums |
0761230215261c26e09513db3b094529953f3a5734a08b375a13ec453879aa45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / pylon_db-0.7.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | pylon_db-0.7.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.1 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7f344ac0efa2b8b9a201c0099851b3531308a0d2d2e6abcfd9b8a065f5296a41
|
|
BLAKE2b-256 checksum How to use checksums |
4cfa4fa4d6a5ebf35414e14ece7a8570ce3515f6add476a9d749db0a711fe3d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency log
