refactor: Use functools.cached_property instead

This package was originally developed for Python 3.6, before
`functools.cached_property` was introduced.  That should be a drop-in
replacement for the home-grown `lazy_property`, though, so now that we
just support Python 3.8+, we should use it instead.

Author: jmgate

staged_script/__init__.py

@@ -16,14 +16,12 @@
     HelpFormatter,
     RetryStage,
     StageDuration,
-    lazy_property,
 )
 
 __all__ = [
     "StagedScript",
     "HelpFormatter",
     "RetryStage",
     "StageDuration",
-    "lazy_property",
 ]
 __version__ = "1.0.0"

staged_script/staged_script.py

@@ -41,33 +41,6 @@
 rich.traceback.install()
 
 
-def lazy_property(func: Callable) -> property:
-    """
-    A decorator to make it such that a property is lazily evaluated.
-
-    When the property is first accessed, the object will not yet have a
-    corresponding attribute, so the value will be computed by executing
-    :arg:`func`.  Any time the property is accessed thereafter, the
-    value will just be retrieved from the object's corresponding
-    attribute.
-
-    Args:
-        func:  The function used to compute the value of the property.
-
-    Returns:
-        The lazy property decorator.
-    """
-    attr_name = f"_lazy_{func.__name__}"
-
-    @property  # type: ignore[misc]
-    def _lazy_property(self):
-        if not hasattr(self, attr_name):
-            setattr(self, attr_name, func(self))
-        return getattr(self, attr_name)
-
-    return _lazy_property  # type: ignore[return-value]
-
-
 class StageDuration(NamedTuple):
     """
     The duration of a stage.
@@ -250,7 +223,7 @@ def _validate_stage_name(stage_name: str) -> None:
     # Parse the command line arguments.
     #
 
-    @lazy_property
+    @functools.cached_property
     def parser(self) -> ArgumentParser:
         """
         The base argument parser.
@@ -261,7 +234,7 @@ def parser(self) -> ArgumentParser:
 
         .. code-block:: python
 
-            @lazy_property
+            @functools.cached_property
             def parser(self) -> ArgumentParser:
                 ap = super().parser
                 ap.description = '''INSERT DESCRIPTION HERE'''