Track GQL features somewhere?

[gregerolsson]

GraphGlot makes is easy to explore the 228 ISO GQL Features that ISO/IEC 39075:2024 defines.

It would be awesome if there was some GrafeoDB documentation somewhere listing which features are supported, preferably linking to GraphGlot somehow or paraphrasing the ISO GQL standard.

[StevenBtw]

Hi, and welcome! Does this help in any way?
GQL Reference

[StevenBtw]

I will have a look at referencing GraphGlot, it's such an awesome playground.

[StevenBtw]

Btw, if you want you can use grafeo wasm to have a real graph database in the playground. I build something similar today, https://grafeo.ai/
But you seem to cover the full spec. Grafeo doesn't cover everything yet (conditional handling is to much work for what it brings imho). I will have a look at the documentation again next weekend, make sure its all up to date with the implemented features. But GQL is the most complete query language, then cypher, when it comes to how much of the full spec is implemented.

[gregerolsson]

The GrafeoDB documentation, like the rest of the project, is absolutely fantastic ❤️

At our company we have been evaluating a few graph databases lately and finding the set of features currently implemented in the database has been a bit tricky since you often have to piece that together yourself from the documentation. Now, GrafeoDB has awesome documentation so it is a lot simpler than with most "competitors", but still.

Regarding a potential spec compliance doc page you would be able to define the GrafeoDB ISO GQL dialect with not much more than a simple table and that would help out in tools like GraphGlot.

I was looking into the compliance test cases in the Rust code and you're referencing the spec features there intermittently. Perhaps something there could autogenerate a compliance spec in the future. This is obviously not a priority in any way, just thinking out loudly.

BTW, grafeo.ai looks great! Some fantastic work going on here.

[StevenBtw]

I will add it to the list and see what I can do. Thank you for the kind words!

[StevenBtw]

@gregerolsson I am working now on a dialect definition for GraphGlot specifically. This will also use and // ISO: annotation in the tests so I can fully generate it. This already works, but as you mentioned, the docstrings (and tests) are not consistent enough yet, so that's where most of the work is now. Next release (0.5.22) will have this as one of the additions. So keep an eye out for the next release!

[StevenBtw]

#146 for reference

[StevenBtw]

A more machine friendly version can be found here: docs/gql-dialect.json

[StevenBtw]

@gregerolsson I am using the python tests, not the rust unit tests. Since the python bindings integration tests current are very complete when it comes to GQL spec aligned testing. Hejdå!

[gregerolsson]

Looks fantastic! 🥳 This integrated with GraphGlot later on, paired with your already good documentation and grafeo.ai will be killer!

[StevenBtw]

@gregerolsson I found another nice way of using GraphGlot and use it now to have another layer of conformance tests for the GQL implementation. I found a few bugs/issues this way so it was useful right away!

[gregerolsson]

Ha, clever! Yeah, the more test cases the merrier. Conformance already looking impressive.