Определения Protocol Buffers
Проверьте самостоятельное определение proto3: дерево, форматированный код и форму JSON. Номера полей сохраняются.
Код остаётся в браузере. Импорты не загружаются, сетевые запросы не отправляются.
Подмножество proto3 для одного файла. Без импортов, пользовательских опций, компиляции и проверки совместимости. Изменение кода сбрасывает выбор корня.
Пределы: 100 000 символов UTF-16, 20 000 токенов, 2 000 объявлений, 32 уровня; ожидание до 8 секунд.
Результат устарел. Экспорт отключён.
Protobuf Formatter помогает разобраться в плотно записанной схеме перед проверкой изменений. Одних отступов недостаточно: в аккуратном коде тоже встречаются зарезервированные номера и неизвестные типы. Поэтому экспорт становится доступен после проверок поддерживаемых объявлений.
Дерево показывает исходные имена, номера полей и полные пути типов. JSON Schema описывает форму данных выбранного сообщения. Исходный контракт нужен отдельно: сведения о сервисах, прежних номерах и поведении сгенерированного кода не переносятся в эту проекцию целиком.
Protobuf Formatter сохраняет порядок объявлений и показывает полные имена ссылок. OuterA.Item и OuterB.Item остаются разными типами. Рекурсивная связь отображается путём к определению, а не бесконечным раскрытием одного и того же поддерева.
В файле может быть несколько сообщений. Выбор корня меняет основной $ref, а общие определения остаются в $defs. Так можно проверить массивы, map и взаимоисключающие контактные поля, не копируя один тип во множество мест результата.
По умолчанию выбирается первое сообщение, даже если перед ним есть enum или в файле описаны сервисы. В параметрах доступны полные имена типов. Редактирование исходника сбрасывает выбор, чтобы результат не продолжал ссылаться на удалённое сообщение.
Раскрывайте объявления и переходите к коду по номеру строки. Дерево выводит по 50 видимых записей. При копировании структуры экспортируются все объявления, включая свёрнутые и ещё не показанные. Для полного отчёта не нужно вручную раскрывать каждый узел.
Автопроверка запускается через 350 мс после изменения. Если её отключить, появятся основная кнопка и сочетание Ctrl/Cmd + Enter. Старый результат сразу блокируется для экспорта. Пример и Очистить сначала показывают замену с числом символов; отмена восстанавливает исходник и результат вместе.
Выберите два или четыре пробела. Комментарии и содержимое строк сохраняются; фигурные скобки и точки с запятой внутри них не считаются структурными разделителями. Имена, номера и порядок полей остаются прежними. Выходной код повторно разбирается, а его дескриптор сравнивается с исходным до разрешения экспорта.
Тег должен быть положительным, уникальным в сообщении и находиться вне диапазона 19000–19999. Учитываются и reserved, записанные после полей. Первый элемент enum в proto3 должен иметь значение ноль; числовые псевдонимы требуют allow_alias. Проверяется текущая схема, без предположений о прежних версиях.
Дерево объединяет package, message, enum, oneof, service и RPC. Ссылки вперёд, вложенные типы и рекурсивные сообщения разрешаются в пределах файла. Неизвестный тип останавливает генерацию. В дереве остаются исходные имена snake_case, даже когда JSON использует lowerCamelCase.
Документ 2020-12 использует полные имена в $defs. repeated становится массивом, map — объектом, int64 — строкой. Для oneof допустимо отсутствие всех членов или присутствие одного, но не двух. Обычные одиночные и optional-поля могут отсутствовать; required автоматически не добавляется.
Нет. Теги сообщений начинаются с 1 и заканчиваются 536870911; диапазон 19000–19999 зарезервирован реализацией. У enum другая роль: первое объявление в proto3 должно иметь значение ноль. Инструмент проверяет эти правила отдельно, чтобы не путать недопустимый тег с обязательным начальным значением перечисления.
Да, последовательная нумерация не требуется. После поля 1 может идти поле 20, если нет конфликта или резерва. Форматирование сохраняет промежутки и порядок. Чтобы запретить повторное использование старого номера, внесите его в reserved. Сам по себе пропуск в последовательности не документирует прежнее использование.
Добавьте optional перед типом, чтобы сгенерированный код мог явно отслеживать присутствие значения. Дерево отражает это объявление. В экспортированном JSON Schema могут отсутствовать и обычные одиночные, и optional-поля. Он не описывает сгенерированный метод has и различие между отсутствием значения и значением по умолчанию, возвращённым runtime.
Обычное число JavaScript не может точно представить все 64-битные целые. Распространённый вывод ProtoJSON использует десятичные строки. Проекция сохраняет эту форму без преобразования в Number. Шаблон проверяет запись, но для точного знакового или беззнакового диапазона нужна дополнительная проверка.
Компилятор ищет зависимости относительно настроенных корневых каталогов импорта. У этой панели нет дерева файлов и средства разрешения зависимостей, поэтому любой import явно отклоняется. Проверяйте полный проект через protoc или Buf. Путь не загружается по сети и не игнорируется ради видимости успешной проверки.
Нашли определение, которое должно поддерживаться?
Protobuf Formatter позволяет изучить поддерживаемые объявления и вернуть исходник с проверенной формой JSON в проект. Для окончательной компиляции по-прежнему нужны все зависимости.