As-A-Person: A simple Python library for converting URLs to citable people

Supports ORCID, ISNI, vCard, hCard, and jCard lookup and parsing. Everything is converted to the internal CitablePerson dataclass.

Motivation

Various metadata fromats, including DataCite and Frictionless require similar, but not identical, metadata for authors. Neither adheres to a particular standard nor supplies tools for resulving author URIs.

Prerequisites

• Python 3.11 runtime
• Pip for package installation

Installation

Install the dependencies into the environment with pip:

pip install -r requirements.txt
pip install .

Usage

Feed identifiers into the appropriate dereferencing function, e.g., orcid_to_person for an ORCID, to return a CitablePerson on success or raise a ValueError on failure.

Testing

python3 -m coverage run -m unittest discover -s test -p "*_test.py" && python -m coverage report --skip-covered
python -m coverage html

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Ryan Quinn - Initial work

License

MIT.