bookops-bpl-solr client

BookOps Python wrapper around BPL Solr service.

Requires Python 3.8 & up. Requires credentials from BPL WebApps.

version

0.4.0

Instalation

Install via pip:

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

Basic usage

Retrieve a specific Sierra bib:

with SolrSession(
    authorization="your_client_key", endpoint="solr_endpoint"
) as session:
    response = session.search_bibNo(10841318)
    print(response.json())

{
  "response": {
    "numFound": 1,
    "start": 0,
    "numFoundExact": true,
    "docs": [
      {
        "id": "10841318",
        "title": "The Civil War.",
        "author_raw": "Robertson, James I.",
        "created_date": "2002-08-31T21:14:32Z",
        "publishYear": 1963,
        "material_type": "Book",
        "call_number": "973.7 R651 C",
        "language": [
          "English"
        ]
      }
    ]
  }
}

Retrieve records matching particular ISBNs:

with SolrSession(authorization="your_client_key", endpoint="solr_endpoint") as session:
    response = session.search_isbns(
        ["9780810984912", "9781419741890", "0810984911"]
    print(response.status_code)
    print(response.url)

Retrive records by e-content reserve id (037$a MARC tag):

with SolrSession(authorization="your_client_key", endpoint="solr_endpoint") as session:
    response = session.search_reserveId("8CD53ED9-CEBD-4F78-8BEF-20A58F6F3857")

Retrieve expired e-content (Overdrive):

with SolrSession(authorization="your_client_key", endpoint="solr_endpoint") as session:
    response = session.find_expired_content()

Custom query:

with SolrSession(authorization="your_client_key", endpoint="solr_endpoint") as session:
    payload = {
        "q": "title:civil AND war",
        "fq": "ss_type:catalog",
        "fq": "material_type:Book",
        "rows": 20,
    }
    response = session._send_request(payload)

Changelog

0.4.0 - 2024-1-2

Added

• dev dependencies:
  • exceptiongroup (1.2.0)

Changed

• dependencies:
  • python 3.8
  • requests (2.31.0)
  • certifi (2023.11.17)
• dev dependencies:
  • black (22.12.0)
  • pytest (7.4.3)
  • pytest-cov (4.1.0)
  • pytest-mock (3.12.0)
• test_search_controlNo() edited with updated control numbers
• conftest.py path to credentials
• coverage configuration moved from .coveragerc to pyproject.toml
• master branch renamed to main
• GitHub-Actions updated
  • checkout and setup-python actions upgraded to v4
  • tests triggered only on push to main and PR to main
  • Python 3.11 and 3.12 added to tests

Fixed

• corrected application of two filters (fq) in live test request so both filters are used in a query

Removed

• dev dependencies:
  • atomicwrites
  • attrs
  • ghp-import
  • importlib-metadata
  • py
  • toml
  • typed-ast
  • zipp

0.3.0 - 2022-06-28

Added

• search_controlNo() to query by control number (MARC 001 tag)
• search_upcs() to query by UPC number (MARC 024 tag)
• dev dependencies:
  • mypy (0.961)
  • types-requests (2.28.0)

Fixed

• typing errors in session.py

0.2.0 - 2022-02-06

Changed

• dependencies:
  • certifi to 2021.10.8
  • requests to 2.27.1
  • urllib3 to 1.26.8
  • idna to 3.3
  • removed mkdocs, mike, mkapi
• CI moved from Travis to Github-Actions
  • added Python 3.10

0.1.1 - 2020-10-30

Fixed

• pyproject.toml python 3.9 compatibility added
• default py 3.8 env

Changed

• urllib3 bump from 1.25.10 to 1.25.11

References

• Apache Solr Reference Guide
• pysolr