style: unify import messages (#3979)

Author: flying-sheep

src/scanpy/external/exporting.py

@@ -577,11 +577,8 @@ def cellbrowser(  # noqa: PLR0913
     """
     try:
         import cellbrowser.cellbrowser as cb
-    except ImportError:
-        logg.error(
-            "The package cellbrowser is not installed. "
-            "Install with 'pip install cellbrowser' and retry."
-        )
+    except ImportError as e:
+        e.add_note("Please install `cellbrowser` and try again.")
         raise
 
     data_dir = str(data_dir)

src/scanpy/external/pp/_bbknn.py

@@ -133,8 +133,8 @@ def bbknn(  # noqa: PLR0913
     try:
         from bbknn import bbknn
     except ImportError as e:
-        msg = "Please install bbknn: `pip install bbknn`."
-        raise ImportError(msg) from e
+        e.add_note("Please install `bbknn` and try again.")
+        raise
     return bbknn(
         adata=adata,
         batch_key=batch_key,

src/scanpy/external/pp/_dca.py

@@ -180,8 +180,8 @@ def dca(  # noqa: PLR0913
     try:
         from dca.api import dca
     except ImportError as e:
-        msg = "Please install dca package (>= 0.2.1) via `pip install dca`"
-        raise ImportError(msg) from e
+        e.add_note("Please install `dca` (≥ 0.2.1) and try again.")
+        raise e
 
     return dca(
         adata,

src/scanpy/external/pp/_harmony_integrate.py

@@ -90,8 +90,8 @@ def harmony_integrate(
     try:
         import harmonypy
     except ImportError as e:
-        msg = "\nplease install harmonypy:\n\n\tpip install harmonypy"
-        raise ImportError(msg) from e
+        e.add_note("Please install `harmonypy` and try again.")
+        raise
 
     x = adata.obsm[basis].astype(np.float64)
 

src/scanpy/external/pp/_magic.py

@@ -140,8 +140,8 @@ def magic(  # noqa: PLR0913
     try:
         from magic import MAGIC
     except ImportError as e:
-        msg = "Please install magic package via `pip install magic-impute`"
-        raise ImportError(msg) from e
+        e.add_note("Please install `magic-impute` and try again.")
+        raise
     else:
         if pkg_version("magic-impute") < Version(MIN_VERSION):
             msg = (

src/scanpy/external/pp/_mnn_correct.py

@@ -133,8 +133,8 @@ def mnn_correct(  # noqa: PLR0913
         import mnnpy
         from mnnpy import mnn_correct
     except ImportError as e:
-        msg = "Please install the package mnnpy (https://github.com/chriscainx/mnnpy). "
-        raise ImportError(msg) from e
+        e.add_note("Please install `mnnpy` and try again.")
+        raise
 
     n_jobs = settings.n_jobs if n_jobs is None else n_jobs
 

src/scanpy/external/pp/_scanorama_integrate.py

@@ -109,8 +109,8 @@ def scanorama_integrate(
     try:
         import scanorama
     except ImportError as e:
-        msg = "\nplease install Scanorama:\n\n\tpip install scanorama"
-        raise ImportError(msg) from e
+        e.add_note("Please install `scanorama` and try again.")
+        raise
 
     # Get batch indices in linear time.
     curr_batch = None

src/scanpy/external/tl/_harmony_timeseries.py

@@ -135,8 +135,8 @@ def harmony_timeseries(
     try:
         import harmony
     except ImportError as e:
-        msg = "\nplease install harmony:\n\n\tpip install harmonyTS"
-        raise ImportError(msg) from e
+        e.add_note("Please install `harmonyTS` and try again.")
+        raise
 
     adata = adata.copy() if copy else adata
     logg.info("Harmony augmented affinity matrix")

src/scanpy/external/tl/_palantir.py

@@ -333,9 +333,9 @@ def palantir_results(
     return pr_res
 
 
-def _check_import():
+def _check_import() -> None:
     try:
         import palantir  # noqa: F401
     except ImportError as e:
-        msg = "\nplease install palantir:\n\tpip install palantir"
-        raise ImportError(msg) from e
+        e.add_note("Please install `palantir` and try again.")
+        raise

src/scanpy/external/tl/_phate.py

@@ -152,11 +152,8 @@ def phate(  # noqa: PLR0913
     try:
         import phate
     except ImportError as e:
-        msg = (
-            "You need to install the package `phate`: please run `pip install "
-            "--user phate` in a terminal."
-        )
-        raise ImportError(msg) from e
+        e.add_note("Please install `phate` and try again.")
+        raise
     x_phate = phate.PHATE(
         n_components=n_components,
         k=k,