Added ability to specify profile for server in Run class

Also added specification of profile using SIMVUE_SERVER_PROFILE

Author: kzscisoft

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change Log
 
+## Unreleased
+
+- Added ability to specify above one server in the `simvue.toml` file using `profiles`.
+- Enforced keyword arguments for readability and certainty in intent within initialiser for `simvue.Run`.
+
 ## [v2.3.0](https://github.com/simvue-io/client/releases/tag/v2.3.0) - 2025-12-11
 
 - Refactored sender functionality introducing new `Sender` class.

simvue/config/user.py

@@ -189,6 +189,8 @@ def fetch(
         """
         _config_dict: dict[str, dict[str, str]] = cls._load_pyproject_configs() or {}
 
+        profile = os.environ.get("SIMVUE_SERVER_PROFILE", profile)
+
         try:
             # NOTE: Legacy INI support has been removed
             _config_dict |= toml.load(cls.config_file())

simvue/run.py

@@ -118,11 +118,13 @@ class Run:
     @pydantic.validate_call
     def __init__(
         self,
+        *,
         mode: typing.Literal["online", "offline", "disabled"] = "online",
         abort_callback: typing.Callable[[Self], None] | None = None,
         server_token: pydantic.SecretStr | None = None,
         server_url: str | None = None,
         debug: bool = False,
+        server_profile: str = "default",
     ) -> None:
         """Initialise a new Simvue run
 
@@ -143,6 +145,10 @@ def __init__(
             overwrite value for server URL, default is None
         debug : bool, optional
             run in debug mode, default is False
+        server_profile : str, optional
+            specify alternative profile to use for server, this assumes
+            additional profiles have been specified in the configuration.
+            Default is to use the main server.
 
         Examples
         --------
@@ -185,7 +191,10 @@ def __init__(
         self._step: int = 0
         self._active: bool = False
         self._user_config: SimvueConfiguration = SimvueConfiguration.fetch(
-            server_url=server_url, server_token=server_token, mode=mode
+            server_url=server_url,
+            server_token=server_token,
+            mode=mode,
+            profile=server_profile,
         )
 
         logging.getLogger(self.__class__.__module__).setLevel(

tests/conftest.py

@@ -158,7 +158,7 @@ def create_test_run_offline(request, monkeypatch: pytest.MonkeyPatch, prevent_sc
     _ = prevent_script_exit
     with tempfile.TemporaryDirectory() as temp_d:
         monkeypatch.setenv("SIMVUE_OFFLINE_DIRECTORY", temp_d)
-        with sv_run.Run("offline") as run:
+        with sv_run.Run(mode="offline") as run:
             _test_run_data = setup_test_run(run, temp_dir=pathlib.Path(temp_d), create_objects=True, request=request)
             yield run, _test_run_data
     with contextlib.suppress(ObjectNotFoundError):
@@ -195,7 +195,7 @@ def create_plain_run_offline(request,prevent_script_exit,monkeypatch) -> Generat
     _ = prevent_script_exit
     with tempfile.TemporaryDirectory() as temp_d:
         monkeypatch.setenv("SIMVUE_OFFLINE_DIRECTORY", temp_d)
-        with sv_run.Run("offline") as run:
+        with sv_run.Run(mode="offline") as run:
             _temporary_directory = pathlib.Path(temp_d)
             yield run, setup_test_run(run, temp_dir=_temporary_directory, create_objects=False, request=request)
     clear_out_files()