Metadata-Version: 2.4
Name: pid4cat-model
Version: 0.4.2
Summary: Python model equivalent of LinkML datamodel for handle-based PIDs for resources in catalysis (pid4cat)
Author-email: David Linke <david.linke@catalysis.de>
Maintainer-email: David Linke <david.linke@catalysis.de>
License-Expression: MIT
License-File: LICENSE
Requires-Python: <4.0,>=3.11
Requires-Dist: click<8.2.0,>=8.1.7
Requires-Dist: httpx<0.29.0,>=0.28.1
Requires-Dist: linkml-runtime>=1.9.2
Description-Content-Type: text/markdown

[![CI - main](https://github.com/nfdi4cat/pid4cat-model/actions/workflows/main.yaml/badge.svg)](https://github.com/nfdi4cat/pid4cat-model/actions/workflows/main.yaml)
[![CI - docs](https://github.com/nfdi4cat/pid4cat-model/actions/workflows/deploy-docs.yaml/badge.svg?branch=main)](https://github.com/nfdi4cat/pid4cat-model/actions/workflows/deploy-docs.yaml)
[![PyPI - Version](https://img.shields.io/pypi/v/pid4cat-model)](https://pypi.org/project/pid4cat-model)
[![DOI](https://zenodo.org/badge/728357011.svg)](https://doi.org/10.5281/zenodo.15173682)

# Python package for pid4cat persistent identifiers

The package helps to interface the **pid4cat service**, a service offered by NFDI4Cat for metadata rich, universal persistent identifiers.
pid4cat builds upon the handle-system (as DOIs do). pid4cat adds a **custom API** to a handle server and provides a **LinkML model for  PID-related metadata**.
The metadata are stored in the handle records.

This Python package includes an equivalent Python (pydantic) model of the LinkML-based datamodel for the metadata of pid4cat identifiers.
It moreover includes some helpers to simplify using pid4cat identifiers.

## Installation

The pid4cat Python is [published on PyPI](https://pypi.org/project/pid4cat) and can be installed in the usual  way

```bash
pip install pid4cat-model
```

## Documentation

- Jupyter notebooks in [examples/](https://github.com/nfdi4cat/pid4cat-model/tree/main/examples) folder.
- Short introduction in [pid4cat Python package](https://nfdi4cat.github.io/pid4cat-model/latest/tools/#pid4cat-model-python-package) section.

## Contributors

See main [README](https://github.com/nfdi4cat/pid4cat-model/blob/main/README.md).

## License

The pid4cat Python package is distributed under the MIT license.

## Acknowledgement

This project started as an in-kind contribution of [Leibniz-Institut für Katalyse e.V.](https://www.catalysis.de) (Rostock, Germany) to the NFDI4Cat project.

After 2024-03-27 this work has been funded by the German Research Foundation (DFG) through the project "[NFDI4Cat](https://www.nfdi4cat.org) - NFDI for Catalysis-Related Sciences" (DFG project no. [441926934](https://gepris.dfg.de/gepris/projekt/441926934)), within the National Research Data Infrastructure ([NFDI](https://www.nfdi.de)) programme of the Joint Science Conference (GWK).
