Adafruit_CircuitPython_HTTP.../examples/httpserver_url_parameters.py
2025-05-16 16:11:43 +00:00

71 lines
1.8 KiB
Python

# SPDX-FileCopyrightText: 2023 Michał Pokusa
#
# SPDX-License-Identifier: Unlicense
import socketpool
import wifi
from adafruit_httpserver import Request, Response, Server
pool = socketpool.SocketPool(wifi.radio)
server = Server(pool, debug=True)
class Device:
def turn_on(self):
print("Turning on device.")
def turn_off(self):
print("Turning off device.")
def get_device(device_id: str) -> Device:
"""
This is a **made up** function that returns a `Device` object.
"""
return Device()
@server.route("/device/<device_id>/action/<action>")
@server.route("/device/emergency-power-off/<device_id>")
def perform_action(request: Request, device_id: str, action: str = "emergency_power_off"):
"""
Performs an "action" on a specified device.
"""
device = get_device(device_id)
if action in {"turn_on"}:
device.turn_on()
elif action in {"turn_off", "emergency_power_off"}:
device.turn_off()
else:
return Response(request, f"Unknown action ({action})")
return Response(request, f"Action ({action}) performed on device with ID: {device_id}")
@server.route("/device/<device_id>/status/<date>")
def device_status_on_date(request: Request, **params: dict):
"""
Return the status of a specified device between two dates.
"""
device_id = params.get("device_id")
date = params.get("date")
return Response(request, f"Status of {device_id} on {date}: ...")
@server.route("/device/.../status", append_slash=True)
@server.route("/device/....", append_slash=True)
def device_status(request: Request):
"""
Returns the status of all devices no matter what their ID is.
Unknown commands also return the status of all devices.
"""
return Response(request, "Status of all devices: ...")
server.serve_forever(str(wifi.radio.ipv4_address))