homecontrol.esp-sensors/src/esp_sensors/humidity.py

"""
Humidity sensor module for ESP-based sensors.
"""

import random
from typing import Dict, Any, Optional
from .sensor import Sensor
from .config import get_sensor_config


class HumiditySensor(Sensor):
    """Humidity sensor implementation."""

    def __init__(
        self,
        name: str = None,
        pin: int = None,
        interval: int = None,
        sensor_config: Dict[str, Any] = None,
        **kwargs,
    ):
        """
        Initialize a new humidity sensor.

        Args:
            name: The name of the sensor (if None, loaded from config)
            pin: The GPIO pin number the sensor is connected to (if None, loaded from config)
            interval: Reading interval in seconds (if None, loaded from config)
            sensor_config: Sensor-Configuration dictionary (if provided, used instead of loading from file)
            **kwargs: Additional keyword arguments to pass to the parent class
        """
        if sensor_config is None:
            sensor_config = {}
        # Initialize base class with sensor_type for configuration loading
        super().__init__(name, pin, interval, sensor_config=sensor_config)
        self._last_humidity = None

    def read_humidity(self) -> float:
        """
        Read the current humidity.

        Returns:
            The humidity reading as a float (percentage)
        """
        # This is a simulation for testing purposes
        # In a real implementation, this would read from the actual sensor
        self._last_humidity = round(random.uniform(30.0, 90.0), 1)
        return self._last_humidity

    def get_metadata(self):
        """
        Get sensor metadata including humidity information.

        Returns:
            A dictionary containing sensor metadata
        """
        metadata = super().get_metadata()
        metadata["last_humidity"] = self._last_humidity
        return metadata