mm-std 0.4.8__py3-none-any.whl → 0.4.10__py3-none-any.whl

mm_std/result.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import sys
 from collections.abc import Awaitable, Callable
 from typing import Any, Protocol, TypeGuard, TypeVar, cast
 
@@ -44,15 +45,61 @@ class Result[T]:
         """
         return self.exception is not None
 
-    def unwrap(self) -> T:
+    def unwrap(self, message_prefix: str | None = None, include_error: bool = True) -> T:
         """
-        Returns the success value.
-        Raises RuntimeError if the result is an error.
+        Returns the success value if the Result is Ok, otherwise raises a RuntimeError.
+
+        Args:
+            message_prefix: Optional custom prefix for the error message if the Result is an error.
+                            If not provided, a default message will be used.
+            include_error: If True, appends the internal error message from the Result to the final exception message.
+
+        Raises:
+            RuntimeError: If the Result is an error.
+
+        Returns:
+            The success value of type T.
         """
         if not self.is_ok():
-            raise RuntimeError(f"Called unwrap() on a failure value: {self.error}")
+            # Use the provided message or a default fallback
+            error_message = message_prefix or "Called unwrap() on a failure value"
+            # Optionally append the error detail
+            if include_error:
+                error_message = f"{error_message}: {self.error}"
+            # Raise with the final constructed message
+            raise RuntimeError(error_message)
+        # Return the success value if present
         return cast(T, self.value)
 
+    def unwrap_or_exit(
+        self,
+        message_prefix: str | None = None,
+        include_error: bool = True,
+        exit_code: int = 1,
+    ) -> T:
+        """
+        Returns the success value if the Result is Ok, otherwise prints an error to stderr and exits.
+
+        Args:
+            message_prefix: Optional custom prefix for the error message.
+            include_error: If True, includes the internal error message in the printed message.
+            exit_code: The exit code to use when terminating the program on error.
+
+        Returns:
+            The success value of type T.
+
+        Exits:
+            Exits the program with the specified exit code if the result is an error.
+        """
+        if self.is_ok():
+            return cast(T, self.value)
+
+        error_message = message_prefix or "Called unwrap_or_exit() on a failure value"
+        if include_error:
+            error_message = f"{error_message}: {self.error}"
+        print(error_message, file=sys.stderr)  # noqa: T201
+        sys.exit(exit_code)
+
     def unwrap_or(self, default: T) -> T:
         """
         Returns the success value if available, otherwise returns the given default.

{mm_std-0.4.8.dist-info → mm_std-0.4.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mm-std
-Version: 0.4.8
+Version: 0.4.10
 Requires-Python: >=3.12
 Requires-Dist: aiohttp-socks~=0.10.1
 Requires-Dist: aiohttp~=3.11.16

{mm_std-0.4.8.dist-info → mm_std-0.4.10.dist-info}/RECORD

@@ -12,7 +12,7 @@ mm_std/net.py,sha256=qdRCBIDneip6FaPNe5mx31UtYVmzqam_AoUF7ydEyjA,590
 mm_std/print_.py,sha256=zB7sVbSSF8RffMxvnOdbKCXjCKtKzKV3R68pBri4NkQ,1638
 mm_std/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mm_std/random_.py,sha256=OuUX4VJeSd13NZBya4qrGpR2TfN7_87tfebOY6DBUnI,1113
-mm_std/result.py,sha256=FaeFo63iCBB8KurSPAx6rnB8-36u_TlLsncFYIeHZ24,8803
+mm_std/result.py,sha256=ltq9lJ-mZYRWuwGfhVtsfb4CX9Gw-tOUKyj5cEoyHiE,10706
 mm_std/str.py,sha256=BEjJ1p5O4-uSYK0h-enasSSDdwzkBbiwdQ4_dsrlEE8,3257
 mm_std/toml.py,sha256=CNznWKR0bpOxS6e3VB5LGS-Oa9lW-wterkcPUFtPcls,610
 mm_std/types_.py,sha256=9FGd2q47a8M9QQgsWJR1Kq34jLxBAkYSoJuwih4PPqg,257
@@ -28,6 +28,6 @@ mm_std/http/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mm_std/http/http_request.py,sha256=VnjZKrfaXQfMxrHRUqQ-Sxtr5Qf9FXBiJ-mmJTCzNkY,3709
 mm_std/http/http_request_sync.py,sha256=bqCBilbe4ZJ9vkhuBQeU5UMTJh6BtvtUwjieEodu6rw,1542
 mm_std/http/http_response.py,sha256=vrRv7Rjr5_kTUGllfW5oJ8ZqkcfiXc9T8PlBGAr-TBM,3884
-mm_std-0.4.8.dist-info/METADATA,sha256=DYv-E1MxynhsDPngxSjO7EVcj0rZ7ZUaBlhDrGxv1Uc,446
-mm_std-0.4.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mm_std-0.4.8.dist-info/RECORD,,
+mm_std-0.4.10.dist-info/METADATA,sha256=yFl2gf7vpu82NE6dY7uZdRmM0msSPOEOpK6SPCmF9CQ,447
+mm_std-0.4.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mm_std-0.4.10.dist-info/RECORD,,