Python-клиент для API нулевого уровня

[Kraysent]

После выполенения #83 для удобства пользования API нужно будет сделать клиент для загрузки данных и даже потенциально выложить его на PyPi для того, чтобы его можно было устанавливать через pip.

Хочется изначально сделать его в таком формате, чтобы в дальнейшем его можно было встроить в astroquery: https://astroquery.readthedocs.io/en/latest/index.html

[Kraysent]

Пока что кажется что в нём должно быть 5 методов:

• Создание библиографии (#88)
• Получение списка библиографий
• Получение библиографии по id
• Создание таблицы нулевого уровня (#83)
• Запись данных на нулевой уровень (#83)

[Kraysent]

Хочется попробовать заиспользовать кодогенерацию тут и не мучаться с поддержкой конкретных endpoint-ов.

Генерация клиента из openapi3 спеки: https://github.com/openapi-generators/openapi-python-client/tree/main

Сейчас мы генерируем openapi2 спеку, есть два варианта решения проблемы:

• продолжать генерировать v2, но после генерации конвертировать её в v3 при помощи first-party конвертера: https://stackoverflow.com/questions/59749513/how-to-convert-openapi-2-0-to-openapi-3-0
• начать генерировать v3 спеку, кажется, это можно сделать при помощи https://github.com/marshmallow-code/apispec и https://github.com/marshmallow-code/apispec-webframeworks, там есть плагин для aiohttp.

[Kraysent]

В итоге хочу сделать частичную кодогенерацию: генерировать модель из библиотеки https://github.com/koxudaxi/datamodel-code-generator А методы написать нормальные.

Указанная в прошлом комментарии библиотека очень много всего лишнего генерит и в итоге даёт не очень удобный клиент, просто генерировать модели в dataclass'ы выглядит попроще и более легко для поддержания.

[Kraysent]

По мере появления новых стабильных методов API будем дописывать этот клиент, пока задачу закрываю