PyPcre 0.2.2__tar.gz → 0.2.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPcre
-Version: 0.2.2
+Version: 0.2.3
 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.3}/PyPcre.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyPcre
-Version: 0.2.2
+Version: 0.2.3
 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.3}/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.3}/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.3}/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.3}/pyproject.toml

@@ -9,7 +9,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "PyPcre"
-version = "0.2.2"
+version = "0.2.3"
 description = "Modern, GIL-friendly, Fast Python bindings for PCRE2 with auto caching and JIT of compiled patterns."
 readme = "README.md"
 requires-python = ">=3.9"

{pypcre-0.2.2 → pypcre-0.2.3}/tests/test_api_parity.py

@@ -3,6 +3,7 @@
 # SPDX-License-Identifier: Apache-2.0
 # Contact: qubitium@modelcloud.ai, x.com/qubitium
 
+import inspect
 import re
 from enum import IntFlag
 
@@ -36,6 +37,22 @@ def test_error_aliases_and_escape():
     assert pcre.escape(b"a+b") == re.escape(b"a+b")
 
 
+def test_stdlib_style_flag_aliases():
+    assert pcre.IGNORECASE == pcre.Flag.CASELESS
+    assert pcre.I == pcre.Flag.CASELESS
+    assert pcre.MULTILINE == pcre.Flag.MULTILINE
+    assert pcre.M == pcre.Flag.MULTILINE
+    assert pcre.DOTALL == pcre.Flag.DOTALL
+    assert pcre.S == pcre.Flag.DOTALL
+    assert pcre.VERBOSE == pcre.Flag.EXTENDED
+    assert pcre.X == pcre.Flag.EXTENDED
+    ascii_alias = pcre.Flag.NO_UTF | pcre.Flag.NO_UCP
+    assert pcre.ASCII == ascii_alias
+    assert pcre.A == ascii_alias
+    assert pcre.UNICODE == 0
+    assert pcre.U == 0
+
+
 def test_specific_compile_error_exposes_dedicated_exception():
     with pytest.raises(pcre.PcreErrorMissingClosingParenthesis) as info:
         pcre.compile("(")
@@ -236,3 +253,27 @@ def test_match_attributes_bytes():
     assert match.lastgroup is None
     assert match.regs == ((2, 4), (2, 3), (3, 4))
     assert match.expand(br"[\1\2]") == b"[ab]"
+
+
+def _signature_fingerprint(func):
+    signature = inspect.signature(func)
+    return tuple((param.name, param.kind, param.default) for param in signature.parameters.values())
+
+
+def test_stdlib_function_signatures_align_with_pcre():
+    stdlib_functions = {
+        name: getattr(re, name)
+        for name in dir(re)
+        if not name.startswith("_") and inspect.isroutine(getattr(re, name))
+    }
+
+    for name, std_callable in stdlib_functions.items():
+        pcre_callable = getattr(pcre, name, None)
+        assert pcre_callable is not None, f"pcre is missing stdlib helper {name!r}"
+        assert inspect.isroutine(pcre_callable), f"pcre.{name} should be a function"
+
+        std_sig = _signature_fingerprint(std_callable)
+        pcre_sig = _signature_fingerprint(pcre_callable)
+        assert (
+            pcre_sig == std_sig
+        ), f"Signature mismatch for {name!r}: pcre{pcre_sig!r} != re{std_sig!r}"

{pypcre-0.2.2 → pypcre-0.2.3}/tests/test_clobber.py

@@ -259,7 +259,6 @@ def _exercise_pattern(
         "subn",
         "module_match",
         "module_search",
-        "module_fullmatch",
         "module_findall",
         "module_split",
         "module_sub",
@@ -288,8 +287,6 @@ def _exercise_pattern(
             pcre.match(pattern, subject, flags=flags)
         elif op == "module_search":
             pcre.search(pattern, subject, flags=flags)
-        elif op == "module_fullmatch":
-            pcre.fullmatch(pattern, subject, flags=flags)
         elif op == "module_findall":
             pcre.findall(pattern, subject, flags=flags)
         elif op == "module_split":

{pypcre-0.2.2 → pypcre-0.2.3}/tests/test_module.py

@@ -27,10 +27,6 @@ def test_module_compile_and_match_shortcuts():
     assert whole is not None
     assert whole.span() == (0, 5)
 
-    module_whole = pcre.module_fullmatch(r"\d+", "12345")
-    assert module_whole is not None
-    assert module_whole.span() == (0, 5)
-
 
 def test_module_finditer_and_findall_helpers():
     matches = [m.group(0) for m in pcre.finditer(r"[A-Z]+", "abc DEF ghi JKL")]