Blog

Escaping Solr Query Characters in Python

I’ve been working in some Python Solr client code. One area where bugs have cropped up is in query terms that need to be escaped before passing to Solr. For example, how do you send Solr an argument term with a “:” in it? Or a “(“?

It turns out that generally you just put a  in front of the character you want to escape. So to search for “:” in the “funnychars” field, you would send q=funnychars::.

Php programmer Mats Lindh has solved this pretty well, using str_replace. str_replace is a convenient, general-purpose string replacement function that lets you do batch string replacement. For example you can do:

$matches = array("Mary", "lamb", "fleece");$replacements = array("Harry", "dog", "fur");str_replace($matches, $replacements,            "Mary had a little lamb, its fleece was white as snow");

Python doesn’t quite have str_replace. There is translate which does single character to single character batch replacement. That can’t be used for escaping because the destination values are strings(ie “:”), not single characters. There’s a general purpose “str_replace” drop-in replacement at this Stackoverflow question:

edits = [("Mary", "Harry"), ("lamb", "dog"), ("fleece", "fur")] # etc.for search, replace in edits:  s = s.replace(search, replace)

You’ll notice that this algorithm requires multiple passes through the string for search/replacement. This is because that earlier search/replaces may impact later search/replaces. For example, what if edits was this:

edits = [("Mary", "Harry"), ("Harry", "Larry"), ("Larry", "Barry")]

First our str_replace will replace Mary with Harry in pass 1, then Harry with Larry in pass 2, etc.

It turns out that escaping characters is a narrower string replacement case that can be done more efficiently without too much complication. The only character that one needs to worry about impacting other rules is escaping the , as the other rules insert characters, we wouldn’t want them double escaped.

Aside from this caveat, all the escaping rules can be processed from a single pass through the string which my solution below does, performing a heck of a lot faster:

# These rules all independent, order of# escaping doesn't matterescapeRules = {'+': r'+',               '-': r'-',               '&': r'&',               '|': r'|',               '!': r'!',               '(': r'(',               ')': r')',               '{': r'{',               '}': r'}',               '[': r'[',               ']': r']',               '^': r'^',               '~': r'~',               '*': r'*',               '?': r'?',               ':': r':',               '"': r'"'