mm-std 0.4.7__py3-none-any.whl → 0.4.9__py3-none-any.whl

mm_std/result.py

@@ -44,13 +44,30 @@ 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(self, default: T) -> T:
@@ -79,7 +96,7 @@ class Result[T]:
             return self.exception
         raise RuntimeError("No exception provided")
 
-    def ok_or_error(self) -> T | str:
+    def value_or_error(self) -> T | str:
         """
         Returns the success value if available, otherwise returns the error message.
         """

{mm_std-0.4.7.dist-info → mm_std-0.4.9.dist-info}/METADATA

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

{mm_std-0.4.7.dist-info → mm_std-0.4.9.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=ZeGL5juBLdrlYiNgI89K50W_pNn35IOVE71sdfV_1uo,8800
+mm_std/result.py,sha256=wzRdm8hzcvhKBD95NgQS7MklRMQQjVpgbsDAcolCMpg,9655
 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.7.dist-info/METADATA,sha256=RM6Tu17kVqjVnLqV08LyQMWh2GuvdKV-wLsBbwon0OE,446
-mm_std-0.4.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mm_std-0.4.7.dist-info/RECORD,,
+mm_std-0.4.9.dist-info/METADATA,sha256=W70MWq3UfeFan-QnCTqG_KArTapiIlNKqQN1bXZrozo,446
+mm_std-0.4.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mm_std-0.4.9.dist-info/RECORD,,