holidays 0.75__py3-none-any.whl → 0.77__py3-none-any.whl

holidays/countries/gibraltar.py

@@ -0,0 +1,219 @@
+#  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.calendars.gregorian import JAN, FEB, APR, MAY, JUN, AUG, SEP
+from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
+from holidays.observed_holiday_base import (
+    ObservedHolidayBase,
+    SAT_SUN_TO_NEXT_MON,
+    SAT_SUN_TO_NEXT_MON_TUE,
+)
+
+
+class Gibraltar(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
+    """Gibraltar holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Gibraltar>
+        * [2000](https://web.archive.org/web/20250714134510/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/1999s073.pdf)
+        * [2001](https://web.archive.org/web/20250714134609/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2000s041.pdf)
+        * [2003](https://web.archive.org/web/20250713064759/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2002s094.pdf)
+        * [2004](https://web.archive.org/web/20250713065008/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2003s105.pdf)
+        * [2005](https://web.archive.org/web/20250713071914/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2004s069.pdf)
+        * [2006](https://web.archive.org/web/20250713072021/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2005s111.pdf)
+        * [2007](https://web.archive.org/web/20250713072021/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2006s122.pdf)
+        * [2008](https://web.archive.org/web/20250713072026/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2007s113.pdf)
+        * [2009](https://web.archive.org/web/20250713072221/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2008s073.pdf)
+        * [2010](https://web.archive.org/web/20250713072222/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2009s049.pdf)
+        * [2011](https://web.archive.org/web/20250713072228/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2010s149.pdf)
+        * [2012](https://web.archive.org/web/20250713073334/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2011s189.pdf)
+        * [2013](https://web.archive.org/web/20250713162959/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2012s146.pdf)
+        * [2014](https://web.archive.org/web/20250713103345/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2013s149.pdf)
+        * [2015](https://web.archive.org/web/20250713163521/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2014s203.pdf)
+        * [2016](https://web.archive.org/web/20250713164519/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2015s196.pdf)
+        * [2017](https://web.archive.org/web/20250713073752/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2016s217.pdf)
+        * [2018](https://web.archive.org/web/20250714135250/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2017s224.pdf)
+        * [2019](https://web.archive.org/web/20250713071343/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2018s229.pdf)
+        * [2020](https://web.archive.org/web/20250714135425/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2019s217.pdf)
+        * [2021](https://web.archive.org/web/20250421063152/https://www.gibraltarlaws.gov.gi/legislations/bank-and-public-holidays-order-2020-5593/download)
+        * [2022](https://web.archive.org/web/20250414134257/https://www.gibraltarlaws.gov.gi/legislations/bank-and-public-holidays-order-2021-6286/version/21-10-2021/download)
+        * [2023](https://web.archive.org/web/20240831014104/https://www.gibraltarlaws.gov.gi/legislations/bank-and-public-holidays-order-2022-6735/version/22-02-2023/download)
+        * [2024](https://web.archive.org/web/20250502030403/https://www.gibraltarlaws.gov.gi/legislations/bank-and-public-holidays-order-2023-7215/version/06-11-2023/download)
+        * [2025](https://web.archive.org/web/20250714135600/https://www.gibraltarlaws.gov.gi/legislations/bank-and-public-holidays-order-2024-7456/download)
+    """
+
+    country = "GI"
+    default_language = "en_GB"
+    # %s (observed).
+    observed_label = tr("%s (observed)")
+    # First holiday info available from 2000.
+    start_year = 2000
+    supported_languages = ("en_GB", "en_US")
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, GibraltarStaticHolidays)
+        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_observed(self._add_new_years_day(tr("New Year's Day")))
+
+        name = (
+            # Winter Midterm Bank Holiday.
+            tr("Winter Midterm Bank Holiday")
+            if self._year >= 2023
+            # Commonwealth Day.
+            else tr("Commonwealth Day")
+        )
+        winter_midterm_dts = {
+            2024: (FEB, 12),
+        }
+        if dt := winter_midterm_dts.get(self._year):
+            self._add_holiday(name, dt)
+        elif self._year >= 2021:
+            self._add_holiday_3rd_mon_of_feb(name)
+        else:
+            self._add_holiday_2nd_mon_of_mar(name)
+
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # Easter Monday.
+        self._add_easter_monday(tr("Easter Monday"))
+
+        if self._year >= 2013:
+            # Workers' Memorial Day.
+            name = tr("Workers' Memorial Day")
+            workers_memorial_dts = {
+                2013: (APR, 26),
+                2015: (APR, 27),
+            }
+            if dt := workers_memorial_dts.get(self._year):
+                self._add_holiday(name, dt)
+            else:
+                self._add_observed(self._add_holiday_apr_28(name))
+
+        # May Day.
+        name = tr("May Day")
+        may_day_dts = {
+            2007: (MAY, 7),
+            2008: (MAY, 5),
+            2009: (MAY, 4),
+        }
+        if dt := may_day_dts.get(self._year):
+            self._add_holiday(name, dt)
+        else:
+            self._add_observed(self._add_holiday_may_1(name))
+
+        # Spring Bank Holiday.
+        name = tr("Spring Bank Holiday")
+        spring_bank_dts = {
+            2012: (JUN, 4),
+            2022: (JUN, 2),
+        }
+        if dt := spring_bank_dts.get(self._year):
+            self._add_holiday(name, dt)
+        else:
+            self._add_holiday_last_mon_of_may(name)
+
+        name = (
+            # King's Birthday.
+            tr("King's Birthday")
+            if self._year >= 2023
+            # Queen's Birthday.
+            else tr("Queen's Birthday")
+        )
+        sovereign_birthday_dts = {
+            2000: (JUN, 19),
+            2001: (JUN, 18),
+            2006: (JUN, 19),
+            2007: (JUN, 18),
+            2012: (JUN, 18),
+            2013: (JUN, 17),
+            2017: (JUN, 19),
+            2019: (JUN, 17),
+            2023: (JUN, 19),
+            2024: (JUN, 17),
+        }
+        if dt := sovereign_birthday_dts.get(self._year):
+            self._add_holiday(name, dt)
+        else:
+            self._add_holiday_2_days_past_2nd_sat_of_jun(name)
+
+        self._add_holiday_last_mon_of_aug(
+            # Summer Bank Holiday.
+            tr("Summer Bank Holiday")
+            if 2002 <= self._year <= 2007
+            # Late Summer Bank Holiday.
+            else tr("Late Summer Bank Holiday")
+        )
+
+        # Gibraltar National Day.
+        name = tr("Gibraltar National Day")
+        national_day_dts = {
+            2016: (SEP, 5),
+            2017: (SEP, 4),
+        }
+        if dt := national_day_dts.get(self._year):
+            self._add_holiday(name, dt)
+        else:
+            self._add_observed(self._add_holiday_sep_10(name))
+
+        self._add_observed(
+            # Christmas Day.
+            self._add_christmas_day(tr("Christmas Day")),
+            rule=SAT_SUN_TO_NEXT_MON_TUE,
+        )
+
+        self._add_observed(
+            # Boxing Day.
+            self._add_christmas_day_two(tr("Boxing Day")),
+            rule=SAT_SUN_TO_NEXT_MON_TUE,
+        )
+
+
+class GI(Gibraltar):
+    pass
+
+
+class GIB(Gibraltar):
+    pass
+
+
+class GibraltarStaticHolidays(StaticHolidays):
+    """Gibraltar special holidays.
+
+    References:
+        * [Evacuation Commemoration Day, 2015](https://web.archive.org/web/20250714174537/https://www.gibraltarlaws.gov.gi/uploads/legislations/banking-and-financial-dealings/B&P%20Holidays/2015s112.pdf)
+    """
+
+    special_public_holidays = {
+        # Tercentenary Holiday.
+        2004: (AUG, 4, tr("Tercentenary Holiday")),
+        # Bank Holiday.
+        2009: (JAN, 12, tr("Bank Holiday")),
+        # Queen's Diamond Jubilee.
+        2012: (JUN, 5, tr("Queen's Diamond Jubilee")),
+        # Evacuation Commemoration Day.
+        2015: (SEP, 7, tr("Evacuation Commemoration Day")),
+        # 75th Anniversary of VE Day.
+        2020: (MAY, 8, tr("75th Anniversary of VE Day")),
+        # Queen's Platinum Jubilee.
+        2022: (JUN, 3, tr("Platinum Jubilee")),
+        # Special King’s Coronation Bank Holiday.
+        2023: (MAY, 8, tr("Special King's Coronation Bank Holiday")),
+    }

holidays/countries/guadeloupe.py

@@ -0,0 +1,44 @@
+#  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 holidays.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysGP(ChildEntity, France):
+    """Guadeloupe holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Guadeloupe>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "GP"
+    parent_entity = France
+    parent_entity_subdivision_code = "971"
+    # Cession from Sweden on May 30th, 1814.
+    start_year = 1815
+
+
+class Guadeloupe(HolidaysGP):
+    pass
+
+
+class GP(HolidaysGP):
+    pass
+
+
+class GLP(HolidaysGP):
+    pass

holidays/countries/guam.py

@@ -10,11 +10,11 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
-from holidays.countries.united_states import US
+from holidays.countries.united_states import UnitedStates
+from holidays.mixins.child_entity import ChildEntity
 
 
-class HolidaysGU(US):
+class HolidaysGU(ChildEntity, UnitedStates):
     """Guam holidays.
 
     Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
@@ -22,21 +22,13 @@ class HolidaysGU(US):
     """
 
     country = "GU"
-    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
-    subdivisions = ()  # Override US subdivisions.
-    subdivisions_aliases = {}  # Override US subdivisions aliases.
+    parent_entity = UnitedStates
+    # Became a U.S. Territory on April 11th, 1899.
+    start_year = 1900
 
-    def _populate_public_holidays(self) -> None:
-        self.subdiv = "GU"
-        super()._populate_public_holidays()
 
-    def _populate_government_holidays(self) -> None:
-        self.subdiv = "GU"
-        super()._populate_government_holidays()
-
-    def _populate_unofficial_holidays(self) -> None:
-        self.subdiv = "GU"
-        super()._populate_unofficial_holidays()
+class Guam(HolidaysGU):
+    pass
 
 
 class GU(HolidaysGU):
@@ -45,7 +37,3 @@ class GU(HolidaysGU):
 
 class GUM(HolidaysGU):
     pass
-
-
-class Guam(HolidaysGU):
-    pass

holidays/countries/guernsey.py

@@ -107,8 +107,8 @@ class Guernsey(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, St
             }
             # Spring Bank Holiday
             name = "Spring Bank Holiday"
-            if self._year in spring_bank_dates:
-                self._add_holiday(name, spring_bank_dates[self._year])
+            if dt := spring_bank_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_holiday_last_mon_of_may(name)
 
@@ -168,9 +168,9 @@ class Guernsey(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, St
                 1945: (JUN, 14),
                 1946: (JUN, 13),
             }
-            if self._year in his_majesty_birth_dates:
+            if dt := his_majesty_birth_dates.get(self._year):
                 # His Majesty's Birthday.
-                self._add_holiday("His Majesty's Birthday", his_majesty_birth_dates[self._year])
+                self._add_holiday("His Majesty's Birthday", dt)
 
         # Summer Bank Holiday
         # Le premier Lundi du mois d'Août
@@ -217,8 +217,8 @@ class Guernsey(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, St
             }
             # Liberation Day.
             name = "Liberation Day"
-            if self._year in liberation_dates:
-                self._add_holiday(name, liberation_dates[self._year])
+            if dt := liberation_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_holiday_may_9(name)
 

holidays/countries/hongkong.py

@@ -34,7 +34,7 @@ from holidays.groups import (
     InternationalHolidays,
     StaticHolidays,
 )
-from holidays.mixins import PreferredDiscretionaryHolidays
+from holidays.mixins.preferred_discretionary_holidays import PreferredDiscretionaryHolidays
 from holidays.observed_holiday_base import (
     ObservedHolidayBase,
     SAT_SUN_TO_NEXT_WORKDAY,

holidays/countries/hungary.py

@@ -28,6 +28,7 @@ class Hungary(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
 
     country = "HU"
     default_language = "hu"
+    start_year = 1945
     supported_languages = ("en_US", "hu", "uk")
 
     def __init__(self, *args, **kwargs):
@@ -40,7 +41,7 @@ class Hungary(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         # New Year's Day.
         self._add_new_years_day(tr("Újév"))
 
-        if 1945 <= self._year <= 1950 or self._year >= 1989:
+        if self._year <= 1950 or self._year >= 1989:
             # National Day.
             self._add_holiday_mar_15(tr("Nemzeti ünnep"))
 

holidays/countries/iran.py

@@ -46,7 +46,7 @@ class Iran(HolidayBase, IslamicHolidays, PersianCalendarHolidays):
     country = "IR"
     default_language = "fa_IR"
     # %s (estimated).
-    estimated_label = tr("(تخمین زده) %s")
+    estimated_label = tr("%s (تخمینی)")
     supported_languages = ("en_US", "fa_IR")
     start_year = 1980
     weekend = {FRI}

holidays/countries/isle_of_man.py

@@ -21,6 +21,10 @@ class IsleOfMan(UnitedKingdom):
     """Isle Of Man holidays."""
 
     country = "IM"
+    # The Isle of Man (IM) is not a subdivision of the United Kingdom (GB)
+    # entity, so the `IsleOfMan` class does not inherit from the `ChildEntity`
+    # mixin. The `parent_entity` is specified below solely to maintain
+    # consistency in holiday name localization.
     parent_entity = UnitedKingdom
     subdivisions = ()  # Override UnitedKingdom subdivisions.
     subdivisions_aliases = {}  # Override UnitedKingdom subdivisions aliases.

holidays/countries/israel.py

@@ -38,7 +38,7 @@ class Israel(ObservedHolidayBase, HebrewCalendarHolidays):
     country = "IL"
     default_language = "he"
     # %s (observed).
-    observed_label = tr("(נצפה) %s")
+    observed_label = tr("%s (נצפה)")
     supported_categories = (OPTIONAL, PUBLIC, SCHOOL)
     supported_languages = ("en_US", "he", "th", "uk")
     weekend = {FRI, SAT}

holidays/countries/japan.py

@@ -137,11 +137,9 @@ class Japan(ObservedHolidayBase, InternationalHolidays, StaticHolidays):
                     2020: (JUL, 23),
                     2021: (JUL, 22),
                 }
-                dts_observed.add(
-                    self._add_holiday(name, dates[self._year])
-                    if self._year in dates
-                    else self._add_holiday_3rd_mon_of_jul(name)
-                )
+                dts_observed.add(self._add_holiday(name, dt)) if (
+                    dt := dates.get(self._year)
+                ) else dts_observed.add(self._add_holiday_3rd_mon_of_jul(name))
 
         if self._year >= 2016:
             dates = {
@@ -178,9 +176,9 @@ class Japan(ObservedHolidayBase, InternationalHolidays, StaticHolidays):
                     2020: (JUL, 24),
                     2021: (JUL, 23),
                 }
-                dts_observed.add(
-                    self._add_holiday(name, dates[self._year])
-                ) if self._year in dates else self._add_holiday_2nd_mon_of_oct(name)
+                dts_observed.add(self._add_holiday(name, dt)) if (
+                    dt := dates.get(self._year)
+                ) else dts_observed.add(self._add_holiday_2nd_mon_of_oct(name))
             else:
                 dts_observed.add(self._add_holiday_oct_10(name))
 

holidays/countries/jersey.py

@@ -106,8 +106,8 @@ class Jersey(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
                 2022: (JUN, 2),
             }
             name = "Spring Bank Holiday"
-            if self._year in spring_bank_dates:
-                self._add_holiday(name, spring_bank_dates[self._year])
+            if dt := spring_bank_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_holiday_last_mon_of_may(name)
 

holidays/countries/jordan.py

@@ -28,7 +28,7 @@ class Jordan(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolid
     country = "JO"
     default_language = "ar"
     # %s (estimated).
-    estimated_label = tr("(تقدير) %s")
+    estimated_label = tr("%s (المقدرة)")
     supported_languages = ("ar", "en_US")
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):

holidays/countries/kuwait.py

@@ -29,7 +29,7 @@ class Kuwait(HolidayBase, InternationalHolidays, IslamicHolidays):
     country = "KW"
     default_language = "ar"
     # %s (estimated).
-    estimated_label = tr("(تقدير) %s")
+    estimated_label = tr("%s (المقدرة)")
     supported_languages = ("ar", "en_US")
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):