holidays 0.65__py3-none-any.whl → 0.67__py3-none-any.whl

holidays/groups/sinhala.py

@@ -0,0 +1,192 @@
+#  holidays
+#  --------
+#  A fast, efficient Python library for generating country, province and state
+#  specific sets of holidays on the fly. It aims to make determining whether a
+#  specific date is a holiday as fast and flexible as possible.
+#
+#  Authors: Vacanza Team and individual contributors (see AUTHORS file)
+#           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/vacanza/holidays
+#  License: MIT (see LICENSE file)
+
+from collections.abc import Iterable
+from datetime import date
+from typing import Optional
+
+from holidays.calendars import _SinhalaLunar
+from holidays.groups.eastern import EasternCalendarHolidays
+
+
+class SinhalaCalendarHolidays(EasternCalendarHolidays):
+    """
+    Sinhala holidays.
+
+    Sinhala Buddhist Uposatha day calculation method is different from Thai LuniSolar
+    and Buddhist (Mahayana) used in East Asia.
+
+    Due to the fact that Poya (Uposatha) days are calculated astronomically
+    based on how close a particular day is closest to full moon at noon, and that
+    an extra month is added every 33 months interval, this is hardcoded for now.
+
+    Adhi month dates are instead hardcoded in Sri Lanka country implementation.
+    """
+
+    def __init__(self, cls=None, show_estimated=False) -> None:
+        self._sinhala_calendar = cls() if cls else _SinhalaLunar()
+        self._sinhala_calendar_show_estimated = show_estimated
+
+    def _add_sinhala_calendar_holiday(
+        self, name: str, dt_estimated: tuple[Optional[date], bool]
+    ) -> Optional[date]:
+        """
+        Add Sinhala calendar holiday.
+
+        Adds customizable estimation label to holiday name if holiday date
+        is an estimation.
+        """
+        return self._add_eastern_calendar_holiday(
+            name, dt_estimated, self._sinhala_calendar_show_estimated
+        )
+
+    def _add_sinhala_calendar_holiday_set(
+        self, name: str, dts_estimated: Iterable[tuple[date, bool]], days_delta: int = 0
+    ) -> set[date]:
+        """
+        Add Sinhala calendar holidays.
+
+        Adds customizable estimation label to holiday name if holiday date
+        is an estimation.
+        """
+        added_dates = set()
+        for dt_estimated in dts_estimated:
+            if dt := self._add_eastern_calendar_holiday(
+                name, dt_estimated, self._sinhala_calendar_show_estimated, days_delta=days_delta
+            ):
+                added_dates.add(dt)
+
+        return added_dates
+
+    def _add_bak_poya(self, name) -> Optional[date]:
+        """
+        Add Bak Poya (first full moon day of the 5th lunar month).
+
+        https://us.lakpura.com/pages/bak-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.bak_poya_date(self._year)
+        )
+
+    def _add_binara_poya(self, name) -> Optional[date]:
+        """
+        Add Binara Poya (first full moon day of the 10th lunar month).
+
+        https://us.lakpura.com/pages/binara-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.binara_poya_date(self._year)
+        )
+
+    def _add_duruthu_poya(self, name) -> set[date]:
+        """
+        Add Duruthu Poya (first full moon day of the 2nd lunar month).
+
+        https://us.lakpura.com/pages/duruthu-poya
+        """
+        return self._add_sinhala_calendar_holiday_set(
+            name, self._sinhala_calendar.duruthu_poya_date(self._year)
+        )
+
+    def _add_esala_poya(self, name) -> Optional[date]:
+        """
+        Add Esala Poya (first full moon day of the 8th lunar month).
+
+        https://us.lakpura.com/pages/esala-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.esala_poya_date(self._year)
+        )
+
+    def _add_il_poya(self, name) -> Optional[date]:
+        """
+        Add Il Poya (first full moon day of the 12th lunar month).
+
+        Also known as "Ill Poya"
+        https://us.lakpura.com/pages/il-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.il_poya_date(self._year)
+        )
+
+    def _add_medin_poya(self, name) -> Optional[date]:
+        """
+        Add Medin Poya (first full moon day of the 4th lunar month).
+
+        https://us.lakpura.com/pages/medin-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.medin_poya_date(self._year)
+        )
+
+    def _add_nawam_poya(self, name) -> Optional[date]:
+        """
+        Add Nawam Poya (first full moon day of the 3rd lunar month).
+
+        Also known as "Navam Poya" and "Magha Puja".
+        https://us.lakpura.com/pages/navam-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.nawam_poya_date(self._year)
+        )
+
+    def _add_nikini_poya(self, name) -> Optional[date]:
+        """
+        Add Nikini Poya (first full moon day of the 9th lunar month).
+
+        https://us.lakpura.com/pages/nikini-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.nikini_poya_date(self._year)
+        )
+
+    def _add_poson_poya(self, name) -> Optional[date]:
+        """
+        Add Poson Poya (first full moon day of the 7th lunar month).
+
+        https://us.lakpura.com/pages/poson
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.poson_poya_date(self._year)
+        )
+
+    def _add_unduvap_poya(self, name) -> Optional[date]:
+        """
+        Add Unduvap Poya (first full moon day of the 1st lunar month).
+
+        Also known as "Undawap Poya".
+        https://us.lakpura.com/pages/unduvap-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.unduvap_poya_date(self._year)
+        )
+
+    def _add_vap_poya(self, name) -> Optional[date]:
+        """
+        Add Vap Poya (first full moon day of the 11th lunar month).
+
+        https://us.lakpura.com/pages/vap-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.vap_poya_date(self._year)
+        )
+
+    def _add_vesak_poya(self, name) -> Optional[date]:
+        """
+        Add Vesak Poya (first full moon day of the 6th lunar month).
+
+        Also known as "Wesak Poya".
+        https://us.lakpura.com/pages/vesak
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.vesak_poya_date(self._year)
+        )

holidays/holiday_base.py

@@ -14,13 +14,14 @@ __all__ = ("DateLike", "HolidayBase", "HolidaySum")
 
 import copy
 import warnings
+from bisect import bisect_left, bisect_right
 from calendar import isleap
 from collections.abc import Iterable
 from datetime import date, datetime, timedelta, timezone
 from functools import cached_property
 from gettext import gettext, translation
 from pathlib import Path
-from typing import Any, Dict, Optional, Union, cast
+from typing import Any, Literal, Optional, Union, cast
 
 from dateutil.parser import parse
 
@@ -249,6 +250,8 @@ class HolidayBase(dict[date, str]):
     """Start year of holidays presence for this entity."""
     end_year: int = DEFAULT_END_YEAR
     """End year of holidays presence for this entity."""
+    parent_entity: Optional[type["HolidayBase"]] = None
+    """Optional parent entity to reference as a base."""
 
     def __init__(
         self,
@@ -364,16 +367,32 @@ class HolidayBase(dict[date, str]):
         self.weekend_workdays = getattr(self, "weekend_workdays", set())
 
         supported_languages = set(self.supported_languages)
-        self.tr = (
-            translation(
+        if self._entity_code is not None:
+            fallback = language not in supported_languages
+            languages = [language] if language in supported_languages else None
+            locale_directory = str(Path(__file__).with_name("locale"))
+
+            # Add entity native content translations.
+            entity_translation = translation(
                 self._entity_code,
-                fallback=language not in supported_languages,
-                languages=[language] if language in supported_languages else None,
-                localedir=str(Path(__file__).with_name("locale")),
-            ).gettext
-            if self._entity_code is not None
-            else gettext
-        )
+                fallback=fallback,
+                languages=languages,
+                localedir=locale_directory,
+            )
+            # Add a fallback if entity has parent translations.
+            if parent_entity := self.parent_entity:
+                entity_translation.add_fallback(
+                    translation(
+                        parent_entity.country or parent_entity.market,
+                        fallback=fallback,
+                        languages=languages,
+                        localedir=locale_directory,
+                    )
+                )
+            self.tr = entity_translation.gettext
+        else:
+            self.tr = gettext
+
         self.years = _normalize_arguments(int, years)
 
         # Populate holidays.
@@ -418,7 +437,7 @@ class HolidayBase(dict[date, str]):
         if not isinstance(key, (date, datetime, float, int, str)):
             raise TypeError(f"Cannot convert type '{type(key)}' to date.")
 
-        return dict.__contains__(cast("Dict[Any, Any]", self), self.__keytransform__(key))
+        return dict.__contains__(cast("dict[Any, Any]", self), self.__keytransform__(key))
 
     def __eq__(self, other: object) -> bool:
         if not isinstance(other, HolidayBase):
@@ -428,7 +447,7 @@ class HolidayBase(dict[date, str]):
             if getattr(self, attribute_name, None) != getattr(other, attribute_name, None):
                 return False
 
-        return dict.__eq__(cast("Dict[Any, Any]", self), other)
+        return dict.__eq__(cast("dict[Any, Any]", self), other)
 
     def __getattr__(self, name):
         try:
@@ -967,6 +986,36 @@ class HolidayBase(dict[date, str]):
 
         raise AttributeError(f"Unknown lookup type: {lookup}")
 
+    def get_closest_holiday(
+        self,
+        target_date: DateLike = None,
+        direction: Literal["forward", "backward"] = "forward",
+    ) -> Optional[tuple[date, str]]:
+        """Return the date and name of the next holiday for a target_date
+        if direction is "forward" or the previous holiday if direction is "backward".
+        If target_date is not provided the current date will be used by default."""
+
+        if direction not in {"backward", "forward"}:
+            raise AttributeError(f"Unknown direction: {direction}")
+
+        dt = self.__keytransform__(target_date or datetime.now().date())
+        if direction == "forward" and (next_year := dt.year + 1) not in self.years:
+            self._populate(next_year)
+        elif direction == "backward" and (previous_year := dt.year - 1) not in self.years:
+            self._populate(previous_year)
+
+        sorted_dates = sorted(self.keys())
+        position = (
+            bisect_right(sorted_dates, dt)
+            if direction == "forward"
+            else bisect_left(sorted_dates, dt) - 1
+        )
+        if 0 <= position < len(sorted_dates):
+            dt = sorted_dates[position]
+            return dt, self[dt]
+
+        return None
+
     def get_nth_working_day(self, key: DateLike, n: int) -> date:
         """Return n-th working day from provided date (if n is positive)
         or n-th working day before provided date (if n is negative).
@@ -1201,4 +1250,4 @@ country_holidays('CA') + country_holidays('MX')
     def _populate(self, year):
         for operand in self.holidays:
             operand._populate(year)
-            self.update(cast("Dict[DateLike, str]", operand))
+            self.update(cast("dict[DateLike, str]", operand))

holidays/registry.py

@@ -142,6 +142,7 @@ COUNTRIES: RegistryDict = {
     "romania": ("Romania", "RO", "ROU"),
     "russia": ("Russia", "RU", "RUS"),
     "saint_kitts_and_nevis": ("SaintKittsAndNevis", "KN", "KNA"),
+    "saint_lucia": ("SaintLucia", "LC", "LCA"),
     "samoa": ("Samoa", "WS", "WSM"),
     "san_marino": ("SanMarino", "SM", "SMR"),
     "saudi_arabia": ("SaudiArabia", "SA", "SAU"),
@@ -153,6 +154,7 @@ COUNTRIES: RegistryDict = {
     "south_africa": ("SouthAfrica", "ZA", "ZAF"),
     "south_korea": ("SouthKorea", "KR", "KOR", "Korea"),
     "spain": ("Spain", "ES", "ESP"),
+    "sri_lanka": ("SriLanka", "LK", "LKA"),
     "sweden": ("Sweden", "SE", "SWE"),
     "switzerland": ("Switzerland", "CH", "CHE"),
     "taiwan": ("Taiwan", "TW", "TWN"),
@@ -162,6 +164,7 @@ COUNTRIES: RegistryDict = {
     "tonga": ("Tonga", "TO", "TON"),
     "tunisia": ("Tunisia", "TN", "TUN"),
     "turkey": ("Turkey", "TR", "TUR"),
+    "tuvalu": ("Tuvalu", "TV", "TUV"),
     "ukraine": ("Ukraine", "UA", "UKR"),
     "united_arab_emirates": ("UnitedArabEmirates", "AE", "ARE"),
     "united_kingdom": ("UnitedKingdom", "GB", "GBR", "UK"),

holidays/version.py

@@ -10,4 +10,4 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-__version__ = "0.65"
+__version__ = "0.67"

{holidays-0.65.dist-info → holidays-0.67.dist-info}/AUTHORS

@@ -29,6 +29,7 @@ Chanran Kim
 Chris McKeague
 Chris Turra
 Christian Alexander
+Colin Watson
 Dan Gentry
 Daniel Musketa
 Daniël Niemeijer