Improve runtime log

Author: kks32

dapi/__init__.py

@@ -3,8 +3,7 @@
 """
 from .client import DSClient
 
-# Import exceptions from the exceptions module
-# Make sure ALL exceptions you want to expose are listed here
+# Import exceptions
 from .exceptions import (
     DapiException,
     AuthenticationError,
@@ -14,14 +13,32 @@
     JobMonitorError,
 )
 
+# Import key classes/functions from jobs module
+from .jobs import (
+    SubmittedJob,
+    interpret_job_status,
+    # Import status constants for user access if needed
+    STATUS_TIMEOUT,
+    STATUS_INTERRUPTED,
+    STATUS_MONITOR_ERROR,
+    STATUS_UNKNOWN,
+    TAPIS_TERMINAL_STATES,
+)
+
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"
 
-# Define what gets imported with 'from dapi import *'
-# Also helps linters and clarifies the public API
 __all__ = [
     "DSClient",
-    # List ALL exported exceptions here
+    "SubmittedJob",
+    "interpret_job_status",
+    # Export status constants
+    "STATUS_TIMEOUT",
+    "STATUS_INTERRUPTED",
+    "STATUS_MONITOR_ERROR",
+    "STATUS_UNKNOWN",
+    "TAPIS_TERMINAL_STATES",
+    # Export exceptions
     "DapiException",
     "AuthenticationError",
     "FileOperationError",

dapi/client.py

@@ -7,7 +7,7 @@
 from .db.accessor import DatabaseAccessor
 
 # Import only the necessary classes/functions from jobs
-from .jobs import SubmittedJob  # JobDefinition is no longer needed
+from .jobs import SubmittedJob, interpret_job_status
 from typing import List, Optional, Dict, Any
 
 
@@ -146,3 +146,7 @@ def get_status(self, job_uuid: str) -> str:
     def get_runtime_summary(self, job_uuid: str, verbose: bool = False):
         """Prints the runtime summary for a job by UUID."""
         jobs_module.get_runtime_summary(self._tapis, job_uuid, verbose=verbose)
+
+    def interpret_status(self, final_status: str, job_uuid: Optional[str] = None):
+        """Prints a user-friendly interpretation of the final job status."""
+        jobs_module.interpret_job_status(final_status, job_uuid)