Merge pull request #43 from UiPath/fix/has_extras_check

fix: add server extras check

Author: cristipufu

pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "uipath-dev"
-version = "0.0.24"
+version = "0.0.25"
 description = "UiPath Developer Console"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"
 dependencies = [
   "uipath-runtime>=0.7.0, <0.8.0",
-  "textual>=7.2.0, <8.0.0",
+  "textual>=7.5.0, <8.0.0",
   "pyperclip>=1.11.0, <2.0.0",
 ]
 classifiers = [
@@ -23,8 +23,8 @@ maintainers = [
 
 [project.optional-dependencies]
 server = [
-  "fastapi>=0.115.0",
-  "uvicorn[standard]>=0.34.0",
+  "fastapi>=0.128.8",
+  "uvicorn[standard]>=0.40.0",
 ]
 
 [project.urls]

src/uipath/dev/server/__init__.py

@@ -18,6 +18,18 @@
 
 logger = logging.getLogger(__name__)
 
+try:
+    import fastapi  # noqa: F401
+    import uvicorn  # noqa: F401
+
+    HAS_EXTRAS = True
+except ModuleNotFoundError:
+    HAS_EXTRAS = False
+
+_MISSING_EXTRAS_MSG = (
+    "Server extras are not installed. Install them with: pip install uipath-dev[server]"
+)
+
 
 class UiPathDeveloperServer:
     """Web server mode for the UiPath Developer Console.
@@ -66,6 +78,9 @@ def __init__(
 
     def create_app(self) -> Any:
         """Create and return a FastAPI application."""
+        if not HAS_EXTRAS:
+            raise ImportError(_MISSING_EXTRAS_MSG)
+
         from uipath.dev.server.app import create_app
 
         return create_app(self)
@@ -76,7 +91,8 @@ async def run_async(self) -> None:
         This is the main entry point — mirrors UiPathDeveloperConsole.run_async().
         Blocks until the server is shut down (Ctrl-C / SIGINT).
         """
-        import uvicorn
+        if not HAS_EXTRAS:
+            raise ImportError(_MISSING_EXTRAS_MSG)
 
         app = self.create_app()
 

tests/test_server.py

@@ -3,6 +3,8 @@
 from datetime import datetime
 from unittest.mock import MagicMock
 
+import pytest
+
 
 def test_data_models_import_without_textual():
     """Data models should import without Textual dependency."""
@@ -148,3 +150,43 @@ def test_frontend_build_module():
 
     assert callable(needs_build)
     assert callable(ensure_frontend_built)
+
+
+def test_create_app_raises_when_extras_missing():
+    """create_app() should raise ImportError when server extras are missing."""
+    import uipath.dev.server as server_mod
+
+    mock_server = MagicMock()
+    mock_server.run_service = MagicMock()
+    mock_server.connection_manager = MagicMock()
+    mock_server.runtime_factory = MagicMock()
+    mock_server.trace_manager = MagicMock()
+
+    original = server_mod.HAS_EXTRAS
+    try:
+        server_mod.HAS_EXTRAS = False
+        with pytest.raises(ImportError, match="pip install uipath-dev\\[server\\]"):
+            mock_server.create_app = server_mod.UiPathDeveloperServer.create_app
+            mock_server.create_app(mock_server)
+    finally:
+        server_mod.HAS_EXTRAS = original
+
+
+@pytest.mark.asyncio
+async def test_run_async_raises_when_extras_missing():
+    """run_async() should raise ImportError when server extras are missing."""
+    import uipath.dev.server as server_mod
+
+    mock_server = MagicMock()
+    mock_server.run_service = MagicMock()
+    mock_server.connection_manager = MagicMock()
+    mock_server.runtime_factory = MagicMock()
+    mock_server.trace_manager = MagicMock()
+
+    original = server_mod.HAS_EXTRAS
+    try:
+        server_mod.HAS_EXTRAS = False
+        with pytest.raises(ImportError, match="pip install uipath-dev\\[server\\]"):
+            await server_mod.UiPathDeveloperServer.run_async(mock_server)
+    finally:
+        server_mod.HAS_EXTRAS = original