Я хотел бы создать полезную документацию для API REST, написанного на Python.
Я предполагаю, что это должно быть примерно так:
'''
/kittens/
This method creates kittens in the browser
HTTP Params:
format(default=json): The format in which kittens will be generated.
count(default=10): The number of kittens to generate.
Returns:
A list of kittens.
'''
Мой синтаксис, очевидно:
program = dict
dict = repeated(name:string | name:dict)
Я бы хотел разобрать этот формат и получить (например) диктон Python, желательно без использования регулярных выражений.
Есть ли уже доступный синтаксический анализатор для такого синтаксиса?
Если нет, то как проще всего определить и проанализировать DSL в Python?
Обратите внимание, что я бы предпочел , а не , чтобы использовать reStructuredText или любой другой формат, отличный от того, что я описал.