bookops-nypl-platform client

BookOps Python wrapper around NYPL Platform API

Requries Python 3.7 & up.

bookops-nypl-platform client provides a Python interface for the internal NYPL Platform API. It provides functionality relevant to BookOps and is not a full implementation of the NYPL Platform API.

Version

0.4.0

Installation

Install via pip:

python -m pip install git+https://github.com/BookOps-CAT/bookops-nypl-platform

Basic usage

Access Token

>>>from bookops_nypl_platform import PlatformToken
>>>token=PlatformToken("my_client_id", "my_client_secret", "oauth_server")
>>>print(token)
"<token: token_string_here, expires_on: 2019-01-01 17:59:59, token_request_response: {'access_token': 'token_string_here', 'expires_in': 3600, 'token_type': 'Bearer', 'scope': 'scopes_here', 'id_token': 'token_string_here'}>"

Retrieve bibs by ISBN

>>>from bookops_nypl_platform import PlatformSession
>>>session = PlatformSession(authorization=token, agent="my_client")
>>>response = session.search_standardNos(keywords=["9780316230032", "0674976002"])
>>>print(response.status_code)
200
>>>print(response.json()) 

{
    "data": [
        {
            "id": "21790265",
            "nyplSource": "sierra-nypl",
            "nyplType": "bib",
            "updatedDate": "2019-07-30T13:38:44-04:00",
            "createdDate": "2019-04-24T16:27:41-04:00",
            "deletedDate": null,
            "deleted": false,
            "locations": [
                {
                    "code": "mal",
                    "name": "SASB - Service Desk Rm 315"
                },
                {
                    "code": "mal",
                    "name": "SASB - Service Desk Rm 315"
                }
            ],
            "suppressed": false,
            "lang": {
                "code": "eng",
                "name": "English"
            },
            "title": "Blueprint : the evolutionary origins of a good society",
            "author": "Christakis, Nicholas A. author.",
            "materialType": {
                "code": "a",
                "value": "BOOK/TEXT"
            },        
        }
    ],
    "count": 1,
    "totalCount": 0,
    "statusCode": 200,
    "debugInfo": []
}

Retrieve bibs by control numbers
context manager:

with PlatformSession(authorization=token) as session:
    response = session.search_controlNos([["1089804986", "1006480637"]])

Changelog

0.4.0 - 2023-12-28

Changed

• conftest.py updated path to credentials
• dependencies:
  • certifi (2023.11.17)
  • requests (2.31.0)
• dev dependencies:
  • black (22.12.0)
  • mike (0.5.5)
  • mkapi (1.0.14)
  • mkdocs (1.5.3)
  • pytest (6.2.5)
  • pytest-cov (2.12.1)
  • pytest-mock (3.11.1)

0.3.0 - 2022-02-05

Changed

• Dependencies update:
  • requests to 2.27.1
  • urllib3 to 1.26.8
  • dev dependencies update
• CI moved to Github-Actions
  • adds Python 3.10

0.2.1 - 2021-10-29

Fixed

• Metadata fixes in pyproject.toml to indicate the client supports Python 3.7

Changed

• Dependencies updates

0.2.0 - 2020-10-27

Added

• /v0.1/items get_item_list a method to retrieve a list of item records

References

• NYPL Platform API Swagger
• NYPL Platform API Documentation
• ruby-nypl-platfom-api-client