GROQ

Spécification GROQ

? Les versions publiées de la spécification peuvent être consultées ici .

Il s'agit de la spécification de GROQ (Graph-Relational Object Queries), un langage de requête et moteur d'exécution créé par Sanity.io, pour filtrer et projeter des documents JSON. Les travaux ont commencé en 2015 et le développement de ce standard ouvert a commencé en 2019. Lisez l'article de blog d'annonce pour en savoir plus sur le processus de spécification et consultez le guide de démarrage pour en savoir plus sur le langage lui-même.

Accédez à GROQ Arcade pour essayer GROQ avec n'importe quelle donnée JSON dès aujourd'hui !

Outils et ressources pour GROQ

• Mise en évidence de la syntaxe dans VS Code.
• Mise en évidence de la syntaxe dans Sublime Text.
• Littéral de modèle balisé GROQ, pour écrire des requêtes GROQ dans des fichiers JavaScript.
• groq-cli, un outil de ligne de commande pour exécuter GROQ sur des fichiers et des URL.
• groq-js, une implémentation JavaScript de GROQ.
• Bibliothèque Go GROQ, une implémentation Go de l'analyseur GROQ.
• groqfmt, un formateur de ligne de commande pour GROQ, écrit en Go.

Développement du cahier des charges

La spécification est écrite à l'aide de spec-md, une variante Markdown optimisée pour l'écriture de spécifications. La source se trouve dans le répertoire spec/ qui est ensuite converti en HTML et présenté sur https://spec.groq.dev. Pour garantir que les implémentations sont compatibles, nous écrivons des cas de test dans la suite de tests GROQ.

La spécification suit le schéma de versionnage de GROQ-X.revisionY où X (majeur) et Y (révision) sont des nombres :

• La première version est GROQ-1.revision0.
• Les révisions ultérieures sont toujours rétrocompatibles avec les révisions antérieures de la même version majeure.
• Les révisions peuvent inclure tout, depuis des clarifications mineures jusqu'à de toutes nouvelles fonctionnalités.
• Les versions majeures sont utilisées pour introduire des modifications importantes.

Licence

La spécification est mise à disposition dans le cadre de l'accord de spécification finale de l'Open Web Foundation (OWFa 1.0).