holidays 0.53__py3-none-any.whl → 0.55__py3-none-any.whl

holidays/__init__.py

@@ -23,7 +23,7 @@ from holidays.holiday_base import *
 from holidays.registry import EntityLoader
 from holidays.utils import *
 
-__version__ = "0.53"
+__version__ = "0.55"
 
 
 EntityLoader.load("countries", globals())

holidays/countries/__init__.py

@@ -101,6 +101,7 @@ from .malaysia import Malaysia, MY, MYS
 from .maldives import Maldives, MV, MDV
 from .malta import Malta, MT, MLT
 from .marshall_islands import MarshallIslands, MH, MHL, HolidaysMH
+from .mauritania import Mauritania, MR, MRT
 from .mexico import Mexico, MX, MEX
 from .moldova import Moldova, MD, MDA
 from .monaco import Monaco, MC, MCO
@@ -127,6 +128,7 @@ from .portugal import Portugal, PT, PRT
 from .puerto_rico import PuertoRico, PR, PRI, HolidaysPR
 from .romania import Romania, RO, ROU
 from .russia import Russia, RU, RUS
+from .samoa import Samoa, WS, WSM
 from .san_marino import SanMarino, SM, SMR
 from .saudi_arabia import SaudiArabia, SA, SAU
 from .serbia import Serbia, RS, SRB

holidays/countries/algeria.py

@@ -12,6 +12,7 @@
 
 from gettext import gettext as tr
 
+from holidays.calendars.gregorian import THU, FRI, SAT, SUN
 from holidays.groups import InternationalHolidays, IslamicHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -38,6 +39,16 @@ class Algeria(HolidayBase, InternationalHolidays, IslamicHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        # The resting days are Friday and Saturday since 2009.
+        # Previously, these were on Thursday and Friday as implemented in 1976.
+        # https://www.thenationalnews.com/mena/2021/12/07/when-is-the-weekend-in-the-arab-world/
+        if self._year >= 2009:
+            self.weekend = {FRI, SAT}
+        elif self._year >= 1976:
+            self.weekend = {THU, FRI}
+        else:
+            self.weekend = {SAT, SUN}
+
         # New Year's Day.
         self._add_new_years_day(tr("رأس السنة الميلادية"))
 

holidays/countries/bangladesh.py

@@ -10,6 +10,7 @@
 #  Website: https://github.com/vacanza/python-holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.calendars.gregorian import FRI, SAT
 from holidays.groups import InternationalHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -22,6 +23,7 @@ class Bangladesh(HolidayBase, InternationalHolidays):
     """
 
     country = "BD"
+    weekend = {FRI, SAT}
 
     def __init__(self, *args, **kwargs):
         InternationalHolidays.__init__(self)

holidays/countries/brunei.py

@@ -13,7 +13,22 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
-from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
+from holidays.calendars.gregorian import (
+    JAN,
+    FEB,
+    MAR,
+    APR,
+    MAY,
+    JUN,
+    JUL,
+    AUG,
+    SEP,
+    OCT,
+    NOV,
+    DEC,
+    FRI,
+    SUN,
+)
 from holidays.groups import (
     ChineseCalendarHolidays,
     ChristianHolidays,
@@ -75,6 +90,7 @@ class Brunei(
     # %s (observed, estimated).
     observed_estimated_label = tr("%s (diperhatikan, anggaran)")
     supported_languages = ("en_US", "ms", "th")
+    weekend = {FRI, SUN}
 
     def __init__(self, *args, **kwargs):
         ChineseCalendarHolidays.__init__(self)

holidays/countries/egypt.py

@@ -12,6 +12,7 @@
 
 from gettext import gettext as tr
 
+from holidays.calendars.gregorian import FRI, SAT
 from holidays.calendars.julian import JULIAN_CALENDAR
 from holidays.groups import ChristianHolidays, IslamicHolidays, InternationalHolidays
 from holidays.holiday_base import HolidayBase
@@ -32,6 +33,7 @@ class Egypt(HolidayBase, ChristianHolidays, IslamicHolidays, InternationalHolida
     # %s (estimated).
     estimated_label = tr("(تقدير) %s")
     supported_languages = ("ar", "en_US")
+    weekend = {FRI, SAT}
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)

holidays/countries/finland.py

@@ -13,18 +13,27 @@
 from gettext import gettext as tr
 
 from holidays.calendars.gregorian import _timedelta
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.holiday_base import HolidayBase
 
 
 class Finland(HolidayBase, ChristianHolidays, InternationalHolidays):
     """
-    https://en.wikipedia.org/wiki/Public_holidays_in_Finland
+    References:
+        - https://en.wikipedia.org/wiki/Public_holidays_in_Finland
+        - `Bank holidays (Finnish) <https://www.suomenpankki.fi/fi/raha-ja-maksaminen/pankkivapaapaivat/>`_
+        - `Bank holidays (English) <https://www.suomenpankki.fi/en/money-and-payments/bank-holidays/>`_
+        - `Bank holidays (Swedish) <https://www.suomenpankki.fi/sv/pengar-och-betalningar/bankfria-dagar-i-finland/>`_
+        - https://en.wikipedia.org/wiki/Flag_flying_days_in_Finland#Customary_flag_days
+        - https://intermin.fi/en/flag-and-arms/flag-flying-days
+        - https://intermin.fi/en/flag-and-arms/flag-days/2024
     """
 
     country = "FI"
     default_language = "fi"
-    supported_languages = ("en_US", "fi", "sv", "uk")
+    supported_languages = ("en_US", "fi", "sv_FI", "uk")
+    supported_categories = (PUBLIC, UNOFFICIAL)
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -49,7 +58,7 @@ class Finland(HolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_easter_sunday(tr("Pääsiäispäivä"))
 
         # Easter Monday.
-        self._add_easter_monday(tr("2. pääsiäispäivä"))
+        self._add_easter_monday(tr("Toinen pääsiäispäivä"))
 
         # May Day.
         self._add_holiday_may_1(tr("Vappu"))
@@ -93,6 +102,83 @@ class Finland(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Second Day of Christmas.
         self._add_christmas_day_two(tr("Tapaninpäivä"))
 
+    def _populate_unofficial_holidays(self):
+        if self._year >= 1854:
+            # Runeberg Day
+            self._add_holiday_feb_5(tr("Runebergin päivä"))
+
+        if self._year >= 1860:
+            # Kalevala Day, Day of Finnish Culture
+            self._add_holiday_feb_28(tr("Kalevalan päivä, suomalaisen kulttuurin päivä"))
+
+        if self._year >= 2007:
+            #  Minna Canth Day, Day of Equality
+            self._add_holiday_mar_19(tr("Minna Canthin päivä, tasa-arvon päivä"))
+
+        if self._year >= 1978:
+            # Mikael Agricola Day, Day of the Finnish Language
+            self._add_holiday_apr_9(tr("Mikael Agricolan päivä, suomen kielen päivä"))
+
+        if self._year >= 1987:
+            # National War Veterans' Day
+            self._add_holiday_apr_27(tr("Kansallinen veteraanipäivä"))
+
+        if self._year >= 2019:
+            # Europe Day
+            self._add_holiday_may_9(tr("Eurooppa-päivä"))
+
+        if self._year >= 1918:
+            # Mothers' Day
+            self._add_holiday_2nd_sun_of_may(tr("Äitienpäivä"))
+
+        if self._year >= 1952:
+            # J. V. Snellman Day, Day of Finnish Heritage
+            self._add_holiday_may_12(tr("J.V. Snellmanin päivä, suomalaisuuden päivä"))
+
+        if self._year >= 1977:
+            # Remembrance Day
+            self._add_holiday_3rd_sun_of_may(tr("Kaatuneitten muistopäivä"))
+
+        if self._year >= 1942:
+            # Flag Day of the Finnish Defense Forces
+            self._add_holiday_jun_6(tr("Puolustusvoimain lippujuhlan päivä"))
+
+        if self._year >= 1992:
+            # Eino Leino Day, Day of Summer and Poetry
+            self._add_holiday_jul_6(tr("Eino Leinon päivä, runon ja suven päivä"))
+
+        if self._year >= 2013:
+            # Finland's Nature Day
+            self._add_holiday_last_sat_of_aug(tr("Suomen luonnon päivä"))
+
+        if self._year >= 2016:
+            # Miina Sillanpää Day, Day of Civic Participation
+            self._add_holiday_oct_1(tr("Miina Sillanpään ja kansalaisvaikuttamisen päivä"))
+
+        if self._year >= 1950:
+            # Aleksis Kivi Day, Day of Finnish Literature
+            self._add_holiday_oct_10(tr("Aleksis Kiven päivä, suomalaisen kirjallisuuden päivä"))
+
+        if self._year >= 1987:
+            # United Nations Day
+            self._add_united_nations_day(tr("YK:n päivä"))
+
+        if self._year >= 1908:
+            # Finnish Swedish Heritage Day, svenska dagen
+            self._add_holiday_nov_6(tr("Ruotsalaisuuden päivä, Kustaa Aadolfin päivä"))
+
+        if self._year >= 1949:
+            # Fathers' Day
+            self._add_holiday_2nd_sun_of_nov(tr("Isänpäivä"))
+
+        if self._year >= 2020:
+            # Day of Children's Rights
+            self._add_holiday_nov_20(tr("Lapsen oikeuksien päivä"))
+
+        if self._year >= 2007:
+            # Jean Sibelius Day, Day of Finnish Music
+            self._add_holiday_dec_8(tr("Jean Sibeliuksen päivä, suomalaisen musiikin päivä"))
+
 
 class FI(Finland):
     pass

holidays/countries/israel.py

@@ -13,7 +13,7 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _HebrewLunisolar
-from holidays.calendars.gregorian import _timedelta
+from holidays.calendars.gregorian import _timedelta, FRI, SAT
 from holidays.calendars.hebrew import (
     HANUKKAH,
     INDEPENDENCE_DAY,
@@ -53,6 +53,7 @@ class Israel(ObservedHolidayBase):
     observed_label = tr("(נצפה) %s")
     supported_categories = (OPTIONAL, PUBLIC, SCHOOL)
     supported_languages = ("en_US", "he", "uk")
+    weekend = {FRI, SAT}
 
     def __init__(self, *args, **kwargs):
         kwargs.setdefault("observed_rule", FRI_TO_PREV_THU + SAT_TO_PREV_THU)

holidays/countries/jordan.py

@@ -12,6 +12,7 @@
 
 from gettext import gettext as tr
 
+from holidays.calendars.gregorian import THU, FRI, SAT
 from holidays.groups import ChristianHolidays, InternationalHolidays, IslamicHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -36,6 +37,10 @@ class Jordan(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolid
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        # The resting days are Friday and Saturday since Jan 6, 2000.
+        # https://archive.wfn.org/2000/01/msg00078.html
+        self.weekend = {FRI, SAT} if self._year >= 2000 else {THU, FRI}
+
         # New Year's Day.
         self._add_new_years_day(tr("رأس السنة الميلادية"))
 

holidays/countries/kuwait.py

@@ -12,6 +12,7 @@
 
 from gettext import gettext as tr
 
+from holidays.calendars.gregorian import THU, FRI, SAT
 from holidays.groups import InternationalHolidays, IslamicHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -36,6 +37,10 @@ class Kuwait(HolidayBase, InternationalHolidays, IslamicHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        # The resting days are Friday and Saturday since Sep 1, 2007.
+        # https://www.arabnews.com/node/298933
+        self.weekend = {FRI, SAT} if self._year >= 2007 else {THU, FRI}
+
         # New Year's Day.
         self._add_new_years_day(tr("رأس السنة الميلادية"))
 

holidays/countries/mauritania.py

@@ -0,0 +1,82 @@
+#  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/python-holidays
+#  License: MIT (see LICENSE file)
+
+#  python-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: dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from holidays.calendars.gregorian import FRI, SAT
+from holidays.groups import InternationalHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Mauritania(HolidayBase, InternationalHolidays, IslamicHolidays):
+    """
+    References:
+    - https://en.wikipedia.org/wiki/Public_holidays_in_Mauritania
+    - https://www.timeanddate.com/holidays/mauritania/
+    """
+
+    country = "MR"
+    weekend = {FRI, SAT}
+
+    def __init__(self, *args, **kwargs):
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(self)
+
+        super().__init__(*args, **kwargs)
+
+    def _populate(self, year):
+        super()._populate(year)
+
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+
+        # Labor Day.
+        self._add_labor_day("Labor Day")
+
+        # Africa Day.
+        self._add_africa_day("Africa Day")
+
+        # Independence Day.
+        if year >= 1960:
+            self._add_holiday_nov_28("Independence Day")
+
+        # Islamic holidays.
+        # Eid al-Fitr.
+        self._add_eid_al_fitr_day("Eid al-Fitr")
+        self._add_eid_al_fitr_day_two("Eid al-Fitr")
+
+        # Eid al-Adha.
+        self._add_eid_al_adha_day("Eid al-Adha")
+        self._add_eid_al_adha_day_two("Eid al-Adha")
+
+        # Muharram/Islamic New Year.
+        self._add_islamic_new_year_day("Islamic New Year")
+
+        # Prophet Muhammad's Birthday.
+        self._add_mawlid_day("Mawlid al-Nabi")
+
+
+class MR(Mauritania):
+    pass
+
+
+class MRT(Mauritania):
+    pass

holidays/countries/russia.py

@@ -12,7 +12,7 @@
 
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import JAN, FEB, APR, MAY, NOV, DEC
+from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, NOV, DEC
 from holidays.calendars.julian import JULIAN_CALENDAR
 from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
 from holidays.holiday_base import HolidayBase
@@ -134,4 +134,13 @@ class RussiaStaticHolidays:
             (DEC, 30, DEC, 28),
             (DEC, 31, JAN, 7),
         ),
+        # Substituted Holidays 2025
+        # src: https://www.consultant.ru/document/cons_doc_LAW_481586/
+        2025: (
+            (MAY, 2, JAN, 4),
+            (DEC, 31, JAN, 5),
+            (MAY, 8, FEB, 23),
+            (JUN, 13, MAR, 8),
+            (NOV, 3, NOV, 1),
+        ),
     }

holidays/countries/samoa.py

@@ -0,0 +1,72 @@
+#  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/python-holidays
+#  License: MIT (see LICENSE file)
+
+from holidays.groups import ChristianHolidays, InternationalHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Samoa(HolidayBase, ChristianHolidays, InternationalHolidays):
+    """
+    References:
+        - https://en.wikipedia.org/wiki/Public_holidays_in_Samoa
+        - https://www.timeanddate.com/holidays/samoa/
+        - https://www.mcil.gov.ws/?attachment_id=6336
+        - https://www.paclii.org/ws/legis/consol_act_2020/pha2008163/
+    """
+
+    country = "WS"
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+
+        super().__init__(*args, **kwargs)
+
+    def _populate(self, year):
+        super()._populate(year)
+
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+        self._add_new_years_day_two("The Day After New Year's Day")
+
+        # Good Friday.
+        self._add_good_friday("Good Friday")
+        self._add_holy_saturday("Day After Good Friday")
+
+        # Easter Monday.
+        self._add_easter_monday("Easter Monday")
+
+        # Mother's Day.
+        self._add_holiday_1_day_past_2nd_sun_of_may("Mother's Day")
+
+        # Independence Day.
+        self._add_holiday_jun_1("Independence Day")
+
+        # Father's Day.
+        self._add_holiday_1_day_past_2nd_sun_of_aug("Father's Day")
+
+        # White Monday (Lotu a Tamaiti).
+        self._add_holiday_1_day_past_2nd_sun_of_oct("White Sunday (Lotu a Tamaiti)")
+
+        # Christmas Day.
+        self._add_christmas_day("Christmas Day")
+
+        # Boxing Day.
+        self._add_christmas_day_two("Boxing Day")
+
+
+class WS(Samoa):
+    pass
+
+
+class WSM(Samoa):
+    pass

holidays/countries/singapore.py

@@ -177,6 +177,7 @@ class SingaporeBuddhistHolidays(_CustomBuddhistHolidays):
         2022: (MAY, 15),
         2023: (JUN, 2),
         2024: (MAY, 22),
+        2025: (MAY, 12),
     }
 
 
@@ -206,10 +207,12 @@ class SingaporeChineseHolidays(_CustomChineseHolidays):
         2022: (FEB, 1),
         2023: (JAN, 22),
         2024: (FEB, 10),
+        2025: (JAN, 29),
     }
 
 
 class SingaporeHinduHolidays(_CustomHinduHolidays):
+    # Deepavali
     DIWALI_DATES = {
         2001: (NOV, 14),
         2002: (NOV, 3),
@@ -235,10 +238,12 @@ class SingaporeHinduHolidays(_CustomHinduHolidays):
         2022: (OCT, 24),
         2023: (NOV, 12),
         2024: (OCT, 31),
+        2025: (OCT, 20),
     }
 
 
 class SingaporeIslamicHolidays(_CustomIslamicHolidays):
+    # Hari Raya Haji
     EID_AL_ADHA_DATES = {
         2001: (MAR, 6),
         2002: (FEB, 23),
@@ -264,8 +269,10 @@ class SingaporeIslamicHolidays(_CustomIslamicHolidays):
         2022: (JUL, 10),
         2023: (JUN, 29),
         2024: (JUN, 17),
+        2025: (JUN, 7),
     }
 
+    # Hari Raya Puasa
     EID_AL_FITR_DATES = {
         2001: (DEC, 16),
         2002: (DEC, 6),
@@ -291,6 +298,7 @@ class SingaporeIslamicHolidays(_CustomIslamicHolidays):
         2022: (MAY, 3),
         2023: (APR, 22),
         2024: (APR, 10),
+        2025: (MAR, 31),
     }