170 похожих чатов

Объясните мне, я не понимаю. В чём профит писать API

вручную? Как потом делать доку и гарантировать то, что она будет соответствовать валидаторам и т.п.? Чем не угодил go-swagger?

27 ответов

35 просмотров
Аноним

Обязательно ознакомлюсь с go-swagger, во-первых я не знал о нём, а во-вторых, думаю что мне как новичку стоит вручную всё писать, для начала

типа сначала писать спеку сваггера 2 года, а потом генерить хендлеры? и если что-то меняешь, то меняешь спеку и перегенеришь хендлеры?

Dmitriy-Sviridov Автор вопроса
Аноним
Обязательно ознакомлюсь с go-swagger, во-первых я ...

Вы напишете API, а потом фронтендер потребует дать ему документацию к API. Скорее всего, вы напишете её вручную. Гарантий, что она соответствует коду, никакой

Аноним
Dmitriy Sviridov
Вы напишете API, а потом фронтендер потребует дать...

Согласен, писать документацию будет сложно

Dmitriy-Sviridov Автор вопроса
Artur Karapetov
типа сначала писать спеку сваггера 2 года, а потом...

"типа сначала писать спеку сваггера 2 года" - ну прото-файлы ты же пишешь и ничего)

Dmitriy-Sviridov Автор вопроса
Artur Karapetov
я не пишу 🙂 я не юзаю grpc

А как у тебя сервисы данными обмениваются?

Dmitriy-Sviridov Автор вопроса
Artur Karapetov
rabbitmq/nuts, json rpc, rest api

Ну тогда вернёмся к rest api: как ты его документируешь?

Dmitriy-Sviridov Автор вопроса
Artur Karapetov
swagger

А как он формируется?

Dmitriy Sviridov
А как он формируется?

// Patch // @Summary Update User List // @Tags Users // @Param input body UpdateListDTO true "body" // @Accept json // @Success 204

Dmitriy-Sviridov Автор вопроса
Artur Karapetov
// Patch // @Summary Update User List // @Tags Use...

Я так в одном пыховом проекте сделал - в итоге он превратился в ад. В контроллере кода на 600 строк, а с докой такой он раздулся почти до 2 тысяч (!!!) строк

Dmitriy-Sviridov Автор вопроса
Artur Karapetov
в пхппхпхпхп может быть что угодно )

Не, тут не в пыхе дело. А в том, что 100500 строк комментов для генерации swagger

Dmitriy-Sviridov Автор вопроса
Dmitriy Sviridov
Я так в одном пыховом проекте сделал - в итоге он ...

Потому что документация в коде антипаттерн?

Миринговин
Потому что документация в коде антипаттерн?

если это считалось бы антипаттерном, то должно быть объяснение почему это антипаттерн

Artur Karapetov
если это считалось бы антипаттерном, то должно быт...

А ты много видишь документации в коде? Или может видишь документацию в документации? 🙂 Не путайте с комментариями, таки

Dmitriy-Sviridov Автор вопроса
Миринговин
Потому что документация в коде антипаттерн?

Впервые слышу. И то не дока, а аннотации для генерации доки

Миринговин
Потому что документация в коде антипаттерн?

Аххахаахазахахазц, а как по твоему доки на pub, go docs генерируются ???)

А как юзать другие веб фреймворки?

Dmitriy-Sviridov Автор вопроса
Evgeniy Trunin
А как юзать другие веб фреймворки?

Для чего?) В том же gin-gonic один роутинг по сути и всё

Dmitriy Sviridov
Для чего?) В том же gin-gonic один роутинг по сути...

Ну некоторые вроде пошустрее работают, чем стандартная либа

Dmitriy-Sviridov Автор вопроса
Evgeniy Trunin
Ну некоторые вроде пошустрее работают, чем стандар...

Если приложение запущено не в единственном инстансе (обычно это так), то это вообще никакой роли не играет

Похожие вопросы

Обсуждают сегодня

Господа, а что сейчас вообще с рынком труда на делфи происходит? Какова ситуация?
Rꙮman Yankꙮvsky
29
А вообще, что может смущать в самой Julia - бы сказал, что нет единого стандартного подхода по многим моментам, поэтому многое выглядит как "хаки" и произвол. Короче говоря, с...
Viktor G.
2
30500 за редактор? )
Владимир
47
а через ESC-код ?
Alexey Kulakov
29
Чёт не понял, я ж правильной функцией воспользовался чтобы вывести отладочную информацию? но что-то она не ловится
notme
18
У меня есть функция где происходит это: write_bit(buffer, 1); write_bit(buffer, 0); write_bit(buffer, 1); write_bit(buffer, 1); write_bit(buffer, 1); w...
~
14
Добрый день! Скажите пожалуйста, а какие программы вы бы рекомендовали написать для того, чтобы научиться управлять памятью? Можно написать динамический массив, можно связный ...
Филипп
7
Недавно Google Project Zero нашёл багу в SQLite с помощью LLM, о чём достаточно было шумно в определённых интернетах, которые сопровождались рассказами, что скоро всех "ибешни...
Alex Sherbakov
5
Ребят в СИ можно реализовать ООП?
Николай
33
https://github.com/erlang/otp/blob/OTP-27.1/lib/kernel/src/logger_h_common.erl#L174 https://github.com/erlang/otp/blob/OTP-27.1/lib/kernel/src/logger_olp.erl#L76 15 лет назад...
Maksim Lapshin
20
Карта сайта