Skip to main content

Grab data from Atom API with Python

Project description

Python AtoM API

This is a simple library for interacting with an AtoM archive within Python. This library works with Python version 3, and has been tested with AtoM version 2.5. All of the API interactions specified in the AtoM documentation all have easy-to-call python functions associated with them in this library. This includes:

  • Browsing Taxonomies
  • Browsing Information Objects
  • Reading Information Objects

This library also implements a virtual endpoint that can be used to retrieve all of the authorities stored in the archive. It does this by treating the front-end application as an API endpoint. For this reason, this operation is more fragile than calling the API directly and is not guaranteed to work with every version of AtoM and every theme.

Install

python -m pip install atomapi

Usage

To use the API, you will require an AtoM API key. To get data from the API, create an instance of the Atom class:

import atomapi

atom = atomapi.Atom('https://youratom.com', api_key='1234567890')

Fetch taxonomies, and view information objects like so:

subjects = atom.taxonomies.browse('subjects')
info_obj = atom.taxonomies.read('some-reference-code')
results = atom.taxonomies.browse(sq={'sq0': 'School'}, so={}, sf={'sf0': 'title'}, filters={})

For more examples, check out the examples folder.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

atomapi-0.1.0.tar.gz (11.1 kB view hashes)

Uploaded source

Built Distribution

atomapi-0.1.0-py3-none-any.whl (28.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page