holidays 0.78__tar.gz → 0.79__tar.gz

{holidays-0.78 → holidays-0.79}/CONTRIBUTORS

@@ -11,6 +11,7 @@ Alexei Mikhailov
 Anders Wenhaug
 Andrei Klimenko
 Andres Marrugo
+Aneesh Angane
 Ankush Kapoor
 Anon Kangpanich
 Anthony Rose
@@ -97,6 +98,7 @@ Matheus Oliveira
 Maurizio Montel
 Max Härtwig
 Michael Thessel
+Miguel Farah
 Mike Borsetti
 Mike Polyakovsky
 Miroslav Šedivý

{holidays-0.78 → holidays-0.79}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.78
+Version: 0.79
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
 License-Expression: MIT
+Project-URL: Changelog, https://github.com/vacanza/holidays/releases/
 Project-URL: Documentation, https://holidays.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/vacanza/holidays/
-Project-URL: Changelog, https://github.com/vacanza/holidays/releases/
-Keywords: holidays,calendar,l10n,worldwide,vacation
+Keywords: calendar,holidays,l10n,vacation,worldwide
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
@@ -46,7 +46,7 @@ specific date is a holiday as fast and flexible as possible.
   <tr>
     <td>PyPI</td>
     <td>
-      <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/dm/holidays?color=41B5BE&style=flat" alt="PyPI downloads"></a>&nbsp;<a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat" alt="PyPI version"></a>&nbsp;<a href="https://github.com/vacanza/holidays/releases"><img src="https://img.shields.io/github/release-date/vacanza/holidays?color=41B5BE&style=flat" alt="PyPI release date"></a>
+      <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pepy/dt/holidays?style=flat&color=41B5BE" alt="Pepy Total Downloads"></a>&nbsp;<a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat" alt="PyPI version"></a>&nbsp;<a href="https://github.com/vacanza/holidays/releases"><img src="https://img.shields.io/github/release-date/vacanza/holidays?color=41B5BE&style=flat" alt="PyPI release date"></a>
     </td>
   </tr>
   <tr>
@@ -142,7 +142,7 @@ and detailed information.
 
 ## Available Countries
 
-We currently support 224 country codes. The standard way to refer to a country is by using its [ISO
+We currently support 233 country codes. The standard way to refer to a country is by using its [ISO
 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes), the same used
 for domain names, and for a subdivision its [ISO 3166-2
 code](https://en.wikipedia.org/wiki/ISO_3166-2). Some countries have common or foreign names or
@@ -352,6 +352,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Bhutan</td>
+<td>BT</td>
+<td>Administrative Subdivisions: 11 (Paro), 12 (Chhukha), 13 (Haa), 14 (Samtse), 15 (Thimphu), 21 (Tsirang), 22 (Dagana), 23 (Punakha), 24 (Wangdue Phodrang), 31 (Sarpang), 32 (Trongsa), 33 (Bumthang), 34 (Zhemgang), 41 (Trashigang), 42 (Monggar), 43 (Pema Gatshel), 44 (Lhuentse), 45 (Samdrup Jongkhar), GA (Gasa), TY (Trashi Yangtse)</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Bolivia</td>
 <td>BO</td>
 <td>Departments: B (El Beni), C (Cochabamba), H (Chuquisaca), L (La Paz), N (Pando), O (Oruro), P (Potosí), S (Santa Cruz), T (Tarija)</td>
@@ -709,6 +716,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Gambia</td>
+<td>GM</td>
+<td></td>
+<td><strong>en_GM</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Georgia</td>
 <td>GE</td>
 <td></td>
@@ -793,6 +807,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Guinea-Bissau</td>
+<td>GW</td>
+<td></td>
+<td>en_US, <strong>pt_GW</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Guyana</td>
 <td>GY</td>
 <td></td>
@@ -856,6 +877,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Iraq</td>
+<td>IQ</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td>CHRISTIAN, HEBREW, SABIAN, YAZIDI</td>
+</tr>
+<tr>
 <td>Ireland</td>
 <td>IE</td>
 <td></td>
@@ -933,6 +961,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HINDU, ISLAMIC</td>
 </tr>
 <tr>
+<td>Kiribati</td>
+<td>KI</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Kuwait</td>
 <td>KW</td>
 <td></td>
@@ -975,6 +1010,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Liberia</td>
+<td>LR</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Libya</td>
 <td>LY</td>
 <td></td>
@@ -1507,6 +1549,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>South Georgia and the South Sandwich Islands</td>
+<td>GS</td>
+<td></td>
+<td><strong>en_GS</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>South Korea</td>
 <td>KR</td>
 <td></td>
@@ -1556,6 +1605,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HALF_DAY, OPTIONAL</td>
 </tr>
 <tr>
+<td>Syrian Arab Republic</td>
+<td>SY</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Taiwan</td>
 <td>TW</td>
 <td></td>
@@ -1626,6 +1682,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HALF_DAY</td>
 </tr>
 <tr>
+<td>Turkmenistan</td>
+<td>TM</td>
+<td></td>
+<td>en_US, ru, <strong>tk</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Turks and Caicos Islands</td>
 <td>TC</td>
 <td></td>

{holidays-0.78 → holidays-0.79}/README.md

@@ -9,7 +9,7 @@ specific date is a holiday as fast and flexible as possible.
   <tr>
     <td>PyPI</td>
     <td>
-      <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/dm/holidays?color=41B5BE&style=flat" alt="PyPI downloads"></a>&nbsp;<a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat" alt="PyPI version"></a>&nbsp;<a href="https://github.com/vacanza/holidays/releases"><img src="https://img.shields.io/github/release-date/vacanza/holidays?color=41B5BE&style=flat" alt="PyPI release date"></a>
+      <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pepy/dt/holidays?style=flat&color=41B5BE" alt="Pepy Total Downloads"></a>&nbsp;<a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat" alt="PyPI version"></a>&nbsp;<a href="https://github.com/vacanza/holidays/releases"><img src="https://img.shields.io/github/release-date/vacanza/holidays?color=41B5BE&style=flat" alt="PyPI release date"></a>
     </td>
   </tr>
   <tr>
@@ -105,7 +105,7 @@ and detailed information.
 
 ## Available Countries
 
-We currently support 224 country codes. The standard way to refer to a country is by using its [ISO
+We currently support 233 country codes. The standard way to refer to a country is by using its [ISO
 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes), the same used
 for domain names, and for a subdivision its [ISO 3166-2
 code](https://en.wikipedia.org/wiki/ISO_3166-2). Some countries have common or foreign names or
@@ -315,6 +315,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Bhutan</td>
+<td>BT</td>
+<td>Administrative Subdivisions: 11 (Paro), 12 (Chhukha), 13 (Haa), 14 (Samtse), 15 (Thimphu), 21 (Tsirang), 22 (Dagana), 23 (Punakha), 24 (Wangdue Phodrang), 31 (Sarpang), 32 (Trongsa), 33 (Bumthang), 34 (Zhemgang), 41 (Trashigang), 42 (Monggar), 43 (Pema Gatshel), 44 (Lhuentse), 45 (Samdrup Jongkhar), GA (Gasa), TY (Trashi Yangtse)</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Bolivia</td>
 <td>BO</td>
 <td>Departments: B (El Beni), C (Cochabamba), H (Chuquisaca), L (La Paz), N (Pando), O (Oruro), P (Potosí), S (Santa Cruz), T (Tarija)</td>
@@ -672,6 +679,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Gambia</td>
+<td>GM</td>
+<td></td>
+<td><strong>en_GM</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Georgia</td>
 <td>GE</td>
 <td></td>
@@ -756,6 +770,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Guinea-Bissau</td>
+<td>GW</td>
+<td></td>
+<td>en_US, <strong>pt_GW</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Guyana</td>
 <td>GY</td>
 <td></td>
@@ -819,6 +840,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Iraq</td>
+<td>IQ</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td>CHRISTIAN, HEBREW, SABIAN, YAZIDI</td>
+</tr>
+<tr>
 <td>Ireland</td>
 <td>IE</td>
 <td></td>
@@ -896,6 +924,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HINDU, ISLAMIC</td>
 </tr>
 <tr>
+<td>Kiribati</td>
+<td>KI</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Kuwait</td>
 <td>KW</td>
 <td></td>
@@ -938,6 +973,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Liberia</td>
+<td>LR</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Libya</td>
 <td>LY</td>
 <td></td>
@@ -1470,6 +1512,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>South Georgia and the South Sandwich Islands</td>
+<td>GS</td>
+<td></td>
+<td><strong>en_GS</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>South Korea</td>
 <td>KR</td>
 <td></td>
@@ -1519,6 +1568,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HALF_DAY, OPTIONAL</td>
 </tr>
 <tr>
+<td>Syrian Arab Republic</td>
+<td>SY</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Taiwan</td>
 <td>TW</td>
 <td></td>
@@ -1589,6 +1645,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HALF_DAY</td>
 </tr>
 <tr>
+<td>Turkmenistan</td>
+<td>TM</td>
+<td></td>
+<td>en_US, ru, <strong>tk</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Turks and Caicos Islands</td>
 <td>TC</td>
 <td></td>

{holidays-0.78 → holidays-0.79}/holidays/calendars/__init__.py

@@ -26,3 +26,4 @@ from holidays.calendars.mongolian import _CustomMongolianHolidays, _MongolianLun
 from holidays.calendars.persian import _Persian
 from holidays.calendars.sinhala import _SinhalaLunar, _CustomSinhalaHolidays
 from holidays.calendars.thai import _ThaiLunisolar, KHMER_CALENDAR, THAI_CALENDAR
+from holidays.calendars.tibetan import _TibetanLunisolar, _CustomTibetanHolidays

{holidays-0.78 → holidays-0.79}/holidays/calendars/chinese.py

@@ -1325,11 +1325,21 @@ class _ChineseLunisolar:
     def _get_holiday(self, holiday: str, year: int, calendar=None) -> tuple[Optional[date], bool]:
         calendar = calendar or self.__calendar
         self.__verify_calendar(calendar)
-        custom_calendar_dates = getattr(self, f"{calendar}_{holiday}_DATES", {})
+        confirmed_dates = getattr(
+            self, f"{holiday}_DATES_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", {}
+        )
+        confirmed_years = getattr(
+            self, f"{holiday}_DATES_CONFIRMED_YEARS_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", (0, 0)
+        )
         estimated_dates = getattr(self, f"{holiday}_DATES", {})
-        exact_dates = getattr(self, f"{holiday}_DATES_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", {})
-        dt = exact_dates.get(year, custom_calendar_dates.get(year, estimated_dates.get(year, ())))
-        return date(year, *dt) if dt else None, year not in exact_dates
+        custom_calendar_dates = getattr(self, f"{calendar}_{holiday}_DATES", {})
+        dt = confirmed_dates.get(
+            year, custom_calendar_dates.get(year, estimated_dates.get(year, ()))
+        )
+        is_confirmed = year in confirmed_dates or (
+            confirmed_years[0] <= year <= confirmed_years[1]
+        )
+        return date(year, *dt) if dt else None, not is_confirmed
 
     def buddha_birthday_date(self, year: int, calendar=None) -> tuple[Optional[date], bool]:
         return self._get_holiday(BUDDHA_BIRTHDAY, year, calendar)

holidays-0.79/holidays/calendars/ethiopian.py

@@ -0,0 +1,31 @@
+#  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)
+
+ETHIOPIAN_CALENDAR = "ETHIOPIAN_CALENDAR"
+
+
+def is_ethiopian_leap_year(year: int) -> bool:
+    """Determine if the Ethiopian year that starts in the given Gregorian year is a leap year.
+
+    Ethiopian leap years follow the Coptic/Julian rule:
+        * Every 4 years without exception (no century rule).
+        * The Ethiopian year starts on September 11 (or 12 in an Ethiopian leap year).
+
+    Args:
+        year:
+            Gregorian year to evaluate.
+
+    Returns:
+        `True` if an Ethiopian leap year starts in the given Gregorian year, `False` otherwise.
+    """
+
+    return (year + 1) % 4 == 0

{holidays-0.78 → holidays-0.79}/holidays/calendars/islamic.py

@@ -3971,11 +3971,23 @@ class _IslamicLunar:
     }
 
     def _get_holiday(self, holiday: str, year: int) -> Iterable[tuple[date, bool]]:
+        confirmed_dates = getattr(
+            self, f"{holiday}_DATES_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", {}
+        )
+        confirmed_years = getattr(
+            self, f"{holiday}_DATES_CONFIRMED_YEARS_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", ()
+        )
         estimated_dates = getattr(self, f"{holiday}_DATES", {})
-        exact_dates = getattr(self, f"{holiday}_DATES_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", {})
-        for year in (year - 1, year):
-            for dt in _normalize_tuple(exact_dates.get(year, estimated_dates.get(year, ()))):
-                yield date(year, *dt), year not in exact_dates
+
+        for check_year in (year - 1, year):
+            for dt in _normalize_tuple(
+                confirmed_dates.get(check_year, estimated_dates.get(check_year, ()))
+            ):
+                is_confirmed = check_year in confirmed_dates or any(
+                    year_from <= check_year <= year_to
+                    for year_from, year_to in _normalize_tuple(confirmed_years)
+                )
+                yield date(check_year, *dt), not is_confirmed
 
     def _is_long_ramadan(self, eid_al_fitr: date) -> bool:
         """Check whether the Ramadan preceding the given Eid al-Fitr date lasted 30 days.

{holidays-0.78 → holidays-0.79}/holidays/calendars/julian.py

@@ -11,3 +11,17 @@
 #  License: MIT (see LICENSE file)
 
 JULIAN_CALENDAR = "JULIAN_CALENDAR"
+
+
+def julian_calendar_drift(year: int) -> int:
+    """Return the Julian–Gregorian date drift relative to the 1899–2099 baseline.
+
+    Args:
+        year:
+            Gregorian year to check.
+
+    Returns:
+        Number of days to add/subtract relative to the 1899–2099 baseline.
+    """
+
+    return -13 if year <= 1582 else (year // 100) - (year // 400) - 15

holidays-0.79/holidays/calendars/mandaean.py

@@ -0,0 +1,59 @@
+#  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 datetime import date
+from typing import Optional
+
+from holidays.calendars.gregorian import _timedelta
+
+
+class _Mandaean:
+    """
+    Mandaean calendar for 1901-2100 years.
+    https://en.wikipedia.org/wiki/Mandaean_calendar
+    """
+
+    # Begin of 445271 Mandaean year.
+    START_DATE = date(1901, 8, 16)
+    START_YEAR = 1901
+    END_YEAR = 2100
+
+    def new_year_date(self, year: int) -> Optional[date]:
+        """
+        Return Gregorian date of Mandaean new year (1 Dowla) in a given Gregorian year.
+        """
+        if year < _Mandaean.START_YEAR or year > _Mandaean.END_YEAR:
+            return None
+
+        return _timedelta(_Mandaean.START_DATE, 365 * (year - _Mandaean.START_YEAR))
+
+    def mandaean_to_gregorian(self, year: int, month: int, day: int) -> Optional[date]:
+        """
+        Return Gregorian date of Mandaean day and month of the year that begins in a given
+        Gregorian year.
+        Extra 5 days inserted after 8th month are considered as 13th month.
+        """
+        start_date = self.new_year_date(year)
+        if not start_date:
+            return None
+
+        if not (1 <= month <= 13) or not (1 <= day <= 30) or (month == 13 and not (1 <= day <= 5)):
+            return None
+
+        if month < 9:
+            delta = 30 * (month - 1)
+        elif month == 13:
+            delta = 30 * 8
+        else:
+            delta = 30 * (month - 1) + 5
+
+        return _timedelta(start_date, delta + day - 1)