from abc import ABC, abstractmethod

class ImageAnalysisInterface(ABC):
    """
    Interface pour les outils d'analyse d'image.

    Une classe implémentant cette interface doit fournir une méthode pour analyser
    une image (locale ou distante) et en générer une description textuelle.
    """

    @abstractmethod
    def analyze(self, image_filename: str) -> str:
        """
        Analyse une image et retourne une légende générée automatiquement.

        Args:
            image_filename (str): Le nom ou chemin du fichier image (local ou distant).

        Returns:
            str: Description générée ou message d'erreur.
        """
        pass