dbrownell-parserlib 0.1.0__tar.gz → 0.2.0__tar.gz

{dbrownell_parserlib-0.1.0 → dbrownell_parserlib-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dbrownell-parserlib
-Version: 0.1.0
+Version: 0.2.0
 Summary: Functionality useful when creating parsers.
 Author: Dave Brownell
 Author-email: Dave Brownell <github@DavidBrownell.com>

{dbrownell_parserlib-0.1.0 → dbrownell_parserlib-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dbrownell-parserlib"
-version = "0.1.0"
+version = "0.2.0"
 #          ^^^^^
 # Wheel names will be generated according to this value. Do not manually modify this value; instead
 # update it according to committed changes by running this command from the root of the repository:
@@ -47,6 +47,7 @@ dev = [
 
 [tool.pytest.ini_options]
 addopts = "--verbose -vv --capture=no --cov=dbrownell_ParserLib --cov-report html --cov-report term --cov-report xml:coverage.xml --cov-fail-under=95.0"
+python_files = ["tests/*Tests.py"]
 
 [tool.ruff]
 line-length = 110

dbrownell_parserlib-0.2.0/src/dbrownell_ParserLib/__init__.py

@@ -0,0 +1,15 @@
+# noqa: D104
+
+from importlib.metadata import version
+
+from dbrownell_ParserLib.location import Location
+
+
+# ----------------------------------------------------------------------
+__all__ = [
+    "Location",
+    "__version__",
+]
+
+
+__version__ = version("dbrownell_ParserLib")

dbrownell_parserlib-0.2.0/src/dbrownell_ParserLib/location.py

@@ -0,0 +1,74 @@
+# noqa: D100
+from dataclasses import dataclass
+from functools import cached_property
+
+
+# ----------------------------------------------------------------------
+@dataclass(frozen=True)
+class Location:
+    """Location within a source file."""
+
+    # ----------------------------------------------------------------------
+    line: int
+    column: int
+
+    # ----------------------------------------------------------------------
+    def __post_init__(self) -> None:
+        if self.line < 1:
+            msg = "Invalid line"
+            raise ValueError(msg)
+
+        if self.column < 1:
+            msg = "Invalid column"
+            raise ValueError(msg)
+
+    # ----------------------------------------------------------------------
+    def __str__(self) -> str:
+        return self._string
+
+    # ----------------------------------------------------------------------
+    @staticmethod
+    def Compare(
+        this: Location,
+        that: Location,
+    ) -> int:
+        """Compare two `Location` objects."""
+
+        result = this.line - that.line
+        if result != 0:
+            return result
+
+        result = this.column - that.column
+        if result != 0:
+            return result
+
+        return 0
+
+    # ----------------------------------------------------------------------
+    def __hash__(self) -> int:
+        return hash((self.line, self.column))
+
+    def __eq__(self, other: object) -> bool:
+        return isinstance(other, Location) and self.__class__.Compare(self, other) == 0
+
+    def __ne__(self, other: object) -> bool:
+        return not isinstance(other, Location) or self.__class__.Compare(self, other) != 0
+
+    def __lt__(self, other: object) -> bool:
+        return isinstance(other, Location) and self.__class__.Compare(self, other) < 0
+
+    def __le__(self, other: object) -> bool:
+        return isinstance(other, Location) and self.__class__.Compare(self, other) <= 0
+
+    def __gt__(self, other: object) -> bool:
+        return isinstance(other, Location) and self.__class__.Compare(self, other) > 0
+
+    def __ge__(self, other: object) -> bool:
+        return isinstance(other, Location) and self.__class__.Compare(self, other) >= 0
+
+    # ----------------------------------------------------------------------
+    # ----------------------------------------------------------------------
+    # ----------------------------------------------------------------------
+    @cached_property
+    def _string(self) -> str:
+        return f"Ln {self.line} Col {self.column}"

dbrownell_parserlib-0.1.0/src/dbrownell_ParserLib/UvScaffolding_sample_file.py

@@ -1,11 +0,0 @@
-"""A sample file generated by copier - this file is safe to delete."""
-
-
-def Add(a: int, b: int) -> int:
-    """Add two numbers."""
-    return a + b
-
-
-def Subtract(a: int, b: int) -> int:
-    """Subtract two numbers."""
-    return a - b

dbrownell_parserlib-0.1.0/src/dbrownell_ParserLib/__init__.py

@@ -1,6 +0,0 @@
-# noqa: D104
-
-from importlib.metadata import version
-
-
-__version__ = version("dbrownell_ParserLib")