commonmeta-rs (Python bindings)
PyO3 bindings exposing commonmeta-rs's list-command batch functions to
Python: VRAIX daily-dump fetch with local caching, lossless Parquet
read/write, and batched archive rendering. Records cross the FFI boundary as
plain JSON-shaped dicts — the same shape commonmeta-py's own readers and
writers already produce and consume.
Install
uv pip install commonmeta-rs
Requires CPython 3.14 or newer. The wheels are built against the stable ABI
(abi3-py314), so one wheel per platform also covers later 3.x releases.
commonmeta-py itself keeps a 3.9 floor; only this backend needs 3.14.
Development
The interpreter must be 3.14+, matching requires-python; an older venv fails
to build rather than falling back.
uv venv --python 3.14 .venv
uv pip install --python .venv/bin/python maturin pytest
source .venv/bin/activate
maturin develop
pytest tests/
Release
Releases are published by hand. PyPI trusted publishing only issues OIDC identities to GitHub, GitLab, Google Cloud and ActiveState, and this repo lives on Codeberg, so CI cannot authenticate to PyPI — the workflow builds and tests wheels only.
The version comes from [workspace.package] in the root Cargo.toml and is
shared with the commonmeta crate, so a wheel names the release it wraps. Bump
it there, not here.
Build one wheel per platform plus the sdist, then publish. Both wheels build on
the host — no Docker. The macOS wheel is a native build; the Linux
manylinux wheel cross-compiles with zig as the C
cross-linker (maturin --zig). All commands are
run from python/.
rm -rf dist
# One-time: the Linux cross target and zig (a pip package, no system install).
rustup target add x86_64-unknown-linux-gnu
uv pip install --python .venv/bin/python ziglang
# macOS (native — arm64 on Apple silicon)
maturin build --release --out dist
# Linux (manylinux2014 x86_64), cross-compiled with zig — no Docker, no emulation.
maturin build --release --out dist --target x86_64-unknown-linux-gnu --zig
# Source distribution (lets other platforms build from source as a fallback)
maturin sdist --out dist
uv publish --token "$PYPI_TOKEN" dist/*
Publishing from one machine uploads only the wheels present in dist/; any
platform without a wheel falls back to building from the sdist. To ship
binaries for more platforms (Windows, Intel macOS, Linux aarch64), add the
matching maturin build --target … invocations or collect the wheels-*
artifacts from the CI workflow into dist/ first.
API
fetch_vraix(source, date, input_path=None, limit=None, offset=0, cache_ttl_days=30) -> list[dict]Fetch records from a VRAIX daily dump (sourceis"crossref"or"datacite"). Withinput_path, reads a local SQLite file directly (no network); otherwise downloads{source}-{date}.sqlite3.zstfrom metadata.vraix.org, caching it locally forcache_ttl_days.write_parquet(records: list[dict]) -> bytesWrite records as a single lossless Parquet file.read_parquet(data: bytes) -> list[dict]Read records back from Parquet bytes written bywrite_parquet.write_archive(records: list[dict], to: str, base_name: str, batch_size=100_000) -> list[tuple[str, bytes]]Render records totoformat, split into batches of at mostbatch_sizerecords, returned as(entry_name, bytes)pairs ready to pack into a zip/tar archive.convert(from_: str, to: str, input: str) -> bytesConvert a single record between formats.
1 maintainer
Metadata
1 maintainer
Release files for commonmeta-rs 0.9.89
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| commonmeta_rs-0.9.89-cp314-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.14 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| commonmeta_rs-0.9.89-cp314-abi3-macosx_11_0_arm64.whl | CPython 3.14 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 29.9 MB
Release files / commonmeta_rs-0.9.89-cp314-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | commonmeta_rs-0.9.89-cp314-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 15.0 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
38c1a5976b54406bd5408cb213c4d9cc3795a08a26bdc78140a95d47947000aa
|
|
BLAKE2b-256 checksum How to use checksums |
d1822dcd16fb191457b12b18a99091557e939c576615f0538ce63d67630c516a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / commonmeta_rs-0.9.89-cp314-abi3-macosx_11_0_arm64.whl
| Download URL | commonmeta_rs-0.9.89-cp314-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 14.9 MB |
| Tags | CPython 3.14 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
05e80e4015109f01c51e5faa1a2dd1e5c57275e608bcb44bd4974f0fbbc024cb
|
|
BLAKE2b-256 checksum How to use checksums |
f6248e99cb2a727a3d9126344b5996474a6df29668cac8b0b1b8132796592397
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for commonmeta-rs 0.9.89
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
