from flask_restx import Api, Model, fields
from dedoc.data_structures.annotation import Annotation
[docs]class SubscriptAnnotation(Annotation):
"""
Subscript text inside the line.
"""
name = "subscript"
valid_values = ["True", "False"]
[docs] def __init__(self, start: int, end: int, value: str) -> None:
"""
:param start: start of the subscript text
:param end: end of the subscript text (not included)
:param value: True if subscript else False (False usually isn't used because you may not use this annotation at all)
"""
try:
bool(value)
except ValueError:
raise ValueError("the value of subscript annotation should be True or False")
super().__init__(start=start, end=end, name=SubscriptAnnotation.name, value=value)
@staticmethod
def get_api_dict(api: Api) -> Model:
return api.model("SuperscriptAnnotation", {
"start": fields.Integer(description="annotation start index", required=True, example=0),
"end": fields.Integer(description="annotation end index", required=True, example=4),
"value": fields.String(description="indicator if the text is subscript ($a_1$ in tex) or not",
required=True,
example="True",
enum=SubscriptAnnotation.valid_values)
})