holidays 0.75__py3-none-any.whl → 0.77__py3-none-any.whl

holidays/countries/united_states_minor_outlying_islands.py

@@ -10,11 +10,11 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
-from holidays.countries.united_states import US
+from holidays.countries.united_states import UnitedStates
+from holidays.mixins.child_entity import ChildEntity
 
 
-class HolidaysUM(US):
+class HolidaysUM(ChildEntity, UnitedStates):
     """United States Minor Outlying Islands holidays.
 
     Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
@@ -22,21 +22,13 @@ class HolidaysUM(US):
     """
 
     country = "UM"
-    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
-    subdivisions = ()  # Override US subdivisions.
-    subdivisions_aliases = {}  # Override US subdivisions aliases.
+    parent_entity = UnitedStates
+    # The first islands were claimed via Guano Islands Act on August 18th, 1856.
+    start_year = 1857
 
-    def _populate_public_holidays(self) -> None:
-        self.subdiv = "UM"
-        super()._populate_public_holidays()
 
-    def _populate_government_holidays(self) -> None:
-        self.subdiv = "UM"
-        super()._populate_government_holidays()
-
-    def _populate_unofficial_holidays(self) -> None:
-        self.subdiv = "UM"
-        super()._populate_unofficial_holidays()
+class UnitedStatesMinorOutlyingIslands(HolidaysUM):
+    pass
 
 
 class UM(HolidaysUM):
@@ -45,7 +37,3 @@ class UM(HolidaysUM):
 
 class UMI(HolidaysUM):
     pass
-
-
-class UnitedStatesMinorOutlyingIslands(HolidaysUM):
-    pass

holidays/countries/united_states_virgin_islands.py

@@ -10,11 +10,11 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
-from holidays.countries.united_states import US
+from holidays.countries.united_states import UnitedStates
+from holidays.mixins.child_entity import ChildEntity
 
 
-class HolidaysVI(US):
+class HolidaysVI(ChildEntity, UnitedStates):
     """United States Virgin Islands (the) holidays.
 
     Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
@@ -22,21 +22,13 @@ class HolidaysVI(US):
     """
 
     country = "VI"
-    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
-    subdivisions = ()  # Override US subdivisions.
-    subdivisions_aliases = {}  # Override US subdivisions aliases.
+    parent_entity = UnitedStates
+    # Became a U.S. Territory since March 31st, 1917.
+    start_year = 1918
 
-    def _populate_public_holidays(self) -> None:
-        self.subdiv = "VI"
-        super()._populate_public_holidays()
 
-    def _populate_government_holidays(self) -> None:
-        self.subdiv = "VI"
-        super()._populate_government_holidays()
-
-    def _populate_unofficial_holidays(self) -> None:
-        self.subdiv = "VI"
-        super()._populate_unofficial_holidays()
+class UnitedStatesVirginIslands(HolidaysVI):
+    pass
 
 
 class VI(HolidaysVI):
@@ -45,7 +37,3 @@ class VI(HolidaysVI):
 
 class VIR(HolidaysVI):
     pass
-
-
-class UnitedStatesVirginIslands(HolidaysVI):
-    pass

holidays/countries/uzbekistan.py

@@ -55,7 +55,7 @@ class Uzbekistan(ObservedHolidayBase, InternationalHolidays, IslamicHolidays, St
         super().__init__(*args, **kwargs)
 
     def _is_observed(self, dt: date) -> bool:
-        # Commencement of the new Labor Code
+        # Commencement of the new Labor Code.
         return dt >= date(2023, APR, 30)
 
     def _populate_public_holidays(self):
@@ -132,6 +132,8 @@ class UzbekistanIslamicHolidays(_CustomIslamicHolidays):
         2021: (JUL, 20),
         2022: (JUL, 9),
         2023: (JUN, 28),
+        2024: (JUN, 16),
+        2025: (JUN, 6),
     }
 
     EID_AL_FITR_DATES = {
@@ -154,10 +156,24 @@ class UzbekistanIslamicHolidays(_CustomIslamicHolidays):
         2022: (MAY, 2),
         2023: (APR, 21),
         2024: (APR, 10),
+        2025: (MAR, 30),
     }
 
 
 class UzbekistanStaticHolidays:
+    """Uzbekistan special holidays.
+
+    References:
+        * [2018](https://web.archive.org/web/20250610012705/https://lex.uz/ru/docs/3479237)
+        * [2019](https://web.archive.org/web/20250521124231/https://lex.uz/docs/-4054698)
+        * [2020](https://web.archive.org/web/20250522053834/https://lex.uz/docs/-4595638)
+        * [2021](https://web.archive.org/web/20250522053822/https://lex.uz/docs/-5137156)
+        * [2022](https://web.archive.org/web/20250522053831/https://lex.uz/docs/-5784917)
+        * [2023](https://web.archive.org/web/20250522053822/https://lex.uz/docs/-6324664)
+        * [2024](https://web.archive.org/web/20250522053835/https://lex.uz/docs/-6704048)
+        * [2025](https://web.archive.org/web/20250422135040/https://lex.uz/docs/-7275687)
+    """
+
     # Date format (see strftime() Format Codes)
     substituted_date_format = tr("%d/%m %Y")
     # Day off (substituted from %s).
@@ -171,7 +187,7 @@ class UzbekistanStaticHolidays:
             (JAN, 3, JAN, 6),
             (MAR, 19, MAR, 17),
             (MAR, 22, MAR, 24),
-            (MAR, 30, additional_day_off),
+            (MAR, 20, additional_day_off),
             (AUG, 23, AUG, 25),
             (AUG, 24, AUG, 26),
             (AUG, 31, additional_day_off),
@@ -232,4 +248,5 @@ class UzbekistanStaticHolidays:
             (DEC, 30, DEC, 14),
             (DEC, 31, additional_day_off),
         ),
+        2025: (JAN, 2, JAN, 4),
     }

holidays/countries/wallis_and_futuna.py

@@ -0,0 +1,43 @@
+#  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 CONTRIBUTORS 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 holidays.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysWF(ChildEntity, France):
+    """Wallis and Futuna holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Wallis_and_Futuna>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "WF"
+    parent_entity = France
+    # Separation from French Caledonia on July 29th, 1961.
+    start_year = 1962
+
+
+class WallisAndFutuna(HolidaysWF):
+    pass
+
+
+class WF(HolidaysWF):
+    pass
+
+
+class WLF(HolidaysWF):
+    pass

holidays/countries/yemen.py

@@ -51,11 +51,11 @@ class Yemen(ObservedHolidayBase, InternationalHolidays, IslamicHolidays):
     country = "YE"
     default_language = "ar"
     # %s (estimated).
-    estimated_label = tr("%s (مُقدَّر)")
+    estimated_label = tr("%s (المقدرة)")
     # %s (observed).
     observed_label = tr("%s (ملاحظة)")
     # %s (observed, estimated).
-    observed_estimated_label = tr("%s (مُقدَّر ملاحظة)")
+    observed_estimated_label = tr("%s (المقدرة، ملاحظة)")
     # The Republic of Yemen was declared on 22 May 1990.
     start_year = 1991
     supported_categories = (PUBLIC, SCHOOL, WORKDAY)

holidays/groups/__init__.py

@@ -22,6 +22,7 @@ from holidays.groups.hebrew import HebrewCalendarHolidays
 from holidays.groups.hindu import HinduCalendarHolidays
 from holidays.groups.international import InternationalHolidays
 from holidays.groups.islamic import IslamicHolidays
+from holidays.groups.mongolian import MongolianCalendarHolidays
 from holidays.groups.persian import PersianCalendarHolidays
 from holidays.groups.sinhala import SinhalaCalendarHolidays
 from holidays.groups.thai import ThaiCalendarHolidays

holidays/groups/chinese.py

@@ -121,6 +121,17 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
             name, self._chinese_calendar.buddha_birthday_date(self._year)
         )
 
+    def _add_chinese_day_before_new_years_eve(self, name) -> Optional[date]:
+        """
+        Add day before Chinese New Year's Eve (second to last day of 12th lunar month).
+
+        Chinese New Year's Eve is the day before the Chinese New Year.
+        https://en.wikipedia.org/wiki/Chinese_New_Year's_Eve
+        """
+        return self._add_chinese_calendar_holiday(
+            name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=-2
+        )
+
     def _add_chinese_new_years_eve(self, name) -> Optional[date]:
         """
         Add Chinese New Year's Eve (last day of 12th lunar month).

holidays/groups/christian.py

@@ -116,7 +116,7 @@ class ChristianHolidays:
         """
         return self._add_holiday_nov_2(name)
 
-    def _add_ascension_thursday(self, name) -> date:
+    def _add_ascension_thursday(self, name, calendar=None) -> date:
         """
         Add Ascension Thursday (39 days after the Easter Sunday).
 
@@ -124,7 +124,7 @@ class ChristianHolidays:
         Day, or sometimes Holy Thursday.
         https://en.wikipedia.org/wiki/Feast_of_the_Ascension
         """
-        return self._add_holiday(name, _timedelta(self._easter_sunday, +39))
+        return self._add_holiday(name, _timedelta(self.__get_easter_sunday(calendar), +39))
 
     def _add_ash_monday(self, name) -> date:
         """
@@ -316,16 +316,16 @@ class ChristianHolidays:
         """
         return self._add_holiday(name, _timedelta(self.__get_easter_sunday(calendar), -2))
 
-    def _add_holy_saturday(self, name) -> date:
+    def _add_holy_saturday(self, name, calendar=None) -> date:
         """
         Add Holy Saturday (1 day before Easter Sunday).
 
         Great and Holy Saturday is a day between Good Friday and Easter Sunday.
         https://en.wikipedia.org/wiki/Holy_Saturday
         """
-        return self._add_holiday(name, _timedelta(self._easter_sunday, -1))
+        return self._add_holiday(name, _timedelta(self.__get_easter_sunday(calendar), -1))
 
-    def _add_holy_thursday(self, name) -> date:
+    def _add_holy_thursday(self, name, calendar=None) -> date:
         """
         Add Holy Thursday (3 days before Easter Sunday).
 
@@ -334,7 +334,7 @@ class ChristianHolidays:
         Jesus Christ with the Apostles, as described in the canonical gospels.
         https://en.wikipedia.org/wiki/Maundy_Thursday
         """
-        return self._add_holiday(name, _timedelta(self._easter_sunday, -3))
+        return self._add_holiday(name, _timedelta(self.__get_easter_sunday(calendar), -3))
 
     def _add_immaculate_conception_day(self, name) -> date:
         """
@@ -355,7 +355,7 @@ class ChristianHolidays:
         """
         return self._add_holiday_sep_8(name)
 
-    def _add_palm_sunday(self, name) -> date:
+    def _add_palm_sunday(self, name, calendar=None) -> date:
         """
         Add Palm Sunday (7 days before Easter Sunday).
 
@@ -365,7 +365,7 @@ class ChristianHolidays:
         Palm Sunday marks the first day of Holy Week.
         https://en.wikipedia.org/wiki/Palm_Sunday
         """
-        return self._add_holiday(name, _timedelta(self._easter_sunday, -7))
+        return self._add_holiday(name, _timedelta(self.__get_easter_sunday(calendar), -7))
 
     def _add_rejoicing_day(self, name) -> date:
         """
@@ -440,7 +440,7 @@ class ChristianHolidays:
         """
         return self._add_holiday(name, _timedelta(self._easter_sunday, +50))
 
-    def _add_whit_sunday(self, name) -> date:
+    def _add_whit_sunday(self, name, calendar=None) -> date:
         """
         Add Whit Sunday (49 days after Easter Sunday).
 
@@ -450,7 +450,7 @@ class ChristianHolidays:
         Feast of Weeks.
         https://en.wikipedia.org/wiki/Pentecost
         """
-        return self._add_holiday(name, _timedelta(self._easter_sunday, +49))
+        return self._add_holiday(name, _timedelta(self.__get_easter_sunday(calendar), +49))
 
     def _add_trinity_sunday(self, name) -> date:
         """

holidays/groups/eastern.py

@@ -29,7 +29,7 @@ class EasternCalendarHolidays:
         days_delta: int = 0,
     ) -> Optional[date]:
         """
-        Add Eastern (Buddhist, Chinese, Hindu, Islamic) calendar holiday.
+        Add Eastern (Buddhist, Chinese, Hindu, Islamic, Mongolian) calendar holiday.
 
         Adds customizable estimation label to holiday name if holiday date is an estimation.
         """

holidays/groups/hebrew.py

@@ -27,11 +27,11 @@ class HebrewCalendarHolidays:
         self._hebrew_calendar = _HebrewLunisolar()
 
     def _add_hebrew_calendar_holiday(
-        self, name: str, hol_date: date, days_delta: Union[int, Iterable[int]] = 0
+        self, name: str, holiday_date: date, days_delta: Union[int, Iterable[int]] = 0
     ) -> set[date]:
         added_dates = set()
         for delta in (days_delta,) if isinstance(days_delta, int) else days_delta:
-            if dt := self._add_holiday(name, _timedelta(hol_date, delta)):
+            if dt := self._add_holiday(name, _timedelta(holiday_date, delta)):
                 added_dates.add(dt)
         return added_dates
 

holidays/groups/islamic.py

@@ -373,6 +373,23 @@ class IslamicHolidays(EasternCalendarHolidays):
             name, self._islamic_calendar.nuzul_al_quran_dates(self._year)
         )
 
+    def _add_prophet_baptism_day(self, name) -> set[date]:
+        """
+        Add Prophet's Baptism.
+
+        Celebrated one week after the Prophet Mohammed's Birthday, this
+        marks the traditional Islamic birth rites that take place seven
+        days after birth. While it is not recognized in mainstream Islam,
+        Mali celebrates it as a cultural-religious public holiday that
+        reflects the local interpretation and honor of the Prophet Muhammad.
+        The term "baptism" is symbolic and not literal - there's no Islamic
+        ritual akin to Christian baptism.
+        https://www.officeholidays.com/holidays/mali/prophets-baptism
+        """
+        return self._add_islamic_calendar_holiday(
+            name, self._islamic_calendar.mawlid_dates(self._year), days_delta=+7
+        )
+
     def _add_prophet_death_day(self, name) -> set[date]:
         """
         Add death of Prophet Muhammad and Hasan ibn Ali day (28th day of 2nd month).

holidays/groups/mongolian.py

@@ -0,0 +1,103 @@
+#  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 CONTRIBUTORS 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 datetime import date
+from typing import Optional
+
+from holidays.calendars import _MongolianLunisolar
+from holidays.groups.eastern import EasternCalendarHolidays
+
+
+class MongolianCalendarHolidays(EasternCalendarHolidays):
+    """
+    Mongolian lunisolar calendar holidays.
+    """
+
+    def __init__(self, cls=None, show_estimated=False) -> None:
+        self._mongolian_calendar = cls() if cls else _MongolianLunisolar()
+        self._mongolian_calendar_show_estimated = show_estimated
+
+    def _add_mongolian_calendar_holiday(
+        self, name: str, dt_estimated: tuple[Optional[date], bool], days_delta: int = 0
+    ) -> Optional[date]:
+        """
+        Add Mongolian 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._mongolian_calendar_show_estimated, days_delta
+        )
+
+    def _add_buddha_day(self, name) -> Optional[date]:
+        """
+        Add Buddha Day.
+
+        Buddha Day is celebrated on the 15th day of the early summer month
+        in the Mongolian lunisolar calendar.
+        This holiday honors the birth, enlightenment, and death of Buddha.
+        https://en.wikipedia.org/wiki/Vesak (general Buddhist context)
+        """
+        return self._add_mongolian_calendar_holiday(
+            name, self._mongolian_calendar.buddha_day_date(self._year)
+        )
+
+    def _add_genghis_khan_day(self, name) -> Optional[date]:
+        """
+        Add Genghis Khan's Birthday.
+
+        Genghis Khan's Birthday is observed on the 1st day of the early winter month
+        according to the Mongolian lunisolar calendar.
+        It commemorates the birth of the founder of the Mongol Empire.
+        https://en.wikipedia.org/wiki/Genghis_Khan
+        """
+        return self._add_mongolian_calendar_holiday(
+            name, self._mongolian_calendar.genghis_khan_day_date(self._year)
+        )
+
+    def _add_tsagaan_sar(self, name) -> Optional[date]:
+        """
+        Add Tsagaan Sar (Mongolian Lunar New Year).
+
+        Tsagaan Sar, or White Moon Festival, marks the beginning of the Mongolian Lunar New Year.
+        It usually falls on the first day of the first month of the Mongolian lunisolar calendar.
+        https://en.wikipedia.org/wiki/Tsagaan_Sar
+        """
+        return self._add_mongolian_calendar_holiday(
+            name, self._mongolian_calendar.tsagaan_sar_date(self._year)
+        )
+
+    def _add_tsagaan_sar_day_2(self, name) -> Optional[date]:
+        """
+        Add Tsagaan Sar Day 2 (Mongolian Lunar New Year).
+
+        Tsagaan Sar, or White Moon Festival, marks the beginning of the Mongolian Lunar New Year.
+        It usually falls on the first day of the first month of the Mongolian lunisolar calendar.
+        https://en.wikipedia.org/wiki/Tsagaan_Sar
+        """
+        return self._add_mongolian_calendar_holiday(
+            name, self._mongolian_calendar.tsagaan_sar_date(self._year), days_delta=+1
+        )
+
+    def _add_tsagaan_sar_day_3(self, name) -> Optional[date]:
+        """
+        Add Tsagaan Sar Day 3 (Mongolian Lunar New Year).
+
+        Tsagaan Sar, or White Moon Festival, marks the beginning of the Mongolian Lunar New Year.
+        It usually falls on the first day of the first month of the Mongolian lunisolar calendar.
+        https://en.wikipedia.org/wiki/Tsagaan_Sar
+        """
+        return self._add_mongolian_calendar_holiday(
+            name, self._mongolian_calendar.tsagaan_sar_date(self._year), days_delta=+2
+        )

holidays/holiday_base.py

@@ -44,7 +44,7 @@ from holidays.constants import HOLIDAY_NAME_DELIMITER, PUBLIC, DEFAULT_START_YEA
 from holidays.helpers import _normalize_arguments, _normalize_tuple
 
 CategoryArg = Union[str, Iterable[str]]
-DateArg = Union[date, tuple[int, int]]
+DateArg = Union[date, tuple[int, int], tuple[int, int, int]]
 DateLike = Union[date, datetime, str, float, int]
 SpecialHoliday = Union[tuple[int, int, str], tuple[tuple[int, int, str], ...]]
 SubstitutedHoliday = Union[
@@ -348,11 +348,16 @@ class HolidayBase(dict[date, str]):
             if isinstance(subdiv, int):
                 subdiv = str(subdiv)
 
-            subdivisions_aliases = tuple(sorted(self.subdivisions_aliases))
+            subdivision_aliases = tuple(self.subdivisions_aliases)
+            supported_subdivisions = set(
+                self.subdivisions
+                + subdivision_aliases
+                + self._deprecated_subdivisions
+                + (self.parent_entity.subdivisions if self.parent_entity else ())
+            )
+
             # Unsupported subdivisions.
-            if not isinstance(self, HolidaySum) and subdiv not in (
-                self.subdivisions + subdivisions_aliases + self._deprecated_subdivisions
-            ):
+            if not isinstance(self, HolidaySum) and subdiv not in supported_subdivisions:
                 raise NotImplementedError(
                     f"Entity `{self._entity_code}` does not have subdivision {subdiv}"
                 )
@@ -371,7 +376,7 @@ class HolidayBase(dict[date, str]):
                     "Dec, 1 2023. The list of supported subdivisions: "
                     f"{', '.join(sorted(self.subdivisions))}; "
                     "the list of supported subdivisions aliases: "
-                    f"{', '.join(subdivisions_aliases)}.",
+                    f"{', '.join(sorted(subdivision_aliases))}.",
                     DeprecationWarning,
                 )