notmuch/doc, branch debian/0.34-1thread-based email index, search, and tagginghttps://git.notmuchmail.org/git/notmuch/atom?h=debian%2F0.34-12021-09-05T00:07:19Zdoc/sexp-queries: update synopsis and description2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:45Zurn:sha1:49aa44bb012e8c2412b5447119b78b61842740b8
I chose to go with a somewhat terse synopsis to try to keep the length
of the page down.
lib/parse-sexp: apply macros2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:41Zurn:sha1:551254eb76c9bb558078f04f21df1f6089cb03d6
Macros implement lazy evaluation and lexical scope. The former is
needed to make certain natural constructs work sensibly (e.g. (tag
,param)) but the latter is mainly future-proofing in case the DSL is
is extended to allow local bindings.
For technical background, see chapters 6 and 17 of [1] (or some other
intermediate programming languages textbook).
[1] http://cs.brown.edu/courses/cs173/2012/book/
CLI/config support saving s-expression queries2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:38Zurn:sha1:81b9dbd110593d6b1a370efb3576bf39585af2ea
This commit does not enable using saved s-expression queries, only
saving and retrieving them from the config file or the database. Use
in queries will be enabled in a following commit.
lib/parse-sexp: handle saved queries2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:37Zurn:sha1:6ab2d9b1a2e62b76960df8e80ff2a45d9c6a8551
This provides functionality analogous to query: in the Xapian
QueryParser based parser. Perhaps counterintuitively, the saved
queries currently have to be in the original query syntax (i.e. not
s-expressions).
lib/parse-sexp: parse user headers2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:35Zurn:sha1:a07ef8abf5248c1128ddc75b8139ae807a88abd9
One subtle aspect is the replacement of _find_prefix with
_notmuch_database_prefix, which understands user headers. Otherwise
the code mainly consists of creating a fake prefix record (since the
user prefixes are not in the prefix table) and error handling.
lib/parse-sexp: support infix subqueries2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:34Zurn:sha1:cc5992a30470222791c24849da04a3c0403ecce5
This is necessary so that programs can take infix syntax queries from
a user and use the sexp query syntax to construct e.g. a refinement of
that query.
lib/parse-sexp: expand queries2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:33Zurn:sha1:afe85e65786df1df9abf261393b4b4e6e2e86009
The code here is just gluing together _notmuch_query_expand with the
existing sexp parser infrastructure.
lib/parse-sexp: support regular expressions2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:29Zurn:sha1:1870b3ae4bae5e68296e63acc81965eea04a1a7a
At least to the degree that the Xapian QueryParser based parser
also supports them. Support short alias 'rx' as it seems to make more
complex queries nicer to read.
lib/parse-sexp: add '*' as syntactic sugar for '(starts-with "")'2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:25Zurn:sha1:0ca4ad2670b22e975a018f9f662ea3a762840583
Users that insist on using a literal '*' as a tag, can continue to do
so by quoting it when searching.
lib/parse-sexp: 'starts-with' wildcard searches2021-09-05T00:07:19ZDavid Bremnerdavid@tethera.net2021-08-24T15:17:24Zurn:sha1:011d06f4d6fec8083581676ba9f9448fe7bea1be
The many tests potentially overkill, but they could catch typos in the
prefixes table. As a simplifying assumption, for now we assume a
single argument to the wildcard operator, as this matches the Xapian
semantics. The name 'starts-with' is chosen to emphasize the supported
case of wildcards in currrent (1.4.x) Xapian.