Fix all references to idom.server

Author: Archmonger

src/idom/backend/fastapi.py

@@ -6,25 +6,25 @@
 
 
 serve_development_app = starlette.serve_development_app
-"""Alias for :func:`idom.server.starlette.serve_development_app`"""
+"""Alias for :func:`idom.backend.starlette.serve_development_app`"""
 
 # see: https://github.com/idom-team/flake8-idom-hooks/issues/12
 use_location = starlette.use_location  # noqa: ROH101
-"""Alias for :func:`idom.server.starlette.use_location`"""
+"""Alias for :func:`idom.backend.starlette.use_location`"""
 
 # see: https://github.com/idom-team/flake8-idom-hooks/issues/12
 use_scope = starlette.use_scope  # noqa: ROH101
-"""Alias for :func:`idom.server.starlette.use_scope`"""
+"""Alias for :func:`idom.backend.starlette.use_scope`"""
 
 # see: https://github.com/idom-team/flake8-idom-hooks/issues/12
 use_websocket = starlette.use_websocket  # noqa: ROH101
-"""Alias for :func:`idom.server.starlette.use_websocket`"""
+"""Alias for :func:`idom.backend.starlette.use_websocket`"""
 
 Options = starlette.Options
-"""Alias for :class:`idom.server.starlette.Options`"""
+"""Alias for :class:`idom.backend.starlette.Options`"""
 
 configure = starlette.configure
-"""Alias for :class:`idom.server.starlette.configure`"""
+"""Alias for :class:`idom.backend.starlette.configure`"""
 
 
 def create_development_app() -> FastAPI:

src/idom/backend/flask.py

@@ -47,8 +47,6 @@ def configure(
 ) -> None:
     """Return a :class:`FlaskServer` where each client has its own state.
 
-    Implements the :class:`~idom.server.proto.ServerFactory` protocol
-
     Parameters:
         constructor: A component constructor
         options: Options for configuring server behavior

src/idom/backend/starlette.py

@@ -42,8 +42,6 @@ def configure(
 ) -> None:
     """Return a :class:`StarletteServer` where each client has its own state.
 
-    Implements the :class:`~idom.server.proto.ServerFactory` protocol
-
     Parameters:
         app: An application instance
         constructor: A component constructor

src/idom/backend/tornado.py

@@ -38,8 +38,6 @@ def configure(
 ) -> None:
     """Return a :class:`TornadoServer` where each client has its own state.
 
-    Implements the :class:`~idom.server.proto.ServerFactory` protocol
-
     Parameters:
         app: A tornado ``Application`` instance.
         component: A root component constructor

src/idom/testing/__init__.py

@@ -6,7 +6,7 @@
     assert_idom_did_not_log,
     capture_idom_logs,
 )
-from .server import ServerFixture
+from .backend import BackendFixture
 
 
 __all__ = [
@@ -18,6 +18,6 @@
     "HookCatcher",
     "LogAssertionError",
     "poll",
-    "ServerFixture",
+    "BackendFixture",
     "StaticEventHandler",
 ]

src/idom/testing/server.py renamed to src/idom/testing/backend.py

@@ -15,7 +15,7 @@
 from .logs import LogAssertionError, capture_idom_logs, list_logged_exceptions
 
 
-class ServerFixture:
+class BackendFixture:
     """A test fixture for running a server and imperatively displaying views
 
     This fixture is typically used alongside async web drivers like ``playwight``.
@@ -99,7 +99,7 @@ def list_logged_exceptions(
             del_log_records,
         )
 
-    async def __aenter__(self) -> ServerFixture:
+    async def __aenter__(self) -> BackendFixture:
         self._exit_stack = AsyncExitStack()
         self._records = self._exit_stack.enter_context(capture_idom_logs())
 

src/idom/testing/display.py

@@ -9,7 +9,7 @@
 from idom import html
 from idom.types import RootComponentConstructor
 
-from .server import ServerFixture
+from .backend import BackendFixture
 
 
 class DisplayFixture:
@@ -19,11 +19,11 @@ class DisplayFixture:
 
     def __init__(
         self,
-        server: ServerFixture | None = None,
+        server: BackendFixture | None = None,
         driver: Browser | BrowserContext | Page | None = None,
     ) -> None:
         if server is not None:
-            self.server = server
+            self.backend = server
         if driver is not None:
             if isinstance(driver, Page):
                 self.page = driver
@@ -37,13 +37,13 @@ async def show(
     ) -> None:
         self._next_view_id += 1
         view_id = f"display-{self._next_view_id}"
-        self.server.mount(lambda: html.div({"id": view_id}, component()))
+        self.backend.mount(lambda: html.div({"id": view_id}, component()))
 
         await self.goto("/")
         await self.page.wait_for_selector(f"#{view_id}", state="attached")
 
     async def goto(self, path: str, query: Any | None = None) -> None:
-        await self.page.goto(self.server.url(path, query))
+        await self.page.goto(self.backend.url(path, query))
 
     async def __aenter__(self) -> DisplayFixture:
         es = self._exit_stack = AsyncExitStack()
@@ -58,8 +58,8 @@ async def __aenter__(self) -> DisplayFixture:
             self.page = await browser.new_page()
 
         if not hasattr(self, "server"):
-            self.server = ServerFixture()
-            await es.enter_async_context(self.server)
+            self.backend = BackendFixture()
+            await es.enter_async_context(self.backend)
 
         return self
 
@@ -69,5 +69,5 @@ async def __aexit__(
         exc_value: BaseException | None,
         traceback: TracebackType | None,
     ) -> None:
-        self.server.mount(None)
+        self.backend.mount(None)
         await self._exit_stack.aclose()

tests/conftest.py

@@ -10,7 +10,7 @@
 from idom.config import IDOM_TESTING_DEFAULT_TIMEOUT
 from idom.testing import (
     DisplayFixture,
-    ServerFixture,
+    BackendFixture,
     capture_idom_logs,
     clear_idom_web_modules_dir,
 )
@@ -34,7 +34,7 @@ async def display(server, page):
 
 @pytest.fixture(scope="session")
 async def server():
-    async with ServerFixture() as server:
+    async with BackendFixture() as server:
         yield server
 
 

tests/test_client.py

@@ -5,7 +5,7 @@
 from playwright.async_api import Browser
 
 import idom
-from idom.testing import DisplayFixture, ServerFixture
+from idom.testing import DisplayFixture, BackendFixture
 
 
 JS_DIR = Path(__file__).parent / "js"
@@ -22,7 +22,7 @@ def OldComponent():
         return idom.html.p({"id": "old-component"}, "old")
 
     async with AsyncExitStack() as exit_stack:
-        server = await exit_stack.enter_async_context(ServerFixture(port=8000))
+        server = await exit_stack.enter_async_context(BackendFixture(port=8000))
         display = await exit_stack.enter_async_context(
             DisplayFixture(server, driver=page)
         )
@@ -43,7 +43,7 @@ def NewComponent():
         return idom.html.p({"id": f"new-component-{state}"}, f"new-{state}")
 
     async with AsyncExitStack() as exit_stack:
-        server = await exit_stack.enter_async_context(ServerFixture(port=8000))
+        server = await exit_stack.enter_async_context(BackendFixture(port=8000))
         display = await exit_stack.enter_async_context(
             DisplayFixture(server, driver=page)
         )

tests/test_server/test_common.py

@@ -7,7 +7,7 @@
 from idom.backend import default as default_implementation
 from idom.backend.types import Location
 from idom.backend.utils import all_implementations
-from idom.testing import DisplayFixture, ServerFixture, poll
+from idom.testing import DisplayFixture, BackendFixture, poll
 
 
 @pytest.fixture(
@@ -16,7 +16,7 @@
     scope="module",
 )
 async def display(page, request):
-    async with ServerFixture(implementation=request.param) as server:
+    async with BackendFixture(implementation=request.param) as server:
         async with DisplayFixture(server=server, driver=page) as display:
             yield display
 
@@ -69,7 +69,7 @@ async def test_use_scope(display: DisplayFixture):
 
     @idom.component
     def ShowScope():
-        scope.current = display.server.implementation.use_scope()
+        scope.current = display.backend.implementation.use_scope()
         return html.pre({"id": "scope"}, str(scope.current))
 
     await display.show(ShowScope)
@@ -88,7 +88,7 @@ async def poll_location():
 
     @idom.component
     def ShowRoute():
-        location.current = display.server.implementation.use_location()
+        location.current = display.backend.implementation.use_location()
         return html.pre({"id": "scope"}, str(location.current))
 
     await display.show(ShowRoute)