improvisation_lab/application/base_app.py

"""Base class for melody practice applications."""

from abc import ABC, abstractmethod
from typing import Any, Optional

import numpy as np

from improvisation_lab.config import Config
from improvisation_lab.service.base_practice_service import BasePracticeService


class BasePracticeApp(ABC):
    """Base class for melody practice applications."""

    def __init__(self, service: BasePracticeService, config: Config):
        """Initialize the application.

        Args:
            service: BasePracticeService instance.
            config: Config instance.
        """
        self.service = service
        self.config = config
        self.phrases: Optional[Any] = None
        self.current_phrase_idx: int = 0
        self.current_note_idx: int = 0
        self.is_running: bool = False

    @abstractmethod
    def _process_audio_callback(self, audio_data: np.ndarray):
        """Process incoming audio data and update the application state.

        Args:
            audio_data: Audio data to process.
        """
        pass

    @abstractmethod
    def _advance_to_next_note(self):
        """Advance to the next note or phrase."""
        pass

    @abstractmethod
    def launch(self, **kwargs):
        """Launch the application.

        Args:
            **kwargs: Additional keyword arguments for the launch method.
        """
        pass