CaltechDATA API Python Library
The caltechdata_api Python library provides a convenient interface for interacting with the CaltechDATA API. It allows users to write files, create DataCite 4 standard JSON records, edit existing records, and retrieve metadata from the CaltechDATA repository.
Features
Writing and Editing Records
caltechdata_write: Writes files and a DataCite 4 standard JSON record to the CaltechDATA repository.caltechdata_edit: Edits existing records in CaltechDATA.
Metadata Operations
get_metadata: Retrieves metadata from CaltechDATA records.
Requirements
- Python 3.9+
Installation
Install the library via pip:
pip install caltechdata_api
Or add it to a uv project:
uv add caltechdata_api
You can also run a script using uv:
uv run write.py
Examples
There are some example python scripts in the GitHub repository.
Create a record:
uv run write.py example.json -fnames logo.gif
# Output: pbkn6-m9y63 (unique identifier)
The response will be the unique identifier for the record. You can put this at the end of a url to visit the record (e.g. https://data.caltechlibrary.dev/records/pbkn6-m9y63)
Edit a record
Make changes to the example.json file to see a change)
uv run edit.py example.json -id pbkn6-m9y63
10.33569/pbkn6-m9y63
The response is the DOI for the record, which includes the unique identifier for the record in the default configuration.
Using Custom DOIs
Some groups have worked with the library to create custom DOIs. These can be passed in the metadata like:
uv run write.py example_custom.json -fnames logo.gif
m6zxz-p4j22
And then you can edit with
uv run edit.py example_custom.json -id m6zxz-p4j22
10.5281/inveniordm.1234
This returns the custom DOI of the record if it is successful.
Setup and Authentication
- Acquire a personal access token from your CaltechDATA account (found under "Applications" at the top right of your screen).
- Copy the token to a file named token.bash.
- Load the token in the command line using source token.bash.
Note on Testing
Only test your application on the test repository (data.caltechlibrary.dev). Testing the API on the public
repository will generate junk records that are annoying to delete.
Using the Command Line Interface
If you would like to interact with the CaltechDATA API using the Command line Interface (CLI), please see the detailed documentation.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file caltechdata_api-2.2.0.tar.gz.
File metadata
- Download URL: caltechdata_api-2.2.0.tar.gz
- Upload date:
- Size: 46.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
86a790b80712d90ad6aa28154000198eada06c9946e4a1c4b98970ede58607e8
|
|
| MD5 |
853a37f9334b89cbbd1fe0a990d5e314
|
|
| BLAKE2b-256 |
7dbfb988484b1d1c73f4450ca648327efd003c073e96785c88d0e7040fb3f47d
|
File details
Details for the file caltechdata_api-2.2.0-py3-none-any.whl.
File metadata
- Download URL: caltechdata_api-2.2.0-py3-none-any.whl
- Upload date:
- Size: 48.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
68e9ce2995d2752721f63d4852d71cab6d1f1a4ba6587a044a19bdeb0fb8e2e4
|
|
| MD5 |
e47c134e45cbd53ba8fcadfefaaf1beb
|
|
| BLAKE2b-256 |
04c5a498a5006ae07d164e3d2a8af061d4d8e0f281f07acf7e98f3c06f02bf0b
|
