Athemis/doi2dataset
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions
doi2dataset is a Python tool designed to process DOIs and generate metadata for Dataverse.org datasets. It retrieves metadata from external APIs (such as OpenAlex and CrossRef), maps metadata fields, and can optionally upload the generated metadata to a Dataverse.org instance.
15 commits 1 branch 1 tag 88 KiB
Python 100%
Find a file
Exact
Alexander Minges 314da684d1
All checks were successful
Test pipeline / test (push) Successful in 11s
Details
Update README.md
2025-03-21 16:19:08 +01:00
.forgejo/workflows Use example config for tests 2025-03-21 16:06:28 +01:00
docs Initial commit and release of doi2dataset 2025-03-21 14:53:23 +01:00
tests Use example config for tests 2025-03-21 16:06:28 +01:00
.gitignore Include missing json for tests 2025-03-21 15:57:29 +01:00
__init__.py Initial commit and release of doi2dataset 2025-03-21 14:53:23 +01:00
config_example.yaml Initial commit and release of doi2dataset 2025-03-21 14:53:23 +01:00
doi2dataset.py Initial commit and release of doi2dataset 2025-03-21 14:53:23 +01:00
LICENSE.md Fix copy-pase error in LICENSE.md 2025-03-21 14:59:59 +01:00
README.md Update README.md 2025-03-21 16:19:08 +01:00
requirements-dev.txt Update requirements-dev.txt 2025-03-21 15:53:09 +01:00
requirements-doc.txt Initial commit and release of doi2dataset 2025-03-21 14:53:23 +01:00
requirements.txt Initial commit and release of doi2dataset 2025-03-21 14:53:23 +01:00
setup.py Initial commit and release of doi2dataset 2025-03-21 14:53:23 +01:00

README.md

doi2dataset

Test Status

doi2dataset is a Python tool designed to process DOIs and generate metadata for Dataverse.org datasets. It retrieves metadata from external APIs (such as OpenAlex and CrossRef), maps metadata fields, and can optionally upload the generated metadata to a Dataverse.org instance.

Features

  • DOI Validation and Normalization: Validates DOIs and converts them into a standardized format.
  • Metadata Retrieval: Fetches metadata such as title, abstract, license, and author information from external sources.
  • Metadata Mapping: Automatically maps and generates metadata fields (e.g., title, description, keywords) including support for controlled vocabularies and compound fields.
  • Optional Upload: Allows uploading of metadata directly to a Dataverse.org server.
  • Progress Tracking: Uses the Rich library for user-friendly progress tracking and error handling.

Installation

Clone the repository from GitHub:

git clone https://git.athemis.de/Athemis/doi2dataset
cd doi2dataset

Configuration

Configuration

Before running the tool, configure the necessary settings in the config.yaml file located in the project root. This file contains configuration details such as:

  • Connection details (URL, API token, authentication credentials)
  • Mapping of project phases
  • Principal Investigator (PI) information
  • Default grant configurations

Usage

Run doi2dataset from the command line by providing one or more DOIs:

python doi2dataset.py [options] DOI1 DOI2 ...

Command Line Options

  • -f, --file Specify a file containing DOIs (one per line).

  • -o, --output-dir Directory where metadata files will be saved.

  • -d, --depositor Name of the depositor.

  • -s, --subject Default subject for the metadata.

  • -m, --contact-mail Contact email address.

  • -u, --upload Upload metadata to a Dataverse.org server.

Documentation

Documentation is generated using Sphinx. See the docs/ directory for detailed API references and usage examples.

Testing

Tests are implemented with pytest. To run the tests, execute:

pytest

Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your improvements.

License

This project is licensed under the MIT License. See the LICENSE.md file for details.