Skip to content

Track

Track event handling subject of the observer.

TrackEventHandler

Inform all registered track-event observers about a track change.

This is the subject of the classical observer pattern

Source code in nowplaying/track/handler.py 
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
class TrackEventHandler:
    """Inform all registered track-event observers about a track change.

    This is the subject of the classical observer pattern
    """

    def __init__(self: Self) -> None:
        """Initialize the track event handler."""
        self.__observers: list[TrackObserver] = []

    def register_observer(self: Self, observer: TrackObserver) -> None:
        """Register an observer to be informed about track changes."""
        logger.info("Registering TrackObserver '%s'", observer.__class__.__name__)
        self.__observers.append(observer)

    def remove_observer(self: Self, observer: TrackObserver) -> None:
        """Remove an observer from the list of observers."""
        self.__observers.remove(observer)

    def get_observers(self: Self) -> list:
        """Return register observers to allow inspecting them."""
        return self.__observers

    def track_started(self: Self, track: Track) -> None:
        """Inform all registered track-event observers about a track started event."""
        logger.info(
            "Sending track-started event to %s observers: %s",
            len(self.__observers),
            track,
        )

        for observer in self.__observers:
            logger.debug(
                "Sending track-started event to observer %s",
                observer.__class__,
            )

            try:
                observer.track_started(track)
            except Exception:
                logger.exception(_EXCEPTION_TRACK_HANDLER_ERROR_START)

    def track_finished(self: Self, track: Track) -> None:
        """Inform all registered track-event observers about a track finished event."""
        logger.info(
            "Sending track-finished event to %s observers: %s",
            len(self.__observers),
            track,
        )

        for observer in self.__observers:
            logger.debug(
                "Sending track-finished event to observer %s",
                observer.__class__,
            )

            try:
                observer.track_finished(track)
            except Exception:
                logger.exception(_EXCEPTION_TRACK_HANDLER_ERROR_FINISH)

__init__()

Initialize the track event handler.

Source code in nowplaying/track/handler.py 
26
27
28
def __init__(self: Self) -> None:
    """Initialize the track event handler."""
    self.__observers: list[TrackObserver] = []

get_observers()

Return register observers to allow inspecting them.

Source code in nowplaying/track/handler.py 
39
40
41
def get_observers(self: Self) -> list:
    """Return register observers to allow inspecting them."""
    return self.__observers

register_observer(observer)

Register an observer to be informed about track changes.

Source code in nowplaying/track/handler.py 
30
31
32
33
def register_observer(self: Self, observer: TrackObserver) -> None:
    """Register an observer to be informed about track changes."""
    logger.info("Registering TrackObserver '%s'", observer.__class__.__name__)
    self.__observers.append(observer)

remove_observer(observer)

Remove an observer from the list of observers.

Source code in nowplaying/track/handler.py 
35
36
37
def remove_observer(self: Self, observer: TrackObserver) -> None:
    """Remove an observer from the list of observers."""
    self.__observers.remove(observer)

track_finished(track)

Inform all registered track-event observers about a track finished event.

Source code in nowplaying/track/handler.py 
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
def track_finished(self: Self, track: Track) -> None:
    """Inform all registered track-event observers about a track finished event."""
    logger.info(
        "Sending track-finished event to %s observers: %s",
        len(self.__observers),
        track,
    )

    for observer in self.__observers:
        logger.debug(
            "Sending track-finished event to observer %s",
            observer.__class__,
        )

        try:
            observer.track_finished(track)
        except Exception:
            logger.exception(_EXCEPTION_TRACK_HANDLER_ERROR_FINISH)

track_started(track)

Inform all registered track-event observers about a track started event.

Source code in nowplaying/track/handler.py 
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
def track_started(self: Self, track: Track) -> None:
    """Inform all registered track-event observers about a track started event."""
    logger.info(
        "Sending track-started event to %s observers: %s",
        len(self.__observers),
        track,
    )

    for observer in self.__observers:
        logger.debug(
            "Sending track-started event to observer %s",
            observer.__class__,
        )

        try:
            observer.track_started(track)
        except Exception:
            logger.exception(_EXCEPTION_TRACK_HANDLER_ERROR_START)