holidays 0.76__py3-none-any.whl → 0.78__py3-none-any.whl

holidays/countries/united_states.py

@@ -351,8 +351,8 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             }
             # Thanksgiving Day.
             name = tr("Thanksgiving Day")
-            if self._year in thanksgiving_day_dates:
-                self._add_holiday(name, thanksgiving_day_dates[self._year])
+            if dt := thanksgiving_day_dates.get(self._year):
+                self._add_holiday(name, dt)
             elif self._year >= 1942:
                 self._add_holiday_4th_thu_of_nov(name)
             else:
@@ -994,7 +994,6 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             # Lincoln's Birthday.
             self._add_observed(self._add_holiday_feb_12(tr("Lincoln's Birthday")))
 
-        if self._year >= 1971:
             # Presidents Day.
             self._add_holiday_3rd_mon_of_feb(tr("Presidents Day"))
 
@@ -1176,7 +1175,6 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             # Christmas Eve.
             self._add_christmas_eve_holiday()
 
-        if self._year >= 1981:
             # Day After Christmas.
             self._add_christmas_day_two(tr("Day After Christmas"))
 
@@ -1217,7 +1215,6 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             # George Washington Day.
             self._add_holiday_3rd_mon_of_feb(tr("George Washington Day"))
 
-        if self._year >= 1971:
             self._add_holiday_2nd_mon_of_oct(
                 # Indigenous Peoples' Day.
                 tr("Indigenous Peoples' Day")

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/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

@@ -182,16 +182,6 @@ class IslamicHolidays(EasternCalendarHolidays):
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+2
         )
 
-    def _add_eid_al_fitr_day_four(self, name) -> set[date]:
-        """
-        Add Eid al-Fitr Day Four.
-
-        https://en.wikipedia.org/wiki/Eid_al-Fitr
-        """
-        return self._add_islamic_calendar_holiday(
-            name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+3
-        )
-
     def _add_eid_al_fitr_eve(self, name) -> set[date]:
         """
         Add Eid al-Fitr Eve (last day of 9th month of Islamic calendar).
@@ -373,6 +363,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/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[
@@ -55,57 +55,32 @@ YearArg = Union[int, Iterable[int]]
 
 
 class HolidayBase(dict[date, str]):
-    """
-    A `dict`-like object containing the holidays for a specific country (and
-    province or state if so initiated); inherits the `dict` class (so behaves
-    similarly to a `dict`). Dates without a key in the Holiday object are not
-    holidays.
-
-    The key of the object is the date of the holiday and the value is the name
-    of the holiday itself. When passing the date as a key, the date can be
-    expressed as one of the following formats:
-
-    * `datetime.datetime` type;
-    * `datetime.date` types;
-    * a `float` representing a Unix timestamp;
-    * or a string of any format (recognized by `dateutil.parser.parse()`).
-
-    The key is always returned as a `datetime.date` object.
-
-    To maximize speed, the list of holidays is built as needed on the fly, one
-    calendar year at a time. When you instantiate the object, it is empty, but
-    the moment a key is accessed it will build that entire year's list of
-    holidays. To pre-populate holidays, instantiate the class with the years
-    argument:
-
-        us_holidays = holidays.US(years=2020)
+    """Represent a dictionary-like collection of holidays for a specific country or region.
 
-    It is generally instantiated using the
-    [country_holidays()][holidays.utils.country_holidays] function.
+    This class inherits from `dict` and maps holiday dates to their names. It supports
+    customization by country and, optionally, by province or state (subdivision). A date
+    not present as a key is not considered a holiday (or, if `observed` is `False`, not
+    considered an observed holiday).
 
-    The key of the `dict`-like `HolidayBase` object is the
-    `date` of the holiday, and the value is the name of the holiday itself.
-    Dates where a key is not present are not public holidays (or, if
-    **observed** is False, days when a public holiday is observed).
+    Keys are holiday dates, and values are corresponding holiday names. When accessing or
+    assigning holidays by date, the following input formats are accepted:
 
-    When passing the `date` as a key, the `date` can be expressed in one of the
-    following types:
+    * `datetime.date`
+    * `datetime.datetime`
+    * `float` or `int` (Unix timestamp)
+    * `str` of any format recognized by `dateutil.parser.parse()`
 
-    * `datetime.date`,
-    * `datetime.datetime`,
-    * a `str` of any format recognized by `dateutil.parser.parse()`,
-    * or a `float` or `int` representing a POSIX timestamp.
+    Keys are always returned as `datetime.date` objects.
 
-    The key is always returned as a `datetime.date` object.
+    To maximize performance, the holiday list is lazily populated one year at a time.
+    On instantiation, the object is empty. Once a date is accessed, the full calendar
+    year for that date is generated, unless `expand` is set to `False`. To pre-populate
+    holidays, instantiate the class with the `years` argument:
 
-    To maximize speed, the list of public holidays is built on the fly as
-    needed, one calendar year at a time. When the object is instantiated
-    without a **years** parameter, it is empty, but, unless **expand** is set
-    to False, as soon as a key is accessed the class will calculate that entire
-    year's list of holidays and set the keys with them.
+        us_holidays = holidays.US(years=2020)
 
-    If you need to list the holidays as opposed to querying individual dates,
-    instantiate the class with the **years** parameter.
+    It is recommended to use the
+    [country_holidays()][holidays.utils.country_holidays] function for instantiation.
 
     Example usage:
 
@@ -163,14 +138,13 @@ class HolidayBase(dict[date, str]):
         >>> assert '2018-01-06' not in us_holidays
         >>> assert '2018-01-06' in us_pr_holidays
 
-    Append custom holiday dates by passing one of:
+    Append custom holiday dates by passing one of the following:
 
-    * a `dict` with date/name key/value pairs (e.g.
-      `{'2010-07-10': 'My birthday!'}`),
-    * a list of dates (as a `datetime.date`, `datetime.datetime`,
-      `str`, `int`, or `float`); `'Holiday'` will be used as a description,
-    * or a single date item (of one of the types above); `'Holiday'` will be
-      used as a description:
+    * A dict mapping date values to holiday names (e.g. `{'2010-07-10': 'My birthday!'}`).
+    * A list of date values (`datetime.date`, `datetime.datetime`, `str`, `int`, or `float`);
+      each will be added with 'Holiday' as the default name.
+    * A single date value of any of the supported types above; 'Holiday' will be used as
+      the default name.
 
     ```python
     >>> custom_holidays = country_holidays('US', years=2015)
@@ -325,7 +299,7 @@ class HolidayBase(dict[date, str]):
                 Requested holiday categories.
 
         Returns:
-            A `HolidayBase` object matching the **country** or **market**.
+            A `HolidayBase` object matching the `country` or `market`.
         """
         super().__init__()
 
@@ -436,10 +410,10 @@ class HolidayBase(dict[date, str]):
 
         The method supports the following input types:
 
-        * `datetime.date`,
-        * `datetime.datetime`,
-        * a `str` of any format recognized by `dateutil.parser.parse()`,
-        * or a `float` or `int` representing a POSIX timestamp.
+        * `datetime.date`
+        * `datetime.datetime`
+        * `float` or `int` (Unix timestamp)
+        * `str` of any format recognized by `dateutil.parser.parse()`
 
         Args:
             key:
@@ -617,10 +591,11 @@ class HolidayBase(dict[date, str]):
         """Convert various date-like formats to `datetime.date`.
 
         The method supports the following input types:
-        * `datetime.date`,
-        * `datetime.datetime`,
-        * a `str` of any format recognized by `dateutil.parser.parse()`,
-        * or a `float` or `int` representing a POSIX timestamp
+
+        * `datetime.date`
+        * `datetime.datetime`
+        * `float` or `int` (Unix timestamp)
+        * `str` of any format recognized by `dateutil.parser.parse()`
 
         Args:
             key:
@@ -816,9 +791,7 @@ class HolidayBase(dict[date, str]):
             self.tr = gettext
 
     def _is_leap_year(self) -> bool:
-        """
-        Returns True if the year is leap. Returns False otherwise.
-        """
+        """Returns True if the year is leap. Returns False otherwise."""
         return isleap(self._year)
 
     def _add_holiday(self, name: str, *args) -> Optional[date]:
@@ -899,12 +872,13 @@ class HolidayBase(dict[date, str]):
         return dt.weekday() in self.weekend
 
     def _populate(self, year: int) -> None:
-        """This is a private class that populates (generates and adds) holidays
+        """This is a private method that populates (generates and adds) holidays
         for a given year. To keep things fast, it assumes that no holidays for
         the year have already been populated. It is required to be called
-        internally by any country populate() method, while should not be called
+        internally by any country `populate()` method, while should not be called
         directly from outside.
-        To add holidays to an object, use the update() method.
+        To add holidays to an object, use the [update()][holidays.holiday_base.HolidayBase.update]
+        method.
 
         Args:
             year: The year to populate with holidays.
@@ -980,10 +954,10 @@ class HolidayBase(dict[date, str]):
             key:
                 The date expressed in one of the following types:
 
-                * `datetime.date`,
-                * `datetime.datetime`,
-                * a `str` of any format recognized by `dateutil.parser.parse()`,
-                * or a `float` or `int` representing a POSIX timestamp.
+                * `datetime.date`
+                * `datetime.datetime`
+                * `float` or `int` (Unix timestamp)
+                * `str` of any format recognized by `dateutil.parser.parse()`
 
             default:
                 The default value to return if no value is found.
@@ -1001,10 +975,10 @@ class HolidayBase(dict[date, str]):
             key:
                 The date expressed in one of the following types:
 
-                * `datetime.date`,
-                * `datetime.datetime`,
-                * a `str` of any format recognized by `dateutil.parser.parse()`,
-                * or a `float` or `int` representing a POSIX timestamp.
+                * `datetime.date`
+                * `datetime.datetime`
+                * `float` or `int` (Unix timestamp)
+                * `str` of any format recognized by `dateutil.parser.parse()`
 
         Returns:
             A list of holiday names if the date is a holiday, otherwise an empty list.
@@ -1116,6 +1090,7 @@ class HolidayBase(dict[date, str]):
         """Find the n-th working day from a given date.
 
         Moves forward if n is positive, or backward if n is negative.
+        If n is 0, returns the given date if it is a working day; otherwise the next working day.
 
         Args:
             key:
@@ -1128,10 +1103,11 @@ class HolidayBase(dict[date, str]):
         Returns:
             The calculated working day after shifting by n working days.
         """
-        direction = +1 if n > 0 else -1
+        direction = +1 if n >= 0 else -1
         dt = self.__keytransform__(key)
-        for _ in range(abs(n)):
-            dt = _timedelta(dt, direction)
+        for _ in range(abs(n) or 1):
+            if n:
+                dt = _timedelta(dt, direction)
             while not self.is_working_day(dt):
                 dt = _timedelta(dt, direction)
         return dt
@@ -1183,10 +1159,10 @@ class HolidayBase(dict[date, str]):
             key:
                 The date expressed in one of the following types:
 
-                * `datetime.date`,
-                * `datetime.datetime`,
-                * a `str` of any format recognized by `dateutil.parser.parse()`,
-                * or a `float` or `int` representing a POSIX timestamp.
+                * `datetime.date`
+                * `datetime.datetime`
+                * `float` or `int` (Unix timestamp)
+                * `str` of any format recognized by `dateutil.parser.parse()`
 
             default:
                 The default value to return if no match is found.
@@ -1290,10 +1266,10 @@ class HolidayBase(dict[date, str]):
 
                 Dates can be expressed in one or more of the following types:
 
-                * `datetime.date`,
-                * `datetime.datetime`,
-                * a `str` of any format recognized by `dateutil.parser.parse()`,
-                * or a `float` or `int` representing a POSIX timestamp.
+                * `datetime.date`
+                * `datetime.datetime`
+                * `float` or `int` (Unix timestamp)
+                * `str` of any format recognized by `dateutil.parser.parse()`
         """
         for arg in args:
             if isinstance(arg, dict):
@@ -1308,12 +1284,17 @@ class HolidayBase(dict[date, str]):
 
 class HolidaySum(HolidayBase):
     """
-    Returns a `dict`-like object resulting from the addition of two or
-    more individual dictionaries of public holidays. The original dictionaries
-    are available as a `list` in the attribute `holidays,` and
-    `country` and `subdiv` attributes are added
-    together and could become `list` s. Holiday names, when different,
-    are merged. All years are calculated (expanded) for all operands.
+    Combine multiple holiday collections into a single dictionary-like object.
+
+    This class represents the sum of two or more `HolidayBase` instances.
+    The resulting object behaves like a dictionary mapping dates to holiday
+    names, with the following behaviors:
+
+    * The `holidays` attribute stores the original holiday collections as a list.
+    * The `country` and `subdiv` attributes are combined from all operands and
+      may become lists.
+    * If multiple holidays fall on the same date, their names are merged.
+    * Holidays are generated (expanded) for all years included in the operands.
     """
 
     country: Union[str, list[str]]  # type: ignore[assignment]

holidays/observed_holiday_base.py

@@ -151,7 +151,9 @@ class ObservedHolidayBase(HolidayBase):
         if dt is None:
             return False, None
 
-        dt = dt if isinstance(dt, date) else date(self._year, *dt)
+        # Use as is if already a date.
+        # Convert to date: (m, d) → use self._year; (y, m, d) → use directly.
+        dt = dt if isinstance(dt, date) else date(self._year, *dt) if len(dt) == 2 else date(*dt)
 
         if not self.observed or not self._is_observed(dt):
             return False, dt