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

holidays/countries/hongkong.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
@@ -51,16 +51,19 @@ class HongKong(
     PreferredDiscretionaryHolidays,
     StaticHolidays,
 ):
-    """
+    """Hong Kong holidays.
+
     References:
-        - `English Wikipedia <https://en.wikipedia.org/wiki/Public_holidays_in_Hong_Kong>`_
-        - `Chinese Wikipedia <https://zh.wikipedia.org/wiki/香港節日與公眾假期>`_
+        * [English Wikipedia](https://en.wikipedia.org/wiki/Public_holidays_in_Hong_Kong)
+        * [Chinese Wikipedia](https://zh.wikipedia.org/wiki/香港節日與公眾假期)
+
     Statutory Holidays:
-        - `Section 39 of Cap. 57 Employment Ordinance <https://www.elegislation.gov.hk/hk/cap57!en-zh-Hant-HK?INDEX_CS=N&xpid=ID_1438403463460_002>`_
-        - `Holidays for 2010-2025 <https://www.labour.gov.hk/eng/news/holidays_list.htm>`_
+        * [Section 39 of Cap. 57 Employment Ordinance](https://www.elegislation.gov.hk/hk/cap57!en-zh-Hant-HK?INDEX_CS=N&xpid=ID_1438403463460_002)
+        * [Holidays for 2010-2025](https://www.labour.gov.hk/eng/news/holidays_list.htm)
+
     General Holidays:
-        - `Cap. 149 General Holidays Ordinance <https://www.elegislation.gov.hk/hk/cap149!en-zh-Hant-HK?INDEX_CS=N>`_
-        - `Holidays for 2007–2025 <https://www.gov.hk/en/about/abouthk/holiday/index.htm>`_
+        * [Cap. 149 General Holidays Ordinance](https://www.elegislation.gov.hk/hk/cap149!en-zh-Hant-HK?INDEX_CS=N)
+        * [Holidays for 2007–2025](https://www.gov.hk/en/about/abouthk/holiday/index.htm)
     """
 
     country = "HK"
@@ -86,24 +89,24 @@ class HongKong(
         super().__init__(*args, **kwargs)
 
     def _add_mid_autumn(self) -> date:
-        # Chinese Mid-Autumn Festival.
+        # Mid-Autumn Festival.
 
         mid_autumn_date = self._mid_autumn_festival
         if self._year >= 1968:
             mid_autumn_date = _timedelta(mid_autumn_date, +1)
-            # The day following the Chinese Mid-Autumn Festival.
+            # The Day following Mid-Autumn Festival.
             name = tr("中秋節翌日")
-            # The second day following the Chinese Mid-Autumn Festival.
+            # The Second Day following Mid-Autumn Festival.
             second_name = tr("中秋節後第二日")
         else:
-            # Chinese Mid-Autumn Festival.
+            # Mid-Autumn Festival.
             name = tr("中秋節")
-            # The day following the Chinese Mid-Autumn Festival.
+            # The Day following Mid-Autumn Festival.
             second_name = tr("中秋節翌日")
 
         if self._is_sunday(mid_autumn_date):
             if 1983 <= self._year <= 2010:
-                # Chinese Mid-Autumn Festival.
+                # Mid-Autumn Festival.
                 self._add_holiday(tr("中秋節"), _timedelta(mid_autumn_date, -1))
             else:
                 self._add_holiday(second_name, _timedelta(mid_autumn_date, +1))
@@ -112,15 +115,15 @@ class HongKong(
         return mid_autumn_date
 
     def _add_lunar_new_year(self, day_three_start_year: int):
-        # Lunar New Year's Day.
+        # Chinese New Year.
         name = tr("農曆年初一")
-        # The day preceding Lunar New Year's Day.
+        # Chinese New Year's Eve.
         preceding_day_lunar = tr("農曆年初一的前一日")
-        # The second day of Lunar New Year.
+        # The second day of Chinese New Year.
         second_day_lunar = tr("農曆年初二")
-        # The third day of Lunar New Year.
+        # The third day of Chinese New Year.
         third_day_lunar = tr("農曆年初三")
-        # The fourth day of Lunar New Year.
+        # The fourth day of Chinese New Year.
         fourth_day_lunar = tr("農曆年初四")
         dt_lunar_new_year = self._chinese_new_year
         if self._year >= 1983:
@@ -156,7 +159,7 @@ class HongKong(
             return None
 
         if self._year >= 1977:
-            # The first day of January.
+            # New Year's Day.
             self._add_observed(self._add_new_years_day(tr("一月一日")))
 
         self._add_lunar_new_year(day_three_start_year=1977)
@@ -173,28 +176,28 @@ class HongKong(
             # Easter Monday.
             self._add_easter_monday(tr("復活節星期一"))
 
-        # Ching Ming Festival.
+        # Tomb-Sweeping Day.
         self._add_observed(self._add_qingming_festival(tr("清明節")))
 
         if self._year >= 2022:
-            # The Birthday of the Buddha.
+            # The Buddha's Birthday.
             self._add_observed(self._add_chinese_birthday_of_buddha(tr("佛誕")))
 
         if self._year >= 1999:
             # Labor Day.
             self._add_observed(self._add_labor_day(tr("勞動節")))
 
-        # Tuen Ng Festival.
+        # Dragon Boat Festival.
         self._add_observed(self._add_dragon_boat_festival(tr("端午節")))
 
         if self._year >= 1997:
-            # Hong Kong Special Administrative Region Establishment Day.
+            # Hong Kong S.A.R. Establishment Day.
             self._add_observed(self._add_holiday_jul_1(tr("香港特別行政區成立紀念日")))
 
         mid_autumn_date = self._add_mid_autumn()
 
         if self._year >= 1977:
-            # Chung Yeung Festival.
+            # Double Ninth Festival.
             dt_double_ninth = self._add_double_ninth_festival(tr("重陽節"))
             self._add_observed(dt_double_ninth)
 
@@ -211,8 +214,8 @@ class HongKong(
             )
 
         if WINTER_SOLSTICE in self.preferred_discretionary_holidays:
-            # Chinese Winter Solstice Festival.
-            self._add_observed(self._add_holiday(tr("冬節"), self._winter_solstice_date))
+            # Winter Solstice.
+            self._add_observed(self._add_dongzhi_festival(tr("冬節")))
 
         if self._year >= 2024:
             # The first weekday after Christmas Day.
@@ -226,21 +229,21 @@ class HongKong(
         # General Holidays.
 
         if self._is_sunday(JAN, 1):
-            # The day following the first day of January.
+            # The day following New Year's Day.
             self._add_new_years_day_two(tr("一月一日翌日"))
         else:
-            # The first day of January.
+            # New Year's Day.
             self._add_new_years_day(tr("一月一日"))
 
         self._add_lunar_new_year(day_three_start_year=1968)
 
         if self._year >= 1968:
-            dt_qingming = self._qingming_date
+            dt_qingming = self._qingming_festival
             if self._is_sunday(dt_qingming) or dt_qingming == _timedelta(self._easter_sunday, +1):
-                # The day following Ching Ming Festival.
+                # The day following Tomb-Sweeping Day.
                 self._add_holiday(tr("清明節翌日"), _timedelta(dt_qingming, +1))
             else:
-                # Ching Ming Festival.
+                # Tomb-Sweeping Day.
                 self._add_qingming_festival(tr("清明節"))
 
         # Good Friday.
@@ -257,12 +260,12 @@ class HongKong(
             self._add_easter_monday(tr("復活節星期一"))
 
         if self._year >= 1999:
-            dt_birthday_of_buddha = self._chinese_calendar.buddha_birthday_date(self._year)[0]
+            dt_birthday_of_buddha = self._chinese_birthday_of_buddha
             if self._is_sunday(dt_birthday_of_buddha):
-                # The day following the Birthday of the Buddha.
+                # The day following the Buddha's Birthday.
                 self._add_holiday(tr("佛誕翌日"), _timedelta(dt_birthday_of_buddha, +1))
             else:
-                # The Birthday of the Buddha.
+                # The Buddha's Birthday.
                 self._add_chinese_birthday_of_buddha(tr("佛誕"))
 
         if self._year >= 1999:
@@ -274,31 +277,31 @@ class HongKong(
                 self._add_labor_day(tr("勞動節"))
 
         if self._year >= 1968:
-            dt_dragon_boat = self._chinese_calendar.dragon_boat_date(self._year)[0]
+            dt_dragon_boat = self._dragon_boat_festival
             if self._is_sunday(dt_dragon_boat):
-                # The day following Tuen Ng Festival.
+                # The day following Dragon Boat Festival.
                 self._add_holiday(tr("端午節翌日"), _timedelta(dt_dragon_boat, +1))
             else:
-                # Tuen Ng Festival.
+                # Dragon Boat Festival.
                 self._add_dragon_boat_festival(tr("端午節"))
 
         if self._year >= 1997:
             if self._is_sunday(JUL, 1):
-                # The day following Hong Kong Special Administrative Region Establishment Day.
+                # The day following Hong Kong S.A.R. Establishment Day.
                 self._add_holiday_jul_2(tr("香港特別行政區成立紀念日翌日"))
             else:
-                # Hong Kong Special Administrative Region Establishment Day.
+                # Hong Kong S.A.R. Establishment Day.
                 self._add_holiday_jul_1(tr("香港特別行政區成立紀念日"))
 
         mid_autumn_date = self._add_mid_autumn()
 
         if self._year >= 1968:
-            dt_double_ninth = self._chinese_calendar.double_ninth_date(self._year)[0]
+            dt_double_ninth = self._double_ninth_festival
             if self._is_sunday(dt_double_ninth):
-                # The day following Chung Yeung Festival.
+                # The day following Double Ninth Festival.
                 self._add_holiday(tr("重陽節翌日"), _timedelta(dt_double_ninth, +1))
             else:
-                # Chung Yeung Festival.
+                # Double Ninth Festival.
                 self._add_double_ninth_festival(tr("重陽節"))
 
         if self._year >= 1997:
@@ -367,20 +370,6 @@ class HongKong(
             else:
                 self._add_holiday_aug_30(name)
 
-    @property
-    def _winter_solstice_date(self) -> tuple[int, int]:
-        # This approximation is reliable for 1952-2099 years.
-        if (
-            (self._year % 4 == 0 and self._year >= 1988)
-            or (self._year % 4 == 1 and self._year >= 2021)
-            or (self._year % 4 == 2 and self._year >= 2058)
-            or (self._year % 4 == 3 and self._year >= 2091)
-        ):
-            day = 21
-        else:
-            day = 22
-        return DEC, day
-
 
 class HK(HongKong):
     pass
@@ -400,11 +389,11 @@ class HongKongStaticHolidays:
     # Queen's Birthday.
     queen_birthday = tr("英女皇壽辰")
 
-    # The day following Hong Kong Special Administrative Region Establishment Day.
+    # The day following Hong Kong S.A.R. Establishment Day.
     day_following_hksar_establishment_day = tr("香港特別行政區成立紀念日翌日")
 
-    # The 70th anniversary day of the victory of
-    # the Chinese people's war of resistance against Japanese aggression.
+    # 70th Anniversary of the Victory of the Chinese People's War of Resistance against
+    # Japanese Aggression and the World Anti-Fascist War.
     victory_70th_anniversary = tr("中國人民抗日戰爭勝利70周年紀念日")
 
     # Sino-Japanese War Victory Day.

holidays/countries/hungary.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,28 +18,12 @@ from holidays.holiday_base import HolidayBase
 
 
 class Hungary(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
-    """
-    https://en.wikipedia.org/wiki/Public_holidays_in_Hungary
-
-    Codification dates:
-        - https://hvg.hu/gazdasag/20170307_Megszavaztak_munkaszuneti_nap_lett_a_nagypentek
-        - https://www.tankonyvtar.hu/hu/tartalom/historia/92-10/ch01.html#id496839
-
-    Substituted holidays official sources:
-      - `2010 <https://njt.hu/jogszabaly/2009-20-20-1X>`_
-      - `2011 <https://njt.hu/jogszabaly/2010-7-20-2X>`_
-      - `2012 <https://njt.hu/jogszabaly/2011-39-20-2X>`_
-      - `2012-2013 <https://njt.hu/jogszabaly/2012-28-20-2X>`_
-      - `2014 <https://njt.hu/jogszabaly/2013-33-20-2X>`_
-      - `2015 <https://njt.hu/jogszabaly/2014-28-20-2X>`_
-      - `2016 <https://njt.hu/jogszabaly/2015-18-20-2X>`_
-      - `2018 <https://njt.hu/jogszabaly/2017-61-B0-15>`_
-      - `2019 <https://njt.hu/jogszabaly/2018-6-20-53>`_
-      - `2020 <https://njt.hu/jogszabaly/2019-7-20-53>`_
-      - `2021 <https://njt.hu/jogszabaly/2020-14-20-7Q>`_
-      - `2022 <https://njt.hu/jogszabaly/2021-23-20-7Q>`_
-      - `2024 <https://njt.hu/jogszabaly/2023-15-20-8P>`_
-      - `2025 <https://njt.hu/jogszabaly/2024-11-20-2X>`_
+    """Hungary holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Hungary>
+        * <https://hvg.hu/gazdasag/20170307_Megszavaztak_munkaszuneti_nap_lett_a_nagypentek>
+        * <https://www.tankonyvtar.hu/hu/tartalom/historia/92-10/ch01.html#id496839>
     """
 
     country = "HU"
@@ -130,6 +114,25 @@ class HUN(Hungary):
 
 
 class HungaryStaticHolidays:
+    """Hungary special holidays.
+
+    References:
+        * [2010](https://njt.hu/jogszabaly/2009-20-20-1X)
+        * [2011](https://njt.hu/jogszabaly/2010-7-20-2X)
+        * [2012](https://njt.hu/jogszabaly/2011-39-20-2X)
+        * [2012-2013](https://njt.hu/jogszabaly/2012-28-20-2X)
+        * [2014](https://njt.hu/jogszabaly/2013-33-20-2X)
+        * [2015](https://njt.hu/jogszabaly/2014-28-20-2X)
+        * [2016](https://njt.hu/jogszabaly/2015-18-20-2X)
+        * [2018](https://njt.hu/jogszabaly/2017-61-B0-15)
+        * [2019](https://njt.hu/jogszabaly/2018-6-20-53)
+        * [2020](https://njt.hu/jogszabaly/2019-7-20-53)
+        * [2021](https://njt.hu/jogszabaly/2020-14-20-7Q)
+        * [2022](https://njt.hu/jogszabaly/2021-23-20-7Q)
+        * [2024](https://njt.hu/jogszabaly/2023-15-20-8P)
+        * [2025](https://njt.hu/jogszabaly/2024-11-20-2X)
+    """
+
     # Substituted date format.
     substituted_date_format = tr("%Y. %m. %d.")
     # Day off (substituted from %s).

holidays/countries/iceland.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,10 +18,11 @@ from holidays.holiday_base import HolidayBase
 
 
 class Iceland(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """Iceland holidays.
+
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Iceland
-        - https://www.althingi.is/lagas/nuna/1971088.html
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Iceland>
+        * <https://www.althingi.is/lagas/nuna/1971088.html>
     """
 
     country = "IS"