kglite-datasets
Fetch-build-cache dataset loaders for kglite —
pull a public registry, build it into a queryable kglite KnowledgeGraph, cache
the result. Extracted from kglite::datasets into a standalone crate + wheel so
the kglite engine links zero network code.
Bundled sources:
- SEC EDGAR — quarterly index, bulk submissions, per-form fetchers, XBRL company facts.
- Sodir — Norwegian Offshore Directorate registry.
- Wikidata — dump download / cache orchestration (heavy ingestion stays engine-side).
Install
pip install kglite-datasets # ships the loaders + Python interface; pulls kglite
The single wheel bundles the Rust loaders and the Python interface; the graph
engine is reused from kglite (a runtime dependency), not forked.
Usage
Each loader fetches its source, builds it into a kglite KnowledgeGraph, and
caches the result under a workdir — returning a graph ready to query:
# SEC EDGAR — name a form, a company, a span:
from kglite_datasets.sec import SEC
g = SEC.fetch(workdir, "13F-HR", "TSLA", years=2, user_agent="Name email@dom")
# Sodir (Norwegian Offshore Directorate):
from kglite_datasets import sodir
g = sodir.open(workdir)
# Wikidata truthy dump (cache-managed download + N-Triples build):
from kglite_datasets import wikidata
g = wikidata.open(workdir)
# Each call above returns a KnowledgeGraph — query the one you built:
g.cypher("MATCH (n) RETURN labels(n) AS labels, count(*) AS nodes ORDER BY nodes DESC LIMIT 5")
Importing sec never drags in sodir/wikidata's optional stack (lazy
submodules), so the SEC path stays light.
Rust
Rust embedders use the crate-root modules directly (they mirror kglite's former
api::datasets::<loader> surface): kglite_datasets::{sec, sodir, wikidata}.
Status
Alpha — extraction complete. Followed the codingest handover playbook:
copy → prove parity → freeze goldens + bench baseline (while kglite still had its
in-tree copy) → kglite removed its loaders (2026-07-16). With the in-tree copy
gone, the frozen goldens (tests/goldens/) and the frozen bench baseline
(benchmarks/baseline.json) are the sole oracles carrying that verified-correct
authority forward.
Development
make gate # CI-equivalent local gate: lint · build · test · determinism · bench-smoke
make lint # cargo fmt --check + clippy -D warnings (+ ruff if installed)
make develop # maturin develop — build the extension into the active venv
make pytest # offline Python suite (live-API tests behind the `live` marker)
The Rust workspace: crates/kglite-datasets (engine-free loaders) +
crates/kglite-datasets-py (PyO3 wrapper → the wheel). Loaders fetch → parse →
emit CSV/blueprint/dump; the graph build reuses kglite's from_blueprint /
load_ntriples. All tests are offline (recorded HTTP fixtures); live-API
smokes are opt-in.
Links
- Documentation: https://kglite-datasets.readthedocs.io
- PyPI: https://pypi.org/project/kglite-datasets/ (
pip install kglite-datasets) - crates.io: https://crates.io/crates/kglite-datasets (
cargo add kglite-datasets) - kglite engine: https://github.com/kkollsga/kglite
Badges and links point at the initial 0.1.0 release; there are no prior
published versions.
License
MIT © Kristian dF Kollsgård
1 maintainer
Metadata
1 maintainer
Release files for kglite-datasets 0.1.25
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kglite_datasets-0.1.25.tar.gz | 275.6 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| kglite_datasets-0.1.25-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details |
| kglite_datasets-0.1.25-cp310-abi3-manylinux_2_28_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| kglite_datasets-0.1.25-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| kglite_datasets-0.1.25-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
| kglite_datasets-0.1.25-cp310-abi3-macosx_10_12_x86_64.whl | CPython 3.10 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 10.7 MB
Release files / kglite_datasets-0.1.25.tar.gz
| Download URL | kglite_datasets-0.1.25.tar.gz |
|---|---|
| Size | 275.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
507de221103fb226a858c798e3f6e4c0685f96987d1f353899043b86b70498c1
|
|
BLAKE2b-256 checksum How to use checksums |
04b1ef019c6e3c4eae64a36499086bd606a1bc352a26795aab8394acf0218f77
|
| 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 5, 2026.
Transparency logRelease files / kglite_datasets-0.1.25-cp310-abi3-win_amd64.whl
| Download URL | kglite_datasets-0.1.25-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 2.1 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
607e005635d9595072b8eec655dc506099d0344ca5ae374332060ae1043a876e
|
|
BLAKE2b-256 checksum How to use checksums |
ce884531de2c1849f09faaba6a8b0fc25c94c96e9b2ef2a08395e04363e16b20
|
| 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 5, 2026.
Transparency logRelease files / kglite_datasets-0.1.25-cp310-abi3-manylinux_2_28_aarch64.whl
| Download URL | kglite_datasets-0.1.25-cp310-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 2.1 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
c158f628119d6d2c431cb6b6de49fc42e5247e4e90dd91b6356c21bc4e1bf96e
|
|
BLAKE2b-256 checksum How to use checksums |
03bafe0de72047472dc3f808d96ccce9d7a3e3f5b49808959d185979fd38544e
|
| 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 5, 2026.
Transparency logRelease files / kglite_datasets-0.1.25-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | kglite_datasets-0.1.25-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
60dac412da98a846f581c92dd165a0f79aae61c86bee54c0f53b99acf38199b1
|
|
BLAKE2b-256 checksum How to use checksums |
6a155ad481f9f99afd99d363befec8bf0e339ed6bfe0a5f786c45253287e76f3
|
| 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 5, 2026.
Transparency logRelease files / kglite_datasets-0.1.25-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | kglite_datasets-0.1.25-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
fd766753a9700e4ea3c8ca0068145b86ae606a5d750263008d9a2ce55a6a0349
|
|
BLAKE2b-256 checksum How to use checksums |
af3d5aebdb580896b2e7a73c07d2ce8bf6dc40f97f43aed17408b56f33c29e1c
|
| 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 5, 2026.
Transparency logRelease files / kglite_datasets-0.1.25-cp310-abi3-macosx_10_12_x86_64.whl
| Download URL | kglite_datasets-0.1.25-cp310-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 2.1 MB |
| Tags | CPython 3.10 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
f87bfbd79704239edcbea7de9e2b0f81402a121d0e41ef2957fdd2c5475d860b
|
|
BLAKE2b-256 checksum How to use checksums |
a42332fd275d6362bd1e5ea97745fcb3d1458f0fb552ef472335ca9f3f60c671
|
| 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 5, 2026.
Transparency log
