debtmap 0.16.3

Code complexity and technical debt analyzer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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
80
81
82
83
84
85
86
87
88
89
90

"""
Observer pattern implementation with decorators, inheritance, and singletons.
"""
from abc import ABC, abstractmethod
from dataclasses import dataclass
from typing import List


# Abstract base class with inheritance
class Observer(ABC):
    """Abstract observer interface."""

    @abstractmethod
    def on_event(self, event: str) -> None:
        """Handle event notification."""
        pass


class Subject(ABC):
    """Abstract subject that notifies observers."""

    def __init__(self):
        self._observers: List[Observer] = []

    def attach(self, observer: Observer) -> None:
        """Attach an observer."""
        if observer not in self._observers:
            self._observers.append(observer)

    def detach(self, observer: Observer) -> None:
        """Detach an observer."""
        self._observers.remove(observer)

    @abstractmethod
    def notify(self) -> None:
        """Notify all observers."""
        pass


# Concrete implementation with decorator
@dataclass
class ConcreteObserver(Observer):
    """Concrete observer with dataclass decorator."""
    name: str

    def on_event(self, event: str) -> None:
        """Handle event notification."""
        print(f"{self.name} received event: {event}")


class EventManager(Subject):
    """Concrete subject managing events."""

    def __init__(self):
        super().__init__()
        self._event_queue: List[str] = []

    def add_event(self, event: str) -> None:
        """Add event to queue."""
        self._event_queue.append(event)
        self.notify()

    def notify(self) -> None:
        """Notify all observers of events."""
        for event in self._event_queue:
            for observer in self._observers:
                observer.on_event(event)
        self._event_queue.clear()


# Module-level singleton instance
event_manager = EventManager()


# Factory function
def create_observer(name: str) -> ConcreteObserver:
    """Create and return a new observer."""
    return ConcreteObserver(name=name)


# Configuration object (another singleton pattern)
class Configuration:
    """Application configuration."""

    def __init__(self):
        self.debug_mode = False
        self.max_observers = 100


config = Configuration()