feat(core): notebook_session provider (#2880)

Co-authored-by: Ralf Grubenmann <[email protected]>

Author: olevski

docs/reference/commands.rst

@@ -196,6 +196,13 @@ Renku Command Line
 
 .. automodule:: renku.ui.cli.githooks
 
+``renku session``
+-----------------
+
+.. automodule:: renku.ui.cli.session
+
+.. _cli-session:
+
 Error Tracking
 --------------
 

docs/spelling_wordlist.txt

@@ -1,4 +1,5 @@
 acyclic
+adhoc
 admin
 Amalthea
 analytics
@@ -243,6 +244,7 @@ Unlink
 unlinking
 unmapped
 unmerged
+unpushed
 untracked
 untracked
 updatable

renku/core/errors.py

@@ -593,6 +593,18 @@ def __init__(self, reason: str):
         super().__init__(f"Docker failed: {reason}")
 
 
+class RenkulabSessionError(RenkuException):
+    """Raised when an error occurs trying to start sessions with the notebook service."""
+
+
+class NotebookSessionNotReadyError(RenkuException):
+    """Raised when a user attempts to open a session that is not ready."""
+
+
+class NotebookSessionImageNotExistError(RenkuException):
+    """Raised when a user attempts to start a session with an image that does not exist."""
+
+
 class MetadataMergeError(RenkuException):
     """Raise when merging of metadata failed."""
 

renku/core/plugin/implementations/__init__.py

@@ -20,6 +20,7 @@
 from typing import TYPE_CHECKING, List, Type
 
 from renku.core.session.docker import DockerSessionProvider
+from renku.core.session.renkulab import RenkulabSessionProvider
 from renku.core.workflow.converters.cwl import CWLExporter
 from renku.core.workflow.providers.cwltool import CWLToolProvider
 
@@ -30,7 +31,7 @@
 
 __all__: List[str] = []
 
-session_providers: "List[Type[ISessionProvider]]" = [DockerSessionProvider]
+session_providers: "List[Type[ISessionProvider]]" = [DockerSessionProvider, RenkulabSessionProvider]
 workflow_exporters: "List[Type[IWorkflowConverter]]" = [CWLExporter]
 workflow_providers: "List[Type[IWorkflowProvider]]" = [CWLToolProvider]