42class Directorium:
 43    """The main class to access the liturgical calendar.
 44
 45    The API-backend is exchangeable to allow for different sources of the
 46    liturgical calendar data.
 47
 48    Attributes:
 49        api (Api): The API to get the liturgical events from.
 50    """
 51
 52    def __init__(self, api: Api):
 53        """Creates the Directorium with the given API.
 54
 55        Args:
 56            api (Api): The api to get the liturgical events from.
 57        """
 58        self.api = api
 59
 60    def get(self, d: Optional[date] = None) -> List[Event]:
 61        """Retrieves a list of liturgical events for a specific date.
 62
 63        Args:
 64            d (Optional[date]): The date for which to get the liturgical events.
 65                If None is provided, the current date is used. Defaults to None.
 66
 67        Returns:
 68            List[Event]: List of liturgical events for the given date.
 69        """
 70        if d is None:
 71            d = date.today()
 72        return [Event.parse(e) for e in self.api.get_date(d)]
 73
 74    @deprecated("Use static method `get_season` instead.")
 75    def season(self, d: Optional[date] = None) -> Season:
 76        """Determines the season of the liturgical year for a specific date.
 77
 78        Args:
 79            d (Optional[date]): The date for which to determine the season. If
 80                None is provided, the current date is used. Defaults to None.
 81
 82        Returns:
 83            Season: The season of the liturgical year for the given date.
 84        """
 85        return Directorium.get_season(d)
 86
 87    @staticmethod
 88    def get_season(d: Optional[date] = None) -> Season:
 89        """Determines the season of the liturgical year for a specific date.
 90
 91        Args:
 92            d (Optional[date]): The date for which to determine the season. If
 93                None is provided, the current date is used. Defaults to None.
 94
 95        Returns:
 96            Season: The season of the liturgical year for the given date.
 97        """
 98        if d is None:
 99            d = date.today()
100        christmas = date(d.year, 12, 25)
101        advent = christmas - timedelta(days=21 + christmas.isoweekday())
102        if d >= advent:
103            return Season.CHRISTMAS
104
105        epiphany = date(d.year, 1, 6)
106        baptism = epiphany + timedelta(days=7 - epiphany.isoweekday() % 7)
107        if d <= baptism:
108            return Season.CHRISTMAS
109
110        easter = utils.easter(d.year)
111        ashwednesday = easter - timedelta(days=46)
112        if d >= ashwednesday and d < easter:
113            return Season.LENT
114
115        pentecoste = easter + timedelta(days=49)
116        if d >= easter and d < pentecoste:
117            return Season.EASTER
118
119        return Season.ORDINARY
120
121    @staticmethod
122    def from_request(calendar: str | None = None) -> "Directorium":
123        """Creates a Directorium instance with a `RequestApi` backend.
124
125        Args:
126            calendar (str | None, optional): The name of the calendar to use.
127
128        Returns:
129            Directorium: The Directorium instance with a RequestApi backend.
130        """
131        from .api import RequestApi
132        return Directorium(RequestApi(calendar))
133
134    @staticmethod
135    def from_file(format_path: str) -> "Directorium":
136        """Creates a Directorium instance with a `FileApi` backend.
137
138        Args:
139            format_path (str): The format string for the file path.
140
141        Returns:
142            Directorium: The Directorium instance with a FileApi backend.
143        """
144        from .api import FileApi
145        return Directorium(FileApi(format_path))
146
147    @staticmethod
148    def from_cache(base_path: str | None = None, calendar: str | None = None) -> "Directorium":
149        """Creates a Directorium instance with a `CacheApi` backend.
150
151        Args:
152            base_path (str | None, optional): The base path for the cache files.
153                If None, the default folder defined in `CacheApi` is used.
154            calendar (str | None, optional): The name of the calendar to use.
155
156        Returns:
157            Directorium: The Directorium instance with a CacheApi backend.
158        """
159        from .api import CacheApi
160        return Directorium(CacheApi(base_path, calendar))