gov-service 0.0.4

gov-service: A local GOV (Geschichtliches Ortsverzeichnis) server service

gov-service

PyPi
GitHub
Code
Docs

A local GOV (Geschichtliches Ortsverzeichnis) server service, usable as an alternative GOV server via the GOV-Tag base_url option.

Command Line Testing

You can test queries directly from the command line using the scripts/gov_query tool:

# List available queries
scripts/gov_query -li

# Test the NameByGovId query with Schönberg's GOV-Kennung
scripts/gov_query -qn NameByGovId --params gov_id=SCHERGJO54EJ -f json

API Testing

When the service is running (e.g. via scripts/startup --gov), you can test the REST API endpoint directly using curl:

# HTML (default)
curl -s http://localhost:8000/item/wikihtml/SCHERGJO54EJ

# JSON via Accept header
curl -s -H "Accept: application/json" http://localhost:8000/item/show/SCHERGJO54EJ

# YAML via Accept header
curl -s -H "Accept: application/x-yaml" http://localhost:8000/item/show/SCHERGJO54EJ

# JSON via format query parameter (overrides Accept header)
curl -s "http://localhost:8000/item/show/SCHERGJO54EJ?format=json"

API Documentation

The service is built with FastAPI, which automatically provides interactive API documentation when the server is running:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Docs

GOV-Service on GOV-Wiki