holidays 0.85__py3-none-any.whl → 0.86__py3-none-any.whl

holidays/countries/mongolia.py

@@ -12,7 +12,6 @@
 
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import _timedelta
 from holidays.constants import PUBLIC, WORKDAY
 from holidays.groups import InternationalHolidays, MongolianCalendarHolidays
 from holidays.holiday_base import HolidayBase
@@ -160,10 +159,7 @@ class Mongolia(HolidayBase, InternationalHolidays, MongolianCalendarHolidays):
 
         if self._year >= 2007:
             # New Harvest Days.
-            name = tr("Шинэ ургацын өдрүүд")
-            dt = self._add_holiday_sep_5(name)
-            for delta in range(1, 46):
-                self._add_holiday(name, _timedelta(dt, delta))
+            self._add_multiday_holiday(self._add_holiday_sep_5(tr("Шинэ ургацын өдрүүд")), 45)
 
         # Memorial Day of Political Victims.
         self._add_holiday_sep_10(tr("Улс төрийн хэлмэгдэгсдийн дурсгалын өдөр"))

holidays/countries/nepal.py

@@ -10,6 +10,8 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from gettext import gettext as tr
+
 from holidays.calendars import _CustomIslamicHolidays, _CustomHinduHolidays
 from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, AUG, SEP, OCT, NOV
 from holidays.constants import PUBLIC, WORKDAY
@@ -47,10 +49,12 @@ class Nepal(
     """
 
     country = "NP"
+    default_language = "ne"
     # %s (estimated).
-    estimated_label = "%s (estimated)"
+    estimated_label = tr("%s (अनुमानित)")
     start_year = 2010
     supported_categories = (PUBLIC, WORKDAY)
+    supported_languages = ("en_US", "ne")
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
         """
@@ -105,7 +109,7 @@ class Nepal(
             }
             if dt := martyrs_day_dates.get(self._year):
                 # Martyr's Day.
-                self._add_holiday("Martyr's Day", dt)
+                self._add_holiday(tr("शहीद दिवस"), dt)
 
             democracy_day_dates = {
                 2010: (FEB, 19),
@@ -135,7 +139,7 @@ class Nepal(
             }
             if dt := democracy_day_dates.get(self._year):
                 # National Democracy Day.
-                self._add_holiday("National Democracy Day", dt)
+                self._add_holiday(tr("राष्ट्रिय प्रजातन्त्र दिवस"), dt)
 
             republic_day_dates = {
                 2010: (MAY, 29),
@@ -164,39 +168,40 @@ class Nepal(
             }
             if dt := republic_day_dates.get(self._year):
                 # Established in 2009.
+
                 # Republic Day.
-                self._add_holiday("Republic Day", dt)
+                self._add_holiday(tr("गणतन्त्र दिवस"), dt)
 
             # Hindu Holidays.
 
             # Ram Navami.
-            self._add_ram_navami("Ram Navami")
+            self._add_ram_navami(tr("राम नवमी"))
 
             # Janai Poornima.
-            self._add_raksha_bandhan("Janai Poornima")
+            self._add_raksha_bandhan(tr("जनै पूर्णिमा"))
 
             # Shree Krishna Janmashtami.
-            self._add_janmashtami("Shree Krishna Janmashtami")
+            self._add_janmashtami(tr("श्रीकृष्ण जन्माष्टमी"))
 
             # Ghatasthapana.
-            self._add_sharad_navratri("Ghatasthapana")
+            self._add_sharad_navratri(tr("घटस्थापना"))
 
             # Duwadashi (Dashain).
-            self._add_papankusha_duwadashi("Duwadashi (Dashain)")
+            self._add_papankusha_duwadashi(tr("दुवादशी (दशैं)"))
 
     def _populate_public_holidays(self):
         if self._year >= 2023:
             # Prithvi Jayanti.
-            self._add_holiday_jan_11("Prithvi Jayanti")
+            self._add_holiday_jan_11(tr("पृथ्वी जयन्ती"))
 
         # International Women's Day.
-        self._add_womens_day("International Women's Day")
+        self._add_womens_day(tr("अन्तर्राष्ट्रिय महिला दिवस"))
 
-        # Nepal New Year.
-        self._add_vaisakhi("Nepali New Year")
+        # Nepali New Year.
+        self._add_vaisakhi(tr("नेपाली नयाँ वर्ष"))
 
-        # International Labour Day.
-        self._add_labor_day("International Labour Day")
+        # International Labor Day.
+        self._add_labor_day(tr("अन्तर्राष्ट्रिय श्रम दिवस"))
 
         constitution_day_dates = {
             2016: (SEP, 19),
@@ -219,77 +224,77 @@ class Nepal(
         }
         if dt := constitution_day_dates.get(self._year):
             # Constitution Day.
-            self._add_holiday("Constitution Day", dt)
+            self._add_holiday(tr("संविधान दिवस"), dt)
 
         # Christmas Day.
-        self._add_christmas_day("Christmas Day")
+        self._add_christmas_day(tr("क्रिसमसको दिन"))
 
         # Hindu holidays.
 
         # Maghe Sankranti.
-        self._add_makar_sankranti("Maghe Sankranti")
+        self._add_makar_sankranti(tr("माघे संक्रान्ति"))
 
         # Sonam Lhochhar.
-        self._add_sonam_losar("Sonam Lhochhar")
+        self._add_sonam_losar(tr("सोनम ल्होछार"))
 
         # Maha Shivaratri.
-        self._add_maha_shivaratri("Maha Shivaratri")
+        self._add_maha_shivaratri(tr("महाशिवरात्रि"))
 
         # Gyalpo Lhosar.
-        self._add_gyalpo_losar("Gyalpo Lhosar")
+        self._add_gyalpo_losar(tr("ग्याल्पो ल्होसार"))
 
         # Fagu Poornima.
-        self._add_nepal_holi("Fagu Poornima")
+        self._add_nepal_holi(tr("फागुपुर्णिमा"))
 
         # Fagu Poornima (Terai).
-        self._add_holi("Fagu Poornima (Terai)")
+        self._add_holi(tr("फागुपूर्णिमा (तराई)"))
 
         # Buddha Jayanti.
-        self._add_buddha_purnima("Buddha Jayanti")
+        self._add_buddha_purnima(tr("बुद्ध जयन्ती"))
 
         # Fulpati.
-        self._add_maha_saptami("Fulpati")
+        self._add_maha_saptami(tr("फुलपाती"))
 
         # Maha Ashtami.
-        self._add_maha_ashtami("Maha Ashtami")
+        self._add_maha_ashtami(tr("महा अष्टमी"))
 
         # Maha Navami.
-        self._add_maha_navami("Maha Navami")
+        self._add_maha_navami(tr("महा नवमी"))
 
         # Bijaya Dashami.
-        self._add_dussehra("Bijaya Dashami")
+        self._add_dussehra(tr("विजया दशमी"))
 
         # Ekadashi (Dashain).
-        self._add_papankusha_ekadashi("Ekadashi (Dashain)")
+        self._add_papankusha_ekadashi(tr("एकादशी (दशैं)"))
 
         # Laxmi Pooja.
-        self._add_diwali_india("Laxmi Pooja")
+        self._add_diwali_india(tr("लक्ष्मी पुजा"))
 
         # Gai Tihar.
-        self._add_gau_krida("Gai Tihar")
+        self._add_gau_krida(tr("गाई तिहार"))
 
         # Gobardhan Pooja.
-        self._add_govardhan_puja("Gobardhan Pooja")
+        self._add_govardhan_puja(tr("गोवर्धन पूजा"))
 
         # Mha Pooja.
-        self._add_govardhan_puja("Mha Pooja")
+        self._add_govardhan_puja(tr("म्ह पूजा"))
 
         # Bhai Tika.
-        self._add_bhai_dooj("Bhai Tika")
+        self._add_bhai_dooj(tr("भाइटीका"))
 
         # Chhath Parva.
-        self._add_chhath_puja("Chhath Parva")
+        self._add_chhath_puja(tr("छठ पर्व"))
 
         # Tamu Lhochhar.
-        self._add_tamu_losar("Tamu Lhochhar")
+        self._add_tamu_losar(tr("तमु ल्हाेसार"))
 
         # Islamic holidays.
 
         # Eid al-Fitr.
-        self._add_eid_al_fitr_day("Id-ul-Fitr")
+        self._add_eid_al_fitr_day(tr("इद उल फित्र"))
 
         # Eid al-Adha.
-        self._add_eid_al_adha_day("Bakrid")
+        self._add_eid_al_adha_day(tr("बकरीद"))
 
         # Removed by MoHA between 2019-2020.
         self._add_non_continuous_holidays()
@@ -398,10 +403,10 @@ class NepalStaticHolidays:
     """
 
     # Day of National Mourning.
-    name_day_of_national_mourning = "Day of National Mourning"
+    name_day_of_national_mourning = tr("राष्ट्रिय शोक दिवस")
 
     # Tihar Holiday.
-    name_tihar_holiday = "Tihar Holiday"
+    name_tihar_holiday = tr("तिहार बिदा")
 
     special_public_holidays = {
         2011: (MAR, 6, name_day_of_national_mourning),
@@ -411,7 +416,7 @@ class NepalStaticHolidays:
         2023: (
             (JAN, 16, name_day_of_national_mourning),
             # People War's Day.
-            (FEB, 13, "People War's Day"),
+            (FEB, 13, tr("जनयुद्ध दिवस")),
             (SEP, 14, name_day_of_national_mourning),
             (NOV, 16, name_tihar_holiday),
         ),

holidays/countries/russia.py

@@ -47,8 +47,7 @@ class Russia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
         else:
             # New Year Holidays.
             name = tr("Новогодние каникулы")
-            for day in range(1, 6):
-                self._add_holiday(name, JAN, day)
+            self._add_multiday_holiday(self._add_new_years_day(name), 4)
             if self._year >= 2013:
                 self._add_holiday_jan_6(name)
                 self._add_holiday_jan_8(name)

holidays/countries/sweden.py

@@ -10,9 +10,17 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from datetime import date
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import _timedelta, _get_all_sundays
+from holidays.calendars.gregorian import (
+    MAR,
+    SUN,
+    _get_all_sundays,
+    _get_nth_weekday_from,
+    _timedelta,
+)
+from holidays.constants import BANK, OPTIONAL, PUBLIC
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -22,21 +30,25 @@ class Sweden(HolidayBase, ChristianHolidays, InternationalHolidays):
 
     References:
         * <https://sv.wikipedia.org/wiki/Helgdagar_i_Sverige>
-        * <https://web.archive.org/web/20250414065223/https://www.riksdagen.se/sv/dokument-lagar/dokument/svensk-forfattningssamling/lag-1989253-om-allmanna-helgdagar_sfs-1989-253>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Sweden>
+        * [Act 1952:48](https://web.archive.org/web/20250518071409/https://blogs.loc.gov/law/2023/06/midsommar-becomes-weekend-holiday-in-sweden-in-1953-pic-of-the-week/)
+        * [Act 1989:253](https://web.archive.org/web/20250414065223/https://www.riksdagen.se/sv/dokument-lagar/dokument/svensk-forfattningssamling/lag-1989253-om-allmanna-helgdagar_sfs-1989-253)
         * <https://sv.wikipedia.org/wiki/Första_maj>
         * <https://sv.wikipedia.org/wiki/Sveriges_nationaldag>
         * <https://sv.wikipedia.org/wiki/Midsommarafton>
-
-
-    Note that holidays falling on a sunday is "lost", it will not be moved
-    to another day to make up for the collision.
+        * [Bank Holidays 2025](https://web.archive.org/web/20250811112642/https://www.riksbank.se/sv/press-och-publicerat/kalender/helgdagar-2025/)
 
     In Sweden, ALL sundays are considered a holiday.
     Initialize this class with `include_sundays=False` to not include sundays as a holiday.
     """
 
+    # %s (from 2pm).
+    begin_time_label = tr("%s (från kl. 14.00)")
     country = "SE"
     default_language = "sv"
+    # Act 1952:48.
+    start_year = 1953
+    supported_categories = (BANK, OPTIONAL, PUBLIC)
     supported_languages = ("en_US", "sv", "th", "uk")
 
     def __init__(self, *args, include_sundays: bool = True, **kwargs):
@@ -57,9 +69,18 @@ class Sweden(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Epiphany.
         self._add_epiphany_day(tr("Trettondedag jul"))
 
-        if self._year <= 1953:
-            # Feast of the Annunciation.
-            self._add_holiday_mar_25(tr("Jungfru Marie bebådelsedag"))
+        if self._year <= 1989:
+            # According to Act 1952:48, Feast of the Annunciation is
+            # "on the Sunday between March 22 and 28 or, if this Sunday is Palm Sunday
+            # or Easter Sunday, on the Sunday before Palm Sunday".
+            dt = _get_nth_weekday_from(1, SUN, date(self._year, MAR, 22))
+            self._add_holiday(
+                # Feast of the Annunciation.
+                tr("Marie bebådelsedag"),
+                _timedelta(self._easter_sunday, -14)
+                if dt == _timedelta(self._easter_sunday, -7) or dt == self._easter_sunday
+                else dt,
+            )
 
         # Good Friday.
         self._add_good_friday(tr("Långfredagen"))
@@ -70,16 +91,15 @@ class Sweden(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Easter Monday.
         self._add_easter_monday(tr("Annandag påsk"))
 
-        if self._year >= 1939:
-            # May Day.
-            self._add_labor_day(tr("Första maj"))
+        # May Day.
+        self._add_labor_day(tr("Första maj"))
 
         # Ascension Day.
         self._add_ascension_thursday(tr("Kristi himmelsfärdsdag"))
 
         if self._year >= 2005:
-            # National Day of Sweden.
-            self._add_holiday_jun_6(tr("Sveriges nationaldag"))
+            # National Day.
+            self._add_holiday_jun_6(tr("Nationaldagen"))
 
         # Whit Sunday.
         self._add_whit_sunday(tr("Pingstdagen"))
@@ -88,23 +108,11 @@ class Sweden(HolidayBase, ChristianHolidays, InternationalHolidays):
             # Whit Monday.
             self._add_whit_monday(tr("Annandag pingst"))
 
-        # Midsummer Eve.
-        name = tr("Midsommarafton")
-        dt = (
-            self._add_holiday_1st_fri_from_jun_19(name)
-            if self._year >= 1953
-            else self._add_holiday_jun_23(name)
-        )
-
         # Midsummer Day.
-        self._add_holiday(tr("Midsommardagen"), _timedelta(dt, +1))
+        self._add_holiday_1st_sat_from_jun_20(tr("Midsommardagen"))
 
-        if self._year >= 1953:
-            # All Saints' Day.
-            self._add_holiday_1st_sat_from_oct_31(tr("Alla helgons dag"))
-
-        # Christmas Eve.
-        self._add_christmas_eve(tr("Julafton"))
+        # All Saints' Day.
+        self._add_holiday_1st_sat_from_oct_31(tr("Alla helgons dag"))
 
         # Christmas Day.
         self._add_christmas_day(tr("Juldagen"))
@@ -112,15 +120,77 @@ class Sweden(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Second Day of Christmas.
         self._add_christmas_day_two(tr("Annandag jul"))
 
-        # New Year's Eve.
-        self._add_new_years_eve(tr("Nyårsafton"))
-
         # Optionally add all Sundays of the year.
         if self.include_sundays:
             for dt in _get_all_sundays(self._year):
                 # Sunday.
                 self._add_holiday(tr("Söndag"), dt)
 
+    def _populate_common(self):
+        """Populate holidays that are both optional and bank holidays."""
+
+        # Twelfth Night.
+        self._add_holiday_jan_5(self.tr(self.begin_time_label) % self.tr("Trettondagsafton"))
+
+        # Maundy Thursday.
+        self._add_holy_thursday(self.tr(self.begin_time_label) % self.tr("Skärtorsdagen"))
+
+        # Walpurgis Night.
+        self._add_holiday_apr_30(self.tr(self.begin_time_label) % self.tr("Valborgsmässoafton"))
+
+        # Midsummer Eve.
+        self._add_holiday_1st_fri_from_jun_19(tr("Midsommarafton"))
+
+        self._add_holiday_1st_fri_from_oct_30(
+            # All Saints' Eve.
+            self.tr(self.begin_time_label) % self.tr("Allahelgonsafton")
+        )
+
+        # Christmas Eve.
+        self._add_christmas_eve(tr("Julafton"))
+
+        # New Year's Eve.
+        self._add_new_years_eve(tr("Nyårsafton"))
+
+    def _populate_bank_holidays(self):
+        self._populate_common()
+
+        self._add_holiday_38_days_past_easter(
+            # Day before Ascension Day.
+            self.tr(self.begin_time_label) % self.tr("Dag före Kristi himmelsfärdsdag")
+        )
+
+        self._add_holiday_1st_thu_from_jun_18(
+            # Day before Midsummer Eve.
+            self.tr(self.begin_time_label) % self.tr("Dag före Midsommarafton")
+        )
+
+        self._add_holiday_47_days_past_easter(
+            # Day before Whitsun Eve.
+            self.tr(self.begin_time_label) % self.tr("Dag före Pingstafton")
+        )
+
+        # Day before Christmas Eve.
+        self._add_holiday_dec_23(self.tr(self.begin_time_label) % self.tr("Dag före Julafton"))
+
+        # Day before New Year's Eve.
+        self._add_holiday_dec_30(self.tr(self.begin_time_label) % self.tr("Dag före Nyårsafton"))
+
+    def _populate_optional_holidays(self):
+        self._populate_common()
+
+        # Holy Saturday.
+        self._add_holy_saturday(tr("Påskafton"))
+
+        # Days between a holiday and a weekend are in Swedish called "klämdagar" (squeeze days).
+        # There is one permanent "klämdag" every year - Friday after Ascension Day.
+
+        # Squeeze day.
+        self._add_holiday_40_days_past_easter(tr("Klämdag"))
+
+        # Whitsun Eve.
+        self._add_holiday_48_days_past_easter(tr("Pingstafton"))
+
 
 class SE(Sweden):
     pass

holidays/countries/taiwan.py

@@ -32,7 +32,6 @@ from holidays.calendars.gregorian import (
     FRI,
     SAT,
     SUN,
-    _get_nth_weekday_of_month,
 )
 from holidays.constants import GOVERNMENT, OPTIONAL, PUBLIC, SCHOOL, WORKDAY
 from holidays.groups import ChineseCalendarHolidays, InternationalHolidays, StaticHolidays
@@ -101,10 +100,8 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
         if dt.year <= 2000:
             weekend = {SUN}
             if dt.weekday() == SAT:
-                if dt in {
-                    _get_nth_weekday_of_month(2, SAT, dt.month, dt.year),  # 2nd Saturday.
-                    _get_nth_weekday_of_month(4, SAT, dt.month, dt.year),  # 4th Saturday.
-                }:
+                nth_saturday = (dt.day - 1) // 7 + 1  # Saturday number in the month.
+                if nth_saturday in {2, 4}:
                     weekend.add(SAT)
         else:
             weekend = {SAT, SUN}
@@ -348,7 +345,7 @@ class TaiwanStaticHolidays:
     substituted_date_format = tr("%Y-%m-%d")
 
     # Day off (substituted from %s).
-    substituted_label = tr("休息日（%s日起取代）")
+    substituted_label = tr("放假日（%s 補班）")
 
     # Women's Day.
     womens_day = tr("婦女節")

holidays/countries/thailand.py

@@ -322,11 +322,11 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
                 if self._year <= 1937:
                     self._add_holiday_apr_3(name)
             elif self._year <= 1925:
-                # Songkran New Year Holidays.
-                name = tr("พระราชพิธีตะรุษะสงกรานต์ แลนักขัตฤกษ์")
-                dt = self._add_holiday_mar_28(name)
-                for delta in range(1, 19):
-                    self._add_holiday(name, _timedelta(dt, delta))
+                self._add_multiday_holiday(
+                    # Songkran New Year Holidays.
+                    self._add_holiday_mar_28(tr("พระราชพิธีตะรุษะสงกรานต์ แลนักขัตฤกษ์")),
+                    18,
+                )
             else:
                 dt = self._add_holiday_apr_13(name)
                 self._add_holiday_apr_14(name)

holidays/holiday_base.py

@@ -46,6 +46,7 @@ from holidays.helpers import _normalize_arguments, _normalize_tuple
 CategoryArg = str | Iterable[str]
 DateArg = date | tuple[int, int] | tuple[int, int, int]
 DateLike = date | datetime | str | float | int
+NameLookup = Literal["contains", "exact", "startswith", "icontains", "iexact", "istartswith"]
 SpecialHoliday = tuple[int, int, str] | tuple[tuple[int, int, str], ...]
 SubstitutedHoliday = (
     tuple[int, int, int, int]
@@ -558,27 +559,25 @@ class HolidayBase(dict[date, str]):
 
             if key.step is None:
                 step = 1
-            elif isinstance(key.step, timedelta):
-                step = key.step.days
             elif isinstance(key.step, int):
                 step = key.step
+            elif isinstance(key.step, timedelta):
+                step = key.step.days
             else:
                 raise TypeError(f"Cannot convert type '{type(key.step)}' to int.")
 
             if step == 0:
                 raise ValueError("Step value must not be zero.")
 
-            date_diff = stop - start
-            if date_diff.days < 0 <= step or date_diff.days >= 0 > step:
-                step *= -1
-
-            days_in_range = []
-            for delta_days in range(0, date_diff.days, step):
-                day = _timedelta(start, delta_days)
-                if day in self:
-                    days_in_range.append(day)
+            diff_days = (stop - start).days
+            if diff_days < 0 <= step or diff_days >= 0 > step:
+                step = -step
 
-            return days_in_range
+            return [
+                day
+                for delta_days in range(0, diff_days, step)
+                if (day := _timedelta(start, delta_days)) in self
+            ]
 
         return dict.__getitem__(self, self.__keytransform__(key))
 
@@ -670,19 +669,14 @@ class HolidayBase(dict[date, str]):
         if self:
             return super().__repr__()
 
-        parts = []
         if hasattr(self, "market"):
-            parts.append(f"holidays.financial_holidays({self.market!r}")
-            parts.append(")")
+            return f"holidays.financial_holidays({self.market!r})"
         elif hasattr(self, "country"):
-            parts.append(f"holidays.country_holidays({self.country!r}")
             if self.subdiv:
-                parts.append(f", subdiv={self.subdiv!r}")
-            parts.append(")")
-        else:
-            parts.append("holidays.HolidayBase()")
+                return f"holidays.country_holidays({self.country!r}, subdiv={self.subdiv!r})"
+            return f"holidays.country_holidays({self.country!r})"
 
-        return "".join(parts)
+        return "holidays.HolidayBase()"
 
     def __setattr__(self, key: str, value: Any) -> None:
         dict.__setattr__(self, key, value)
@@ -809,6 +803,37 @@ class HolidayBase(dict[date, str]):
         self[dt] = self.tr(name)
         return dt
 
+    def _add_multiday_holiday(
+        self, start_date: date, duration_days: int, *, name: str | None = None
+    ) -> set[date]:
+        """Add a multi-day holiday.
+
+        Args:
+            start_date:
+                First day of the holiday.
+
+            duration_days:
+                Number of additional days to add.
+
+            name:
+                Optional holiday name; inferred from `start_date` if omitted.
+
+        Returns:
+            A set of all added holiday dates.
+
+        Raises:
+            ValueError:
+                If the holiday name cannot be inferred from `start_date`.
+        """
+        if (holiday_name := name or self.get(start_date)) is None:
+            raise ValueError(f"Cannot infer holiday name for date {start_date!r}.")
+
+        return {
+            d
+            for delta in range(1, duration_days + 1)
+            if (d := self._add_holiday(holiday_name, _timedelta(start_date, delta)))
+        }
+
     def _add_special_holidays(self, mapping_names, *, observed=False):
         """Add special holidays."""
         for mapping_name in mapping_names:
@@ -997,7 +1022,10 @@ class HolidayBase(dict[date, str]):
         return [name for name in self.get(key, "").split(HOLIDAY_NAME_DELIMITER) if name]
 
     def get_named(
-        self, holiday_name: str, lookup: str = "icontains", split_multiple_names: bool = True
+        self,
+        holiday_name: str,
+        lookup: NameLookup = "icontains",
+        split_multiple_names: bool = True,
     ) -> list[date]:
         """Find all holiday dates matching a given name.
 
@@ -1202,7 +1230,7 @@ class HolidayBase(dict[date, str]):
 
         return dict.pop(self, self.__keytransform__(key), default)
 
-    def pop_named(self, holiday_name: str, lookup: str = "icontains") -> list[date]:
+    def pop_named(self, holiday_name: str, lookup: NameLookup = "icontains") -> list[date]:
         """Remove all holidays matching the given name.
 
         This method removes all dates associated with a holiday name, so they are