docs: Add simple devices and plans for use in tutorials

docs/resources/config.yaml

@@ -0,0 +1,13 @@
+env:
+  metadata:
+    instrument: demo
+  sources:
+    - kind: deviceManager
+      module: blueapi.tutorial.devices
+    - kind: planFunctions
+      module: dodal.plans
+    - kind: planFunctions
+      module: dodal.plan_stubs.wrapped
+stomp:
+  enabled: true
+  url: tcp://localhost:61613/

pyproject.toml

@@ -43,6 +43,9 @@ license.file = "LICENSE"
 readme = "README.md"
 requires-python = ">=3.11"
 
+[project.optional-dependencies]
+demo = ["dls-dodal>=1.69.0", "ophyd-async[sim]"]
+
 [dependency-groups]
 dev = [
     "ophyd_async[sim]",
@@ -76,7 +79,7 @@ dev = [
     "tiled[minimal-server]>=0.2.4", # For system-test of dls.py
     "respx",
     "pytest-xdist[psutil]",
-    "httpx2>=2.5.0"
+    "httpx2>=2.5.0",
 ]
 
 [project.scripts]

src/blueapi/tutorial/devices.py

@@ -0,0 +1,31 @@
+from dodal.device_manager import DeviceManager
+from ophyd_async import sim
+
+devices = DeviceManager()
+
+
+@devices.fixture
+def path_provider():
+    from pathlib import Path
+
+    from ophyd_async.core import AutoIncrementFilenameProvider, StaticPathProvider
+
+    return StaticPathProvider(
+        AutoIncrementFilenameProvider(base_filename="demo"),
+        Path("/tmp"),
+    )
+
+
+@devices.fixture
+def pattern_generator():
+    return sim.PatternGenerator()
+
+
+@devices.factory()
+def stage(pattern_generator) -> sim.SimStage:
+    return sim.SimStage(pattern_generator)
+
+
+@devices.factory()
+def det(path_provider, pattern_generator) -> sim.SimBlobDetector:
+    return sim.SimBlobDetector(path_provider, pattern_generator)

tests/unit_tests/tutorial/test_devices.py

@@ -0,0 +1,18 @@
+from pathlib import Path
+
+import pytest
+
+from blueapi.config import ApplicationConfig, ConfigLoader
+from blueapi.core.context import BlueskyContext
+
+
+@pytest.fixture
+def context() -> BlueskyContext:
+    loader = ConfigLoader(ApplicationConfig)
+    loader.use_values_from_yaml(Path("docs/resources/config.yaml"))
+    config: ApplicationConfig = loader.load()
+    return BlueskyContext(configuration=config)
+
+
+def test_devices_loaded_from_module(context):
+    assert "det", "stage" in context.devices