Metadata-Version: 2.5
Name: pkdb
Version: 0.11.1
Summary: Prepare, validate, query, and upload PK-DB studies
Project-URL: Homepage, https://pk-db.com
Project-URL: Documentation, https://matthiaskoenig.github.io/pkdb/
Project-URL: Repository, https://github.com/matthiaskoenig/pkdb
Project-URL: Issues, https://github.com/matthiaskoenig/pkdb/issues
Author: Matthias König
License-Expression: MIT
License-File: LICENSE
Keywords: pharmacokinetics,pk-db,validation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: <3.16,>=3.14
Requires-Dist: httpx2<3,>=2.13.0
Requires-Dist: numpy<3,>=2.5.3
Requires-Dist: openpyxl<4,>=3.1.5
Requires-Dist: pandas<4,>=3.0.6
Requires-Dist: pint<1,>=0.26.1
Requires-Dist: pkpdutils<2,>=1.2.0
Requires-Dist: pydantic<3,>=2.13.5; python_version < '3.15'
Requires-Dist: pydantic<3,>=2.14.0b2; python_version >= '3.15'
Requires-Dist: rich<16,>=15
Requires-Dist: scipy<2,>=1.18.1
Description-Content-Type: text/markdown

# PK-DB Python client

[![PyPI](https://img.shields.io/pypi/v/pkdb.svg)](https://pypi.org/project/pkdb/) [![Python versions](https://img.shields.io/pypi/pyversions/pkdb.svg)](https://pypi.org/project/pkdb/)

Prepare, validate, query, and upload pharmacokinetic studies with the same scientific validation engine used by the PK-DB server. Python 3.14 and 3.15 are supported on Linux, macOS, and Windows.

Install [pkdb from PyPI](https://pypi.org/project/pkdb/) with `python -m pip install pkdb`. For source installation, see [Development](https://matthiaskoenig.github.io/pkdb/development/).

Existing `pkdb_data` study folders work directly:

```bash
pkdb prepare studies/ExampleStudy
pkdb validate studies/ExampleStudy --offline
pkdb upload studies/ExampleStudy --endpoint https://alpha.pk-db.com
```

Preparation and validation work offline using the bundled vocabulary. Upload validates locally first and then the server validates the original files again. Set `PKDB_API_KEY` for authenticated operations and optionally `PKDB_ENDPOINT` for the default endpoint.

```python
from pkdb import prepare

prepared = prepare("studies/ExampleStudy")
print(prepared.study.sid)
```

See the [client documentation](https://matthiaskoenig.github.io/pkdb/python-client/) for vocabulary snapshots, structured reports, authentication, queries, and downloads.
