holidays 0.66__py3-none-any.whl → 0.68__py3-none-any.whl

holidays/countries/united_states.py

@@ -49,11 +49,36 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
     Frances Xavier Cabrini Day:
         - https://leg.colorado.gov/sites/default/files/2020a_1031_signed.pdf
 
-    Washington's Birthday (GA):
-        - https://www.gasupreme.us/court-information/holidays-2/
-
-    Washington's Birthday (IN):
-        - https://www.in.gov/spd/benefits/state-holidays/
+    Washington's Birthday:
+        - AK: https://doa.alaska.gov/calendar/
+        - AL: https://admincode.legislature.state.al.us/administrative-code/670-X-12-.01
+        - AR: https://arkleg.state.ar.us/Home/FTPDocument?path=/ACTS/2001/Public/ACT304.pdf
+        - AZ: https://www.azleg.gov/ars/1/00301.htm
+        - CA: https://www.sos.ca.gov/state-holidays
+        - CO: https://leg.colorado.gov/sites/default/files/images/olls/crs2023-title-24.pdf
+        - GA: https://www.gasupreme.us/court-information/holidays-2/
+        - HI: https://www.capitol.hawaii.gov/hrscurrent/Vol01_Ch0001-0042F/HRS0008/HRS_0008-0001.htm
+        - ID: https://idaho.gov/government/state-holidays/
+        - IN: https://digital.statelib.lib.in.us/infoexpress/holidays.aspx
+              https://www.in.gov/spd/benefits/state-holidays/
+        - MD: https://msa.maryland.gov/msa/mdmanual/01glance/html/holidayl.html
+        - MN: https://www.revisor.mn.gov/statutes/cite/645.44
+        - MT: https://archive.legmt.gov/bills/mca/title_0010/chapter_0010/part_0020/section_0160/0010-0010-0020-0160.html
+        - NJ: https://nj.gov/nj/about/facts/holidays/
+        - OH: https://codes.ohio.gov/ohio-revised-code/section-1.14
+        - OK: https://oklahoma.gov/omes/divisions/human-capital-management/employee-benefits/leave-holidays/holidays.html
+        - OR: https://www.oregonlegislature.gov/bills_laws/ors/ors187.html
+        - PA: https://www.legis.state.pa.us/WU01/LI/LI/US/PDF/1893/0/0138..PDF
+        - PR: https://en.wikipedia.org/wiki/Public_holidays_in_Puerto_Rico
+        - SC: https://www.scstatehouse.gov/code/t53c005.php
+        - TN: https://www.tn.gov/about-tn/state-holidays.html
+        - TX: https://www.tsl.texas.gov/ref/abouttx/holidays
+        - UT: https://le.utah.gov/xcode/Title63G/Chapter1/63G-1-S301.html
+        - VA: https://law.lis.virginia.gov/vacode/title2.2/chapter33/section2.2-3300/
+        - VT: https://legislature.vermont.gov/statutes/section/01/007/00371
+        - WA: https://app.leg.wa.gov/rcw/default.aspx?cite=1.16.050
+        - WV: https://code.wvlegislature.gov/2-2-1/
+        - WY: https://ai.wyo.gov/about-us/state-holidays-and-office-closures
 
     American Samoa holidays:
         - https://asbar.org/code-annotated/1-0501-public-holidays/
@@ -197,15 +222,38 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
 
         # Washington's Birthday
         if self._year >= 1879 and self.subdiv not in {
+            "AK",
             "AL",
             "AR",
+            "AZ",
+            "CA",
+            "CO",
             "DE",
             "FL",
             "GA",
+            "HI",
+            "ID",
             "IN",
+            "MD",
+            "MN",
+            "MT",
+            "NJ",
             "NM",
+            "OH",
+            "OK",
+            "OR",
+            "PA",
             "PR",
+            "SC",
+            "TN",
+            "TX",
+            "UT",
+            "VA",
             "VI",
+            "VT",
+            "WA",
+            "WV",
+            "WY",
         }:
             name = "Washington's Birthday"
             if self._year >= 1971:
@@ -246,6 +294,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         super()._populate_subdiv_holidays()
 
     def _populate_subdiv_ak_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # Seward's Day
         # No observance in 1921: https://chroniclingamerica.loc.gov/lccn/sn86072239/1922-03-29/ed-1/seq-8/
         if self._year >= 1918 and self._year != 1921:
@@ -327,11 +379,19 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         if self._year >= 1986:
             self._add_holiday_3rd_mon_of_jan("Dr. Martin Luther King Jr. / Civil Rights Day")
 
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Lincoln/Washington Presidents' Day")
+
     def _populate_subdiv_ca_public_holidays(self):
         # Lincoln's Birthday
         if 1971 <= self._year <= 2009:
             self._add_observed(self._add_holiday_feb_12("Lincoln's Birthday"))
 
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # Susan B. Anthony Day
         if self._year >= 2014:
             self._add_holiday_feb_15("Susan B. Anthony Day")
@@ -349,6 +409,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_holiday_1_day_past_4th_thu_of_nov("Day After Thanksgiving")
 
     def _populate_subdiv_co_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Washington-Lincoln Day")
+
         # Cesar Chavez Day
         if self._year >= 2001:
             self._add_holiday_mar_31("Cesar Chavez Day")
@@ -453,6 +517,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         self._add_immaculate_conception_day("Lady of Camarin Day")
 
     def _populate_subdiv_hi_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # Prince Jonah Kuhio Kalanianaole Day
         if self._year >= 1949:
             self._add_observed(self._add_holiday_mar_26("Prince Jonah Kuhio Kalanianaole Day"))
@@ -485,6 +553,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
                 else "Martin Luther King Jr. Day"
             )
 
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
     def _populate_subdiv_il_public_holidays(self):
         # Lincoln's Birthday
         if self._year >= 1971:
@@ -581,6 +653,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
                 rule=SUN_TO_NEXT_MON,
             )
 
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # American Indian Heritage Day
         if self._year >= 2008:
             self._add_holiday_1_day_past_4th_thu_of_nov("American Indian Heritage Day")
@@ -609,7 +685,9 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_observed(self._add_new_years_eve("New Year's Eve"))
 
     def _populate_subdiv_mn_public_holidays(self):
-        pass
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Washington's and Lincoln's Birthday")
 
     def _populate_subdiv_mo_public_holidays(self):
         # Truman Day
@@ -648,6 +726,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_holiday_last_mon_of_apr("Confederate Memorial Day")
 
     def _populate_subdiv_mt_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Lincoln's and Washington's Birthdays")
+
         # Election Day
         if self._year >= 2008 and self._year % 2 == 0:
             self._add_holiday_1_day_past_1st_mon_of_nov("Election Day")
@@ -711,6 +793,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         if self._year >= 1971:
             self._add_observed(self._add_holiday_feb_12("Lincoln's Birthday"))
 
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents Day")
+
         # Good Friday
         self._add_good_friday("Good Friday")
 
@@ -755,17 +841,29 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_holiday_1_day_past_1st_mon_of_nov("Election Day")
 
     def _populate_subdiv_oh_public_holidays(self):
-        pass
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Washington-Lincoln Day")
 
     def _populate_subdiv_ok_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # Day After Thanksgiving
         if self._year >= 1975:
             self._add_holiday_1_day_past_4th_thu_of_nov("Day After Thanksgiving")
 
     def _populate_subdiv_or_public_holidays(self):
-        pass
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents Day")
 
     def _populate_subdiv_pa_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # Day After Thanksgiving
         self._add_holiday_1_day_past_4th_thu_of_nov("Day After Thanksgiving")
 
@@ -800,6 +898,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             )
 
     def _populate_subdiv_sc_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("President's Day")
+
         # Confederate Memorial Day
         if self._year >= 1866:
             self._add_holiday_4th_mon_of_apr("Confederate Memorial Day")
@@ -814,6 +916,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
                 self._add_columbus_day(name)
 
     def _populate_subdiv_tn_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("President's Day")
+
         # Good Friday
         self._add_good_friday("Good Friday")
 
@@ -822,6 +928,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         if self._year >= 1931:
             self._add_holiday_jan_19("Confederate Memorial Day")
 
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # Texas Independence Day
         if self._year >= 1874:
             self._add_holiday_mar_2("Texas Independence Day")
@@ -861,6 +971,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         pass
 
     def _populate_subdiv_ut_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Washington and Lincoln Day")
+
         # Pioneer Day
         if self._year >= 1849:
             self._add_observed(self._add_holiday_jul_24("Pioneer Day"))
@@ -885,6 +999,11 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
                 else self._add_holiday_mar_4(name),
                 rule=SUN_TO_NEXT_MON,
             )
+
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("George Washington Day")
+
         # Indigenous Peoples' Day
         if self._year >= 1971:
             self._add_holiday_2nd_mon_of_oct(
@@ -932,6 +1051,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         self._add_christmas_day_two("Christmas Second Day")
 
     def _populate_subdiv_vt_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # Town Meeting Day
         if self._year >= 1800:
             self._add_holiday_1st_tue_of_mar("Town Meeting Day")
@@ -941,7 +1064,9 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_observed(self._add_holiday_aug_16("Bennington Battle Day"))
 
     def _populate_subdiv_wa_public_holidays(self):
-        pass
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
 
     def _populate_subdiv_wi_public_holidays(self):
         # Susan B. Anthony Day
@@ -956,6 +1081,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_observed(self._add_new_years_eve("New Year's Eve"))
 
     def _populate_subdiv_wv_public_holidays(self):
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+
         # West Virginia Day
         if self._year >= 1927:
             self._add_observed(self._add_holiday_jun_20("West Virginia Day"))
@@ -969,7 +1098,9 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_holiday_1_day_past_4th_thu_of_nov("Day After Thanksgiving")
 
     def _populate_subdiv_wy_public_holidays(self):
-        pass
+        # Washington's Birthday
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("President's Day")
 
     def _populate_unofficial_holidays(self):
         # Very common celebrated cultural days, but no official observance.

holidays/countries/uruguay.py

@@ -61,7 +61,7 @@ class Uruguay(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
             # Cry of Asencio.
             self._add_holiday_feb_28(tr("Grito de Asencio"))
 
-        # International Workers' Day.
+        # Workers' Day.
         dt = self._add_labor_day(tr("Día de los Trabajadores"))
         if self._year <= 1983:
             self._move_holiday(dt)

holidays/financial/brasil_bolsa_balcao.py

@@ -70,7 +70,7 @@ class BrasilBolsaBalcao(HolidayBase, ChristianHolidays, InternationalHolidays):
             self._add_holiday_apr_21(tr("Tiradentes"))
 
         if self._year >= 1925:
-            # Workers' Day.
+            # Worker's Day.
             self._add_labor_day(tr("Dia do Trabalhador"))
 
         # Corpus Christi.

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"),
@@ -163,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.66"
+__version__ = "0.68"

{holidays-0.66.dist-info → holidays-0.68.dist-info}/AUTHORS

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