from pathlib import Path
from fastapi.routing import APIRouter
from rootski.main.endpoints.breakdown.docs import ExampleResponse, make_apidocs_responses_obj
from starlette.responses import FileResponse
router = APIRouter()
[docs]@router.get(
"/morpheme/morphemes.json",
responses={
200: make_apidocs_responses_obj(
[
ExampleResponse(
title="Morpheme Index",
body={
"1": {
"morpheme_id": 1,
"morpheme": "баб",
"type": "root",
"word_pos": "any",
"family_id": 0,
"meanings": [{"meaning": "old woman"}],
"level": 4,
"family": "баб",
},
"2": {
"morpheme_id": 2,
"morpheme": "бав",
"type": "root",
"word_pos": "any",
"family_id": 1,
"meanings": [{"meaning": "being,be"}],
"level": 2,
"family": "бав,бв,быв",
},
},
),
]
)
},
)
async def get_morphemes_json(): # request: Request, force: bool = False
"""
Get the morphemes.json file. This is used on the frontend as
an index of morphemes. This endpoint allows the frontend to fetch
all morphemes along with their data in one round trip.
One use of this is that it makes the performace of the breakdown
widget very fast.
NOTE: if the morphemes.json file does not exist locally, it
will be created here and cached on disk.
Query parameters:
force (boolean): forces regeneration of the morphemes.json file
"""
THIS_DIR = Path(__file__).parent.parent.parent
morpheme_json_fpath = THIS_DIR / "resources/morphemes.json"
return FileResponse(morpheme_json_fpath, media_type="application/json")