bookops-sierra

A Sierra API wrapper supporting v6.8 and client credential grant flow of the API.

Installation

Basic usage

References

• Sierra API documentation
• Sierra Developer Network
• NYPL Test Sierra API version

Sample Test server bibs & items:

• b217595996
• i389995009
• i389994947

Changelog

0.2.0 - (4/10/2026)

Added

• support for /patrons/{id}/holds/requests and /patrons/{id}/holds endpoints to create and get hold requests for patrons.
• py.typed marker and any missing type annotations
• additional unit tests to bring coverage up to 100%
• unit tests for Python 3.14 in github actions
• support for managing dependencies using uv. reformatted pyproject.toml to work with poetry 2.0 and uv.

Changed

• separated test coverage and unit tests into two github actions workflows
• error handling:
  • returns response from API rather than raising for status with each request so that response codes and messages are passed from the API to the user. Removed Query class to facilitate this.
  • changed BookopsSierraError to ValueError or TypeError where more appropriate

Removed

• unnecessary List, Dict, Tuple, and Union type imports (package only supports python 3.12+)
• magic strings from top of each module
• delay param from SierraSession