Pull to refresh

Comments 6

А чем не устраивает API Blueprint в интеграции с Laravel?
Ну не то, чтобы не устраивало, но два года назад, когда этот проект стартанул выбор пал на Swagger. Плагин всё это время жил как внутренняя корпоративная тулза, поэтому большой потребности добавлять поддержку Blueprint не появлялось.
Насколько я могу нагуглить в принципе реализовать поддержку Blueprint формата вполне можно.
Я ведь правильно понял, что если в проекте только unit тесты, то данный подход не подойдет?

Если на проекте используется Passpot от Laravel, то соответственно тесты на авторизацию редко пишут, так как там уже готовый пакет. И в документацию эти методы не войдут, верно?
Извиняюсь, за поздний ответ.
Приведённые в статье тесты не являются unit-тестами с изначальном смысле этого слова. Это скорее Интеграционные тесты API.
Если вы тестируете методы и классы, а не запросы, то сбор документации по использованию API становится немножко нетривиальной задачей. В данном случае наверное да, этот метод не подойдёт.

Да, в документацию пойдёт ровно то, что тестируется. Если на что-то не написано теста, то система на это не рассчитана.
Я работал с обеими и думаю что Swagger удобнее.
Если использовать реквести/респонс модели – можно на их основе генерировать json-схемы + добавив сюда пару анотаций с названием метода/описанием – можно сделать полноценную генерацию документации
Sign up to leave a comment.

Articles