holidays 0.25__py3-none-any.whl → 0.27__py3-none-any.whl

holidays/calendars/thai.py

@@ -14,8 +14,12 @@ from datetime import timedelta as td
 from functools import lru_cache
 from typing import Optional
 
+# Manual Assign to avoid circular import
+KHMER_CALENDAR = "KHMER_CALENDAR"
+THAI_CALENDAR = "THAI_CALENDAR"
 
-class _ThaiLuniSolar:
+
+class _ThaiLunisolar:
     """
     ** Thai Lunar Calendar Holidays only work from 1941 (B.E. 2484) onwards
        until 2057 (B.E. 2600) as we only have Thai year-type data for
@@ -25,7 +29,7 @@ class _ThaiLuniSolar:
         3-year types for calendar intercalation:
             - Pakatimat (Normal Year):
                     consist of 12 months, has 354 days.
-            - Athikawan (Extra-Day Year): a
+            - Athikawan (Extra-Day Year):
                     add a day to the 7th month of the year, has 355 days
                     for the synodic month correction.
             - Athikamat (Extra-Month Year):
@@ -41,27 +45,40 @@ class _ThaiLuniSolar:
                 the usual calendar by 1 month.
 
     List of public holidays dependent on the Thai Lunar Calendar:
-        - Magha Puja/Makha Bucha:
+        - Magha Puja/Makha Bucha/Meak Bochea:
                 15th Waxing Day (Full Moon) of Month 3
                 (On Month 4 for Athikamat Years).
-        - Royal Ploughing Ceremony:
+                KHMER_CALENDAR always fall on Month 3.
+        - Vesak/Visakha Bucha/Visaka Bochea:
+                15th Waxing Day (Full Moon) of Month 6
+                (On Month 7 for Athikamat Years).
+                KHMER_CALENDAR always fall on Month 6.
+        - Thai Royal Ploughing Ceremony/Raeknakhwan:
                 Based on this, though Court Astrologer picks the
                 auspicious dates, which sadly don't fall into a
                 predictable pattern; see its specific section below.
-        - Vesak/Visakha Bucha:
-                15th Waxing Day (Full Moon) of Month 6
+        - Cambodian Royal Ploughing Ceremony/Preah Neangkol:
+                4th Waning Day of Month 6
                 (On Month 7 for Athikamat Years).
+                This defaults to KHMER_CALENDAR (its sole user).
         - Asalha Puja/Asarnha Bucha:
                 15th Waxing Day (Full Moon) of Month 8
                 (On Month 8/8 for Athikamat Years).
+                KHMER_CALENDAR always fall on Month 8.
         - Buddhist Lent Day/Wan Khao Phansa:
                 1st Waning Day of Month 8
                 (On Month 8/8 for Athikamat Years).
+                KHMER_CALENDAR always fall on Month 8.
+        - Pchum Ben/Prachum Bandar:
+                15th Waning Day (New Moon) of Month 10.
+        - Loy Krathong/Boun That Louang/Bon Om Touk:
+                15th Waxing Day (Full Moon) of Month 12.
 
     Other Buddhist date on Thai Lunar Calendar:
         - Buddha's Cremation Day/Atthami Bucha
                 8th Waning Day of  Month 6
                 (On Month 7 for Athikamat Years).
+                KHMER_CALENDAR always fall on Month 6
         - End of Buddhist Lent Day/Ok Phansa:
                 15th Waxing Day (Full Moon) of Month 11
 
@@ -76,8 +93,8 @@ class _ThaiLuniSolar:
 
     Usage example:
 
-    >>> from holidays.utils import _ThaiLuniSolar
-    >>> thls = _ThaiLuniSolar()
+    >>> from holidays.utils import _ThaiLunisolar
+    >>> thls = _ThaiLunisolar()
     >>> print(thls.visakha_bucha_date(2010))
     2010-05-28
     """
@@ -167,6 +184,28 @@ class _ThaiLuniSolar:
     START_YEAR = 1941
     END_YEAR = 2057
 
+    def __init__(self, calendar=THAI_CALENDAR) -> None:
+        self.__verify_calendar(calendar)
+        self.__calendar = calendar
+
+    @staticmethod
+    def __is_khmer_calendar(calendar):
+        """
+        Return True if `calendar` is Khmer calendar.
+        Return False otherwise.
+        """
+        return calendar == KHMER_CALENDAR
+
+    @staticmethod
+    def __verify_calendar(calendar):
+        """
+        Verify calendar type.
+        """
+        if calendar not in {KHMER_CALENDAR, THAI_CALENDAR}:
+            raise ValueError(
+                f"Unknown calendar name: {calendar}. Use `KHMER_CALENDAR` or `THAI_CALENDAR`."
+            )
+
     @lru_cache()
     def _get_start_date(self, year: int) -> Optional[date]:
         """
@@ -181,16 +220,16 @@ class _ThaiLuniSolar:
         :return:
              The start date of Thai Lunar Calendar for a Gregorian year.
         """
-        if year < _ThaiLuniSolar.START_YEAR or year > _ThaiLuniSolar.END_YEAR:
+        if year < _ThaiLunisolar.START_YEAR or year > _ThaiLunisolar.END_YEAR:
             return None
 
-        iter_start_date = _ThaiLuniSolar.START_DATE
-        iter_start_year = _ThaiLuniSolar.START_YEAR
+        iter_start_date = _ThaiLunisolar.START_DATE
+        iter_start_year = _ThaiLunisolar.START_YEAR
 
         while iter_start_year < year:
-            if iter_start_year in _ThaiLuniSolar.ATHIKAMAT_YEARS_GREGORIAN:
+            if iter_start_year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN:
                 delta_days = 384
-            elif iter_start_year in _ThaiLuniSolar.ATHIKAWAN_YEARS_GREGORIAN:
+            elif iter_start_year in _ThaiLunisolar.ATHIKAWAN_YEARS_GREGORIAN:
                 delta_days = 355
             else:
                 delta_days = 354
@@ -198,14 +237,16 @@ class _ThaiLuniSolar:
             iter_start_year += 1
         return iter_start_date
 
-    def makha_bucha_date(self, year: int) -> Optional[date]:
+    def makha_bucha_date(self, year: int, calendar=None) -> Optional[date]:
         """
         Calculate the estimated Gregorian date of Makha Bucha.
-        If the Gregorian year input is invalud, this will outputs None instead.
+        If the Gregorian year input is invalid, this will outputs None instead.
+
+        Also known as "Magha Puja", "Makha Buxha" and "Meak Bochea".
+        This concides with the 15th Waxing Day of Month 3
+        in Thai Lunar Calendar, or Month 4 in Athikamat years.
 
-        Also known as "Magha Puja". This concides with
-        the 15th Waxing Day of Month 3 in Thai Lunar Calendar,
-        or Month 4 in Athikamat years.
+        KHMER_CALENDAR will always use Month 3 regardless of year type.
 
         To calculate, we use use the following time delta:
         - Athikamat: 15th Waxing Day of Month 4
@@ -218,30 +259,41 @@ class _ThaiLuniSolar:
         :param year:
             The Gregorian year.
 
+        :param calendar:
+            Calendar type, this defaults to THAI_CALENDAR.
+
         :return:
             Estimated Gregorian date of Makha Bucha.
         """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
         start_date = self._get_start_date(year)
         if not start_date:
             return None
 
         return start_date + td(
             days=+102
-            if year in _ThaiLuniSolar.ATHIKAMAT_YEARS_GREGORIAN
+            if (
+                year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN
+                and not self.__is_khmer_calendar(calendar)
+            )
             else +73
         )
 
-    def visakha_bucha_date(self, year: int) -> Optional[date]:
+    def visakha_bucha_date(self, year: int, calendar=None) -> Optional[date]:
         """
         Calculate the estimated Gregorian date of Visakha Bucha.
-        If the Gregorian year input is invalud, this will outputs None instead.
+        If the Gregorian year input is invalid, this will outputs None instead.
 
         Also known as "Vesak" and "Buddha Day". This concides with
         the 15th Waxing Day of Month 6 in Thai Lunar Calendar,
         or Month 7 in Athikamat years.
 
+        KHMER_CALENDAR will always use Month 6 regardless of year type.
+
         To calculate, we use use the following time delta:
-        - Athikamat: 15th Waxing Day of Month 6
+        - Athikamat: 15th Waxing Day of Month 7
                      or 177[1-6] + 15[7] -1 = 191
         - Athikawan: 15th Waxing Day of Month 6
                      or 147[1-5] + 15[6] -1 = 161
@@ -251,28 +303,68 @@ class _ThaiLuniSolar:
         :param year:
             The Gregorian year.
 
+        :param calendar:
+            Calendar type, this defaults to THAI_CALENDAR.
+
         :return:
             Estimated Gregorian date of Visakha Bucha.
         """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
         start_date = self._get_start_date(year)
         if not start_date:
             return None
 
         return start_date + td(
             days=+191
-            if year in _ThaiLuniSolar.ATHIKAMAT_YEARS_GREGORIAN
+            if (
+                year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN
+                and not self.__is_khmer_calendar(calendar)
+            )
             else +161
         )
 
-    def atthami_bucha_date(self, year: int) -> Optional[date]:
+    def preah_neangkoal_date(self, year: int) -> Optional[date]:
+        """
+        Calculate the estimated Gregorian date of Preah Neangkoal.
+        If the Gregorian year input is invalid, this will outputs None instead.
+
+        Also known as "Cambodian Royal Ploughing Ceremony". This always
+        concides with the 4th Waning Day of Month 6 in Khmer Lunar Calendar.
+
+        To calculate, we use use the following time delta:
+        - Athikamat: 15th Waxing Day of Month 6
+                     or 177[1-6] + 19[7] -1 = 165
+        - Athikawan: 15th Waxing Day of Month 6
+                     or 147[1-5] + 19[6] -1 = 165
+        - Pakatimat: 15th Waxing Day of Month 6
+                     or 147[1-5] + 19[6] -1 = 165
+        Or as in simpler terms: "Visakha Bucha" +4
+
+        :param year:
+            The Gregorian year.
+
+        :return:
+            Estimated Gregorian date of Preah Neangkoal.
+        """
+        start_date = self._get_start_date(year)
+        if not start_date:
+            return None
+
+        return start_date + td(days=+165)
+
+    def atthami_bucha_date(self, year: int, calendar=None) -> Optional[date]:
         """
         Calculate the estimated Gregorian date of Atthami Bucha.
-        If the Gregorian year input is invalud, this will outputs None instead.
+        If the Gregorian year input is invalid, this will outputs None instead.
 
         Also known as "Buddha's Cremation Day". This concides with
         the 8th Waning Day of Month 6 in Thai Lunar Calendar,
         or Month 7 in Athikamat years.
 
+        KHMER_CALENDAR will always use Month 6 regardless of year type.
+
         To calculate, we use use the following time delta:
         - Athikamat: 8th Waning Day of  Month 7
                     or 177[1-6] + 23[7] -1 = 199
@@ -285,28 +377,39 @@ class _ThaiLuniSolar:
         :param year:
             The Gregorian year.
 
+        :param calendar:
+            Calendar type, this defaults to THAI_CALENDAR.
+
         :return:
             Estimated Gregorian date of Atthami Bucha.
         """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
         start_date = self._get_start_date(year)
         if not start_date:
             return None
 
         return start_date + td(
             days=+199
-            if year in _ThaiLuniSolar.ATHIKAMAT_YEARS_GREGORIAN
+            if (
+                year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN
+                and not self.__is_khmer_calendar(calendar)
+            )
             else +169
         )
 
-    def asarnha_bucha_date(self, year: int) -> Optional[date]:
+    def asarnha_bucha_date(self, year: int, calendar=None) -> Optional[date]:
         """
         Calculate the estimated Gregorian date of Asarnha Bucha.
-        If the Gregorian year input is invalud, this will outputs None instead.
+        If the Gregorian year input is invalid, this will outputs None instead.
 
         Also known as "Asalha Puja". This concides with
         the 15th Waxing Day of Month 8 in Thai Lunar Calendar,
         or Month 8.8 in Athikamat years.
 
+        KHMER_CALENDAR will always use Month 8 regardless of year type.
+
         To calculate, we use use the following time delta:
         - Athikamat: 15th Waxing Day of Month 8/8
                      or 177[1-6] + 29[7] + 30[8] + 15[8.8] -1 = 250
@@ -318,30 +421,40 @@ class _ThaiLuniSolar:
         :param year:
             The Gregorian year.
 
+        :param calendar:
+            Calendar type, this defaults to THAI_CALENDAR.
+
         :return:
             Estimated Gregorian date of Asarnha Bucha.
         """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
         start_date = self._get_start_date(year)
         if not start_date:
             return None
 
-        if year in _ThaiLuniSolar.ATHIKAMAT_YEARS_GREGORIAN:
+        if year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN and not self.__is_khmer_calendar(
+            calendar
+        ):
             delta_days = 250
-        elif year in _ThaiLuniSolar.ATHIKAWAN_YEARS_GREGORIAN:
+        elif year in _ThaiLunisolar.ATHIKAWAN_YEARS_GREGORIAN:
             delta_days = 221
         else:
             delta_days = 220
         return start_date + td(days=delta_days)
 
-    def khao_phansa_date(self, year: int) -> Optional[date]:
+    def khao_phansa_date(self, year: int, calendar=None) -> Optional[date]:
         """
         Calculate the estimated Gregorian date of Khao Phansa.
-        If the Gregorian year input is invalud, this will outputs None instead.
+        If the Gregorian year input is invalid, this will outputs None instead.
 
         Also known as "(Start of) Buddhist Lent" and "Start of Vassa".
         This concides with the 1st Waning Day of Month 8
         in Thai Lunar Calendar, or Month 8.8 in Athikamat years.
 
+        KHMER_CALENDAR will always use Month 8 regardless of year type.
+
         To calculate, we use use the following time delta:
         - Athikamat: 1st Waning Day of Month 8.8
                      or 177[1-6] + 29[7] + 30[8] + 16[8.8] -1 = 251
@@ -354,25 +467,68 @@ class _ThaiLuniSolar:
         :param year:
             The Gregorian year.
 
+        :param calendar:
+            Calendar type, this defaults to THAI_CALENDAR.
+
         :return:
             Estimated Gregorian date of Khao Phansa.
         """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
         start_date = self._get_start_date(year)
         if not start_date:
             return None
 
-        if year in _ThaiLuniSolar.ATHIKAMAT_YEARS_GREGORIAN:
+        if year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN and not self.__is_khmer_calendar(
+            calendar
+        ):
             delta_days = 251
-        elif year in _ThaiLuniSolar.ATHIKAWAN_YEARS_GREGORIAN:
+        elif year in _ThaiLunisolar.ATHIKAWAN_YEARS_GREGORIAN:
             delta_days = 222
         else:
             delta_days = 221
         return start_date + td(days=delta_days)
 
+    def pchum_ben_date(self, year: int) -> Optional[date]:
+        """
+        Calculate the estimated Gregorian date of Pchum Ben.
+        If the Gregorian year input is invalid, this will outputs None instead.
+
+        Also known as "Prachum Bandar".
+        This concides with the 15th Waning Day of Month 10 in
+        Thai Lunar Calendar.
+
+         To calculate, we use use the following time delta:
+        - Athikamat: 15th Waning Day of Month 10
+                     or 265[1-9] + 30[8.8] + 30[10] -1 = 324
+        - Athikawan: 15th Waning Day of Month 10
+                     or 265[1-9] + 1[7] + 30[10] -1 = 295
+        - Pakatimat: 15th Waning Day of Month 10
+                     or 265[1-9] + 30[10] -1 = 294
+
+        :param year:
+            The Gregorian year.
+
+        :return:
+            Estimated Gregorian date of Pchum Ben.
+        """
+        start_date = self._get_start_date(year)
+        if not start_date:
+            return None
+
+        if year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN:
+            delta_days = 324
+        elif year in _ThaiLunisolar.ATHIKAWAN_YEARS_GREGORIAN:
+            delta_days = 295
+        else:
+            delta_days = 294
+        return start_date + td(days=delta_days)
+
     def ok_phansa_date(self, year: int) -> Optional[date]:
         """
-        Calculate the estimated Gregorian date of Ok Phansa
-        If the Gregorian year input is invalud, this will outputs None instead.
+        Calculate the estimated Gregorian date of Ok Phansa.
+        If the Gregorian year input is invalid, this will outputs None instead.
 
         Also known as "End of Buddhist Lent" and "End of Vassa".
         This concides with the 15th Waxing Day of Month 11
@@ -396,10 +552,45 @@ class _ThaiLuniSolar:
         if not start_date:
             return None
 
-        if year in _ThaiLuniSolar.ATHIKAMAT_YEARS_GREGORIAN:
+        if year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN:
             delta_days = 339
-        elif year in _ThaiLuniSolar.ATHIKAWAN_YEARS_GREGORIAN:
+        elif year in _ThaiLunisolar.ATHIKAWAN_YEARS_GREGORIAN:
             delta_days = 310
         else:
             delta_days = 309
         return start_date + td(days=delta_days)
+
+    def loy_krathong_date(self, year: int) -> Optional[date]:
+        """
+        Calculate the estimated Gregorian date of Loy Krathong.
+        If the Gregorian year input is invalid, this will outputs None instead.
+
+        Also known as "Boun That Louang" and "Bon Om Touk".
+        This concides with the 15th Waxing Day of Month 12
+        in Thai Lunar Calendar.
+
+        To calculate, we use use the following time delta:
+        - Athikamat: 15th Waxing Day of Month 12
+                     or 324[1-11] + 30[8.8] + 15[11] -1 = 368
+        - Athikawan: 15th Waxing Day of Month 12
+                     or 324[1-11] + 1[7] + 15[11] -1 = 339
+        - Pakatimat: 15th Waxing Day of Month 12
+                     or 324[1-11] + 15[11] -1 = 338
+
+        :param year:
+            The Gregorian year.
+
+        :return:
+            Estimated Gregorian date of Loy Krathong.
+        """
+        start_date = self._get_start_date(year)
+        if not start_date:
+            return None
+
+        if year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN:
+            delta_days = 368
+        elif year in _ThaiLunisolar.ATHIKAWAN_YEARS_GREGORIAN:
+            delta_days = 339
+        else:
+            delta_days = 338
+        return start_date + td(days=delta_days)

holidays/countries/__init__.py

@@ -24,13 +24,19 @@ from .bahrain import Bahrain, BH, BAH
 from .bangladesh import Bangladesh, BD, BGD
 from .belarus import Belarus, BY, BLR
 from .belgium import Belgium, BE, BEL
+from .belize import Belize, BZ, BLZ
 from .bolivia import Bolivia, BO, BOL
 from .bosnia_and_herzegovina import BosniaAndHerzegovina, BA, BIH
 from .botswana import Botswana, BW, BWA
 from .brazil import Brazil, BR, BRA
+from .brunei import Brunei, BN, BRN
 from .bulgaria import Bulgaria, BG, BLG
+from .burkina_faso import BurkinaFaso, BF, BFA
 from .burundi import Burundi, BI, BDI
+from .cambodia import Cambodia, KH, KHM
+from .cameroon import Cameroon, CM, CMR
 from .canada import Canada, CA, CAN
+from .chad import Chad, TD, TCD
 from .chile import Chile, CL, CHL
 from .china import China, CN, CHN
 from .colombia import Colombia, CO, COL
@@ -45,11 +51,13 @@ from .djibouti import Djibouti, DJ, DJI
 from .dominican_republic import DominicanRepublic, DO, DOM
 from .ecuador import Ecuador, EC, ECU
 from .egypt import Egypt, EG, EGY
+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 .finland import Finland, FI, FIN
 from .france import France, FR, FRA
+from .gabon import Gabon, GA, GAB
 from .georgia import Georgia, GE, GEO
 from .germany import Germany, DE, DEU
 from .greece import Greece, GR, GRC

holidays/countries/albania.py

@@ -14,13 +14,10 @@ from datetime import timedelta as td
 from holidays.calendars import JULIAN_CALENDAR
 from holidays.constants import JAN, MAR, SEP, OCT, NOV, DEC
 from holidays.holiday_base import HolidayBase
-from holidays.holiday_groups import ChristianHolidays, IslamicHolidays
-from holidays.holiday_groups import InternationalHolidays
+from holidays.holiday_groups import ChristianHolidays, IslamicHolidays, InternationalHolidays
 
 
-class Albania(
-    HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays
-):
+class Albania(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays):
     """
     References:
       - https://en.wikipedia.org/wiki/Public_holidays_in_Albania
@@ -56,22 +53,16 @@ class Albania(
 
         # Easter.
         observed_dates.add(self._add_easter_sunday("Catholic Easter"))
-        observed_dates.add(
-            self._add_easter_sunday("Orthodox Easter", JULIAN_CALENDAR)
-        )
+        observed_dates.add(self._add_easter_sunday("Orthodox Easter", JULIAN_CALENDAR))
 
         # May Day.
         observed_dates.add(self._add_labor_day("May Day"))
 
         # Mother Teresa Day.
         if 2004 <= year <= 2017:
-            observed_dates.add(
-                self._add_holiday("Mother Teresa Beatification Day", OCT, 19)
-            )
+            observed_dates.add(self._add_holiday("Mother Teresa Beatification Day", OCT, 19))
         elif year >= 2018:
-            observed_dates.add(
-                self._add_holiday("Mother Teresa Canonization Day", SEP, 5)
-            )
+            observed_dates.add(self._add_holiday("Mother Teresa Canonization Day", SEP, 5))
 
         # Independence Day.
         observed_dates.add(self._add_holiday("Independence Day", NOV, 28))
@@ -100,9 +91,7 @@ class Albania(
                 while self._is_weekend(obs_date) or obs_date in observed_dates:
                     obs_date += td(days=+1)
                 for hol_name in self.get_list(hol_date):
-                    observed_dates.add(
-                        self._add_holiday("%s (Observed)" % hol_name, obs_date)
-                    )
+                    observed_dates.add(self._add_holiday("%s (Observed)" % hol_name, obs_date))
 
             # observed holidays special cases
             if year == 2007:

holidays/countries/andorra.py

@@ -115,9 +115,7 @@ class Andorra(HolidayBase, ChristianHolidays, InternationalHolidays):
     # Sant Julià de Lòria.
     def _add_subdiv_06_holidays(self):
         name = "Sant Julià de Lòria Annual Festival"
-        last_fri_of_july = _get_nth_weekday_from(
-            -1, FRI, date(self._year, JUL, 29)
-        )
+        last_fri_of_july = _get_nth_weekday_from(-1, FRI, date(self._year, JUL, 29))
         self._add_holiday(name, last_fri_of_july)
         self._add_holiday(name, last_fri_of_july + td(days=+1))
         self._add_holiday(name, last_fri_of_july + td(days=+2))
@@ -126,9 +124,7 @@ class Andorra(HolidayBase, ChristianHolidays, InternationalHolidays):
     # Andorra la Vella.
     def _add_subdiv_07_holidays(self):
         name = "Andorra la Vella Annual Festival"
-        first_sat_of_august = _get_nth_weekday_of_month(
-            1, SAT, AUG, self._year
-        )
+        first_sat_of_august = _get_nth_weekday_of_month(1, SAT, AUG, self._year)
         self._add_holiday(name, first_sat_of_august)
         self._add_holiday(name, first_sat_of_august + td(days=+1))
         self._add_holiday(name, first_sat_of_august + td(days=+2))