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

holidays/countries/botswana.py

@@ -12,14 +12,13 @@
 from datetime import date
 from datetime import timedelta as td
 
-from dateutil.easter import easter
-
 from holidays.calendars import _get_nth_weekday_of_month
-from holidays.constants import JAN, MAY, JUL, SEP, DEC, MON
+from holidays.constants import JUL, SEP, MON
 from holidays.holiday_base import HolidayBase
+from holidays.holiday_groups import ChristianHolidays, InternationalHolidays
 
 
-class Botswana(HolidayBase):
+class Botswana(HolidayBase, ChristianHolidays, InternationalHolidays):
     """
     https://www.gov.bw/public-holidays
     https://publicholidays.africa/botswana/2021-dates/
@@ -28,60 +27,54 @@ class Botswana(HolidayBase):
     """
 
     country = "BW"
-    special_holidays = {2019: ((JUL, 2, "Public Holiday"),)}
-
-    def _populate(self, year: int):
-        def _add_with_observed(
-            hol_date: date, hol_name1: str, hol_name2: str = None
-        ) -> None:
-            self[hol_date] = hol_name1
-            if hol_name2:
-                self[hol_date + td(days=+1)] = hol_name2
-
-            if self.observed and year >= 1995:
-                if self._is_saturday(hol_date) and hol_name2:
-                    self[hol_date + td(days=+2)] = f"{hol_name2} (Observed)"
-                elif self._is_sunday(hol_date):
-                    self[
-                        hol_date + td(days=+2 if hol_name2 else +1)
-                    ] = f"{hol_name1} (Observed)"
+    special_holidays = {2019: (JUL, 2, "Public Holiday")}
+
+    def __init__(self, *args, **kwargs) -> None:
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
 
+    def _add_observed(self, dt: date, days: int = +1) -> None:
+        if self.observed and self._is_sunday(dt) and self._year >= 1995:
+            self._add_holiday("%s (Observed)" % self[dt], dt + td(days=days))
+
+    def _populate(self, year):
         if year <= 1965:
             return None
 
         super()._populate(year)
 
-        _add_with_observed(
-            date(year, JAN, 1), "New Year's Day", "New Year's Day Holiday"
-        )
+        self._add_observed(self._add_new_years_day("New Year's Day"), days=+2)
+        self._add_observed(self._add_new_years_day_two("New Year's Day Holiday"))
 
         # Easter and easter related calculations
-        easter_date = easter(year)
-        self[easter_date + td(days=-2)] = "Good Friday"
-        self[easter_date + td(days=-1)] = "Holy Saturday"
-        self[easter_date + td(days=+1)] = "Easter Monday"
-        self[easter_date + td(days=+39)] = "Ascension Day"
+        self._add_good_friday("Good Friday")
+        self._add_holy_saturday("Holy Saturday")
+        self._add_easter_monday("Easter Monday")
+        self._add_ascension_thursday("Ascension Day")
 
-        _add_with_observed(date(year, MAY, 1), "Labour Day")
-        if self.observed and year >= 2016 and self._is_saturday(MAY, 1):
-            self[date(year, MAY, 1) + td(days=+2)] = "Labour Day Holiday"
+        may_1 = self._add_labor_day("Labour Day")
+        self._add_observed(may_1)
+        if self.observed and year >= 2016 and self._is_saturday(may_1):
+            self._add_holiday("Labour Day Holiday", may_1 + td(days=+2))
 
-        _add_with_observed(date(year, JUL, 1), "Sir Seretse Khama Day")
+        self._add_observed(self._add_holiday("Sir Seretse Khama Day", JUL, 1))
 
-        # 3rd Monday of July = "President's Day"
-        dt = _get_nth_weekday_of_month(3, MON, JUL, year)
-
-        self[dt] = "President's Day"
-        self[dt + td(days=+1)] = "President's Day Holiday"
-
-        _add_with_observed(
-            date(year, SEP, 30), "Botswana Day", "Botswana Day Holiday"
+        july_3rd_monday = self._add_holiday(
+            "President's Day", _get_nth_weekday_of_month(3, MON, JUL, year)
         )
+        self._add_holiday("President's Day Holiday", july_3rd_monday + td(days=+1))
+
+        sep_30 = self._add_holiday("Botswana Day", SEP, 30)
+        self._add_observed(sep_30, days=+2)
+        self._add_observed(self._add_holiday("Botswana Day Holiday", sep_30 + td(days=+1)))
 
-        _add_with_observed(date(year, DEC, 25), "Christmas Day", "Boxing Day")
+        self._add_observed(self._add_christmas_day("Christmas Day"), days=+2)
+        dec_26 = self._add_christmas_day_two("Boxing Day")
+        self._add_observed(dec_26)
 
-        if self.observed and year >= 2016 and self._is_saturday(DEC, 26):
-            self[date(year, DEC, 26) + td(days=+2)] = "Boxing Day Holiday"
+        if self.observed and year >= 2016 and self._is_saturday(dec_26):
+            self._add_holiday("Boxing Day Holiday", dec_26 + td(days=+2))
 
 
 class BW(Botswana):

holidays/countries/brazil.py

@@ -13,8 +13,7 @@ from datetime import timedelta as td
 from datetime import date
 
 from holidays.calendars import _get_nth_weekday_from, _get_nth_weekday_of_month
-from holidays.constants import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP
-from holidays.constants import OCT, NOV, DEC, FRI, SUN
+from holidays.constants import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC, FRI, SUN
 from holidays.holiday_base import HolidayBase
 from holidays.holiday_groups import ChristianHolidays, InternationalHolidays
 
@@ -150,9 +149,7 @@ class Brazil(HolidayBase, ChristianHolidays, InternationalHolidays):
         def get_movable_acre(*args) -> date:
             dt = date(self._year, *args)
             if self._year >= 2009 and (
-                self._is_tuesday(dt)
-                or self._is_wednesday(dt)
-                or self._is_thursday(dt)
+                self._is_tuesday(dt) or self._is_wednesday(dt) or self._is_thursday(dt)
             ):
                 dt = _get_nth_weekday_from(1, FRI, dt)
             return dt
@@ -215,7 +212,7 @@ class Brazil(HolidayBase, ChristianHolidays, InternationalHolidays):
 
         if self._year >= 2012:
             # Saint James' Day.
-            self._add_holiday("São Tiago", JUL, 25)
+            self._add_saint_james_day("São Tiago")
 
         # Creation of the Federal Territory.
         self._add_holiday("Criação do Território Federal", SEP, 13)
@@ -309,7 +306,7 @@ class Brazil(HolidayBase, ChristianHolidays, InternationalHolidays):
     def _add_subdiv_rj_holidays(self):
         if self._year >= 2008:
             # Saint George's Day.
-            self._add_holiday("São Jorge", APR, 23)
+            self._add_saint_georges_day("São Jorge")
 
         if self._year >= 2002:
             self._add_holiday("Consciência Negra", NOV, 20)

holidays/countries/brunei.py

@@ -0,0 +1,427 @@
+#  python-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: dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from datetime import timedelta as td
+from gettext import gettext as tr
+
+from holidays.calendars import _CustomIslamicCalendar
+from holidays.constants import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
+from holidays.holiday_base import HolidayBase
+from holidays.holiday_groups import (
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+)
+
+
+class Brunei(
+    HolidayBase,
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+):
+    """
+    A subclass of :py:class:`HolidayBase` representing public holidays
+    in Brunei Darussalam.
+
+
+    References:
+
+    - Based on: http://www.labour.gov.bn/Lists/Upcomming%20events/AllItems.aspx
+                http://www.labour.gov.bn/Download/GUIDE%20TO%20BRUNEI%20EMPLOYMENT%20LAWS%20-%20english%20version-3.pdf  # noqa: E501
+    - Checked with: https://asean.org/wp-content/uploads/2021/12/ASEAN-National-Holidays-2022.pdf  # noqa: E501
+                    https://asean.org/wp-content/uploads/2022/12/ASEAN-Public-Holidays-2023.pdf  # noqa: E501
+                    https://www.timeanddate.com/holidays/brunei/
+    - [Jubli Emas Sultan Hassanal Bolkiah]
+        https://www.brudirect.com/news.php?id=28316
+
+    Limitations:
+
+    - Brunei Darussalam holidays only works from 1984 onwards
+    - Islamic holidays
+
+
+    Country created by: `PPsyrius <https://github.com/PPsyrius>`__
+
+    Country maintained by: `PPsyrius <https://github.com/PPsyrius>`__
+    """
+
+    country = "BN"
+    default_language = "ms"
+    estimated_label = tr("%s* (*anggaran)")
+    supported_languages = ("en_US", "ms", "th")
+
+    special_holidays = {
+        # Sultan Hassanal Bolkiah's Golden Jubilee celebration
+        2017: (OCT, 5, tr("Jubli Emas Sultan Hassanal Bolkiah")),
+    }
+
+    def __init__(self, *args, **kwargs):
+        ChineseCalendarHolidays.__init__(self)
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(self, calendar=BruneiIslamicCalendar())
+
+        super().__init__(*args, **kwargs)
+
+    def _populate(self, year):
+        # Available post-Independence from 1984 afterwards
+        if year <= 1983:
+            return None
+
+        def _add_observed(dt: date) -> None:
+            """
+            If Public Holiday falls on either Friday or Sunday, in-lieu
+            observance is given out on the following Saturday or Monday.
+            """
+            if self.observed and (self._is_friday(dt) or self._is_sunday(dt)):
+                for name in self.get_list(dt):
+                    self._add_holiday(self.tr("%s - Diperhatikan") % name, dt + td(days=+1))
+
+        super()._populate(year)
+
+        # Awal Tahun Masihi
+        # Status: In-Use.
+
+        # New Year's Day
+        _add_observed(self._add_new_years_day(tr("Awal Tahun Masihi")))
+
+        # Tahun Baru Cina
+        # Status: In-Use.
+
+        # Lunar New Year
+        _add_observed(self._add_chinese_new_years_day(tr("Tahun Baru Cina")))
+
+        # Hari Kebangsaan
+        # Status: In-Use.
+        # Starts in 1984.
+
+        # National Day
+        _add_observed(self._add_holiday(tr("Hari Kebangsaan"), FEB, 23))
+
+        # Hari Angkatan Bersenjata Diraja Brunei
+        # Status: In-Use.
+        # Starts in 1984.
+        # Commemorates the formation of Royal Brunei Malay Regiment in 1961.
+
+        _add_observed(
+            self._add_holiday(
+                # Armed Forces Day
+                tr("Hari Angkatan Bersenjata Diraja Brunei"),
+                MAY,
+                31,
+            )
+        )
+
+        # Hari Keputeraan KDYMM Sultan Brunei
+        # Status: In-Use.
+        # Started in 1968.
+
+        _add_observed(
+            self._add_holiday(
+                # Sultan Hassanal Bolkiah's Birthday
+                tr("Hari Keputeraan KDYMM Sultan Brunei"),
+                JUL,
+                15,
+            )
+        )
+
+        # Hari Natal
+        # Status: In-Use.
+
+        # Christmas Day
+        _add_observed(self._add_christmas_day(tr("Hari Natal")))
+
+        # Islamic Holidays are placed after Gregorian holidays to prevent
+        # the duplication of observed tags. - see #1168
+
+        # Israk dan Mikraj
+        # Status: In-Use.
+
+        # Isra Mi'raj
+        for dt in self._add_isra_and_miraj_day(tr("Israk dan Mikraj")):
+            _add_observed(dt)
+
+        # Hari Pertama Berpuasa
+        # Status: In-Use.
+
+        # First Day of Ramadan
+        for dt in self._add_ramadan_beginning_day(tr("Hari Pertama Berpuasa")):
+            _add_observed(dt)
+
+        # Hari Nuzul Al-Quran
+        # Status: In-Use.
+
+        # Anniversary of the revelation of the Quran
+        for dt in self._add_nuzul_al_quran_day(tr("Hari Nuzul Al-Quran")):
+            _add_observed(dt)
+
+        # Hari Raya Aidil Fitri
+        # Status: In-Use.
+        # This is celebrate for three days in Brunei.
+        # Observed as 'Hari Raya Puasa' and only for 2 days at certain point.
+        # We utilizes a separate in-lieu trigger for this one.
+        # 1: If Wed-Thu-Fri -> Sat (+3)
+        # 2: If Thu-Fri-Sat -> Mon (+4)
+        # 3: If Fri-Sat-Sun -> Mon (+3)
+        # 4: If Sat-Sun-Mon -> Tue (+3)
+        # 5: If Sun-Mon-Tue -> Wed (+3)
+
+        # Eid al-Fitr
+        name = tr("Hari Raya Aidil Fitri")
+
+        al_fitr_dates = self._add_eid_al_fitr_day(name)
+        self._add_eid_al_fitr_day_two(name)
+        self._add_eid_al_fitr_day_three(name)
+
+        if self.observed:
+            for dt in al_fitr_dates:
+                obs_date = None
+                for delta in range(3):
+                    hol_date = dt + td(days=delta)
+                    if self._is_friday(hol_date) or self._is_sunday(hol_date):
+                        obs_date = dt + td(days=+3)
+                        if self._is_sunday(obs_date):
+                            obs_date += td(days=+1)
+                        break
+                if obs_date:
+                    self._add_islamic_calendar_holiday(
+                        self.tr("%s - Diperhatikan") % self[hol_date],
+                        (
+                            (
+                                obs_date,
+                                self._year not in BruneiIslamicCalendar.EID_AL_FITR_DATES,
+                            ),
+                        ),
+                    )
+
+        # Hari Raya Aidil Adha
+        # Status: In-Use.
+
+        # Eid al-Adha
+        for dt in self._add_eid_al_adha_day(tr("Hari Raya Aidil Adha")):
+            _add_observed(dt)
+
+        # Awal Tahun Hijrah
+        # Status: In-Use.
+
+        # Islamic New Year
+        for dt in self._add_islamic_new_year_day(tr("Awal Tahun Hijrah")):
+            _add_observed(dt)
+
+        # Maulidur Rasul
+        # Status: In-Use.
+
+        # Birth of the Prophet
+        for dt in self._add_mawlid_day(tr("Maulidur Rasul")):
+            _add_observed(dt)
+
+
+class BN(Brunei):
+    pass
+
+
+class BRN(Brunei):
+    pass
+
+
+class BruneiIslamicCalendar(_CustomIslamicCalendar):
+    EID_AL_ADHA_DATES = {
+        2000: (MAR, 16),
+        2001: (MAR, 6),
+        2002: (FEB, 23),
+        2003: (FEB, 12),
+        2004: (FEB, 2),
+        2005: (JAN, 21),
+        2006: ((JAN, 10), (DEC, 31)),
+        2007: (DEC, 20),
+        2008: (DEC, 9),
+        2009: (NOV, 28),
+        2010: (NOV, 17),
+        2011: (NOV, 7),
+        2012: (OCT, 26),
+        2013: (OCT, 15),
+        2014: (OCT, 5),
+        2015: (SEP, 24),
+        2016: (SEP, 13),
+        2017: (SEP, 2),
+        2018: (AUG, 22),
+        2019: (AUG, 11),
+        2020: (AUG, 1),
+        2021: (JUL, 20),
+        2022: (JUL, 10),
+        2023: (JUN, 29),
+    }
+
+    EID_AL_FITR_DATES = {
+        2000: ((JAN, 8), (DEC, 28)),
+        2001: (DEC, 17),
+        2002: (DEC, 6),
+        2003: (NOV, 26),
+        2004: (NOV, 14),
+        2005: (NOV, 3),
+        2006: (OCT, 24),
+        2007: (OCT, 13),
+        2008: (OCT, 1),
+        2009: (SEP, 20),
+        2010: (SEP, 10),
+        2011: (AUG, 31),
+        2012: (AUG, 19),
+        2013: (AUG, 8),
+        2014: (JUL, 29),
+        2015: (JUL, 18),
+        2016: (JUL, 7),
+        2017: (JUN, 26),
+        2018: (JUN, 15),
+        2019: (JUN, 5),
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 3),
+        2023: (APR, 22),
+    }
+
+    HIJRI_NEW_YEAR_DATES = {
+        2000: (APR, 6),
+        2001: (MAR, 26),
+        2002: (MAR, 15),
+        2003: (MAR, 5),
+        2004: (FEB, 22),
+        2005: (FEB, 10),
+        2006: (JAN, 31),
+        2007: (JAN, 20),
+        2008: ((JAN, 10), (DEC, 29)),
+        2009: (DEC, 18),
+        2010: (DEC, 8),
+        2011: (NOV, 27),
+        2012: (NOV, 15),
+        2013: (NOV, 5),
+        2014: (OCT, 25),
+        2015: (OCT, 15),
+        2016: (OCT, 3),
+        2017: (SEP, 22),
+        2018: (SEP, 12),
+        2019: (SEP, 1),
+        2020: (AUG, 20),
+        2021: (AUG, 10),
+        2022: (JUL, 30),
+        2023: (JUL, 19),
+    }
+
+    ISRA_AND_MIRAJ_DATES = {
+        2000: (OCT, 26),
+        2001: (OCT, 15),
+        2002: (OCT, 4),
+        2003: (SEP, 24),
+        2004: (SEP, 12),
+        2005: (SEP, 1),
+        2006: (AUG, 22),
+        2007: (AUG, 11),
+        2008: (JUL, 31),
+        2009: (JUL, 20),
+        2010: (JUL, 9),
+        2011: (JUN, 29),
+        2012: (JUN, 17),
+        2013: (JUN, 6),
+        2014: (MAY, 27),
+        2015: (MAY, 16),
+        2016: (MAY, 5),
+        2017: (APR, 24),
+        2018: (APR, 14),
+        2019: (APR, 3),
+        2020: (MAR, 22),
+        2021: (MAR, 11),
+        2022: (MAR, 1),
+        2023: (FEB, 18),
+    }
+
+    MAWLID_DATES = {
+        2000: (JUN, 15),
+        2001: (JUN, 4),
+        2002: (MAY, 24),
+        2003: (MAY, 14),
+        2004: (MAY, 2),
+        2005: (APR, 21),
+        2006: (APR, 11),
+        2007: (MAR, 31),
+        2008: (MAR, 20),
+        2009: (MAR, 9),
+        2010: (FEB, 26),
+        2011: (FEB, 16),
+        2012: (FEB, 5),
+        2013: (JAN, 24),
+        2014: (JAN, 14),
+        2015: ((JAN, 3), (DEC, 24)),
+        2016: (DEC, 12),
+        2017: (DEC, 1),
+        2018: (NOV, 21),
+        2019: (NOV, 9),
+        2020: (OCT, 29),
+        2021: (OCT, 19),
+        2022: (OCT, 8),
+        2023: (SEP, 28),
+    }
+
+    NUZUL_AL_QURAN_DATES = {
+        2000: (DEC, 14),
+        2001: (DEC, 3),
+        2002: (NOV, 22),
+        2003: (NOV, 12),
+        2004: (NOV, 1),
+        2005: (OCT, 21),
+        2006: (OCT, 10),
+        2007: (SEP, 29),
+        2008: (SEP, 18),
+        2009: (SEP, 7),
+        2010: (AUG, 27),
+        2011: (AUG, 17),
+        2012: (AUG, 5),
+        2013: (JUL, 25),
+        2014: (JUL, 15),
+        2015: (JUL, 4),
+        2016: (JUN, 23),
+        2017: (JUN, 12),
+        2018: (JUN, 2),
+        2019: (MAY, 23),
+        2020: (MAY, 10),
+        2021: (APR, 29),
+        2022: (APR, 19),
+        2023: (APR, 8),
+    }
+
+    RAMADAN_BEGINNING_DATES = {
+        2000: (NOV, 28),
+        2001: (NOV, 17),
+        2002: (NOV, 6),
+        2003: (OCT, 27),
+        2004: (OCT, 16),
+        2005: (OCT, 5),
+        2006: (SEP, 24),
+        2007: (SEP, 13),
+        2008: (SEP, 2),
+        2009: (AUG, 22),
+        2010: (AUG, 11),
+        2011: (AUG, 1),
+        2012: (JUL, 20),
+        2013: (JUL, 9),
+        2014: (JUN, 29),
+        2015: (JUN, 18),
+        2016: (JUN, 7),
+        2017: (MAY, 27),
+        2018: (MAY, 16),
+        2019: (MAY, 6),
+        2020: (APR, 25),
+        2021: (APR, 13),
+        2022: (APR, 3),
+        2023: (MAR, 23),
+    }

holidays/countries/bulgaria.py

@@ -41,6 +41,7 @@ class Bulgaria(HolidayBase):
 
     country = "BG"
     default_language = "bg"
+    supported_languages = ("bg", "en_US")
 
     def _populate(self, year):
         if year < 1990:
@@ -52,9 +53,7 @@ class Bulgaria(HolidayBase):
         self._add_holiday(tr("Нова година"), JAN, 1)
 
         # Liberation Day.
-        self._add_holiday(
-            tr("Ден на Освобождението на България от османско иго"), MAR, 3
-        )
+        self._add_holiday(tr("Ден на Освобождението на България от османско иго"), MAR, 3)
 
         # International Workers' Day.
         self._add_holiday(
@@ -64,9 +63,7 @@ class Bulgaria(HolidayBase):
         )
 
         # Saint George's Day.
-        self._add_holiday(
-            tr("Гергьовден, Ден на храбростта и Българската армия"), MAY, 6
-        )
+        self._add_holiday(tr("Гергьовден, Ден на храбростта и Българската армия"), MAY, 6)
 
         # Bulgarian Education and Culture and Slavonic Literature Day.
         self._add_holiday(