backrefs 5.8__py313-none-any.whl

backrefs/util.py

@@ -0,0 +1,163 @@
+"""
+Utilities and compatibility abstraction.
+
+Licensed under MIT
+Copyright (c) 2015 - 2020 Isaac Muse <isaacmuse@gmail.com>
+"""
+from __future__ import annotations
+import warnings
+import sys
+from typing import Any, Callable, AnyStr
+
+PY311 = (3, 11) <= sys.version_info
+PY312 = (3, 12) <= sys.version_info
+
+FMT_FIELD = 0
+FMT_INDEX = 1
+FMT_ATTR = 2
+FMT_CONV = 3
+FMT_SPEC = 4
+
+
+class StringIter:
+    """Preprocess replace tokens."""
+
+    def __init__(self, text: str) -> None:
+        """Initialize."""
+
+        self._string = text
+        self._index = 0
+
+    def __iter__(self) -> StringIter:
+        """Iterate."""
+
+        return self
+
+    def __next__(self) -> str:
+        """Python 3 iterator compatible next."""
+
+        return self.iternext()
+
+    @property
+    def index(self) -> int:
+        """Get Index."""
+
+        return self._index
+
+    def rewind(self, count: int) -> None:
+        """Rewind index."""
+
+        if count > self._index:  # pragma: no cover
+            raise ValueError("Can't rewind past beginning!")
+
+        self._index -= count
+
+    def iternext(self) -> str:
+        """Iterate through characters of the string."""
+
+        try:
+            char = self._string[self._index]
+            self._index += 1
+        except IndexError as e:
+            raise StopIteration from e
+
+        return char
+
+
+def _to_bstr(obj: Any) -> bytes:
+    """Convert to byte string."""
+
+    if isinstance(obj, str):
+        return obj.encode('ascii', 'backslashreplace')
+    elif not isinstance(obj, bytes):
+        return str(obj).encode('ascii', 'backslashreplace')
+    return obj
+
+
+def _to_str(obj: Any) -> str:
+    """Convert to string."""
+
+    if not isinstance(obj, str):
+        return str(obj)
+    return obj
+
+
+def format_captures(
+    captures: list[AnyStr],
+    formatting: tuple[tuple[int, Any]],
+    converter: Callable[[Any], AnyStr],
+    default: AnyStr
+) -> AnyStr:
+    """Perform a string format on a set of captures."""
+
+    capture = captures  # type: Any
+    for i, fmt in enumerate(formatting, 0):
+        if i == 0:
+            continue
+        fmt_type, value = fmt
+        if fmt_type == FMT_ATTR:
+            # Attribute
+            capture = getattr(capture, value)
+        elif fmt_type == FMT_INDEX:
+            # Index
+            if value is not None:
+                capture = capture[value]
+            else:
+                capture = default if not capture else capture[0]
+        elif fmt_type == FMT_CONV:
+            # Conversion
+            if value == 'a':
+                capture = ascii(capture)
+            elif value == 'r':
+                capture = repr(capture)
+            elif value == 's':
+                # If the object is not string or byte string already
+                capture = str(capture)
+        elif fmt_type == FMT_SPEC:
+            # Integers and floats don't have an explicit 's' format type.
+            if value[3] and value[3] == 's':
+                if isinstance(capture, int):  # pragma: no cover
+                    raise ValueError("Unknown format code 's' for object of type 'int'")
+                if isinstance(capture, float):  # pragma: no cover
+                    raise ValueError("Unknown format code 's' for object of type 'float'")
+
+            # Ensure object is a byte string
+            capture = converter(capture)
+
+            spec_type = value[1]
+            if spec_type == '^':
+                capture = capture.center(value[2], value[0])
+            elif spec_type == ">":
+                capture = capture.rjust(value[2], value[0])
+            else:
+                capture = capture.ljust(value[2], value[0])
+
+    # Make sure the final object is a byte string
+    return converter(capture)
+
+
+class Immutable:
+    """Immutable."""
+
+    __slots__: tuple[Any, ...] = ()
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initialize."""
+
+        for k, v in kwargs.items():
+            super().__setattr__(k, v)
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        """Prevent mutability."""
+
+        raise AttributeError('Class is immutable!')
+
+
+def warn_deprecated(message: str, stacklevel: int = 2) -> None:  # pragma: no cover
+    """Warn deprecated."""
+
+    warnings.warn(
+        message,
+        category=DeprecationWarning,
+        stacklevel=stacklevel
+    )

backrefs-5.8.dist-info/METADATA

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: backrefs
+Version: 5.8
+Summary: A wrapper around re and regex that adds additional back references.
+Project-URL: Homepage, https://github.com/facelessuser/backrefs
+Author-email: Isaac Muse <Isaac.Muse@gmail.com>
+License-Expression: MIT
+License-File: LICENSE.md
+Keywords: re,regex
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Provides-Extra: extras
+Requires-Dist: regex; extra == 'extras'
+Description-Content-Type: text/markdown
+
+[![Donate via PayPal][donate-image]][donate-link]
+[![Discord][discord-image]][discord-link]
+[![Build][github-ci-image]][github-ci-link]
+[![Coverage Status][codecov-image]][codecov-link]
+[![PyPI Version][pypi-image]][pypi-link]
+[![PyPI Downloads][pypi-down]][pypi-link]
+[![PyPI - Python Version][python-image]][pypi-link]
+![License][license-image-mit]
+
+# Backrefs
+
+Backrefs is a wrapper around Python's built-in [Re][re] and the 3rd party [Regex][regex] library.  Backrefs adds various
+additional back references (and a couple other features) that are known to some regular expression engines, but not to
+Python's Re and/or Regex.  The supported back references actually vary depending on the regular expression engine being
+used as the engine may already have support for some.
+
+```python
+from backrefs import bre
+>>> pattern = bre.compile(r'(\p{Letter}+)')
+>>> pattern.sub(r'\C\1\E', 'sometext')
+'SOMETEXT'
+```
+
+# Documentation
+
+https://facelessuser.github.io/backrefs/
+
+# License
+
+MIT
+
+[github-ci-image]: https://github.com/facelessuser/backrefs/workflows/build/badge.svg?branch=master&event=push
+[github-ci-link]: https://github.com/facelessuser/backrefs/actions?query=workflow%3Abuild+branch%3Amaster
+[discord-image]: https://img.shields.io/discord/678289859768745989?logo=discord&logoColor=aaaaaa&color=mediumpurple&labelColor=333333
+[discord-link]:https://discord.gg/TWs8Tgr
+[codecov-image]: https://img.shields.io/codecov/c/github/facelessuser/backrefs/master.svg?logo=codecov&logoColor=aaaaaa&labelColor=333333
+[codecov-link]: https://codecov.io/github/facelessuser/backrefs
+[pypi-image]: https://img.shields.io/pypi/v/backrefs.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333
+[pypi-down]: https://img.shields.io/pypi/dm/backrefs.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333
+[pypi-link]: https://pypi.python.org/pypi/backrefs
+[python-image]: https://img.shields.io/pypi/pyversions/backrefs?logo=python&logoColor=aaaaaa&labelColor=333333
+[license-image-mit]: https://img.shields.io/badge/license-MIT-blue.svg?labelColor=333333
+[donate-image]: https://img.shields.io/badge/Donate-PayPal-3fabd1?logo=paypal
+[donate-link]: https://www.paypal.me/facelessuser
+
+[re]: https://docs.python.org/3/library/re.html
+[regex]: https://pypi.python.org/pypi/regex

backrefs-5.8.dist-info/RECORD

@@ -0,0 +1,40 @@
+backrefs/__init__.py,sha256=8Qt-anmlWzm-8FEjX1c9xYa47PG8-ccQgWQOAiKA4PM,90
+backrefs/__meta__.py,sha256=mSYqLTsLDPFAUgIjV35jMDcez1NdX9z2ac81kYO0YT4,6766
+backrefs/_bre_parse.py,sha256=w6wONmzAZRTf0sz1pIFGH3fxlpPa-rDutMjEBl8oSx0,52529
+backrefs/_bregex_parse.py,sha256=VGrP76iMRPXiaYo3vKGu9Jq5PFaYOaWUDMg6537N6n4,46436
+backrefs/_bregex_typing.py,sha256=THgf80whbUAJrpKWayEMJx8ixrU5oXwmVaQAa8n0DsQ,236
+backrefs/bre.py,sha256=1NY-n_gcftYTkgdhDgOBGGrWgedBHwygFys1UOutufo,19815
+backrefs/bregex.py,sha256=VHdyZkcoIWcfRlZ4jYfCLTdWhM872wJL7DSwKAe3WFw,20919
+backrefs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+backrefs/util.py,sha256=2qnLiUsB06IKKIdrjWIxYqwUG7OFqtOhafgx23ZwBn8,4285
+backrefs/uniprops/__init__.py,sha256=87ZqdAgKgULgX_SyxRlEXcUsMVOmLY2XqOYqcwYEG-0,20983
+backrefs/uniprops/unidata/__init__.py,sha256=P2_J3AFJMSQLerh7imUYLRlZJFFQjo5FynhEAU3GNlA,992
+backrefs/uniprops/unidata/age.py,sha256=COo7QxVKOqkKWXAEmEyDq1qpDT2OA5seIlHNjRuNGsU,72680
+backrefs/uniprops/unidata/alias.py,sha256=-qkP1PRDi1sT6L2PQ6CPpJuE69k-aIwzV4qBwzCm2jw,23996
+backrefs/uniprops/unidata/bidiclass.py,sha256=YB1sRZFPwSkgI7m5CcDS2dTGr0OlDSfiHeNTzsxfXko,45044
+backrefs/uniprops/unidata/bidipairedbrackettype.py,sha256=iqSaRbzHhZhrx5jHfuRtqkmkb6Gv92RWYi7lvCXP-CY,3226
+backrefs/uniprops/unidata/binary.py,sha256=0PQnH3FONroFTejZUCAvqJRCDV2OAkzPb22hfqr_wHA,416599
+backrefs/uniprops/unidata/block.py,sha256=xYdrPqQNlZFhojRNgM6bRWsULowAf3wxA5bwydCKSX0,58868
+backrefs/uniprops/unidata/canonicalcombiningclass.py,sha256=nnM92VD4NQqM-uhnCLXqdK-2xyFC0KZsJrXYH_N9GpA,37918
+backrefs/uniprops/unidata/decompositiontype.py,sha256=kCOMO35nCv0U4WhEIUUdb2xQ2xJ0RfcfvkFi1WiRk9A,27340
+backrefs/uniprops/unidata/eastasianwidth.py,sha256=RWV0Dpjs-Bw71qU7YWDbROKwb-qaOA28MgsSQQtJ2QY,15385
+backrefs/uniprops/unidata/generalcategory.py,sha256=3Ui8c2Zbf4AKvIM29XWHGDP2FqGpCkLSetqFkdgtRUI,137221
+backrefs/uniprops/unidata/graphemeclusterbreak.py,sha256=4WOJJKOwbAGV2skDB4FsrQ1JIlmKu-qqmQku8xQXTTQ,42409
+backrefs/uniprops/unidata/hangulsyllabletype.py,sha256=7DIE0I2XpGo6FRZD_dMtpQ3734Mgz2vH3dRCO8705Og,16173
+backrefs/uniprops/unidata/indicpositionalcategory.py,sha256=3NxmotJhdMtpENizEb-UWjmCTBRB6mfUjgG5ioBbIFQ,24481
+backrefs/uniprops/unidata/indicsyllabiccategory.py,sha256=9JD-ereOAnPz88j2hugK0orAqeHgdHSSsBz4xG0oQEk,35093
+backrefs/uniprops/unidata/joininggroup.py,sha256=5WnWwxmXUfdQUMJanXAFg6KfCYNVGLhgTQWdWf-92aY,17883
+backrefs/uniprops/unidata/joiningtype.py,sha256=ANJ0uDz4Z1B9OQBEkxFoiyA6Fbyiydez-SQE62lFvlk,24897
+backrefs/uniprops/unidata/linebreak.py,sha256=Hse42kUIocVUT4wvDIiIaSNFUzmI7mI2thQaplnJAEw,93916
+backrefs/uniprops/unidata/numerictype.py,sha256=HA7pTq474mXi5jHlYPSf6Gswfj-uXXsoHtsA0OGktaM,13975
+backrefs/uniprops/unidata/numericvalue.py,sha256=e80mjWWkgf7wdUadas6HFZtsJo0Z6r7McdIBG31mxuE,68897
+backrefs/uniprops/unidata/quickcheck.py,sha256=L8W2OEkTsEgI6xsPJNXESYUxOD2E75-DDq6ZCi9kZFg,47702
+backrefs/uniprops/unidata/script.py,sha256=9SrMpTFDLz2Mzguz5spUYCZuTO-x_fm0Id-RHZDcYGo,68216
+backrefs/uniprops/unidata/scriptextensions.py,sha256=54DWwqAFZ1ELAf6tAG00ry_vAnrI0Of40cB570_TCz8,73306
+backrefs/uniprops/unidata/sentencebreak.py,sha256=9yx3B1vDSiXZy9LW8894dMpxRHU7uamwc5ymXEWUo40,77366
+backrefs/uniprops/unidata/verticalorientation.py,sha256=BslCuQxyLjlrYuaIAWWycbOy2bU7S62NMp27XZAx2JM,6860
+backrefs/uniprops/unidata/wordbreak.py,sha256=11bI8IpBeBZNcKxV8IWo-8BI1WxR6EUWUPPVt_9yWp0,54677
+backrefs-5.8.dist-info/METADATA,sha256=3QKkNWY0pTfQgRv4OEncFpGmObF-yBp7d_lPLwVdirk,3329
+backrefs-5.8.dist-info/WHEEL,sha256=OS2QfsHxY8Lt2DGTbHY6dnHbm1Jjry_zcEe4ga9mbtc,89
+backrefs-5.8.dist-info/licenses/LICENSE.md,sha256=p7PCxDq-7r411h71_GHWySyijC5wKgao9GiyXpQA9dg,1084
+backrefs-5.8.dist-info/RECORD,,

backrefs-5.8.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py313-none-any

backrefs-5.8.dist-info/licenses/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 - 2023 Isaac Muse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.