real-regex
A drop-in replacement for Python's re, backed by a linear-time, ReDoS-safe C++20 engine — with
bounded lookarounds that the other linear-time engines (RE2, Rust) don't have.
pip install real-regex
Drop-in for re
Import it as re and use the API you already know — compile, search, match, fullmatch, findall,
finditer, sub, subn, split, and Match.group / groups / groupdict / span / start / end:
import real as re
m = re.match(r"(\w+)@(\w+)\.(\w+)", "user@example.com")
m.group(1), m.group(2), m.group(3) # ('user', 'example', 'com')
re.findall(r"\d+", "a1 b22 c333") # ['1', '22', '333']
re.sub(r"\s+", "_", "a b c") # 'a_b_c'
Flags work the same: re.I, re.M, re.S, re.X, re.A. Unicode \w \d \s \b and IGNORECASE
case-folding follow re in text mode.
Why replace re
- No ReDoS.
re(like every backtracking engine) blows up on patterns like(a+)+bagainst a hostile input — seconds, then minutes. real-regex is a Thompson NFA simulation: linear time, always, no catastrophic backtracking, ever. - Bounded lookarounds, still linear.
(?=…)(?!…)(?<=…)(?<!…)— including variable-width lookbehind — match without backtracking. RE2 and Rust drop lookarounds to stay safe; real-regex keeps them. - Faster than
reon most work — the measured multiples (geometric mean, per-case wins and the two accepted losses) live indocs/BENCHMARKS.md§B. Sparse scans, multiline anchors and capture-dense extraction lead; a couple of high-volumesplit/tiny-anchored cases stay slower (CPython's C engine wins there). It is not the fastest engine at raw throughput — it is the safe one that is also quick.
Not re, on purpose
Strict by default — every accepted pattern is guaranteed linear. The unsupported constructs
(backreferences, conditionals, non-binary Unicode properties like \p{Bidi_Class=L}) raise real.error
rather than silently falling back to a backtracking engine, so a compiled pattern is a ReDoS-safety
guarantee, not a maybe. (\p{L} / \p{sc=Greek} / \p{scx=Grek} / \p{Alphabetic} — General_Category,
Script, Script_Extensions and the standard binary properties — are supported, a superset of stdlib
re.) Opt
into delegating those to the standard library re per call with real.compile(pat, fallback=True) (or
module-wide with real.fallback = True) — it may accept them, at the cost of the linear-time guarantee for
that pattern; Pattern.engine ("real" or "re") always tells you which backend you got. A few semantics
differ deliberately (e.g. a nullable loop's final empty capture). Full list:
Differences from Python re.
The wheel also ships the header-only C++ library — real.get_include() returns its path, so the same engine
is available to C++ via #include <real/real.hpp>. Source, benchmarks and the C++ API:
https://github.com/RECHE23/real-regex.
1 maintainer
Metadata
1 maintainer
Release files for real-regex 2026.10.14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| real_regex-2026.10.14.tar.gz | 687.3 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| real_regex-2026.10.14-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details |
| real_regex-2026.10.14-cp311-abi3-win32.whl | CPython 3.11 | abi3 | Windows x86-32 | Details |
| real_regex-2026.10.14-cp311-abi3-musllinux_1_2_x86_64.whl | CPython 3.11 | abi3 | Linux musl 1.2+ x86-64 | Details |
| real_regex-2026.10.14-cp311-abi3-musllinux_1_2_aarch64.whl | CPython 3.11 | abi3 | Linux musl 1.2+ ARM64 | Details |
| real_regex-2026.10.14-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.24+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| real_regex-2026.10.14-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl | CPython 3.11 | abi3 | Linux glibc 2.24+ ARM64, Linux glibc 2.28+ ARM64 | Details |
| real_regex-2026.10.14-cp311-abi3-macosx_11_0_arm64.whl | CPython 3.11 | abi3 | macOS 11.0+ ARM64 | Details |
| real_regex-2026.10.14-cp311-abi3-macosx_10_9_x86_64.whl | CPython 3.11 | abi3 | macOS 10.9+ x86-64 | Details |
Total release size: 23.3 MB
Release files / real_regex-2026.10.14.tar.gz
| Download URL | real_regex-2026.10.14.tar.gz |
|---|---|
| Size | 687.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ad8439f72e03a071fad93932e438141ccfc7b93c1627a6e134dd283ea614dad0
|
|
BLAKE2b-256 checksum How to use checksums |
095ae7cfc0e6e6453079beee101c49010ee48f3e65cba0dcfdabbf2de656c5ad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / real_regex-2026.10.14-cp311-abi3-win_amd64.whl
| Download URL | real_regex-2026.10.14-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
112c0f7c928f0efdafe4c3fe5d5a3b28b4ac72bda447311e2f2ccbe05ff72379
|
|
BLAKE2b-256 checksum How to use checksums |
1d20afaf6f82681604de3879b395209aed4a2485cf547da556af864cfb849199
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / real_regex-2026.10.14-cp311-abi3-win32.whl
| Download URL | real_regex-2026.10.14-cp311-abi3-win32.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.11 Windows x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
b0c6d25a4d5e6d75d4ecdb56162fbd2fd7e4f35a069d6bf20445f5ba5b1aceb7
|
|
BLAKE2b-256 checksum How to use checksums |
2388ac6cbad49ce5fbb4e2fecc8d0d9aee538f3bd750c5b570dfa9402a5d6310
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / real_regex-2026.10.14-cp311-abi3-musllinux_1_2_x86_64.whl
| Download URL | real_regex-2026.10.14-cp311-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 5.2 MB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
ee25bdb482a8076e93e613cc213979b3644267dca584dd28b581e12aa7a57e48
|
|
BLAKE2b-256 checksum How to use checksums |
3285cce5295f447e413ecc7e69218f0cfc3fd0e0090a02dbbdc67b474b9ca74d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / real_regex-2026.10.14-cp311-abi3-musllinux_1_2_aarch64.whl
| Download URL | real_regex-2026.10.14-cp311-abi3-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 5.0 MB |
| Tags | CPython 3.11 Linux musl 1.2+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
ca73524c7b48cb28be83ff0ac0074c8be07b43565c40c7e8983411bdd3df6560
|
|
BLAKE2b-256 checksum How to use checksums |
653ef53d5da1e4235eb008407b81d4bb7f1fcbfdac2003ee2753d4ce5a66406e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / real_regex-2026.10.14-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
| Download URL | real_regex-2026.10.14-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 4.2 MB |
| Tags | CPython 3.11 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
da4f0898b9e94906b8925b1b9eb5b526a9f8aa9aee270d3ef7589d477cebab73
|
|
BLAKE2b-256 checksum How to use checksums |
a1641c07906a0b72cecf7940e2f81c634c4452afa2601bf92f97b14d480168d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / real_regex-2026.10.14-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
| Download URL | real_regex-2026.10.14-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.11 Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
da6eda54adeba12c2003bfb3696913048565a5f813d7f8b0f2d4b6b3d684ac25
|
|
BLAKE2b-256 checksum How to use checksums |
10e3d29410c2a77c3a87db6d9b80ac33c9ce2f17bd31d526b2992841ee758847
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / real_regex-2026.10.14-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | real_regex-2026.10.14-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 964.6 kB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
077480571cf900beaa4a16f11bf1b340941b600d3ccfd07aa98ff20fb8e76a51
|
|
BLAKE2b-256 checksum How to use checksums |
064fb141ab718307222468c41f2c44dca3643813b84ed45b17520b07503aaa73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / real_regex-2026.10.14-cp311-abi3-macosx_10_9_x86_64.whl
| Download URL | real_regex-2026.10.14-cp311-abi3-macosx_10_9_x86_64.whl |
|---|---|
| Size | 999.0 kB |
| Tags | CPython 3.11 abi3 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
46df07a17b5f775ebc37411260e375baea30881c1c2d5f6ad1f1202cb3940d87
|
|
BLAKE2b-256 checksum How to use checksums |
1379bd233813136d779a8f67e8f95284a96bede9d33e6b7f3cc826fcbbc7bbd0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency log
