slubfind 1.11.0

query data exports from the SLUB catalog

With slubfind you can query data exports from the SLUB catalog in Python.

This package is based on txpyfind, which enables access to data exports from TYPO3-find.

Installation

… via PyPI

pip install slubfind

… or from GitHub source

pip install git+https://github.com/slub/slubfind.git

Command-Line Usage

After installation, the slubfind command is available (also via python -m slubfind). The base URL defaults to https://katalog.slub-dresden.de.

Query

Execute a search query:

slubfind query "manfred bonitz"

With a facet filter and pagination:

slubfind query "python" --facet "format_de14=Book, E-Book" --page 1 --count 10

Document

Fetch a single document by ID:

slubfind document "0-1132486122"

Scroll

Fetch all results for a query:

slubfind scroll "manfred bonitz" --batch 10

Stream results as JSONL (one JSON object per line), useful for piping:

slubfind scroll "manfred bonitz" --stream | jq .id

Settings

Show TYPO3-find settings:

slubfind settings

Solr Parameters

Show Solr parameters for a query:

slubfind solr-params "manfred bonitz"

Solr Request

Show Solr request URL for a query:

slubfind solr-request "manfred bonitz"

From URL

Use --from-url to query using a SLUB catalog URL instead of individual parameters. This works with query, scroll, solr-params, and solr-request:

slubfind query --from-url "https://katalog.slub-dresden.de/?tx_find_find%5Bq%5D%5Bdefault%5D=manfred+bonitz"
slubfind solr-params --from-url "https://katalog.slub-dresden.de/?tx_find_find%5Bq%5D%5Bdefault%5D=manfred+bonitz"

Show Request URL

Use --show-url to print the request URL instead of fetching the response. This works with all subcommands:

slubfind --show-url query "python" --facet "format_de14=Book, E-Book"
slubfind --show-url document "0-1132486122"
slubfind --show-url scroll "python" --batch 10

Export Format

Use --export-format to select the output format. The default is app.

Available formats:

• Query view (query): app, json-ld, json-all, raw-solr-response

• Detail view (document): app, json-ld, json-holding-status

The scroll subcommand always uses raw-solr-response internally. The formats json-solr-params and json-solr-request are used internally by the solr-params and solr-request subcommands.

Fetch a document in JSON-LD format:

slubfind document "0-1132486122" --export-format json-ld

Search in JSON-LD format:

slubfind query "manfred bonitz" --export-format json-ld

Fetch holding status for a document:

slubfind document "0-1132486122" --export-format json-holding-status

Query with raw Solr response:

slubfind query "manfred bonitz" --export-format raw-solr-response

Environment Variable

Set SLUBFIND_URL to override the default base URL:

export SLUBFIND_URL=https://katalog.slub-dresden.de
slubfind query "manfred bonitz"

Python Usage Example

from slubfind.client import SlubFind
# create SlubFind instance
slub_find = SlubFind()
# retrieve JSON data (query view, app format)
slub_q = slub_find.app_search("manfred bonitz")
# retrieve JSON data (detail view, app format)
slub_doc = slub_find.app_document("0-1132486122")
# retrieve JSON-LD data (detail view)
slub_jsonld = slub_find.jsonld_document("0-1132486122")
# retrieve JSON-LD data (query view)
slub_jsonld_q = slub_find.jsonld_search("manfred bonitz")
# retrieve holding status (detail view)
slub_hs = slub_find.holding_status_document("0-1132486122")