kcidb-io

library141pypypiunverified

I/O library for KCIDB, the Linux Kernel CI reporting system. Handles schema validation, data loading, submission, and querying against Google Cloud Platform BigQuery. Current version 141 (2025), requires Python >=3.10, major schema v4 with renamed 'revisions' to 'checkouts'.

data gcp serialization database

pip install kcidb-io

github ↗package ↗

INSTALL

IMPORT

SIG · KCIDB-IO

kcidb-io

datapythonv141

Install

3.0s avg

Import

—

Disk

26MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v141 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 3.4s

py 3.11

✓ —

✓ 3.2s

py 3.12

✓ —

✓ 2.7s

py 3.13

✓ —

✓ 2.6s

py 3.9

✕ build_error

26MB installed

● package 26MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Client

✓ from kcidb_io import Client

✗ from kcidb_io import Client

Submit an empty v4 data structure to BigQuery dataset. Requires GCP credentials.

import os from kcidb import Client client = Client(project=os.environ.get('GCP_PROJECT', 'my-project'), dataset='kernelci04', credentials=os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', '')) client.submit({'version': {'major': 4, 'minor': 0}, 'checkouts': []})

Debug

Known issues

breakingSchema v4 renamed 'revisions' to 'checkouts'. Data using v3 field names will fail validation.

fix

Update all data to use 'checkouts' instead of 'revisions'. kcidb-io v141 (and its schema) no longer accepts 'revisions'.

affects: >=v3

deprecatedEnvironment variable KCIDB_GS_KEYFILE is deprecated. Use GOOGLE_APPLICATION_CREDENTIALS or explicit credentials parameter.

fix

Unset KCIDB_GS_KEYFILE and export GOOGLE_APPLICATION_CREDENTIALS='/path/to/key.json'.

affects: v2+

gotchaValidation of internal consistency is disabled by default. To enable, set KCIDB_VALIDATE_INTERNAL=1.

fix

Export KCIDB_VALIDATE_INTERNAL=1 in environment before importing.

affects: >=v2

Upgrade

Version history

141latest on PyPI · released Apr 8, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

30 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/kernelci/kcidb-io ↗

packagehttps://pypi.org/project/kcidb-io/ ↗