1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
String utils
============
.. Prevent text wrap in captures table
.. raw:: html
<style>
.wy-table-responsive table td {white-space: nowrap}
</style>
.. function:: re_find(regex, s, flags=0)
Finds ``regex`` in ``s``, returning the match in the simplest possible form guessed by captures in given regular expression:
================================= ==================================
Captures Return value
================================= ==================================
no captures a matched string
single positional capture a substring matched by capture
only positional captures a tuple of substrings for captures
only named captures a dict of substrings for captures
mixed pos/named captures a match object
================================= ==================================
Returns ``None`` on mismatch.
::
# Find first number in a line
silent(int)(re_find(r'\d+', line))
# Find number of men in a line
re_find(r'(\d+) m[ae]n', line)
# Parse uri into nice dict
re_find(r'^/post/(?P<id>\d+)/(?P<action>\w+)$', uri)
.. function:: re_test(regex, s, flags=0)
Tests whether ``regex`` can be found in ``s``.
.. function:: re_all(regex, s, flags=0)
re_iter(regex, s, flags=0)
Returns a list or an iterator of all matches of ``regex`` in ``s``. Matches are presented in most simple form possible, see table in :func:`re_find` docs.
::
# A fast and dirty way to parse ini section into dict
dict(re_iter('(\w+)=(\w+)', ini_text))
.. function:: re_finder(regex, flags=0)
Returns a function that calls :func:`re_find` for its sole argument. Its main purpose is quickly constructing mapper functions for :func:`map` and friends.
See also :ref:`extended_fns`.
.. function:: re_tester(regex, flags=0)
Returns a function that calls :func:`re_test` for it's sole argument. Aimed at quick construction of predicates for use in :func:`filter` and friends.
See also :ref:`extended_fns`.
.. function:: str_join([sep=""], seq)
Joins sequence with ``sep``. Same as ``sep.join(seq)``, but forcefully converts all elements to separator type, ``str`` by default.
See also :func:`joining`.
.. function:: cut_prefix(s, prefix)
Cuts prefix from given string if it's present.
.. function:: cut_suffix(s, suffix)
Cuts suffix from given string if it's present.
.. raw:: html
:file: descriptions.html
|
