solrq 0.0.2

solrq

Python Solr query utility. It helps making query strings for Solr more ‘pythonicaly’ and also helps with escaping reserved characters.

pip install solrq

And you’re ready to go!

usage

Everything in solrq is about Q object. Drop into python repl and just feed it with bunch of field and search terms to see how it works:

>>> from solrq import Q
>>> # note: all terms in single Q object are implicitely joined with 'AND'
>>> query = Q(type="animal", species="dog")
>>> query
<Q: type:animal AND species:dog>

>>> # ohh, forgot about cats?
>>> query & Q(type="animal", species="dog")
<Q: (type:animal AND species:dog) AND (type:animal AND species:dog)>

>>># more a cat lover? Let's give them a boost boost
>>> Q(type="animal") & (Q(species="cat")^2 | Q(species="dog"))
<Q: type:animal AND ((species:cat^2) OR species:dog)>

But what to do with this Q? Simply pass it to your Solr library of choice, like pysolr or mysolr. Most of them just expect simple string as a query parameter or even can’t help with escaping. This is why solrq integrates so easily. See how it looks like for pysolr:

from solrq import Q
import pysolr

solr = Solr("<your solr url>")

# simply using Q object
solr.search(Q(text="easy as f***"))

# or explicitely making it string
solr.search(str(Q(text="easy as f***")))

>>> Q(text='cat') ^ 2
<Q: text:cat^2>

>>> Q(text='cat') & Q(text='dog')
<Q: text:cat AND text:dog>

>>> Q(text='cat') | Q(text='dog')
<Q: text:cat AND text:dog>

>>> ~ Q(text='cat')
<Q: !text:cat>

>>> from solrq import Range
>>> Q(age=Range(18, 25))
<Q: age:[18 TO 25]>

>>> from solrq import Proximity
>>> Q(age=Proximity("cat dogs", 5))
<Q: age:"cat\ dogs"~5>

>>> from solrq import Q, Value
>>> Q(type='foo bar[]')
<Q: type:foo\ bar\[\]>
>>> Q(type=Value('foo bar[]', safe=True))
<Q: type:foo bar[]>

>>> from datetime import datetime, timedelta
>>> Q(date=datetime(1970, 1, 1))
<Q: date:"1970-01-01T00:00:00">
>>> # note that timedeltas has any sense mostly with ranges
>>> Q(delta=timedelta(days=1))
<Q: delta:NOW+1DAYS+0SECONDS+0MILLISECONDS>

>>> Q(**{"*_t": "text_to_search"})
<Q: *_t:text_to_search>

contributing

Any contribution is welcome. Issues, suggestions, pull requests - whatever. There are no strict contribution guidelines beyond PEP-8 and sanity. Code style is checked with flakes8 and any PR that has failed build will not be merged.

And one last thing: if you submit a PR please do not rebase it later unless you are not asked for that. Reviewing pull requests that suddenly had their history rewritten just drives me crazy.

testing

Tests are run using tox. Simply install it and run:

pip install
tox

And that’s all.