Finetune automatic log printing of failed batch jobs

Author: soxofaan

CHANGELOG.md

@@ -14,6 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Setting the environment variable `OPENEO_BASEMAP_URL` allows to set a new templated URL to a XYZ basemap for the Vue Components library,  `OPENEO_BASEMAP_ATTRIBUTION` allows to set the attribution for the basemap ([#260](https://github.com/Open-EO/openeo-python-client/issues/260))
 - Initial support for experimental "federation:missing" flag on partial openEO Platform user job listings ([Open-EO/openeo-api#419](https://github.com/Open-EO/openeo-api/pull/419))
 - Best effort detection of mistakenly using Python builtin `sum` or `all` functions in callbacks ([Forum #113](https://discuss.eodc.eu/t/reducing-masks-in-openeo/113))
+- Automatically print batch job logs when job doesn't finish successfully (using `execute_batch/run_synchronous/start_and_wait`).
 
 
 ### Changed

openeo/rest/job.py

@@ -1,5 +1,6 @@
 import datetime
 import logging
+import textwrap
 import time
 import typing
 from pathlib import Path
@@ -204,10 +205,15 @@ def soft_error(message: str):
             poll_interval = min(1.25 * poll_interval, max_poll_interval)
 
         if status != "finished":
-            print("Your batch job failed. Logs can be found online in an openEO editor, or you can get them with 'connection.job('my_job_id_123').logs()'")
+            print(textwrap.dedent("""
+                Your batch job {i!r} failed.
+                Logs can be inspected in an openEO (web) editor or with `connection.job({i!r}).logs()`.
+            """.format(i=self.job_id)))
+            # TODO: make it possible to disable printing logs automatically?
+            # TODO: render logs jupyter-aware in a notebook context?
             print("Printing logs:")
             print(self.logs())
-            raise JobFailedException("Batch job {i} didn't finish properly. Status: {s} (after {t}).".format(
+            raise JobFailedException("Batch job {i!r} didn't finish successfully. Status: {s} (after {t}).".format(
                 i=self.job_id, s=status, t=elapsed()
             ), job=self)