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

holidays/countries/egypt.py

@@ -12,20 +12,63 @@
 
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import FRI, SAT
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import (
+    JAN,
+    MAR,
+    APR,
+    MAY,
+    JUN,
+    JUL,
+    AUG,
+    SEP,
+    OCT,
+    MON,
+    TUE,
+    WED,
+    FRI,
+    SAT,
+    SUN,
+)
 from holidays.calendars.julian import JULIAN_CALENDAR
-from holidays.groups import ChristianHolidays, IslamicHolidays, InternationalHolidays
-from holidays.holiday_base import HolidayBase
+from holidays.constants import GOVERNMENT, PUBLIC, SCHOOL
+from holidays.groups import (
+    ChristianHolidays,
+    IslamicHolidays,
+    InternationalHolidays,
+    StaticHolidays,
+)
+from holidays.observed_holiday_base import ObservedHolidayBase, ObservedRule
 
+EG_OBSERVED_RULE = ObservedRule({MON: +3, TUE: +2, WED: +1, SUN: +4})
 
-class Egypt(HolidayBase, ChristianHolidays, IslamicHolidays, InternationalHolidays):
-    """Egypt holidays."""
+
+class Egypt(
+    ObservedHolidayBase, ChristianHolidays, IslamicHolidays, InternationalHolidays, StaticHolidays
+):
+    """Egypt holidays.
+
+    References:
+        * <https://ar.wikipedia.org/wiki/قائمة_العطل_الرسمية_في_مصر>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Egypt>
+        * [National Holidays (Arabic)](https://web.archive.org/web/20250614072551/https://www.presidency.eg/ar/مصر/العطلات-الرسمية/)
+        * [National Holidays (English)](https://web.archive.org/web/20250529043734/https://www.presidency.eg/en/مصر/العطلات-الرسمية/)
+        * [National Holidays (French)](https://web.archive.org/web/20250608173134/https://www.presidency.eg/fr/مصر/العطلات-الرسمية/)
+        * [Ministerial Decision 1193](https://web.archive.org/web/20250423073350/https://manshurat.org/node/44922)
+    """
 
     country = "EG"
-    default_language = "ar"
+    default_language = "ar_EG"
     # %s (estimated).
     estimated_label = tr("%s (المقدرة)")
-    supported_languages = ("ar", "en_US")
+    # %s (observed).
+    observed_label = tr("%s (ملاحظة)")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s (المقدرة، ملاحظة)")
+    # Republic of Egypt was declared on 18 June 1953.
+    start_year = 1954
+    supported_categories = (GOVERNMENT, PUBLIC, SCHOOL)
+    supported_languages = ("ar_EG", "en_US", "fr")
     weekend = {FRI, SAT}
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
@@ -37,67 +80,98 @@ class Egypt(HolidayBase, ChristianHolidays, IslamicHolidays, InternationalHolida
         """
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
+        IslamicHolidays.__init__(
+            self, cls=EgyptIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        StaticHolidays.__init__(self, cls=EgyptStaticHolidays)
+        kwargs.setdefault("observed_rule", EG_OBSERVED_RULE)
+        kwargs.setdefault("observed_since", 2020)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # New Year's Day.
-        self._add_new_years_day(tr("رأس السنة الميلادية"))
-
-        # Coptic Christmas Day.
-        self._add_christmas_day(tr("عيد الميلاد المجيد (تقويم قبطي)"))
+        if self._year >= 2002 and self._year not in {2022, 2023}:
+            # Coptic Christmas Day.
+            self._add_christmas_day(tr("عيد الميلاد المجيد"))
 
-        if self._year >= 2012:
-            # January 25th Revolution.
-            self._add_holiday_jan_25(tr("عيد ثورة 25 يناير"))
-        elif self._year >= 2009:
-            # National Police Day.
-            self._add_holiday_jan_25(tr("عيد الشرطة"))
+        if self._year >= 2009:
+            self._move_holiday(
+                self._add_holiday_jan_25(
+                    # January 25th Revolution and National Police Day.
+                    tr("ثورة ٢٥ يناير وعيد الشرطة")
+                    if self._year >= 2012
+                    # National Police Day.
+                    else tr("عيد الشرطة")
+                )
+            )
 
-        # Coptic Easter.
-        self._add_easter_sunday(tr("عيد الفصح القبطي"))
+        if self._year >= 1983:
+            # Sinai Liberation Day.
+            dt = self._add_holiday_apr_25(tr("عيد تحرير سيناء"))
+            if self._year != 2022:
+                self._move_holiday(dt)
 
         # Spring Festival.
-        self._add_easter_monday(tr("شم النسيم"))
-
-        if self._year > 1982:
-            # Sinai Liberation Day.
-            self._add_holiday_apr_25(tr("عيد تحرير سيناء"))
+        self._add_easter_monday(tr("عيد شم النسيم"))
 
         # Labor Day.
-        self._add_labor_day(tr("عيد العمال"))
-
-        # Armed Forces Day.
-        self._add_holiday_oct_6(tr("عيد القوات المسلحة"))
+        if self._year != 2024:
+            self._move_holiday(self._add_labor_day(tr("عيد العمال")))
 
         if self._year >= 2014:
             # June 30 Revolution Day.
-            self._add_holiday_jun_30(tr("عيد ثورة 30 يونيو"))
+            dt = self._add_holiday_jun_30(tr("عيد ثورة ٣٠ يونيو"))
+            if self._year != 2024:
+                self._move_holiday(dt)
 
-        if self._year > 1952:
-            # July 23 Revolution Day.
-            self._add_holiday_jul_23(tr("عيد ثورة 23 يوليو"))
+        # July 23 Revolution Day.
+        dt = self._add_holiday_jul_23(tr("عيد ثورة ٢٣ يوليو"))
+        if self._year != 2023:
+            self._move_holiday(dt)
+
+        # Armed Forces Day.
+        dt = self._add_holiday_oct_6(tr("عيد القوات المسلحة"))
+        if self._year != 2024:
+            self._move_holiday(dt)
+
+        # Islamic New Year.
+        for dt in self._add_islamic_new_year_day(tr("رأس السنة الهجرية")):
+            self._move_holiday(dt)
+
+        # Prophet's Birthday.
+        self._add_mawlid_day(tr("المولد النبوي الشريف"))
 
         # Eid al-Fitr.
-        self._add_eid_al_fitr_day(tr("عيد الفطر"))
-        # Eid al-Fitr Holiday.
-        self._add_eid_al_fitr_day_two(tr("عطلة عيد الفطر"))
-        self._add_eid_al_fitr_day_three(tr("عطلة عيد الفطر"))
+        name = tr("عيد الفطر المبارك")
+        self._add_eid_al_fitr_day(name)
+        self._add_eid_al_fitr_day_two(name)
 
         # Arafat Day.
-        self._add_arafah_day(tr("يوم عرفة"))
+        self._add_arafah_day(tr("وقفة عيد الأضحى المبارك"))
 
         # Eid al-Adha.
-        self._add_eid_al_adha_day(tr("عيد الأضحى"))
-        # Eid al-Adha Holiday.
-        self._add_eid_al_adha_day_two(tr("عطلة عيد الأضحى"))
-        self._add_eid_al_adha_day_three(tr("عطلة عيد الأضحى"))
+        name = tr("عيد الأضحى المبارك")
+        self._add_eid_al_adha_day(name)
+        self._add_eid_al_adha_day_two(name)
+        self._add_eid_al_adha_day_three(name)
 
-        # Islamic New Year.
-        self._add_islamic_new_year_day(tr("رأس السنة الهجرية"))
+    def _populate_government_holidays(self):
+        if self._year >= 2019:
+            # Eid al-Fitr.
+            name = tr("عيد الفطر المبارك")
+            self._add_eid_al_fitr_eve(name)
+            self._add_eid_al_fitr_day_three(name)
 
-        # Prophet's Birthday.
-        self._add_mawlid_day(tr("عيد المولد النبوي"))
+        if self._year >= 2018:
+            # Eid al-Adha.
+            self._add_eid_al_adha_day_four(tr("عيد الأضحى المبارك"))
+
+    def _populate_school_holidays(self):
+        if self._year >= 2019:
+            # Taba Liberation Day.
+            self._add_holiday_mar_19(tr("عيد تحرير طابا"))
+
+            # Evacuation Day.
+            self._add_holiday_jun_18(tr("عيد الجلاء"))
 
 
 class EG(Egypt):
@@ -106,3 +180,85 @@ class EG(Egypt):
 
 class EGY(Egypt):
     pass
+
+
+class EgyptIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES = {
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 10),
+        2023: (JUN, 28),
+        2024: (JUN, 16),
+        2025: (JUN, 6),
+    }
+
+    EID_AL_FITR_DATES = {
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 1),
+        2023: (APR, 21),
+        2024: (APR, 10),
+        2025: (MAR, 30),
+    }
+
+    HIJRI_NEW_YEAR_DATES = {
+        2020: (AUG, 20),
+        2021: (AUG, 11),
+        2022: (JUL, 30),
+        2023: (JUL, 19),
+        2024: (JUL, 7),
+        2025: (JUN, 26),
+    }
+
+    MAWLID_DATES = {
+        2020: (OCT, 29),
+        2021: (OCT, 18),
+        2022: (OCT, 8),
+        2023: (SEP, 28),
+        2024: (SEP, 15),
+        2025: (SEP, 4),
+    }
+
+
+class EgyptStaticHolidays:
+    """Egypt special holidays.
+
+    References:
+        * [2022 Coptic Christmas](https://web.archive.org/web/20240227004025/https://english.ahram.org.eg/NewsContent/1/2/454491/Egypt/Society/Thursday-paid-day-off-at-public-sector-in-Egypt-fo.aspx)
+    """
+
+    # Coptic Christmas Day.
+    coptic_christmas_day = tr("عيد الميلاد المجيد")
+
+    # Eid al-Adha.
+    eid_al_adha = tr("عيد الأضحى المبارك")
+
+    # Eid al-Fitr.
+    eid_al_fitr = tr("عيد الفطر المبارك")
+
+    special_public_holidays = {
+        2021: (
+            (JUL, 17, eid_al_adha),
+            (JUL, 18, eid_al_adha),
+        ),
+        2022: (
+            (JUL, 13, eid_al_adha),
+            (JUL, 14, eid_al_adha),
+        ),
+    }
+
+    special_public_holidays_observed = {
+        2022: (
+            (JAN, 6, coptic_christmas_day),
+            (MAY, 4, eid_al_fitr),
+        ),
+        2023: (
+            (JAN, 8, coptic_christmas_day),
+            (APR, 24, eid_al_fitr),
+            # June 30 Revolution Day.
+            (JUL, 2, tr("عيد ثورة ٣٠ يونيو")),
+            (JUL, 3, eid_al_adha),
+        ),
+        # Labor Day.
+        2024: (MAY, 5, tr("عيد العمال")),
+    }

holidays/countries/faroe_islands.py

@@ -0,0 +1,102 @@
+#  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 gettext import gettext as tr
+
+from holidays.constants import HALF_DAY, PUBLIC
+from holidays.groups import ChristianHolidays, InternationalHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class FaroeIslands(HolidayBase, ChristianHolidays, InternationalHolidays):
+    """Faroe Islands holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_the_Faroe_Islands>
+        * [Decree no. 52 of 23 April 2003](https://web.archive.org/web/20241204233745/https://logir.fo/Kunngerd/52-fra-23-04-2003-um-flagging-fra-landsins-bygningum)
+        * [2007](https://web.archive.org/web/20250125193236/https://www.framtak.com/info/holidays.html))
+        * [2024](https://web.archive.org/web/20250615193008/https://visitfaroeislands.com/en/plan-your-stay/get-ready-for-your-trip/general-facts/public-holidays)
+        * [2025](https://web.archive.org/web/20250615193215/https://guidetofaroeislands.fo/travel-information/faroe-islands-holiday/)
+    """
+
+    country = "FO"
+    default_language = "fo"
+    # Denmark granted home rule to the Faroe Islands on 30 March 1948.
+    start_year = 1949
+    supported_categories = (HALF_DAY, PUBLIC)
+    supported_languages = ("da", "en_US", "fo", "is", "no", "sv")
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day(tr("Nýggjársdagur"))
+
+        # Maundy Thursday.
+        self._add_holy_thursday(tr("Skírhósdagur"))
+
+        # Good Friday.
+        self._add_good_friday(tr("Langifríggjadagur"))
+
+        # Easter Sunday.
+        self._add_easter_sunday(tr("Páskadagur"))
+
+        # Easter Monday.
+        self._add_easter_monday(tr("Annar páskadagur"))
+
+        # Great Prayer Day.
+        self._add_holiday_26_days_past_easter(tr("Dýri biðidagur"))
+
+        # Ascension Day.
+        self._add_ascension_thursday(tr("Kristi himmalsferðardagur"))
+
+        # Whit Sunday.
+        self._add_whit_sunday(tr("Hvítusunnudagur"))
+
+        # Whit Monday.
+        self._add_whit_monday(tr("Annar hvítusunnudagur"))
+
+        # Saint Olaf's Day.
+        self._add_holiday_jul_29(tr("Ólavsøkudagur"))
+
+        # Christmas Eve.
+        self._add_christmas_eve(tr("Jólaaftan"))
+
+        # Christmas Day.
+        self._add_christmas_day(tr("Jóladagur"))
+
+        # Second Day of Christmas.
+        self._add_christmas_day_two(tr("Annar jóladagur"))
+
+        # New Year's Eve.
+        self._add_new_years_eve(tr("Nýggjársaftan"))
+
+    def _populate_half_day_holidays(self):
+        # National Flag Day.
+        self._add_holiday_apr_25(tr("Flaggdagur"))
+
+        # Constitution Day.
+        self._add_holiday_jun_5(tr("Grundlógardagur"))
+
+        # Saint Olaf's Eve.
+        self._add_holiday_jul_28(tr("Ólavsøkuaftan"))
+
+
+class FO(FaroeIslands):
+    pass
+
+
+class FRO(FaroeIslands):
+    pass

holidays/countries/georgia.py

@@ -19,12 +19,13 @@ from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHoli
 from holidays.holiday_base import HolidayBase
 
 
-class Georgia(HolidayBase, ChristianHolidays, InternationalHolidays):
+class Georgia(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
     """Georgia holidays.
 
     References:
         * <https://en.wikipedia.org/wiki/Public_holidays_in_Georgia_(country)>
-        * <https://web.archive.org/web/20250121212149/https://matsne.gov.ge/en/document/view/1155567?publication=24>
+        * [Labour Code of Georgia](https://web.archive.org/web/20250121212149/https://matsne.gov.ge/en/document/view/1155567?publication=24)
+        * [Organic Law 4455-XVIმს-Xმპ](https://web.archive.org/web/20250421162538/https://matsne.gov.ge/ka/document/view/6283937?publication=0)
     """
 
     country = "GE"
@@ -57,6 +58,9 @@ class Georgia(HolidayBase, ChristianHolidays, InternationalHolidays):
         # International Women's Day.
         self._add_womens_day(tr("ქალთა საერთაშორისო დღე"))
 
+        # National Unity Day.
+        self._add_holiday_apr_9(tr("ეროვნული ერთიანობის დღე"))
+
         # Good Friday.
         self._add_good_friday(tr("წითელი პარასკევი"))
 
@@ -69,15 +73,17 @@ class Georgia(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Easter Monday.
         self._add_easter_monday(tr("შავი ორშაბათი"))
 
-        # National Unity Day.
-        self._add_holiday_apr_9(tr("ეროვნული ერთიანობის დღე"))
-
         # Day of Victory over Fascism.
         self._add_world_war_two_victory_day(tr("ფაშიზმზე გამარჯვების დღე"), is_western=False)
 
         # Saint Andrew's Day.
         self._add_holiday_may_12(tr("წმინდა ანდრია პირველწოდებულის დღე"))
 
+        # Established by Organic Law 4455-XVIმს-Xმპ.
+        if self._year >= 2025:
+            # Day of Family Sanctity and Respect for Parents.
+            self._add_holiday_may_17(tr("ოჯახის სიწმინდისა და მშობლების პატივისცემის დღე"))
+
         # Independence Day.
         self._add_holiday_may_26(tr("დამოუკიდებლობის დღე"))
 

holidays/countries/germany.py

@@ -31,12 +31,17 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
     "Mariä Himmelfahrt" is only a holiday in Bavaria (BY) and "Fronleichnam"
     in Saxony (SN) and Thuringia (TH) if municipality is mostly catholic which
     in term depends on census data. It's listed in "CATHOLIC" category for these provinces.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Germany>
+        * [Bavaria's Feiertagsgesetz](https://web.archive.org/web/20250724092008/https://www.gesetze-bayern.de/Content/Document/BayFTG-1)
     """
 
     country = "DE"
     default_language = "de"
     start_year = 1990
     subdivisions = (
+        # States.
         "BB",  # Brandenburg.
         "BE",  # Berlin.
         "BW",  # Baden-Württemberg.
@@ -53,6 +58,8 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         "SN",  # Sachsen.
         "ST",  # Sachsen-Anhalt.
         "TH",  # Thüringen.
+        # Cities.
+        "Augsburg",
     )
     subdivisions_aliases = {
         "Brandenburg": "BB",
@@ -147,9 +154,13 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
 
     def _populate_subdiv_by_public_holidays(self):
         if self._year >= 1991:
+            # Epiphany.
             self._add_epiphany_day(tr("Heilige Drei Könige"))
+
+            # Corpus Christi.
             self._add_corpus_christi_day(tr("Fronleichnam"))
 
+        # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
 
     def _populate_subdiv_by_catholic_holidays(self):
@@ -159,63 +170,83 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
 
     def _populate_subdiv_hb_public_holidays(self):
         if self._year >= 2018:
+            # Reformation Day.
             self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_he_public_holidays(self):
         if self._year >= 1991:
+            # Corpus Christi.
             self._add_corpus_christi_day(tr("Fronleichnam"))
 
     def _populate_subdiv_hh_public_holidays(self):
         if self._year >= 2018:
+            # Reformation Day.
             self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_mv_public_holidays(self):
         if self._year >= 2023:
+            # International Women's Day.
             self._add_womens_day(tr("Internationaler Frauentag"))
 
+        # Reformation Day.
         self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_ni_public_holidays(self):
         if self._year >= 2018:
+            # Reformation Day.
             self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_nw_public_holidays(self):
         if self._year >= 1991:
+            # Corpus Christi.
             self._add_corpus_christi_day(tr("Fronleichnam"))
 
+        # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
 
     def _populate_subdiv_rp_public_holidays(self):
         if self._year >= 1991:
+            # Corpus Christi.
             self._add_corpus_christi_day(tr("Fronleichnam"))
 
+        # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
 
     def _populate_subdiv_sh_public_holidays(self):
         if self._year >= 2018:
+            # Reformation Day.
             self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_sl_public_holidays(self):
         if self._year >= 1991:
+            # Corpus Christi.
             self._add_corpus_christi_day(tr("Fronleichnam"))
+
+            # Assumption Day.
             self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
 
+        # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
 
     def _populate_subdiv_sn_public_holidays(self):
+        # Reformation Day.
         self._add_holiday_oct_31(tr("Reformationstag"))
 
         if self._year >= 1995:
+            # Repentance and Prayer Day.
             self._add_holiday_1st_wed_before_nov_22(tr("Buß- und Bettag"))
 
     def _populate_subdiv_sn_catholic_holidays(self):
         if self._year >= 1991:
+            # Corpus Christi.
             self._add_corpus_christi_day(tr("Fronleichnam"))
 
     def _populate_subdiv_st_public_holidays(self):
         if self._year >= 1991:
+            # Epiphany.
             self._add_epiphany_day(tr("Heilige Drei Könige"))
 
+        # Reformation Day.
         self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_th_public_holidays(self):
@@ -223,12 +254,21 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
             # World Children's Day.
             self._add_holiday_sep_20(tr("Weltkindertag"))
 
+        # Reformation Day.
         self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_th_catholic_holidays(self):
         if self._year >= 1991:
+            # Corpus Christi.
             self._add_corpus_christi_day(tr("Fronleichnam"))
 
+    def _populate_subdiv_augsburg_public_holidays(self):
+        self._populate_subdiv_by_public_holidays()
+
+        if self._year >= 1991:
+            # Augsburg Peace Festival.
+            self._add_holiday_aug_8(tr("Augsburger Hohes Friedensfest"))
+
 
 class DE(Germany):
     pass
@@ -248,6 +288,7 @@ class GermanyStaticHolidays:
     """
 
     special_public_holidays = {
+        # Reformation Day.
         2017: (OCT, 31, tr("Reformationstag")),
     }