wrolpi/controller/test/test_admin_api.py
Roland 0d2c13e4e7 Controller: move hotspot settings to controller.yaml with WiFi device dropdown.
Hotspot was reported as "not supported" on x86 machines (Ubuntu/Debian PCs)
because the Controller only watched the hardcoded default wlan0 device, while
predictable interface naming produces names like wlp2s0. The Settings page
saved hotspot_device to wrolpi.yaml, which the Controller never read.

The Controller now owns hotspot settings in controller.yaml:

* New endpoints: GET/POST /api/hotspot/settings, GET /api/hotspot/devices
  (WiFi interfaces discovered via nmcli).
* Legacy hotspot_* values in wrolpi.yaml are migrated into controller.yaml
  once on startup, unless controller.yaml already sets them.
* The Hotspot SSID/password/device fields moved from the Settings page to the
  Control page next to the Hotspot toggle; the device is now a dropdown of
  the WiFi devices found on the machine.
* The Controller fallback UI gets the same hotspot settings form for parity.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 09:03:58 -06:00

110 lines
5 KiB
Python

"""
Integration tests for Controller admin API endpoints.
"""
import pytest
class TestStatusEndpoints:
"""Status endpoints (hotspot/bluetooth/throttle/timezone) — shape + docker behaviour."""
@pytest.mark.parametrize("endpoint,required_fields", [
("/api/hotspot/status", ["enabled", "available"]),
("/api/bluetooth/status", ["enabled", "available"]),
("/api/throttle/status", ["enabled", "available"]),
("/api/timezone/status", ["available", "timezone"]),
])
def test_status_endpoint_shape(self, test_client, endpoint, required_fields):
"""Each status endpoint should return 200 with the documented fields."""
response = test_client.get(endpoint)
assert response.status_code == 200
data = response.json()
for field in required_fields:
assert field in data, f"{endpoint} missing field {field!r}"
@pytest.mark.parametrize("endpoint", [
"/api/hotspot/status",
"/api/bluetooth/status",
"/api/throttle/status",
"/api/timezone/status",
])
def test_status_endpoint_unavailable_in_docker(self, test_client_docker_mode, endpoint):
"""Status endpoints should report available=False in Docker mode."""
data = test_client_docker_mode.get(endpoint).json()
assert data["available"] is False
class TestHotspotDevicesEndpoint:
"""GET /api/hotspot/devices lists WiFi interfaces for the Settings dropdown."""
def test_devices_endpoint_shape(self, test_client):
"""Should return the WiFi devices found by nmcli."""
from unittest import mock
with mock.patch("controller.api.admin.get_wifi_devices", return_value=["wlan0", "wlp2s0"]):
response = test_client.get("/api/hotspot/devices")
assert response.status_code == 200
assert response.json() == {"devices": ["wlan0", "wlp2s0"]}
def test_devices_empty_in_docker(self, test_client_docker_mode):
"""Should return an empty list in Docker mode."""
response = test_client_docker_mode.get("/api/hotspot/devices")
assert response.status_code == 200
assert response.json() == {"devices": []}
class TestHotspotSettingsEndpoint:
"""GET/POST /api/hotspot/settings manage hotspot settings in controller.yaml."""
def test_get_settings(self, test_client):
"""Should return the current hotspot settings."""
response = test_client.get("/api/hotspot/settings")
assert response.status_code == 200
assert response.json() == {"device": "wlan0", "ssid": "WROLPi", "password": "wrolpi hotspot"}
def test_post_settings(self, test_client, mock_config_path):
"""Should update settings and persist them to controller.yaml."""
response = test_client.post(
"/api/hotspot/settings",
json={"device": "wlp2s0", "ssid": "RafaelPi", "password": "password123"},
)
assert response.status_code == 200
assert response.json() == {"device": "wlp2s0", "ssid": "RafaelPi", "password": "password123"}
assert "wlp2s0" in mock_config_path.read_text()
def test_post_rejects_short_password(self, test_client, mock_config_path):
"""Should reject a password shorter than 8 characters."""
response = test_client.post("/api/hotspot/settings", json={"password": "short"})
assert response.status_code == 400
def test_post_rejected_in_docker(self, test_client_docker_mode):
"""Should reject settings changes in Docker mode."""
response = test_client_docker_mode.post("/api/hotspot/settings", json={"device": "wlp2s0"})
assert response.status_code == 500
class TestDockerModeRejectsAdminActions:
"""Admin action endpoints should reject requests when running in Docker."""
@pytest.mark.parametrize("method,endpoint,expected_status,payload", [
# Subsystem enable/disable — return 500 with a Docker-flavoured error.
("post", "/api/hotspot/enable", 500, None),
("post", "/api/hotspot/disable", 500, None),
("post", "/api/bluetooth/enable", 500, None),
("post", "/api/bluetooth/disable", 500, None),
("post", "/api/throttle/enable", 500, None),
("post", "/api/throttle/disable", 500, None),
("post", "/api/timezone/set", 500, {"timezone": "America/Denver"}),
# System control — return 501 (not implemented under Docker).
("post", "/api/shutdown", 501, None),
("post", "/api/reboot", 501, None),
("post", "/api/restart", 501, None),
])
def test_action_rejected_in_docker(self, test_client_docker_mode, method, endpoint, expected_status, payload):
"""Admin endpoints should reject Docker-mode requests with a Docker-mentioning error."""
client_call = getattr(test_client_docker_mode, method)
response = client_call(endpoint, json=payload) if payload else client_call(endpoint)
assert response.status_code == expected_status
assert "Docker" in response.json()["detail"]
# OpenAPI endpoint-presence tests are consolidated in test_api.py::TestOpenAPI.