Improvement

Author: slinkydeveloper

python/restate/exceptions.py

@@ -27,33 +27,22 @@ def __init__(self, message: str) -> None:
         super().__init__(
             message +
 """
-This exception should be ignored in your code. If you see this exception:
+This exception is safe to ignore. If you see it, you might be using a try/catch all statement.
 
-* You might be using a try/catch all statement and logging afterwards. Don't do:
+Don't do:
 try:
   # Code
 except:
   # This catches all exceptions, including the SdkInternalBaseException!
-  traceback.print_exc() <- Prints this exception
 
 Do instead:
 try:
   # Code
 except TerminalError:
   # In Restate handlers you typically want to catch TerminalError only
 
-* To catch ctx.run/ctx.run_typed errors, check https://docs.restate.dev/develop/python/durable-steps#run for more details.
-
-* Only if you need to release/cleanup some resource, like a file, 
-  use try/finally https://docs.python.org/3/tutorial/errors.html#defining-clean-up-actions, 
-  or use restate.is_internal_exception to distinguish between an internal exception or not:
-  
-try:
-  # Code
-except TerminalError:
-  # Handle terminal error
-finally:
-  # Perform cleanup 
+Or remove the try/except altogether if you don't need it.
+For further info on error handling, refer to https://docs.restate.dev/develop/python/error-handling
 """)
 
 class SuspendedException(SdkInternalBaseException):

src/lib.rs

@@ -784,7 +784,8 @@ impl ErrorFormatter for PythonErrorFormatter {
     fn display_closed_error(&self, f: &mut fmt::Formatter<'_>, event: &str) -> fmt::Result {
         write!(f, "Execution is suspended, but the handler is still attempting to make progress (calling '{event}'). This can happen:
 
-* If you use catch all statements. Don't do:
+* If you use try/catch all statements.
+Don't do:
 try:
   # Code
 except:
@@ -797,7 +798,8 @@ try:
 except TerminalError:
   # In Restate handlers you typically want to catch TerminalError only
 
-* To catch ctx.run/ctx.run_typed errors, check https://docs.restate.dev/develop/python/durable-steps#run for more details.
+Or remove the try/except altogether if you don't need it.
+For further info on error handling, refer to https://docs.restate.dev/develop/python/error-handling
 
 * If you use the context after the handler completed, e.g. moving the context to another thread.
   Check https://docs.restate.dev/develop/python/concurrent-tasks for more details on how to create durable concurrent tasks in Python.")