Хочу описать в json schema реквесты с респонсами для api, чтобы с них и дока генерилась и тесты шли. Пока подобрал связку api blueprint + aglio для доки и justinrainbow/json-schema для валидации в тестах. Кто-нибудь делал такое? На чем?

https://github.com/swaggest/php-json-schema вот еще нашел

Спасиб, посмотрю) я пока этим вдохновился, собираю пруф на коленке https://philsturgeon.uk/api/2018/04/13/openapi-and-json-schema-divergence-solved/

кстате а как давно в phpunit выпилили из code coverage трейты и для их покрытия надо писать отдельные юнит тесты?

спиздел похоже я

Спасиб, посмотрю) я пока этим вдохновился, собираю пруф на коленке https://philsturgeon.uk/api/2018/04/13/openapi-and-json-schema-divergence-solved/

во, я тоже такой целью задавался

поделись, когда будет, что показать) меня еще интересовала подстановка данных с помощью $data, но вроде как это планируют только в 8 драфт впилить - я общался тогда с одним из кор контрибьюторов спеки

поделись, когда будет, что показать) меня еще интересовала подстановка данных с помощью $data, но вроде как это планируют только в 8 драфт впилить - я общался тогда с одним из кор контрибьюторов спеки

Ок, дам знать)

спиздел похоже я

XDebug не было? :)

XDebug не было? :)

там же пишет, что его нету, вместо генерации покрытия)

Оно то да, но не им единым. Можно через phpdbg еще генерить. Так и делал пока xdebug под 7.2 в репах убунты не завезли.

Оно то да, но не им единым. Можно через phpdbg еще генерить. Так и делал пока xdebug под 7.2 в репах убунты не завезли.

ты свой велосипед забросил что ль?

Пылю потихоньку. Но слабо, ушел в С# и прочие питоны.

ясн)

вродь phpdbg быстрее ковераж генерит

XDebug не было? :)

был, просто в коде методы трейтов не дергались не в той ветке был

вообщем я сам виноват)))

Всем привет. кто подскажет. Как правильно разбить данные содержащие в себе бинарные данные. Идут данные ввиде на скрипт id=00001&bin=2T��� " mb_split("&", $str); или explode("&", $str); теряет большую часть bin

parse_url

И банарные данные, если чо, пакуют в base64

эти даннные приходят на сокет с оборудования и ни кто их не пакует)

так бы давно бы попросил бы их в json присылать

ладно разобрался сначало все данные в hex преобразую а потом уже буду разбивать

эти даннные приходят на сокет с оборудования и ни кто их не пакует)

ну так в чем проблема?

просто не надо вардампами дебажить)

и не надо multibyte юзать для этого

банально через explode и потом еще раз explode и потом уже unpack для бинарных данных (или если просто хранить - base64)

поделись, когда будет, что показать) меня еще интересовала подстановка данных с помощью $data, но вроде как это планируют только в 8 драфт впилить - я общался тогда с одним из кор контрибьюторов спеки

Все хорошо кроме одного, конвертер json-schema в openapi3 поддерживает только драфт 4-5, а мне хочется драфт 6, чтобы в схеме прописывать examples и генерировать из них примеры запросов-ответов с вменяемыми данными... но так это все пока не умеет

Есть еще apidocjs + apidoc-plugin-example но там ровно та же проблема, игнорирует examples и примеры получаются с рандомной тарабарщиной

как жаль что нельзя свою доку генерить так как ты хочешь из каких-то готовых компонентов(

Да, странно что никто еще не сделал, технических ограничений не вижу

Да, странно что никто еще не сделал, технических ограничений не вижу

потому что все делают под себя а так это ж думать надо

А как клево было бы весь процесс разработки апи по спеке из схемы

в основном все делают клоны свагера по итогу и от того хуита выходит

А как клево было бы весь процесс разработки апи по спеке из схемы

не ну по сути ты и сейчас это можешь делать. вопрос только в том что бы рендрить из этого html-ку

что в целом делается быстро довольно

а дальше - привязка схемы к роутам - изи бризи, валидация реквестов и респонсов по схеме - в целом тоже

примеры запросов - это посложнее но в целом если у тебя в схеме есть экзамплы - изи бризи

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

просто схему придется руками описывать)

но! опять же можно герерить ее из DTO) если есть

Это все и так есть, и дока генерится, и тесты ответы по схеме валидируют, проблема только с генерацией примеров запроса-ответа с вменяемыми данными

Это все и так есть, и дока генерится, и тесты ответы по схеме валидируют, проблема только с генерацией примеров запроса-ответа с вменяемыми данными

фэйкер

если у тебя тип и формат в схеме фигурируют то большую часть данных можно фэйкером нагенерить

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

apidoc-plugin-example как раз фейкером и генерит

Толку от этого, это не для людей примеры получаются

Можно ведь просто в схеме прописать examples и брать оттуда, но это драфт 6, а все тулзы застряли на 4-5

Ладно, хороший повод сделать самому)

Получилось что хотел, правда пришлось зайти с обратной стороны. Спеку писать в apib, с нее генерится норм дока с человеческими примерами и json-schema через apib2json

https://apiblueprint.org/documentation/examples/15-advanced-json-schema.html

хм, а драфт свежий отдаёт?

хотя никакой разницы, в принципе

Да, для валидации сгодится

Есть даже генератор коллекций постмена из apib, прям все что надо

это круто, спасибо

Есть даже генератор коллекций постмена из apib, прям все что надо

Что такое апиб? В 2-ух словах

Маркдаун на стероидах для описания апи с кучей тулзов

Один раз описал контракт, с него сразу получаешь доку, тесты, клиент, мок-сервер

Что такое апиб? В 2-ух словах

ссылку лень открыть?

ссылку лень открыть?

С мобильного как понесёт по интернетам...

Один раз описал контракт, с него сразу получаешь доку, тесты, клиент, мок-сервер

ну это рядом с единорогами. в реальности ты получаешь только средненькую доку и средненький мок сервер (что уже неплохо само по себе) и помощь в тестах - но не более. Что до клиента - только если ты сам напишешь какой-нибудь генератор клиентов

С мобильного как понесёт по интернетам...

ну... типа да

тыкнул такой и перешел - чудеса

не HD парнуха ж, трафик не сожрет

@fes0r ты меня видишь ?

тыкнул такой и перешел - чудеса

Ага, а спустя 5 минут уже качаешь книгу «легкий способ бросить юзать апиб»... в лучшем случае)

не HD парнуха ж, трафик не сожрет

Водафон безлим, порно андимитэд

ERROR: S client not available

ну это рядом с единорогами. в реальности ты получаешь только средненькую доку и средненький мок сервер (что уже неплохо само по себе) и помощь в тестах - но не более. Что до клиента - только если ты сам напишешь какой-нибудь генератор клиентов

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

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

ну я потому ее и юзал 2 года)

меня больше расстраивает что за все это время она чет как-то не развивалась особо

меня больше расстраивает что за все это время она чет как-то не развивалась особо

Меня больше расстраивает, что я впервые слышу о ней. А вообще, если б народ на донат не жлобился, было бы и развитие и «раньше она лучше была»

ну я пока не пришёл к подходу "задонатить за то, что вроде бы ок, но ещё хз" не знаю, насчёт остальных

Или вы, как я, программист, пол месяца стреляющий на троллейбус?)

Меня больше расстраивает, что я впервые слышу о ней. А вообще, если б народ на донат не жлобился, было бы и развитие и «раньше она лучше была»

Их оракл год назад купил, не нужны им твои $10

Их оракл год назад купил, не нужны им твои $10

Я тебя прошу, я за $10 сам писать такое сяду

А если серьезно, оракл это круто, молодцы ребята, странно, что(не вижу смысла сомневаться в твоих словах) они так и не продвинулись особо

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

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

Строковая арифметика или arbotary precision numbers

Arbitary

А если серьезно, оракл это круто, молодцы ребята, странно, что(не вижу смысла сомневаться в твоих словах) они так и не продвинулись особо

Нет конкурентов)

И все на плюсах

Нет конкурентов)

Так а профит с чего?

Apiary.com

Вот с этого

Ой не то

https://apiary.io/

Ой не то

Господи, меня чуть не бомбануло от зависти

Это как джира, говно но стандарт индустрии

Это как джира, говно но стандарт индустрии

"говнота"

Это как джира, говно но стандарт индустрии

Говно, согласен, я сам больше люблю Asana, интересно, что подходит остальным тут?

"говнота"

High5

Народ, есть тут кто из Киева, кому в компанию нужен толковый джун?

Народ, есть тут кто из Киева, кому в компанию нужен толковый джун?

Спроси @aioslike Там на ларавеле есть задачки

Спроси @aioslike Там на ларавеле есть задачки

Точно

Это как джира, говно но стандарт индустрии

стандартное говно

стандартное говно

Так а шо вы сами предпочли бы использовать?

Так а шо вы сами предпочли бы использовать?

не редмайн :D джира медленная, редмайн тупой, трелло ограниченный

не редмайн :D джира медленная, редмайн тупой, трелло ограниченный

Редмайн? Боже упаси.