holidays 0.69__py3-none-any.whl → 0.70__py3-none-any.whl

holidays/constants.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -39,6 +39,7 @@ HOLIDAY_NAME_DELIMITER = "; "  # Holiday names separator.
 
 # Supported holiday categories.
 ARMED_FORCES = "armed_forces"
+ARMENIAN = "armenian"
 BANK = "bank"
 GOVERNMENT = "government"
 HALF_DAY = "half_day"

holidays/countries/__init__.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -18,6 +18,7 @@ from .algeria import Algeria, DZ, DZA
 from .american_samoa import AmericanSamoa, AS, ASM, HolidaysAS
 from .andorra import Andorra, AD, AND
 from .angola import Angola, AO, AGO
+from .antigua_and_barbuda import AntiguaAndBarbuda, AG, ATG
 from .argentina import Argentina, AR, ARG
 from .armenia import Armenia, AM, ARM
 from .aruba import Aruba, AW, ABW
@@ -63,6 +64,7 @@ from .el_salvador import ElSalvador, SV, SLV
 from .estonia import Estonia, EE, EST
 from .eswatini import Eswatini, SZ, SZW, Swaziland
 from .ethiopia import Ethiopia, ET, ETH
+from .fiji import Fiji, FJ, FJI
 from .finland import Finland, FI, FIN
 from .france import France, FR, FRA
 from .gabon import Gabon, GA, GAB
@@ -74,6 +76,7 @@ from .greenland import Greenland, GL, GRL
 from .guam import Guam, GU, GUM, HolidaysGU
 from .guatemala import Guatemala, GT, GUA
 from .guernsey import Guernsey, GG, GGY
+from .guinea import Guinea, GN, GIN
 from .haiti import Haiti, HT, HTI
 from .honduras import Honduras, HN, HND
 from .hongkong import HongKong, HK, HKG
@@ -86,6 +89,7 @@ from .ireland import Ireland, IE, IRL
 from .isle_of_man import IsleOfMan, IM, IMN
 from .israel import Israel, IL, ISR
 from .italy import Italy, IT, ITA
+from .ivory_coast import IvoryCoast, CI, CIV
 from .jamaica import Jamaica, JM, JAM
 from .japan import Japan, JP, JPN
 from .jersey import Jersey, JE, JEY
@@ -132,6 +136,7 @@ from .philippines import Philippines, PH, PHL
 from .poland import Poland, PL, POL
 from .portugal import Portugal, PT, PRT
 from .puerto_rico import PuertoRico, PR, PRI, HolidaysPR
+from .qatar import Qatar, QA, QAT
 from .romania import Romania, RO, ROU
 from .russia import Russia, RU, RUS
 from .saint_kitts_and_nevis import SaintKittsAndNevis, KN, KNA

holidays/countries/afghanistan.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -33,10 +33,12 @@ from holidays.holiday_base import HolidayBase
 
 
 class Afghanistan(HolidayBase, InternationalHolidays, IslamicHolidays, PersianCalendarHolidays):
-    """
-    https://en.wikipedia.org/wiki/Public_holidays_in_Afghanistan
-    https://www.timeanddate.com/holidays/afghanistan/
-    https://en.wikipedia.org/wiki/Workweek_and_weekend
+    """Afghanistan holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Afghanistan>
+        * <https://www.timeanddate.com/holidays/afghanistan/>
+        * <https://en.wikipedia.org/wiki/Workweek_and_weekend>
     """
 
     country = "AF"
@@ -50,8 +52,10 @@ class Afghanistan(HolidayBase, InternationalHolidays, IslamicHolidays, PersianCa
 
     def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
         """
-        :param islamic_show_estimated:
-            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
         """
         InternationalHolidays.__init__(self)
         IslamicHolidays.__init__(

holidays/countries/albania.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -27,11 +27,12 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SAT_SUN_TO_NEXT_
 class Albania(
     ObservedHolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays, StaticHolidays
 ):
-    """
+    """Albania holidays.
+
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Albania
-        - `Law No. 7651 <http://kqk.gov.al/sites/default/files/publikime/ligj_7651_-_per_festat_zyrtare_e_ditet_perkujtimore.pdf>`_
-        - `Holidays for 2018–2024 <https://www.bankofalbania.org/Shtypi/Kalendari_i_festave_zyrtare_2024/>`_
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Albania>
+        * [Law No. 7651](http://kqk.gov.al/sites/default/files/publikime/ligj_7651_-_per_festat_zyrtare_e_ditet_perkujtimore.pdf)
+        * [Holidays for 2018–2024](https://www.bankofalbania.org/Shtypi/Kalendari_i_festave_zyrtare_2024/)
     """
 
     country = "AL"
@@ -48,8 +49,10 @@ class Albania(
 
     def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
         """
-        :param islamic_show_estimated:
-            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
         """
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)

holidays/countries/algeria.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -18,13 +18,12 @@ from holidays.holiday_base import HolidayBase
 
 
 class Algeria(HolidayBase, InternationalHolidays, IslamicHolidays):
-    """
-    References:
-      - https://en.wikipedia.org/wiki/Public_holidays_in_Algeria
-
-        As of April 30, 2023. Algeria has 3 days of Eid holidays
-        (https://www.horizons.dz/english/archives/amp/12021)
+    """Algeria holidays.
 
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Algeria>
+        * <https://www.horizons.dz/english/archives/amp/12021>
+        * <https://www.thenationalnews.com/mena/2021/12/07/when-is-the-weekend-in-the-arab-world/>
     """
 
     country = "DZ"
@@ -35,8 +34,10 @@ class Algeria(HolidayBase, InternationalHolidays, IslamicHolidays):
 
     def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
         """
-        :param islamic_show_estimated:
-            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
         """
         InternationalHolidays.__init__(self)
         IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
@@ -45,7 +46,6 @@ class Algeria(HolidayBase, InternationalHolidays, IslamicHolidays):
     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:

holidays/countries/american_samoa.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -15,9 +15,11 @@ from holidays.countries.united_states import US
 
 
 class HolidaysAS(US):
-    # Alias of a US subdivision that is also officially assigned its own
-    # country code in ISO 3166-1.  See
-    # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
+    """American Samoa holidays.
+
+    Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
+    See <https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1>
+    """
 
     country = "AS"
     supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)

holidays/countries/andorra.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -15,10 +15,11 @@ from holidays.holiday_base import HolidayBase
 
 
 class Andorra(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """Andorra holidays.
+
     References:
-      - https://en.wikipedia.org/wiki/Public_holidays_in_Andorra
-      - https://www.holsdb.com/public-holidays/ad
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Andorra>
+        * <https://www.holsdb.com/public-holidays/ad>
     """
 
     country = "AD"

holidays/countries/angola.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -25,20 +25,21 @@ from holidays.observed_holiday_base import (
 
 
 class Angola(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
-    """
+    """Angola holidays.
+
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Angola
-        - http://www.siac.gv.ao/downloads/181029-Lei-Feriados.pdf
-        - `Decree #5/75 <https://www.lexlink.eu/FileGet.aspx?FileId=3023486>`_
-        - [Decree #92/80] https://www.lexlink.eu/FileGet.aspx?FileId=3023473
-        - [Decree #7/92] https://www.lexlink.eu/FileGet.aspx?FileId=3023485
-        - [Law #16/96] https://www.lexlink.eu/FileGet.aspx?FileId=3037036
-        - [Law #1/01] https://www.lexlink.eu/FileGet.aspx?FileId=3029035
-        - [Law #7/03] https://www.lexlink.eu/FileGet.aspx?FileId=3002131
-        - [Law #10/11] https://equadros.gov.ao/documents/40468/0/lei_10_11-1+%281%29.pdf
-        - [Law #11/18] https://equadros.gov.ao/documents/40468/0/Lei_no_11-18+%281%29.pdf
-        - https://www.officeholidays.com/countries/angola/
-        - https://www.timeanddate.com/holidays/angola/
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Angola>
+        * <http://www.siac.gv.ao/downloads/181029-Lei-Feriados.pdf>
+        * [Decree #5/75](https://www.lexlink.eu/FileGet.aspx?FileId=3023486)
+        * [Decree #92/80](https://www.lexlink.eu/FileGet.aspx?FileId=3023473)
+        * [Decree #7/92](https://www.lexlink.eu/FileGet.aspx?FileId=3023485)
+        * [Law #16/96](https://www.lexlink.eu/FileGet.aspx?FileId=3037036)
+        * [Law #1/01](https://www.lexlink.eu/FileGet.aspx?FileId=3029035)
+        * [Law #7/03](https://www.lexlink.eu/FileGet.aspx?FileId=3002131)
+        * [Law #10/11](https://equadros.gov.ao/documents/40468/0/lei_10_11-1+%281%29.pdf)
+        * [Law #11/18](https://equadros.gov.ao/documents/40468/0/Lei_no_11-18+%281%29.pdf)
+        * <https://www.officeholidays.com/countries/angola/>
+        * <https://www.timeanddate.com/holidays/angola/>
     """
 
     country = "AO"

holidays/countries/antigua_and_barbuda.py

@@ -0,0 +1,145 @@
+#  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.md 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.calendars.gregorian import JAN, FEB, MAR, AUG
+from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
+from holidays.observed_holiday_base import (
+    ObservedHolidayBase,
+    SUN_TO_NEXT_MON,
+    SAT_SUN_TO_NEXT_MON_TUE,
+    SAT_SUN_TO_NEXT_MON,
+)
+
+
+class AntiguaAndBarbuda(
+    ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays
+):
+    """Antigua and Barbuda holidays.
+
+    References:
+        * [The Public Holidays Act, 1954](https://laws.gov.ag/wp-content/uploads/2018/08/cap-354.pdf)
+        * [The Public Holidays (Amendment) Act, 2005](https://laws.gov.ag/wp-content/uploads/2018/08/a2005-8.pdf)
+        * [The Public Holidays (Amendment) Act, 2014](https://laws.gov.ag/wp-content/uploads/2019/03/Public-Holidays-Amendment-Act.pdf)
+        * [The Public Holidays (Amendment) Act, 2019](https://laws.gov.ag/wp-content/uploads/2020/02/No.-23-of-2019-Public-Holidays-Amendment-Act-2019.pdf)
+        * [No. 24 of 2006 Proclamation](https://laws.gov.ag/wp-content/uploads/2022/06/No.-24-of-2006-Proclamation-dated-29th-November2006-Appointing-the-11th-of-December2006.pdf)
+        * [No. 40 of 2012 Proclamation](https://laws.gov.ag/wp-content/uploads/2021/08/No.-40-of-2012-Proclamation-dated-the-27th-day-of-November-2012-Apponting-the-27th-of-December-2012-as-a-Public-Holiday-throughout-Antigua-and-Barbuda.pdf)
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Antigua_and_Barbuda>
+
+    Notes:
+        In accordance with No. 24 of 2006 Proclamation, National Heroes Day was celebrated on
+        Dec 11, 2006. In accordance with No. 40 of 2012 Proclamation, National Heroes Day was
+        celebrated on Dec 10, 2012.
+    """
+
+    country = "AG"
+    observed_label = "%s (observed)"
+    start_year = 1955
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, AntiguaAndBarbudaStaticHolidays)
+        kwargs.setdefault("observed_rule", 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("New Year's Day"))
+
+        # Good Friday.
+        self._add_good_friday("Good Friday")
+
+        # Easter Monday.
+        self._add_easter_monday("Easter Monday")
+
+        # Labour Day.
+        self._add_holiday_1st_mon_of_may("Labour Day")
+
+        # Whit Monday.
+        self._add_whit_monday("Whit Monday")
+
+        if self._year <= 2005:
+            # Caribbean Community (Caricom) Day.
+            self._add_holiday_1st_mon_of_jul("Caribbean Community (Caricom) Day")
+
+        # Carnival Monday.
+        self._add_holiday_1st_mon_of_aug("Carnival Monday")
+
+        if self._year >= 2006:
+            # Carnival Tuesday.
+            self._add_holiday_1_day_past_1st_mon_of_aug("Carnival Tuesday")
+
+        # Independence Day.
+        dt = self._add_holiday_nov_1("Independence Day")
+        if self._year >= 2005:
+            self._add_observed(dt, rule=SAT_SUN_TO_NEXT_MON)
+
+        if self._year >= 2005:
+            name = (
+                # Sir Vere Cornwall Bird Snr. Day.
+                "Sir Vere Cornwall Bird Snr. Day"
+                if self._year >= 2014
+                # National Heroes Day.
+                else "National Heroes Day"
+            )
+            if self._year == 2006:
+                self._add_holiday_dec_11(name)
+            elif self._year == 2012:
+                self._add_holiday_dec_10(name)
+            else:
+                dt = self._add_holiday_dec_9(name)
+                if self._year >= 2020:
+                    self._add_observed(dt, rule=SAT_SUN_TO_NEXT_MON)
+
+        # Christmas Day.
+        self._add_observed(self._add_christmas_day("Christmas Day"), rule=SAT_SUN_TO_NEXT_MON_TUE)
+
+        # Boxing Day.
+        self._add_observed(self._add_christmas_day_two("Boxing Day"), rule=SAT_SUN_TO_NEXT_MON_TUE)
+
+
+class AG(AntiguaAndBarbuda):
+    pass
+
+
+class ATG(AntiguaAndBarbuda):
+    pass
+
+
+class AntiguaAndBarbudaStaticHolidays:
+    """Antigua and Barbuda special holidays.
+
+    References:
+        * [August 3, 1993 Holiday](https://laws.gov.ag/wp-content/uploads/2021/08/No.-42-of-1993-Proclamation-dated-the-22nd-day-of-July-1993-appointing-Tuesday-the-3rd-day-of-August-1993-as-a-public-holiday-throughout-Antigua-and-Barbuda..pdf)
+        * [State Funeral of the late The Honourable Charlesworth T. Samuel](https://laws.gov.ag/wp-content/uploads/2022/12/No.-7-of-2008-Proclamation-dated-the-13th-day-of-February-2008-Appointing-Tuesday-19th-February-2008-as-a-Public-Holiday.pdf)
+        * [State Funeral of the late The Honourable Sir George Herbert Walter](https://laws.gov.ag/wp-content/uploads/2022/12/No.-9-of-2008-Proclamation-dated-the-13th-day-of-March-2008-Appointing-Tuesday-18th-March-2008-as-a-Public-Holiday.pdf)
+        * According to the Public Holidays (Amendment) Act, 2014, the day after the general
+          election is a holiday.
+            * [2018 Antiguan general election](https://en.wikipedia.org/wiki/2018_Antiguan_general_election)
+            * [2023 Antiguan general election](https://en.wikipedia.org/wiki/2023_Antiguan_general_election)
+            * [The Public Holidays (Amendment) Act, 2014](https://laws.gov.ag/wp-content/uploads/2019/03/Public-Holidays-Amendment-Act.pdf)
+    """
+
+    # Day after the General Election.
+    day_after_the_general_election = "Day after the General Election"
+
+    special_public_holidays = {
+        1993: (AUG, 3, "Public Holiday"),
+        2008: (
+            # State Funeral of the late The Honourable Charlesworth T. Samuel.
+            (FEB, 19, "State Funeral of the late The Honourable Charlesworth T. Samuel"),
+            # State Funeral of the late The Honourable Sir George Herbert Walter.
+            (MAR, 18, "State Funeral of the late The Honourable Sir George Herbert Walter"),
+        ),
+        2018: (MAR, 22, day_after_the_general_election),
+        2023: (JAN, 19, day_after_the_general_election),
+    }