retools

txttk.retools.condense(ss_unescaped)

Given multiple strings, returns a compressed regular expression just for these strings

>>> condense(['she', 'he', 'her', 'hemoglobin'])
'he(moglobin|r)?|she'

txttk.retools.is_solid(regex)

Check the given regular expression is solid.

>>> is_solid(r'a')
True
>>> is_solid(r'[ab]')
True
>>> is_solid(r'(a|b|c)')
True
>>> is_solid(r'(a|b|c)?')
True
>>> is_solid(r'(a|b)(c)')
False
>>> is_solid(r'(a|b)(c)?')
False

txttk.retools.is_packed(regex)

Check if the regex is solid and packed into a pair of parens

txttk.retools.consolidate(regex)

Put on a pair of parens (with no catch tag) outside the regex, if the regex is not yet consolidated

txttk.retools.danger_unpack(regex)

Remove the outermost parens

>>> unpack(r'(abc)')
'abc'
>>> unpack(r'(?:abc)')
'abc'
>>> unpack(r'(?P<xyz>abc)')
'abc'
>>> unpack(r'[abc]')
'[abc]'

txttk.retools.unpack(regex)

Remove the outermost parens, keep the (?P...) one

>>> unpack(r'(abc)')
'abc'
>>> unpack(r'(?:abc)')
'abc'
>>> unpack(r'(?P<xyz>abc)')
'(?P<xyz>abc)'
>>> unpack(r'[abc]')
'[abc]'

txttk.retools.parallel(regex_list, sort=False)

Join the given regexes using r’|’ if the sort=True, regexes will be sorted by lenth before processing

>>> parallel([r'abc', r'def'])
'abc|def'
>>> parallel([r'abc', r'd|ef'])
'abc|def'
>>> parallel([r'abc', r'(d|ef)'])
'abc|d|ef'
>>> parallel([r'abc', r'defg'])
'defg|abc'

txttk.retools.concat(regex_list)

Concat multiple regular expression into one, if the given regular expression is not packed, a pair of paren will be add.

>>> reg_1 = r'a|b'
>>> reg_2 = r'(c|d|e)'
>>> concat([reg_1, reg2])
(a|b)(c|d|e)

txttk.retools.nocatch(regex)

Put on a pair of parens (with no catch tag) outside the regex, if the regex is not yet packed; modified the outmost parens by adding nocatch tag

txttk.retools.nocatchall(regex)

Return a regex with all parens has a no catch tag

txttk.retools.option(regex)

return a regex has a option tag

>>> option(r'[ab]')
'[ab]?'
>>> option(r'(abc)')
'(abc)?'
>>> option('abc')
'(abc)?'