Python bindings for the PCRE2 regular expression library

These details have not been verified by PyPI

Project links

Homepage

Project description

PCRE2.py: Python bindings for the PCRE2 regular expression library

This project contains Python bindings for PCRE2. PCRE2 is the revised API for the Perl-compatible regular expressions (PCRE) library created by Philip Hazel. For original source code, see the official PCRE2 repository.

Installation

From PyPI:

pip install pcre2

If a wheel is not available for your platform, the module will be built from source. Building requires:

cmake
C compiler toolchain, such as gcc and make
libtool
Python headers

Usage

Regular expressions are compiled with pcre2.compile() which accepts both unicode strings and bytes-like objects. This returns a Pattern object. Expressions can be compiled with a number of options (combined with the bitwise-or operator) and can be JIT compiled,

>>> import pcre2
>>> expr = r'(?<head>\w+)\s+(?<tail>\w+)'
>>> patn = pcre2.compile(expr, options=pcre2.I, jit=True)
>>> # Patterns can also be JIT compiled after initialization.
>>> patn.jit_compile()

Inspection of Pattern objects is done as follows,

>>> patn.jit_size
980
>>> patn.name_dict()
{1: 'head', 2: 'tail'}
>>> patn.options
524296
>>> # Deeper inspection into options is available.
>>> pcre2.CompileOption.decompose(patn.options)
[<CompileOption.CASELESS: 0x8>, <CompileOption.UTF: 0x80000>]

Once compiled, Pattern objects can be used to match against strings. Matching return a Match object, which has several functions to view results,

>>> subj = 'foo bar buzz bazz'
>>> match = patn.match(subj)
>>> match.substring()
'foo bar'
>>> match.start(), match.end()
(8, 17)

Substitution is also supported, both from Pattern and Match objects,

>>> repl = '$2 $1'
>>> patn.substitute(repl, subj) # Global substitutions by default.
'bar foo bazz buzz'
>>> patn.substitute(repl, subj, suball=False)
'bar foo buzz bazz'
>>> match.expand(repl)
'bar foo buzz bazz'

Additionally, Pattern objects support scanning over subjects for all non-overlapping matches,

>>> for match in patn.scan(subj):
...     print(match.substring('head'))
...
foo
buzz

Performance

PCRE2 provides a fast regular expression library, particularly with JIT compilation enabled. Below are the regex-redux benchmark results included in this repository,

Script	Number of runs	Total time	Real time	User time	System time
`baseline.py`	10	3.020	0.302	0.020	0.086
`vanilla.py`	10	51.380	5.138	11.408	0.529
`hand_optimized.py`	10	13.190	1.319	2.846	0.344
`pcre2_module.py`	10	13.670	1.367	2.269	0.532

Script descriptions are as follows,

Script	Description
`baseline.py`	Reads input file and outputs stored expected output
`vanilla.py`	Pure Python version
`hand_optimized.py`	Manually written Python `ctypes` bindings for shared PCRE2 C library
`pcre2_module.py`	Implementation using Python bindings written here

Tests were performed on an M2 Macbook Air. Note that to run benchmarks locally, Git LFS must be installed to download the input dataset. Additionally, a Python virtual environment must be created, and the package built with make init and make build respectively. For more information on this benchmark, see The Computer Language Benchmarks Game. See source code of benchmark scripts for details and original sources.

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

This version

0.4.0

Apr 20, 2024

0.3.0

Sep 14, 2023

0.2.0

Apr 17, 2023

0.1.0

Nov 8, 2022

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pcre2-0.4.0.tar.gz (2.9 MB view details)

Uploaded Apr 20, 2024 Source

Built Distributions

pcre2-0.4.0-cp311-cp311-win_amd64.whl (1.9 MB view details)

Uploaded Apr 20, 2024 CPython 3.11 Windows x86-64

pcre2-0.4.0-cp311-cp311-musllinux_1_1_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.11 musllinux: musl 1.1+ x86-64

pcre2-0.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.11 manylinux: glibc 2.17+ x86-64

pcre2-0.4.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.11 manylinux: glibc 2.17+ ARM64

pcre2-0.4.0-cp311-cp311-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded Apr 20, 2024 CPython 3.11 macOS 11.0+ ARM64

pcre2-0.4.0-cp311-cp311-macosx_10_9_x86_64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.11 macOS 10.9+ x86-64

pcre2-0.4.0-cp310-cp310-win_amd64.whl (1.9 MB view details)

Uploaded Apr 20, 2024 CPython 3.10 Windows x86-64

pcre2-0.4.0-cp310-cp310-musllinux_1_1_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.10 musllinux: musl 1.1+ x86-64

pcre2-0.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.10 manylinux: glibc 2.17+ x86-64

pcre2-0.4.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.10 manylinux: glibc 2.17+ ARM64

pcre2-0.4.0-cp310-cp310-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded Apr 20, 2024 CPython 3.10 macOS 11.0+ ARM64

pcre2-0.4.0-cp310-cp310-macosx_10_9_x86_64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.10 macOS 10.9+ x86-64

pcre2-0.4.0-cp39-cp39-win_amd64.whl (1.9 MB view details)

Uploaded Apr 20, 2024 CPython 3.9 Windows x86-64

pcre2-0.4.0-cp39-cp39-musllinux_1_1_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.9 musllinux: musl 1.1+ x86-64

pcre2-0.4.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.9 manylinux: glibc 2.17+ x86-64

pcre2-0.4.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.9 manylinux: glibc 2.17+ ARM64

pcre2-0.4.0-cp39-cp39-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded Apr 20, 2024 CPython 3.9 macOS 11.0+ ARM64

pcre2-0.4.0-cp39-cp39-macosx_10_9_x86_64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.9 macOS 10.9+ x86-64

pcre2-0.4.0-cp38-cp38-win_amd64.whl (1.9 MB view details)

Uploaded Apr 20, 2024 CPython 3.8 Windows x86-64

pcre2-0.4.0-cp38-cp38-musllinux_1_1_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.8 musllinux: musl 1.1+ x86-64

pcre2-0.4.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.8 manylinux: glibc 2.17+ x86-64

pcre2-0.4.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.8 manylinux: glibc 2.17+ ARM64

pcre2-0.4.0-cp38-cp38-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded Apr 20, 2024 CPython 3.8 macOS 11.0+ ARM64

pcre2-0.4.0-cp38-cp38-macosx_10_9_x86_64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.8 macOS 10.9+ x86-64

pcre2-0.4.0-cp37-cp37m-win_amd64.whl (1.9 MB view details)

Uploaded Apr 20, 2024 CPython 3.7m Windows x86-64

pcre2-0.4.0-cp37-cp37m-musllinux_1_1_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.7m musllinux: musl 1.1+ x86-64

pcre2-0.4.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.7m manylinux: glibc 2.17+ x86-64

pcre2-0.4.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.7m manylinux: glibc 2.17+ ARM64

pcre2-0.4.0-cp37-cp37m-macosx_10_9_x86_64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.7m macOS 10.9+ x86-64

pcre2-0.4.0-cp36-cp36m-win_amd64.whl (1.9 MB view details)

Uploaded Apr 20, 2024 CPython 3.6m Windows x86-64

pcre2-0.4.0-cp36-cp36m-musllinux_1_1_x86_64.whl (2.3 MB view details)

Uploaded Apr 20, 2024 CPython 3.6m musllinux: musl 1.1+ x86-64

pcre2-0.4.0-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.6m manylinux: glibc 2.17+ x86-64

pcre2-0.4.0-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.1 MB view details)

Uploaded Apr 20, 2024 CPython 3.6m manylinux: glibc 2.17+ ARM64

pcre2-0.4.0-cp36-cp36m-macosx_10_9_x86_64.whl (2.2 MB view details)

Uploaded Apr 20, 2024 CPython 3.6m macOS 10.9+ x86-64

File details

Details for the file pcre2-0.4.0.tar.gz.

File metadata

Download URL: pcre2-0.4.0.tar.gz
Upload date: Apr 20, 2024
Size: 2.9 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/5.0.0 CPython/3.9.19

File hashes

Hashes for pcre2-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`ebc3efd3134fef1ff440f3d3e314fa80296172ecf13a6e84c00fb13a242d3051`
MD5	`ee657d446f56ae3b2304692f05a7c4b8`
BLAKE2b-256	`493014a6d20d631423931b21360fd137bdcd25ee25a2dda11ab512b059d09f8f`

Algorithm	Hash digest
SHA256	`dfa828ff5db9b8608e7686f8b56e2b30270fecafa180ddedda5ffa7d3a1b155f`
MD5	`a87ee25d9839076ea88d770f46589a19`
BLAKE2b-256	`47d9b813972209ec072c35d12c57bac4674f40542005330ac62cfbd8387381f2`

Algorithm	Hash digest
SHA256	`dcb4d60a2e7b62e64d1e136a3463bb623607006fae30991907ccc74452525a52`
MD5	`72776906c0efddc8f982ed1d653ba7ac`
BLAKE2b-256	`788d86f7040c21cdab9e8da11623f697ccd9fb3d1a705245c067b85a36da2ac8`

Algorithm	Hash digest
SHA256	`2d56e919abddc4d2c203e2d70d7f4d678b2a8c97b9106521bfe3b43b6c8f9913`
MD5	`ce715052ff6245da546779399116dd1c`
BLAKE2b-256	`3b281e7cebe3dbca9a24a2be0460dc8b6c9e0c4fc22b2878519e3ca91eedea15`

Algorithm	Hash digest
SHA256	`b47061d2ab77718b10c5c7dc2df5d3dc38df8a9c4aa94c342e5113ed65dab79d`
MD5	`017688b9f0285b8536878681528a7487`
BLAKE2b-256	`affa8186ccf80759a088264660a3fb745390afe3406113fdbb2ab283f203bbc3`

Algorithm	Hash digest
SHA256	`5f49a62f27b718481a722be450c75671160041f936ffa22358aa378c5e8f03db`
MD5	`2235211bcb5b78f5d7578c0683a07122`
BLAKE2b-256	`f59a9e597d0bde10132a64518d9e15c71565196501654d3b421434dc08738697`

Algorithm	Hash digest
SHA256	`a31226def6388e31231c6c4cf7957e692ef77e863ad9e1cbc42dd947c345cdb3`
MD5	`679c274eb0bf7dc9524d30b40ac48c43`
BLAKE2b-256	`bfda04f8eae620e0f2db0ade917f002ba9dc9e7ade815731d3921d17dd1e60ce`

Algorithm	Hash digest
SHA256	`e9bf01ec7b4462131a29deb4e449702d786b0ea4dba66679beec00422bf21a04`
MD5	`7a757a6d62da7ebb33f37235bf602eb2`
BLAKE2b-256	`085d8d2ca99de4d72aaec6d5a9e9d62afa4a506f7a80d48f0e9a65c0755871b9`

Algorithm	Hash digest
SHA256	`b4c64bdb6db21f7c2a5b53e8ceedccb86d1d165b28b21c1ad7c0c53442eb9525`
MD5	`b7dab1103421aea67e917d7088218693`
BLAKE2b-256	`c956ef2538b256ecda43385dda94e8dfc77b56e6e8a4da0139ee8fadfde3c58c`

Algorithm	Hash digest
SHA256	`ea422f9f5bf3dff9ab9cbffc6c407b92b8e45b10afdd1d4cfff0a2ce69bfcae9`
MD5	`56c3dc32c69e3db14b6ad2092db6ba08`
BLAKE2b-256	`d4cfbd93c0555c678a0a0ab273c6b3fbe553e47042d4ffdc5e130a443575fa34`

Algorithm	Hash digest
SHA256	`9171a9357dab1b95db809a7bfcf6658fb939a4742a93351e9fbf6bfe7b0a5bd3`
MD5	`a0774706bc34a896b75405eef6f5e1c7`
BLAKE2b-256	`4c8655c32f84b9beec72b6684e100b5ff100aea1b7041df942cf181e09417edc`

Algorithm	Hash digest
SHA256	`2776e2244794f65d43b6f68472970348b14e2146b052362450600e2b630650ec`
MD5	`1113d90e6ecbf8f97bdda928aa07dc9e`
BLAKE2b-256	`e64593d9c5d2d490590197f53d014ea71e95424bf66c843a243f5526ebb6afbd`

Algorithm	Hash digest
SHA256	`60d2992a282f14b19b5550e055a43860fd1a36d13d518de2a321af8fc2798f45`
MD5	`e5ef4677feeb160da1228921b1c9b889`
BLAKE2b-256	`63868d9b18b3a2af842892dcddaeea4cb5f1969a476987a81eec0bc6e4a384d6`

Algorithm	Hash digest
SHA256	`4517865a07e1338865fcb3af7af95aa4075ea07da2fa77f6c7b4a240fcb24c93`
MD5	`3905e5edbcb3c2083fd78bc6660b612c`
BLAKE2b-256	`5907eff8dedd007c09f7f89d0bae5e9cb70cdcea677401060f1eaca44762879d`

Algorithm	Hash digest
SHA256	`b4759a5b1df132ed1659338d8942f215def844f4561dabdd2110a0c8f75935be`
MD5	`e6c23d68c2721e6abfe3183287960c1a`
BLAKE2b-256	`566ff85f6fd56027b25534814512b6a7449d223056991ce2b2f5713c299fee3e`

Algorithm	Hash digest
SHA256	`8df0c6a690b071bcdf5ea4c4781e6400c164a250cbf748facf3396b8bef79012`
MD5	`b475ba990e0c1d79f01e6e96034419ba`
BLAKE2b-256	`25fe7611b98b49bedaf3d31d52385f14710b98679bc730b14db0e67e14f906f1`

Algorithm	Hash digest
SHA256	`7f14453e4792595ab1358dd67f2bc2f54efaa3bb9901a8d60a5fb36c393103a7`
MD5	`cdcfc98a4037da3484daf67747375bf1`
BLAKE2b-256	`3069225f79aca2634066fbd32a78154c635585a50ee0bb0230ab95614991fd17`

Algorithm	Hash digest
SHA256	`8c978420031d28b062829278eeaefd2974c35ec8743dd339db782329ff26980d`
MD5	`99d04b810d6197a291b2ec334e6d49ae`
BLAKE2b-256	`af6d516a0be5a4bb0bd9d06918019dfbfab2a09bc8dca5dfcb0a6ca099a0808e`

Algorithm	Hash digest
SHA256	`f727447d4e1255b9d6c37f8652aa44c0cbb28d2fb950e076176f10416fd65fb5`
MD5	`eb5ff21f2c5837c84f89624bcc4c84fa`
BLAKE2b-256	`db0a058937e5a437c312d011df4ca400deb2e3726f446a382bc1af72b0851050`

Algorithm	Hash digest
SHA256	`1826dd58f969936cc09981dbe664b77bc814d8d8f1ed23bb75b067c0c84adccd`
MD5	`65447e1c5c9a3c40a8b6ba9f3394b92a`
BLAKE2b-256	`fdb404155acfedf61d18d9517133efa39508c324695e7d6a5f24a9eaabd9e381`

Algorithm	Hash digest
SHA256	`48ce33defad4b2b52aa15f561ed3e05f4c9a48102ab38277a29d695b3f440ddb`
MD5	`f412f80e20fd7b6828fff0adc5d2207b`
BLAKE2b-256	`cceec6bcaf6f1c41bc34e6f63df62b7773e6172ab9a3115bac010be2f0a5e899`

pcre2 0.4.0

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

PCRE2.py: Python bindings for the PCRE2 regular expression library

Installation

Usage

Performance

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

Algorithm	Hash digest
SHA256	`fbe16baf78ef42d765ea9938d02476efe5c71c47e6060706ca42c5c3ba8adeb8`
MD5	`b751937fc87308c463368909fde7a8b1`
BLAKE2b-256	`717d561b86e795037bea71be84be67f378fe513afe4466c0906d0d13cc332997`

Algorithm	Hash digest
SHA256	`a3916de168491936fe5fd074e852a92ef4c2630f168541dc227cdfb2a14d13e9`
MD5	`f1dfce8563f86285c9087486a455f7bc`
BLAKE2b-256	`7b73b20893fcb8a7820c31e4d3b2b474e8bd4a59c082becc45ccbbcb6fa3735b`

Algorithm	Hash digest
SHA256	`30f5c9679918ab04e493cd4a8ad4931c3f756c9d3cc702b9b215e3f20267cfe1`
MD5	`39856d243827721b3c1671b93ffb307f`
BLAKE2b-256	`6a858417527264c999983a623a21333b689534e7e42abbcaead66e69c5899645`

Algorithm	Hash digest
SHA256	`3f24db661dca6744053aba762dc6993d92d86512c19462ae57e0e4e6a3ce1f4f`
MD5	`ef53e0116015f829515018150d444513`
BLAKE2b-256	`be20d62901c6abab1a6c246c842eb1dab71af252e619987bb8cb6813256ab1eb`

Algorithm	Hash digest
SHA256	`f653e15528a30b0a70d9c89d561a59d05568283a7de1c2777cedde7e6dd94fff`
MD5	`20f481d9a38a6064bf0c9f1840bea2c6`
BLAKE2b-256	`e2de4f9235092f535f12b7c357c8b00cfae3529a9cdd4cbafb6441bf5125df2e`

Algorithm	Hash digest
SHA256	`3810d2f8dbe137d4b7fbb5bf254723f81cfd06cca4776e1b4600e14dcd55da94`
MD5	`5088548560490f17406240f129a41226`
BLAKE2b-256	`66475748bcd4ea7e44bade9bedb5d877dbd7db365dab696ab8f0723fb34bcd44`

Algorithm	Hash digest
SHA256	`7bbabbcfde7bf9ac140b15430680bdaecc99d54872098e6867c66c49df96862b`
MD5	`f009379de6a69c88219f1339b6343773`
BLAKE2b-256	`3d827e0067fb3b5078aa7db4aa9037aa5d8945ff21cdf5d63f1419f226b44795`

Algorithm	Hash digest
SHA256	`c0d97d0adbe4a43870b8bfb96a72a3e37ab806483b0c85a2fbb4daf635467d51`
MD5	`f3957e2ace2c28f1df9d4c70c618952b`
BLAKE2b-256	`724a8a9bddb87a31cc9c5339462ce679143a1875adb8fd63ec5c832967b65731`

Algorithm	Hash digest
SHA256	`af04a41186ad76f98350cb7d960af130679847b821423c0f6cf31bfd40333a86`
MD5	`d12a01c14256da3f7b1c12031e378d32`
BLAKE2b-256	`ec1397f8f5dfa66777a123d24c591e4146e04afd4f6fcc34ac622952851c02f4`

Algorithm	Hash digest
SHA256	`9c6d62dc83611016316c50dbf0d7fe8e08e36e25406b7a2c1bc4b8798c36a8b0`
MD5	`cd45ca1a2e550b1874b9102b763fc4b9`
BLAKE2b-256	`5bfb7f2b9c01aea258b61fdae329f79e396ca1fbce29dd879f2380809d011a0f`