PyPcre 0.2.2__tar.gz → 0.2.4__tar.gz

{pypcre-0.2.2 → pypcre-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPcre
-Version: 0.2.2
+Version: 0.2.4
 Summary: Modern, GIL-friendly, Fast Python bindings for PCRE2 with auto caching and JIT of compiled patterns.
 Author-email: ModelCloud <qubitium@modelcloud.ai>
 License-Expression: Apache-2.0
@@ -32,7 +32,7 @@ Dynamic: license-file
 
 # PyPcre (Python Pcre2 Binding)
 
-Python bindings for the system PCRE2 library with a familiar `re`-style API.
+Modern `nogil` Python bindings for the Pcre2 library with `stdlib.re` api compatibility.
 
 <p align="center">
     <a href="https://github.com/ModelCloud/PyPcre/releases" style="text-decoration:none;"><img alt="GitHub release" src="https://img.shields.io/github/release/ModelCloud/Pcre.svg"></a>
@@ -43,7 +43,7 @@ Python bindings for the system PCRE2 library with a familiar `re`-style API.
 </p>
 
 ## Latest News
-* 10/11/2025 [0.2.1](https://github.com/ModelCloud/PyPcre/releases/tag/v0.2.1): 🤗 Full `GIL=0` compliance for Python >= 3.13T. Reduced cache thread contention. Improved performance for all api. Expanded ci testing coverage. FreeBSD, Solaris, and Windows compatibility validated.
+* 10/12/2025 [0.2.3](https://github.com/ModelCloud/PyPcre/releases/tag/v0.2.3): 🤗 Full `GIL=0` compliance for Python >= 3.13T. Reduced cache thread contention. Improved performance for all api. Expanded ci testing coverage. FreeBSD, Solaris, and Windows compatibility validated.
 * 10/09/2025 [0.1.0](https://github.com/ModelCloud/PyPcre/releases/tag/v0.1.0): 🎉 First release. Thread safe, auto JIT, auto pattern caching and optimistic linking to system library for fast install.
 
 ## Why PyPcre:
@@ -64,9 +64,29 @@ pip install PyPcre
 
 The package prioritizes linking against the `libpcre2-8` shared library in system for fast install and max security protection which gets latest patches from OS. See [Building](#building) for manual build details.
 
+## Platform Support (Validated):
+
+`Linux`, `MacOS`, `Windows`, `WSL`, `FreeBSD`, `Solaris`
+
+
 ## Usage
 
-### Drop-in helpers
+
+If you already rely on the standard library `re`, migrating is as
+simple as changing your import:
+
+```python
+import pcre as re
+```
+
+The module-level entry points (`match`, `search`, `fullmatch`, `findall`,
+`finditer`, `split`, `sub`, `subn`, `compile`, `escape`, `purge`) expose the
+same call signatures as their `re` counterparts, making existing code work
+unchanged. Every standard flag with a PCRE2 equivalent—`IGNORECASE`,
+`MULTILINE`, `DOTALL`, `VERBOSE`, `ASCII`, and friends—is supported via the
+re-exported constants and the `pcre.Flag` enum. 
+
+### Sample Usage
 
 ```python
 from pcre import match, search, findall, compile, Flag
@@ -78,15 +98,11 @@ pattern = compile(rb"\d+", flags=Flag.MULTILINE)
 numbers = pattern.findall(b"line 1\nline 22")
 ```
 
-`pcre` mirrors the core helpers from Python’s standard library `re` module—
-`match`, `search`, `fullmatch`, `finditer`, `findall`, and `compile`—while
+`pcre` mirrors the core helpers from Python’s standard library `re` module 
+`match`, `search`, `fullmatch`, `finditer`, `findall`, and `compile` while
 exposing PCRE2’s extended flag set through the Pythonic `Flag` enum
 (`Flag.CASELESS`, `Flag.MULTILINE`, `Flag.UTF`, ...).
 
-### Platform Support:
-
-Linux, MacOS, Windows, WSL, FreeBSD, Solaris
-
 ### Stdlib `re` compatibility
 
 - Module-level helpers and the `Pattern` class follow the same call shapes as

{pypcre-0.2.2 → pypcre-0.2.4}/PyPcre.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPcre
-Version: 0.2.2
+Version: 0.2.4
 Summary: Modern, GIL-friendly, Fast Python bindings for PCRE2 with auto caching and JIT of compiled patterns.
 Author-email: ModelCloud <qubitium@modelcloud.ai>
 License-Expression: Apache-2.0
@@ -32,7 +32,7 @@ Dynamic: license-file
 
 # PyPcre (Python Pcre2 Binding)
 
-Python bindings for the system PCRE2 library with a familiar `re`-style API.
+Modern `nogil` Python bindings for the Pcre2 library with `stdlib.re` api compatibility.
 
 <p align="center">
     <a href="https://github.com/ModelCloud/PyPcre/releases" style="text-decoration:none;"><img alt="GitHub release" src="https://img.shields.io/github/release/ModelCloud/Pcre.svg"></a>
@@ -43,7 +43,7 @@ Python bindings for the system PCRE2 library with a familiar `re`-style API.
 </p>
 
 ## Latest News
-* 10/11/2025 [0.2.1](https://github.com/ModelCloud/PyPcre/releases/tag/v0.2.1): 🤗 Full `GIL=0` compliance for Python >= 3.13T. Reduced cache thread contention. Improved performance for all api. Expanded ci testing coverage. FreeBSD, Solaris, and Windows compatibility validated.
+* 10/12/2025 [0.2.3](https://github.com/ModelCloud/PyPcre/releases/tag/v0.2.3): 🤗 Full `GIL=0` compliance for Python >= 3.13T. Reduced cache thread contention. Improved performance for all api. Expanded ci testing coverage. FreeBSD, Solaris, and Windows compatibility validated.
 * 10/09/2025 [0.1.0](https://github.com/ModelCloud/PyPcre/releases/tag/v0.1.0): 🎉 First release. Thread safe, auto JIT, auto pattern caching and optimistic linking to system library for fast install.
 
 ## Why PyPcre:
@@ -64,9 +64,29 @@ pip install PyPcre
 
 The package prioritizes linking against the `libpcre2-8` shared library in system for fast install and max security protection which gets latest patches from OS. See [Building](#building) for manual build details.
 
+## Platform Support (Validated):
+
+`Linux`, `MacOS`, `Windows`, `WSL`, `FreeBSD`, `Solaris`
+
+
 ## Usage
 
-### Drop-in helpers
+
+If you already rely on the standard library `re`, migrating is as
+simple as changing your import:
+
+```python
+import pcre as re
+```
+
+The module-level entry points (`match`, `search`, `fullmatch`, `findall`,
+`finditer`, `split`, `sub`, `subn`, `compile`, `escape`, `purge`) expose the
+same call signatures as their `re` counterparts, making existing code work
+unchanged. Every standard flag with a PCRE2 equivalent—`IGNORECASE`,
+`MULTILINE`, `DOTALL`, `VERBOSE`, `ASCII`, and friends—is supported via the
+re-exported constants and the `pcre.Flag` enum. 
+
+### Sample Usage
 
 ```python
 from pcre import match, search, findall, compile, Flag
@@ -78,15 +98,11 @@ pattern = compile(rb"\d+", flags=Flag.MULTILINE)
 numbers = pattern.findall(b"line 1\nline 22")
 ```
 
-`pcre` mirrors the core helpers from Python’s standard library `re` module—
-`match`, `search`, `fullmatch`, `finditer`, `findall`, and `compile`—while
+`pcre` mirrors the core helpers from Python’s standard library `re` module 
+`match`, `search`, `fullmatch`, `finditer`, `findall`, and `compile` while
 exposing PCRE2’s extended flag set through the Pythonic `Flag` enum
 (`Flag.CASELESS`, `Flag.MULTILINE`, `Flag.UTF`, ...).
 
-### Platform Support:
-
-Linux, MacOS, Windows, WSL, FreeBSD, Solaris
-
 ### Stdlib `re` compatibility
 
 - Module-level helpers and the `Pattern` class follow the same call shapes as

{pypcre-0.2.2 → pypcre-0.2.4}/PyPcre.egg-info/SOURCES.txt

@@ -19,10 +19,13 @@ pcre_ext/atomic_compat.h
 pcre_ext/cache.c
 pcre_ext/error.c
 pcre_ext/flag.c
+pcre_ext/jit_support.c
 pcre_ext/memory.c
+pcre_ext/pattern_cache.c
 pcre_ext/pcre2.c
 pcre_ext/pcre2.h
 pcre_ext/pcre2_module.h
+pcre_ext/string_helpers.c
 pcre_ext/util.c
 tests/test_accuracy.py
 tests/test_api_parity.py

{pypcre-0.2.2 → pypcre-0.2.4}/README.md

@@ -7,7 +7,7 @@
 
 # PyPcre (Python Pcre2 Binding)
 
-Python bindings for the system PCRE2 library with a familiar `re`-style API.
+Modern `nogil` Python bindings for the Pcre2 library with `stdlib.re` api compatibility.
 
 <p align="center">
     <a href="https://github.com/ModelCloud/PyPcre/releases" style="text-decoration:none;"><img alt="GitHub release" src="https://img.shields.io/github/release/ModelCloud/Pcre.svg"></a>
@@ -18,7 +18,7 @@ Python bindings for the system PCRE2 library with a familiar `re`-style API.
 </p>
 
 ## Latest News
-* 10/11/2025 [0.2.1](https://github.com/ModelCloud/PyPcre/releases/tag/v0.2.1): 🤗 Full `GIL=0` compliance for Python >= 3.13T. Reduced cache thread contention. Improved performance for all api. Expanded ci testing coverage. FreeBSD, Solaris, and Windows compatibility validated.
+* 10/12/2025 [0.2.3](https://github.com/ModelCloud/PyPcre/releases/tag/v0.2.3): 🤗 Full `GIL=0` compliance for Python >= 3.13T. Reduced cache thread contention. Improved performance for all api. Expanded ci testing coverage. FreeBSD, Solaris, and Windows compatibility validated.
 * 10/09/2025 [0.1.0](https://github.com/ModelCloud/PyPcre/releases/tag/v0.1.0): 🎉 First release. Thread safe, auto JIT, auto pattern caching and optimistic linking to system library for fast install.
 
 ## Why PyPcre:
@@ -39,9 +39,29 @@ pip install PyPcre
 
 The package prioritizes linking against the `libpcre2-8` shared library in system for fast install and max security protection which gets latest patches from OS. See [Building](#building) for manual build details.
 
+## Platform Support (Validated):
+
+`Linux`, `MacOS`, `Windows`, `WSL`, `FreeBSD`, `Solaris`
+
+
 ## Usage
 
-### Drop-in helpers
+
+If you already rely on the standard library `re`, migrating is as
+simple as changing your import:
+
+```python
+import pcre as re
+```
+
+The module-level entry points (`match`, `search`, `fullmatch`, `findall`,
+`finditer`, `split`, `sub`, `subn`, `compile`, `escape`, `purge`) expose the
+same call signatures as their `re` counterparts, making existing code work
+unchanged. Every standard flag with a PCRE2 equivalent—`IGNORECASE`,
+`MULTILINE`, `DOTALL`, `VERBOSE`, `ASCII`, and friends—is supported via the
+re-exported constants and the `pcre.Flag` enum. 
+
+### Sample Usage
 
 ```python
 from pcre import match, search, findall, compile, Flag
@@ -53,15 +73,11 @@ pattern = compile(rb"\d+", flags=Flag.MULTILINE)
 numbers = pattern.findall(b"line 1\nline 22")
 ```
 
-`pcre` mirrors the core helpers from Python’s standard library `re` module—
-`match`, `search`, `fullmatch`, `finditer`, `findall`, and `compile`—while
+`pcre` mirrors the core helpers from Python’s standard library `re` module 
+`match`, `search`, `fullmatch`, `finditer`, `findall`, and `compile` while
 exposing PCRE2’s extended flag set through the Pythonic `Flag` enum
 (`Flag.CASELESS`, `Flag.MULTILINE`, `Flag.UTF`, ...).
 
-### Platform Support:
-
-Linux, MacOS, Windows, WSL, FreeBSD, Solaris
-
 ### Stdlib `re` compatibility
 
 - Module-level helpers and the `Pattern` class follow the same call shapes as

{pypcre-0.2.2 → pypcre-0.2.4}/pcre/__init__.py

@@ -32,7 +32,6 @@ from .pcre import (
     finditer,
     fullmatch,
     match,
-    module_fullmatch,
     parallel_map,
     search,
     split,
@@ -80,6 +79,28 @@ def escape(pattern: Any) -> Any:
     return _std_re.escape(pattern)
 
 
+# Compat: expose stdlib-style flag constants so migrating `re` users can
+# continue referencing familiar names. Prefer `pcre.Flag` for new code.
+_FLAG_ZERO = Flag(0)
+_FLAG_COMPAT_ALIASES = {
+    "IGNORECASE": Flag.CASELESS,
+    "I": Flag.CASELESS,
+    "MULTILINE": Flag.MULTILINE,
+    "M": Flag.MULTILINE,
+    "DOTALL": Flag.DOTALL,
+    "S": Flag.DOTALL,
+    "VERBOSE": Flag.EXTENDED,
+    "X": Flag.EXTENDED,
+    "ASCII": Flag.NO_UTF | Flag.NO_UCP,
+    "A": Flag.NO_UTF | Flag.NO_UCP,
+    "UNICODE": _FLAG_ZERO,
+    "U": _FLAG_ZERO,
+}
+
+for _alias, _flag in _FLAG_COMPAT_ALIASES.items():
+    globals()[_alias] = _flag
+
+
 __all__ = [
     "Pattern",
     "Match",
@@ -97,7 +118,6 @@ __all__ = [
     "match",
     "search",
     "fullmatch",
-    "module_fullmatch",
     "finditer",
     "findall",
     "parallel_map",
@@ -113,6 +133,8 @@ __all__ = [
     "ERRORS_BY_MACRO",
 ]
 
+__all__ += list(_FLAG_COMPAT_ALIASES.keys())
+
 __all__ += list(_error_module.__all__)
 __all__ += _EXPORTED_ERROR_CLASSES
 

{pypcre-0.2.2 → pypcre-0.2.4}/pcre/pcre.py

@@ -556,12 +556,6 @@ def fullmatch(pattern: Any, string: Any, flags: FlagInput = 0) -> Match | None:
     return compile(pattern, flags=flags).fullmatch(string)
 
 
-def module_fullmatch(pattern: Any, string: Any, flags: FlagInput = 0) -> Match | None:
-    """Compat helper for code expecting a distinct module-level fullmatch."""
-
-    return fullmatch(pattern, string, flags=flags)
-
-
 def finditer(pattern: Any, string: Any, flags: FlagInput = 0) -> Iterable[Match]:
     return compile(pattern, flags=flags).finditer(string)
 

{pypcre-0.2.2 → pypcre-0.2.4}/pcre_ext/cache.c

@@ -70,24 +70,6 @@ required_ovector_pairs(PatternObject *self)
     return required;
 }
 
-static int
-env_flag_is_true(const char *value)
-{
-    if (value == NULL || value[0] == '\0') {
-        return 0;
-    }
-    switch (value[0]) {
-        case '0':
-        case 'f':
-        case 'F':
-        case 'n':
-        case 'N':
-            return 0;
-        default:
-            return 1;
-    }
-}
-
 static inline ThreadCacheState *
 thread_cache_state_get(void)
 {

pypcre-0.2.4/pcre_ext/jit_support.c

@@ -0,0 +1,151 @@
+// SPDX-FileCopyrightText: 2025 ModelCloud.ai
+// SPDX-FileCopyrightText: 2025 qubitium@modelcloud.ai
+// SPDX-License-Identifier: Apache-2.0
+// Contact: qubitium@modelcloud.ai, x.com/qubitium
+
+#include "pcre2_module.h"
+
+static PyThread_type_lock jit_serial_lock = NULL;
+
+#if defined(PCRE_EXT_HAVE_ATOMICS)
+static ATOMIC_VAR(int) default_jit_enabled = ATOMIC_VAR_INIT(1);
+#else
+static int default_jit_enabled = 1;
+static PyThread_type_lock default_jit_lock = NULL;
+#endif
+
+int
+jit_support_initialize(int force_serial_lock)
+{
+#if !defined(PCRE_EXT_HAVE_ATOMICS)
+    if (default_jit_lock == NULL) {
+        default_jit_lock = PyThread_allocate_lock();
+        if (default_jit_lock == NULL) {
+            PyErr_NoMemory();
+            return -1;
+        }
+    }
+#endif
+    if (force_serial_lock) {
+        if (jit_serial_lock == NULL) {
+            jit_serial_lock = PyThread_allocate_lock();
+            if (jit_serial_lock == NULL) {
+                PyErr_NoMemory();
+                return -1;
+            }
+        }
+    }
+    return 0;
+}
+
+void
+jit_support_teardown(void)
+{
+#if !defined(PCRE_EXT_HAVE_ATOMICS)
+    if (default_jit_lock != NULL) {
+        PyThread_free_lock(default_jit_lock);
+        default_jit_lock = NULL;
+    }
+#endif
+    if (jit_serial_lock != NULL) {
+        PyThread_free_lock(jit_serial_lock);
+        jit_serial_lock = NULL;
+    }
+}
+
+void
+jit_guard_acquire(void)
+{
+    if (jit_serial_lock != NULL) {
+        PyThread_acquire_lock(jit_serial_lock, 1);
+    }
+}
+
+void
+jit_guard_release(void)
+{
+    if (jit_serial_lock != NULL) {
+        PyThread_release_lock(jit_serial_lock);
+    }
+}
+
+int
+default_jit_get(void)
+{
+#if defined(PCRE_EXT_HAVE_ATOMICS)
+    if (jit_serial_lock != NULL) {
+        jit_guard_acquire();
+        int value = atomic_load_explicit(&default_jit_enabled, memory_order_acquire);
+        jit_guard_release();
+        return value;
+    }
+    return atomic_load_explicit(&default_jit_enabled, memory_order_acquire);
+#else
+    PyThread_acquire_lock(default_jit_lock, 1);
+    int value = default_jit_enabled;
+    PyThread_release_lock(default_jit_lock);
+    return value;
+#endif
+}
+
+void
+default_jit_set(int value)
+{
+#if defined(PCRE_EXT_HAVE_ATOMICS)
+    if (jit_serial_lock != NULL) {
+        jit_guard_acquire();
+        atomic_store_explicit(&default_jit_enabled, value, memory_order_release);
+        jit_guard_release();
+        return;
+    }
+    atomic_store_explicit(&default_jit_enabled, value, memory_order_release);
+#else
+    PyThread_acquire_lock(default_jit_lock, 1);
+    default_jit_enabled = value;
+    PyThread_release_lock(default_jit_lock);
+#endif
+}
+
+int
+pattern_jit_get(PatternObject *pattern)
+{
+#if defined(PCRE_EXT_HAVE_ATOMICS)
+    if (jit_serial_lock != NULL) {
+        jit_guard_acquire();
+        int value = atomic_load_explicit(&pattern->jit_enabled, memory_order_acquire);
+        jit_guard_release();
+        return value;
+    }
+    return atomic_load_explicit(&pattern->jit_enabled, memory_order_acquire);
+#else
+    if (pattern->jit_lock != NULL) {
+        PyThread_acquire_lock(pattern->jit_lock, 1);
+        int value = pattern->jit_enabled;
+        PyThread_release_lock(pattern->jit_lock);
+        return value;
+    }
+    return pattern->jit_enabled;
+#endif
+}
+
+void
+pattern_jit_set(PatternObject *pattern, int value)
+{
+#if defined(PCRE_EXT_HAVE_ATOMICS)
+    if (jit_serial_lock != NULL) {
+        jit_guard_acquire();
+        atomic_store_explicit(&pattern->jit_enabled, value, memory_order_release);
+        jit_guard_release();
+        return;
+    }
+    atomic_store_explicit(&pattern->jit_enabled, value, memory_order_release);
+#else
+    if (pattern->jit_lock != NULL) {
+        PyThread_acquire_lock(pattern->jit_lock, 1);
+        pattern->jit_enabled = value;
+        PyThread_release_lock(pattern->jit_lock);
+        return;
+    }
+    pattern->jit_enabled = value;
+#endif
+}