Bonjour Forge IoT¶

Objectif : premier contact avec le module opt-in forge-mvc-iot et sa
configuration.

Ce que vous allez apprendre : vérifier que le module IoT répond, et
inspecter sa configuration MQTT avec load_iot_config, en masquant le mot
de passe. Aucun broker, aucune base : on découvre simplement comment Forge IoT
est branché.

Premier palier du niveau débutant de la progression IoT
(vue d'ensemble des starters).

Module opt-in

Ce starter suppose le module installé : forge opt-in:install iot
(ou pip install forge-mvc-iot). Le cœur de Forge reste autonome ; l'IoT
est une brique que l'on ajoute à la demande.

Ce que ce starter montre¶

une route texte de premier contact (GET /iot-welcome) ;
la lecture de la configuration IoT avec load_iot_config ;
la sérialisation JSON de cette config avec le mot de passe masqué.

Aucun broker MQTT, aucune base de données.

Classes Forge utilisées¶

Classe / fonction	Rôle dans ce starter	Référence
`forge_mvc_iot.config.load_iot_config`	Lire la configuration MQTT du module IoT.	Forge IoT
`Response.text` / `Response.json`	Renvoyer du texte puis du JSON.	Response

Tester¶

forge run

Ouvrez https://localhost:8000/iot-welcome : la page affiche
« Bonjour Forge IoT ». Puis https://localhost:8000/iot-welcome/inspect
renvoie la configuration MQTT en JSON, le mot de passe remplacé par ***.

Le contrôleur¶

Créez le fichier ci-dessous, complet et copiable tel quel.

# mvc/controllers/iot_welcome_controller.py
from core.http.request import Request
from core.http.response import Response
from core.mvc.controller.base_controller import BaseController

from forge_mvc_iot.config import load_iot_config


def _config_to_safe_dict(cfg) -> dict:
    """Sérialise la config IoT en dict JSON, mot de passe masqué."""
    return {
        "mqtt_host": cfg.mqtt_host,
        "mqtt_port": cfg.mqtt_port,
        "mqtt_topic": cfg.mqtt_topic,
        "mqtt_client_id": cfg.mqtt_client_id,
        "mqtt_username": cfg.mqtt_username,
        "mqtt_password": "***" if cfg.mqtt_password else None,
    }


class IotWelcomeController(BaseController):
    """Starter pédagogique : premier contact avec Forge IoT."""

    @staticmethod
    def index(request: Request) -> Response:
        return Response.text("Bonjour Forge IoT")

    @staticmethod
    def inspect(request: Request) -> Response:
        cfg = load_iot_config()
        return Response.json(_config_to_safe_dict(cfg))

Comprendre ce code¶

load_iot_config() lit la configuration MQTT (hôte, port, topic, identifiants)
depuis l'environnement Forge : comme le reste de la config Forge, elle est
explicite.
On ne renvoie jamais le mot de passe : "***" if cfg.mqtt_password else None. Une config exposée masque toujours ses secrets.

La route¶

Déclarez les deux routes dans mvc/routes.py, à l'intérieur du groupe public.

# mvc/routes.py
from mvc.controllers.iot_welcome_controller import IotWelcomeController

with router.group("", public=True) as public:
    public.add("GET", "/iot-welcome", IotWelcomeController.index, name="iot_welcome_index")
    public.add("GET", "/iot-welcome/inspect", IotWelcomeController.inspect, name="iot_welcome_inspect")

À retenir¶

Le module IoT est opt-in : on l'installe à la demande, le cœur reste
autonome.
load_iot_config() donne accès à la configuration MQTT de façon explicite.
On masque les secrets dès qu'une config est sérialisée.

Après ce starter¶

Premier contact établi. La suite : lire les événements déjà stockés.

Lire les événements IoT