Телеграмм чат группы nest

2020 April 02

IL

Ihor Levchenko in NestJS — русскоязычное сообщество

Grigorii K. Shartsev

А как наличие try в сваггер ui мешает проекту?

да никак не мешает
просто не люблю когда есть кнопки которые вообще не работают или не должны даже быть представлены ))

источник

15:47пожаловаться #1

GS

Grigorii K. Shartsev in NestJS — русскоязычное сообщество

Я ими даже иногда пользуюсь)

источник

15:47пожаловаться #2

AK

Alexander Kazantsev in NestJS — русскоязычное сообщество

Ihor Levchenko

чтобы легко было глазами читать информацию, мне try it out вообще не нужен и он не отключается(

не нужно пользоваться чем-то - не пользуйся 🙂
читается хорошо. есть возможность добавить примеров и всякого рода дескрипшенов. очень удобно. тестеровщики довольны, фронтендщики тоже. что еще нужно?)

источник

16:00пожаловаться #3

IL

Ihor Levchenko in NestJS — русскоязычное сообщество

а как вы вообще с сваггером делаете?
Пока в дев режиме - экспортируете json и заливаете куда-то на документацию а в продакшн естественно без сваггера?

источник

16:01пожаловаться #4

GS

Grigorii K. Shartsev in NestJS — русскоязычное сообщество

Alexander Kazantsev

не нужно пользоваться чем-то - не пользуйся 🙂
читается хорошо. есть возможность добавить примеров и всякого рода дескрипшенов. очень удобно. тестеровщики довольны, фронтендщики тоже. что еще нужно?)

Вообще, много чего можно было в UI сделать лучше)
Подсветку JSON.
Менее жирным UI запросов (как-нибудь типа того, что в insomnia / postman, чтобы с вкладками, подсветкой, а не толпой вниз).
Если ивестен формат сообщения, то по-лучше конструктор сделать, чтобы не целиком руками его писать.

источник

16:02пожаловаться #5

IL

Ihor Levchenko in NestJS — русскоязычное сообщество

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

мне нравится что в маркдауне можно оформить все красиво

У меня даже появляются мысли напедалить свой АПИ док генератор.

источник

16:08пожаловаться #6

IL

Ihor Levchenko in NestJS — русскоязычное сообщество

Ihor Levchenko

а как вы вообще с сваггером делаете?
Пока в дев режиме - экспортируете json и заливаете куда-то на документацию а в продакшн естественно без сваггера?

но мне все же интересно как другие используют

источник

16:08пожаловаться #7

LK

L K in NestJS — русскоязычное сообщество

Ihor Levchenko

но мне все же интересно как другие используют

используем то что есть
в проде выключаем swagger

источник

16:23пожаловаться #8

IL

Ihor Levchenko in NestJS — русскоязычное сообщество

L K

используем то что есть
в проде выключаем swagger

то есть документация читается наживо с дев сервера, не экспортируется в json и потом куда-то дальше в хранилище доков?

источник

16:24пожаловаться #9

LK

L K in NestJS — русскоязычное сообщество

Ihor Levchenko

то есть документация читается наживо с дев сервера, не экспортируется в json и потом куда-то дальше в хранилище доков?

да, читается наживо

источник

16:24пожаловаться #10

GS

Grigorii K. Shartsev in NestJS — русскоязычное сообщество

L K

используем то что есть
в проде выключаем swagger

аналогично

источник

16:25пожаловаться #11

LK

L K in NestJS — русскоязычное сообщество

хотелось бы какой-то поиск в swagger, но увы
ctrl + f

источник

16:25пожаловаться #12

GS

Grigorii K. Shartsev in NestJS — русскоязычное сообщество

Хотя хочется куда-нибудь в удобное место в репе засовывать json с конфигом при сборке

источник

16:25пожаловаться #13

AK

Alexander Kazantsev in NestJS — русскоязычное сообщество

Ihor Levchenko

но мне все же интересно как другие используют

https://docs.nestjs.com/recipes/swagger для дева, в проде отключается

Documentation | NestJS - A progressive Node.js framework

Nest is a framework for building efficient, scalable Node.js server-side applications. It uses progressive JavaScript, is built with TypeScript and combines elements of OOP (Object Oriented Progamming), FP (Functional Programming), and FRP (Functional Reactive Programming).

источник

16:36пожаловаться #14

AK

Alexander Kazantsev in NestJS — русскоязычное сообщество

Ihor Levchenko

а как вы вообще с сваггером делаете?
Пока в дев режиме - экспортируете json и заливаете куда-то на документацию а в продакшн естественно без сваггера?

это я сюда писал 🙂

источник

16:37пожаловаться #15

AK

Alexander Kazantsev in NestJS — русскоязычное сообщество

для джанги много всякого есть. например вот такие модули: https://github.com/axnsan12/drf-yasg

GitHub

axnsan12/drf-yasg

Automated generation of real Swagger/OpenAPI 2.0 schemas from Django REST Framework code. - axnsan12/drf-yasg