P
Коллеги, кто-нибудь генерирует на базе кода на эликсире публичную апи документацию?
Да, юзаем https://github.com/api-hogs/bureaucrat
Size: a a a
2020 September 24
P
Ничего лучше не нашел, пока 🙂
ML
Да, юзаем https://github.com/api-hogs/bureaucrat
А у вас результат публичный? Можно посмотреть?
P
Нет, не публичный. Мы юзаем то, что генерирует .md документацию, нам пока хватает, там есть интеграция со Slate и т.п. я смотрел мельком, нам пока не понадобилось.
ML
Те это доя внутреннего пользования?
P
Да
AN
Коллеги, кто-нибудь генерирует на базе кода на эликсире публичную апи документацию?
есть еще такая штука: https://github.com/open-api-spex/open_api_spex вроде живая, но хз кто в проде использует
Y
У нас open_api_spex, доку рендерим через redoc. Вот так выглядит
ML
нравится?
P
А open_api_spex как гарантирует то, что у вас дока актуальная? 🙂
P
Просто бюрократ - это дока из тестов
Y
нравится?
Да вполне
ML
А open_api_spex как гарантирует то, что у вас дока актуальная? 🙂
а мы вот тестируем куски кода из доки
ML
Да вполне
спасибо!
Y
А open_api_spex как гарантирует то, что у вас дока актуальная? 🙂
Мы пишем спеку и валидируем ответы по ней
P
Мы пишем спеку и валидируем ответы по ней
Не увидел там assert_spec, прикольно! Гляну, спасибо за наводочку
SS
V
Во-первых, матчу по трём. Во-вторых, какая разница? Он ругается на
The pattern can never match the type.a value что в себя включает? может диалайзер имеет ввиду как раз то, что вариант {:error, :reason1} никогда не сможет сматчиться.
SS
хотя value тут конечно ни при чем )
DE
Всем привет!
В следующую пятницу (2 октября), в Питере, приглашаю испить вкусного пивка в компании эликсирщиков и сочувствующих
https://www.meetup.com/ru-RU/Elixir-Lang-St-Petersburg/events/lkmkxrybcnbdb
В следующую пятницу (2 октября), в Питере, приглашаю испить вкусного пивка в компании эликсирщиков и сочувствующих
https://www.meetup.com/ru-RU/Elixir-Lang-St-Petersburg/events/lkmkxrybcnbdb
IK
Где вы сейчас находитесь?
Анонимный опрос
Проголосовало: 126