SiKuLa

Simple Query Language - [ˈziːˈkuːˈlaː]

原理

又一个查询语言，你认真吗？

实际上它并不算新颖。但是将其命名为“类似GitHub搜索语法的查询语言”（QLSTGHSS）并不是一个真正的选择。

更准确地说，它更像是一个熟悉语法的实现。

那么区别在哪里呢？

它们很微妙。但我不想破坏惊喜。或者也许我只是太懒于编写文档。🤷

示例

假设你定义了一个用于搜索电子邮件的枚举类型

use sikula::prelude::*;

#[derive(Search, Clone, Debug, PartialEq, Eq)]
enum DeriveResource<'a> {
    /// Standard qualifier: `author:someone`
    #[search(sort, scope)]
    Author(&'a str),
    /// Default primary: `warranty`
    #[search(default)]
    Subject(Primary<'a>),
    /// Non-default primary: `warranty in:message`, to search in both: `warranty in:message in:subject`
    #[search(scope)]
    Message(Primary<'a>),

    /// Predicate: `is:read`
    Read,

    /// Numeric qualifier example:
    /// * `size:100` (equals)
    /// * `size:>=100` (size greater than or equals 100)
    /// * `size:100..200` (size between 100 inclusive and 200 exclusive)
    /// * `size:*..200` (size up to 200 exclusive)
    #[search(sort)]
    Size(Ordered<usize>),

    #[search(sort)]
    Sent(Ordered<time::OffsetDateTime>),

    Label(Qualified<'a, &'a str>),
}

Query derive 提供了特质实现。#[query(scope)] 属性将 Subject 变体标记为 Body 范围的主要搜索词，如果没有选择则将 Subject 作为默认值。

一般来说，有三种类型的词：主要、修饰词、谓词。谓词是简单的“这个条件是否为真”风格的过滤器。如果一个枚举变体没有值，它就是一个谓词。

修饰词是额外的匹配条件，这取决于值的类型。

使用 #[query(sort)] 标志，字段可以用于对结果进行排序。

现在，你可以执行以下查询

为了测试上面的资源，你可以运行 cli 示例

cargo run --example cli --features time -- -is:read AND foo

这将为您提供解析查询的结构化输出

Input: '-is:read AND foo'
Query {
    terms: And(
        [
            Not(
                Match(
                    Read,
                ),
            ),
            Match(
                Subject(
                    Partial(
                        "foo",
                    ),
                ),
            ),
        ],
    ),
    sorting: [],
}