Ravenports generated: 17 Sep 2022 15:25
[ravenports.git] / bucket_AC / python-regex
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-regex
4 VERSION=                2022.9.13
5 KEYWORDS=               python
6 VARIANTS=               py39 py310
7 SDESC[py310]=           Alternative regular expression module (3.10)
8 SDESC[py39]=            Alternative regular expression module (3.9)
9 HOMEPAGE=               https://github.com/mrabarnett/mrab-regex
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPI/r/regex
14 DISTFILE[1]=            regex-2022.9.13.tar.gz:main
15 DF_INDEX=               1
16 SPKGS[py310]=           single
17 SPKGS[py39]=            single
18
19 OPTIONS_AVAILABLE=      PY39 PY310
20 OPTIONS_STANDARD=       none
21 VOPTS[py310]=           PY39=OFF PY310=ON
22 VOPTS[py39]=            PY39=ON PY310=OFF
23
24 DISTNAME=               regex-2022.9.13
25
26 GENERATED=              yes
27
28 [PY39].USES_ON=                         python:py39,sutools
29
30 [PY310].USES_ON=                        python:py310,sutools
31
32 [FILE:3137:descriptions/desc.single]
33 Introduction
34 ------------
35
36 This regex implementation is backwards-compatible with the standard 're'
37 module, but offers additional functionality.
38
39 Note
40 ----
41
42 The re module's behaviour with zero-width matches changed in Python 3.7,
43 and this module follows that behaviour when compiled for Python 3.7.
44
45 Python 2
46 --------
47
48 Python 2 is no longer supported. The last release that supported Python 2
49 was 2021.11.10.
50
51 PyPy
52 ----
53
54 This module is targeted at CPython. It expects that all codepoints are the
55 same width, so it won't behave properly with PyPy outside U+0000..U+007F
56 because PyPy stores strings as UTF-8.
57
58 Multithreading
59 --------------
60
61 The regex module releases the GIL during matching on instances of the
62 built-in (immutable) string classes, enabling other Python threads to run
63 concurrently. It is also possible to force the regex module to release the
64 GIL during matching by calling the matching methods with the keyword
65 argument ``concurrent=True``. The behaviour is undefined if the string
66 changes during matching, so use it *only* when it is guaranteed that that
67 won't happen.
68
69 Unicode
70 -------
71
72 This module supports Unicode 14.0.0. Full Unicode case-folding is
73 supported.
74
75 Flags
76 -----
77
78 There are 2 kinds of flag: scoped and global. Scoped flags can apply to
79 only part of a pattern and can be turned on or off; global flags apply to
80 the entire pattern and can only be turned on.
81
82 The scoped flags are: ``ASCII (?a)``, ``FULLCASE (?f)``, ``IGNORECASE
83 (?i)``, ``LOCALE (?L)``, ``MULTILINE (?m)``, ``DOTALL (?s)``, ``UNICODE
84 (?u)``, ``VERBOSE (?x)``, ``WORD (?w)``.
85
86 The global flags are: ``BESTMATCH (?b)``, ``ENHANCEMATCH (?e)``, ``POSIX
87 (?p)``, ``REVERSE (?r)``, ``VERSION0 (?V0)``, ``VERSION1 (?V1)``.
88
89 If neither the ASCII, LOCALE nor UNICODE flag is specified, it will default
90 to UNICODE if the regex pattern is a Unicode string and ASCII if it's a
91 bytestring.
92
93 The ENHANCEMATCH flag makes fuzzy matching attempt to improve the fit of
94 the next match that it finds.
95
96 The BESTMATCH flag makes fuzzy matching search for the best match instead
97 of the next match.
98
99 Old vs new behaviour
100 --------------------
101
102 In order to be compatible with the re module, this module has 2 behaviours:
103
104 * **Version 0** behaviour (old behaviour, compatible with the re module):
105
106   Please note that the re module's behaviour may change over time, and I'll
107 endeavour to match that behaviour in version 0.
108
109   * Indicated by the VERSION0 flag.
110
111   * Zero-width matches are not handled correctly in the re module before
112 Python 3.7. The behaviour in those earlier versions is:
113
114     * ``.split`` won't split a string at a zero-width match.
115
116     * ``.sub`` will advance by one character after a zero-width match.
117
118   * Inline flags apply to the entire pattern, and they can't be turned off.
119
120   * Only simple sets are supported.
121
122   * Case-insensitive matches in Unicode use simple case-folding by default.
123
124 * **Version 1** behaviour (new behaviour, possibly different from the re
125 module):
126
127   * Indicated by the VERSION1 flag.
128
129   * Zero-width matches are handled correctly.
130
131   * Inline flags apply to the end of the group or pattern, and they can be
132 turned off.
133
134
135 [FILE:101:distinfo]
136 f07373b6e56a6f3a0df3d75b651a278ca7bd357a796078a26a958ea1ce0588fd       391531 regex-2022.9.13.tar.gz
137