lucene-querybuilder 0.2

开始

>>> from lucenequerybuilder import Q

创建查询

基本查询可以通过将字符串传入q的构造函数来给出。

>>> q = Q('a')

>>> q = Q('The quick brown fox')

查询构建器将自动检测一个术语（没有空格）还是一个短语（多个术语一起用空格分隔），并用引号将它们正确地绑定。

所有术语和短语都将被取消转义，并将被转义：

>>> q = Q(r'The *quick* brown (fox)')

>>> str(q)

'"The \\*quick\\* brown \\(fox\\)"'

范围查询

范围也很容易放入查询中。有两种类型的范围查询，包含范围和排除范围。这些将通过关键字参数传递到查询生成器中。

>>> q = Q(inrange=(1,5))

>>> q = Q(exrange=['egg','hgg'])

ranges可用于任何长度为2的列表式对象。

链接查询

您可以使用&；（and）、（or）、&；~（and not）、+（must）和-（must not）链接查询。并且，或者，并且不需要在它出现之前和之后进行查询。必须而且不仅必须在之后直接处理查询。下面是一些示例：

>>> q = Q('a') & Q('b')

>>> q = Q('a') & ~Q('b')

>>> q = +Q('a') -Q('b')

嵌套查询

查询可以相互嵌套以创建新查询。这使得将查询分组变得很容易。以下示例：

>>> q = Q(Q('a') & Q('b')) & ~Q('c')

>>> q = Q(Q(Q('a') | Q(inrange=[1,2])) +Q('c))

字段

通过将字段作为第一个参数放入查询，可以将字段添加到查询中。字段不能有任何空格，也不能相互嵌套。以下示例是有效的查询：

>>> q = Q('name', 'Edward')

>>> q = Q('text', 'Mary had a little lamb')

>>> q = Q('age', inrange=[10, 9001])

以下示例是将引发错误的无效查询：

>>> q = Q('name', Q('lastname', 'Purcell'))

>>> q = Q('bad', Q('range', inrange=[10, 9001]))

模糊查询

使用fuzzy关键字可以完成模糊术语查询：

>>> q = Q('name', fuzzy=('edd', .2))

>>> str(q)

'name:(edd~0.200)'

模糊元组中的第一个元素是术语，第二个元素是相似度比率-浮点数、str或介于0和1之间的小数。

如果删除第二个元素，只提供str，则字符串将表示使用lucene的默认比率-0.5:

>>> q = Q('name', fuzzy='edd')

>>> str(q)

'name:(edd~)'

通配符查询

为了防止通配符查询有'？'和'*'被转义，简单地包括通配符标志：

>>> str(Q('c?t', wildcard=True))

'c?t'

与“猫”或“小床”匹配。

增强通配符查询

这些查询尚不受支持，但将很快提供。随时添加支持自己和要求拉！