def error_parse_variable(dic: Dict[str, str]) -> str:
"""Explain why we a variable fails to parse"""
# pylint: disable=too-many-return-statements
assert Variable.from_dict(dic) is None
if "name" not in dic:
return "missing name field"
if not isinstance(dic["name"], str):
return "name field is not a string"
for field in ("comment", "type"):
if field not in dic:
return "missing {} field for {}".format(field, dic["name"])
if not isinstance(dic[field], str):
return "{} field for {} is not a string".format(field, dic["name"])
type_ = Type.from_string(dic["type"])
if type_ is None:
return "unable to parse type {} for {}: {}".format(
dic["type"], dic["name"], error_parse_type(dic["type"]))
if dic.get("format", "") == "no_endline" and type_.main != TypeEnum.INT:
return f'{dic["name"]} has format "no_endline" but is {dic["type"]}, not int'
if dic.get("format", "") == "force_newlines" and (
type_.main != TypeEnum.LIST or type_.encapsulated is None
or type_.encapsulated.main != TypeEnum.INT):
return (
f'{dic["name"]} has format "force_newlines" but is {dic["type"]}'
", not List[int]")
return "unknown error"
def error_parse_input(dic: Dict[str, Any]) -> str:
"""Explain why we an input fails to parse"""
# pylint: disable=too-many-return-statements
# pylint: disable=too-many-branches
assert Input.from_dict(dic) is None
if "function_name" not in dic:
if "name" in dic:
dic["function_name"] = dic["name"]
else:
return "missing function_name field"
if not isinstance(dic["function_name"], str):
return "function_name is not a string"
if "structs" in dic: # non mandatory
if not isinstance(dic["structs"], list):
return "'structs' is not a list"
for node in dic["structs"]:
if Struct.from_dict(node) is None:
return "failed to parse struct: " + error_parse_struct(node)
if "input" not in dic:
return "missing input field"
if not isinstance(dic["input"], list):
return "output is not a list"
for node in dic["input"]:
if Variable.from_dict(node) is None:
return "failed to parse variable: " + error_parse_variable(node)
if "output" not in dic:
return "missing output field"
if not isinstance(dic["output"], str):
return "output is not a string"
return "unknown error"
def error_parse_struct(
dic: Dict[str, Union[str, List[Dict[str, str]]]]) -> str:
"""Explain why we a struct fails to parse"""
# pylint: disable=too-many-return-statements
assert Struct.from_dict(dic) is None
if "name" not in dic:
return "missing name field"
if not isinstance(dic["name"], str):
return "name field is not a string"
for field in ("comment", "fields"):
if field not in dic:
return "missing {} field for {}".format(field, dic["name"])
if not isinstance(dic["comment"], str):
return "{} field for {} is not a string".format(field, dic["name"])
if not isinstance(dic["fields"], list):
return "fields field for {} is not a list".format(dic["name"])
for i in dic["fields"]:
if not isinstance(i, dict):
return "a field for {}.fields is not a map".format(dic["name"])
if Variable.from_dict(i) is None:
return "failed to parse field of {}: {}".format(
dic["name"], error_parse_variable(i))
return "unknown error"