Apicurio-studio: Редактор: Поддержка allOf (наследование типов данных)

@EricWittmann провел последние пару дней в инструменте, это, вероятно, самый большой пробел, мешающий мне использовать инструмент с клиентами.

Ok. Добавляем в список!

какие-либо дальнейшие мысли по этому поводу? Я начинаю читать, чтобы начать некоторые проекты, и я бы хотел использовать apicruio, но эта проблема - настоящий блокировщик

У меня были некоторые мысли в этой области, но у меня не было возможности поработать над этим. Журнал функций довольно обширен, в том числе относительно повсеместное обновление UX.

Есть ли у вас какие-то мысли о том, как может выглядеть пользовательский интерфейс, поддерживающий allOf (и, предположительно, oneOf и anyOf)?

allOf должен показать мне, что определение foo расширяет панель определения и, желательно, перечисление полей, которые являются частью bar. вид foo должен содержать гиперссылку на bar. Я представляю здесь своего рода разделенный экран, но дизайн пользовательского интерфейса - не моя сильная сторона.

oneOf и anyOf - разные варианты использования с точки зрения UX. В этих сценариях мне нужно просто перечислить определения, которые можно использовать при назначении переменной, но мне не нужно видеть детали определений, как это необходимо в allOf. Мне просто нужно знать список имен определений.

Я подниму вопрос с UX, чтобы посмотреть, сможем ли мы что-нибудь придумать. К сожалению, это, вероятно, не самый высокий пункт в списке дел, но я постараюсь. :)

Понятно, я просто хочу, чтобы вы знали, что нам нужно для использования этой штуки в лаборатории. Сейчас это главное - я могу обойти большинство других вещей. Но мне нужно уметь наследовать в реальном проекте.

Абсолютно понятно. :) Я максимально увеличу это требование - я бы определенно хотел, чтобы Apicurio был как можно более полезным в реальных проектах.

Если у вас есть другие проблемы, о которых вы еще не упомянули, которые можно исправить - обязательно дайте мне знать о них. (Примечание: мы работаем над разработкой функции CRUD, которая значительно упростит быстрое добавление стандартных операций для «ресурса»)

Привет, есть новости по этому поводу? Жалко, что такой хороший инструмент не справляется с наследованием ...

К сожалению, пока ничего, хотя и не из-за отсутствия желания поддерживать наследство. На самом деле, это просто вопрос расстановки приоритетов.

Если у кого-то есть навыки UX-дизайна, то что очень поможет, так это макет того, как это будет работать. @ sherl0cks уже предоставил некоторые идеи, но было бы намного проще реализовать что-то здесь с помощью UX-дизайна. ИЛИ, если у вас есть инструмент, который делает что-то подобное так, как вам нравится, не стесняйтесь указать на это!

Я понимаю, что спросить может быть много. :)

В любом случае, это будет сделано, я еще не знаю, когда.

Привет,

если UX-часть по-прежнему блокирует - почему бы не повторно использовать существующий стиль вкладок, например https://imagebin.ca/v/4mkbz35931av

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

ps наследование - это потрясающая функция документации OpenApi, поскольку она позволяет избежать копирования - вставки!

Неплохой дизайн! Спасибо за вклад. Надеюсь, у вас все в порядке, но я подумал, что было бы полезно встроить изображение, чтобы упростить задачу (не нужно щелкать мышью на imagebin):

Нет, я подожду, пока это не будет выпущено, а потом подам жалобу за нарушение авторских прав! : D

ps кроме этого - вы, ребята, создали отличный инструмент! Поздравляю!

Ха-ха! 🤣

Надеемся, что эта функция будет реализована!

Работаем над этим сейчас (наконец). :)

Я знаю, что это заняло много времени, но начальная реализация базовой поддержки allOf, oneOf и anyOf (очевидно, для документов OpenAPI 2.0 это только «allOf»).

Это всего лишь бета-версия поддержки. Я хотел бы получить отзывы об этом. Я думаю, что можно внести множество улучшений, но мне интересно, что другие думают в первую очередь.

Сегодня я сделаю релиз, чтобы каждый мог протестировать функции, используя пробную (облачную) версию Apicurio Studio.

Исправлено: https://github.com/Apicurio/apicurio-studio/pull/1022

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

К сожалению, недолго в роли, в которой я использую apicurio, но это звучит отлично, @EricWittmann !