feat: connection over rest

doc/changelog.d/5015.added.md

@@ -0,0 +1 @@
+Connection over rest

pyproject.toml

@@ -119,7 +119,8 @@ markers = [
     "settings_only: Read and modify the case settings only, without loading the mesh, initializing, or solving the case",
     "nightly: Tests that run under nightly CI",
     "fluent_version(version): Tests that runs with specified Fluent version",
-    "standalone: Tests that cannot be run within container"
+    "standalone: Tests that cannot be run within container",
+    "real_server: Tests that require a live Fluent / SimBA server"
 ]
 
 [tool.black]

src/ansys/fluent/core/rest/__init__.py

@@ -0,0 +1,55 @@
+# Copyright (C) 2021 - 2026 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""REST-based PyFluent settings client and session.
+
+Standalone HTTP transport layer for PyFluent, connecting to Fluent's
+embedded web server via REST.  Pure HTTP/JSON — no gRPC, no protobuf,
+no code-generated modules, no local settings tree.
+
+* :class:`~ansys.fluent.core.rest.client.FluentRestClient` – pure-Python
+  HTTP client using stdlib ``urllib`` only.  Each method makes one HTTP
+  call and returns the server's JSON directly.
+
+* :func:`~ansys.fluent.core.rest.rest_launcher.launch_webserver` – **primary
+  entry point**. Spawns a local Fluent process with ``-ws -ws-port={port}``,
+  generates and configures the web server authentication token internally
+  for the subprocess, and returns a connected
+    :class:`~ansys.fluent.core.rest.client.FluentRestClient`.
+
+Example::
+
+    from ansys.fluent.core.rest import launch_webserver
+
+    client = launch_webserver()
+    print(client.get_var("setup/models/energy/enabled"))
+    client.set_var("setup/models/energy/enabled", False)
+"""
+
+from ansys.fluent.core.rest.client import FluentRestClient
+from ansys.fluent.core.rest.rest_launcher import (
+    launch_webserver,
+)
+
+__all__ = [
+    "FluentRestClient",
+    "launch_webserver",
+]