(feat) Query builder

[thomasht86]

I confirm that this contribution is made under the terms of the license found in the root directory of this repository's source tree and that I have the authority necessary to make this contribution on behalf of its copyright owner.

Consider this a first draft, and I can go through it tomorrow.

To discuss:

• Should we allow for using kwargs for annotations - good for some, but many annotations are camelCase - does not good in python.
• Rename Q and G- to what?

TODO:

• Integration test for grouping

[thomasht86]

Discovered more grouping functions that should be added (and tests for) before merging. :D
https://docs.vespa.ai/en/reference/grouping-syntax.html

[thomasht86]

Ready for another review now @glebashnik 🙏

[glebashnik]

Looks very good, both design wise and tests.
I setup env and ran tests in Python 2.12 3.12.
For future improvement, it would be great to be able to run tests in different Python versions. Tools like Nox can help with this.

[thomasht86]

Looks very good, both design wise and tests. I setup env and ran tests in Python 2.12. For future improvement, it would be great to be able to run tests in different Python versions. Tools like Nox can help with this.

Thanks. Assume you mean 3.12? 😅 We do run unit tests on matrix of Python 3.8-3.12 and macos, ubuntu, windows.
Doing it for all would take a lot of time and cost a lot, but maybe we could do some of the integration tests at least.

[glebashnik]

Right. Found the GH job. All good.