I have two related questions: Is there a formal grammar for

filter_by

or any of the search parameters? I am working on a complex query system which takes a query language, validates and parses it, then constructs typesense queries from the syntax tree. Doing this without knowing the precise filtering grammar (or other params) is quite a challenge. At the moment I've taken all the documented examples and tried to formalise them into PEG and BNF grammars but I would love to be more confident that it matches. Second (much more mundane) question, is there any way to programmatically get a collections schema? I'm using the schema to inject some more intelligent behaviour into the query system so that things like filtering

tags[] > 5

throws a useful syntax error in the frontend. I can copy-paste the schema when it changes but I would really love to avoid that.

We don’t have a formal grammar documented anywhere. But here’s all the possible options written out here under

filter_by

in this table

Yeah that's the reference I've been using

is there any way to programmatically get a collections schema?

Yup. Using this GET endpoint

Any insight into how the filters are parsed? I couldn't find much searching the repo

We tried a grammar-based codegen approach, but it became to unwieldy to manage the generated code, so we built our own light-weight parser

Gotcha, is that parser public?

Yup: https://github.com/typesense/typesense/blob/e60094c88bf1fdea2e152220a106f3d641f57799/src/field.cpp#L475

Awesome, this is great reference, thanks!

This one actually: https://github.com/typesense/typesense/blob/e60094c88bf1fdea2e152220a106f3d641f57799/src/string_utils.cpp#L384

Sweet

No, we validate only the server-side

Cool, if I end up producing something interesting or useful I'll share it here, having realtime feedback for complex typesense queries has been really enjoyable for the project I'm working on, might be for others too.

That would be great! I’m really curious to see what you’re building!

Yeah I look forward to sharing! If deadlines are hit it will be a month, so expect me back here in 2!