GROQ

Спецификация GROQ

? Опубликованные версии спецификации можно посмотреть здесь .

Это спецификация GROQ (Graph-Relational Object Queries), языка запросов и механизма выполнения, созданного на Sanity.io, для фильтрации и проектирования документов JSON. Работа началась в 2015 году, а разработка этого открытого стандарта началась в 2019 году. Прочтите анонс в блоге, чтобы узнать больше о процессе спецификации, и ознакомьтесь с руководством по началу работы, чтобы узнать больше о самом языке.

Посетите GROQ Arcade, чтобы опробовать GROQ с любыми данными JSON уже сегодня!

Инструменты и ресурсы для GROQ

• Подсветка синтаксиса в VS Code.
• Подсветка синтаксиса в Sublime Text.
• Литерал шаблона с тегом GROQ для написания запросов GROQ в файлах JavaScript.
• groq-cli — инструмент командной строки для запуска GROQ для файлов и URL-адресов.
• groq-js, реализация GROQ на JavaScript.
• Библиотека Go GROQ, реализация парсера GROQ на Go.
• groqfmt — форматировщик командной строки для GROQ, написанный на Go.

Разработка спецификации

Спецификация написана с использованием spec-md — варианта Markdown, оптимизированного для написания спецификаций. Исходный код находится в каталоге spec/ , который затем преобразуется в HTML и представлен по адресу https://spec.groq.dev. Чтобы гарантировать совместимость реализаций, мы пишем тестовые примеры в наборе тестов GROQ.

Спецификация соответствует схеме управления версиями GROQ-X.revisionY , где X (основная версия) и Y (версия) — числа:

• Первая версия — GROQ-1.revision0.
• Более поздние версии всегда обратно совместимы с более ранними версиями той же основной версии.
• Изменения могут включать в себя все: от незначительных уточнений до совершенно новых функций.
• Основные версии используются для внесения критических изменений.

Лицензия

Спецификация доступна в соответствии с Соглашением об окончательной спецификации Open Web Foundation (OWFa 1.0).