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

holidays/groups/hindu.py

@@ -10,6 +10,7 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from collections.abc import Iterable
 from datetime import date
 from typing import Optional
 
@@ -35,10 +36,54 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
         Adds customizable estimation label to holiday name if holiday date
         is an estimation.
         """
+
         return self._add_eastern_calendar_holiday(
             name, dt_estimated, self._hindu_calendar_show_estimated
         )
 
+    def _add_hindu_calendar_holiday_set(
+        self, name: str, dts_estimated: Iterable[tuple[date, bool]], days_delta: int = 0
+    ) -> set[date]:
+        """
+        Add Hindu calendar holidays.
+
+        Adds customizable estimation label to holiday name if holiday date
+        is an estimation.
+        """
+        added_dates = set()
+        for dt_estimated in dts_estimated:
+            if dt := self._add_eastern_calendar_holiday(
+                name, dt_estimated, self._hindu_calendar_show_estimated, days_delta=days_delta
+            ):
+                added_dates.add(dt)
+
+        return added_dates
+
+    def _add_buddha_purnima(self, name) -> Optional[date]:
+        """
+        Add Buddha Purnima.
+
+        Buddha Purnima, also known as Vesak, commemorates the birth, enlightenment,
+        and passing of Gautama Buddha. It falls on the full moon day of the
+        Hindu month of Vaisakha (April-May).
+        https://en.wikipedia.org/wiki/Vesak
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.buddha_purnima_date(self._year)
+        )
+
+    def _add_chhath_puja(self, name) -> Optional[date]:
+        """
+        Add Chhath Puja.
+
+        Chhath Puja is a Hindu festival dedicated to the Sun God (Surya).
+        It is observed six days after Diwali in the month of Kartika (October-November).
+        https://en.wikipedia.org/wiki/Chhath
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.chhath_puja_date(self._year)
+        )
+
     def _add_diwali(self, name) -> Optional[date]:
         """
         Add Diwali Festival.
@@ -51,6 +96,204 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
         """
         return self._add_hindu_calendar_holiday(name, self._hindu_calendar.diwali_date(self._year))
 
+    def _add_diwali_india(self, name) -> Optional[date]:
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.diwali_india_date(self._year)
+        )
+
+    def _add_dussehra(self, name) -> Optional[date]:
+        """
+        Add Dussehra Festival.
+
+        Dussehra (Vijayadashami) is a major Hindu festival that marks the end
+        of Navratri. It is celebrated on the 10th day of the Hindu lunisolar
+        month of Ashvin (September-October).
+        https://en.wikipedia.org/wiki/Vijayadashami
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.dussehra_date(self._year)
+        )
+
+    def _add_ganesh_chaturthi(self, name) -> Optional[date]:
+        """
+        Add Ganesh Chaturthi.
+
+        Ganesh Chaturthi is a Hindu festival celebrating the birth of Lord Ganesha.
+        It falls on the fourth day of the Hindu month of Bhadrapada (August/September).
+        https://en.wikipedia.org/wiki/Ganesh_Chaturthi
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.ganesh_chaturthi_date(self._year)
+        )
+
+    def _add_govardhan_puja(self, name) -> Optional[date]:
+        """
+        Add Govardhan Puja.
+
+        Govardhan Puja, also known as Annakut, is celebrated the day after Diwali
+        to honor Lord Krishna. It falls on the first lunar day of the Hindu month of Kartika.
+        https://en.wikipedia.org/wiki/Govardhan_Puja
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.govardhan_puja_date(self._year)
+        )
+
+    def _add_gudi_padwa(self, name) -> Optional[date]:
+        """
+        Add Gudi Padwa.
+
+        Gudi Padwa is the traditional New Year festival for Maharashtrians.
+        It falls on the first day of Chaitra (March-April).
+        https://en.wikipedia.org/wiki/Gudi_Padwa
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.gudi_padwa_date(self._year)
+        )
+
+    def _add_guru_gobind_singh_jayanti(self, name) -> set[date]:
+        """
+        Add Guru Gobind Singh Jayanti.
+
+        Guru Gobind Singh Jayanti commemorates the birth anniversary of
+        Guru Gobind Singh, the tenth Sikh Guru. It follows the Nanakshahi calendar.
+        https://en.wikipedia.org/wiki/Guru_Gobind_Singh
+        """
+        return self._add_hindu_calendar_holiday_set(
+            name, self._hindu_calendar.guru_gobind_singh_jayanti_date(self._year)
+        )
+
+    def _add_guru_nanak_jayanti(self, name) -> Optional[date]:
+        """
+        Add Guru Nanak Jayanti.
+
+        Guru Nanak Jayanti celebrates the birth anniversary of Guru Nanak,
+        the founder of Sikhism. It is observed on the full moon day of
+        Kartik (October-November).
+        https://en.wikipedia.org/wiki/Guru_Nanak_Gurpurab
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.guru_nanak_jayanti_date(self._year)
+        )
+
+    def _add_holi(self, name) -> Optional[date]:
+        """
+        Add Holi Festival.
+
+        Holi, known as the Festival of Colors, is a Hindu festival that marks
+        the arrival of spring. It is celebrated on the full moon day of the
+        Hindu month of Phalguna (February/March).
+        https://en.wikipedia.org/wiki/Holi
+        """
+        return self._add_hindu_calendar_holiday(name, self._hindu_calendar.holi_date(self._year))
+
+    def _add_janmashtami(self, name) -> Optional[date]:
+        """
+        Add Janmashtami.
+
+        Janmashtami is a Hindu festival that celebrates the birth of Lord Krishna.
+        It falls on the eighth day of the Hindu month of Bhadrapada (August/September).
+        https://en.wikipedia.org/wiki/Krishna_Janmashtami
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.janmashtami_date(self._year)
+        )
+
+    def _add_maha_navami(self, name) -> Optional[date]:
+        """
+        Add Maha Navami.
+
+        Maha Navami is the ninth day of Navratri, dedicated to Goddess Durga.
+        It is observed in Ashvin (September-October).
+        https://en.wikipedia.org/wiki/Navaratri
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.maha_navami_date(self._year)
+        )
+
+    def _add_maha_shivaratri(self, name) -> Optional[date]:
+        """
+        Add Maha Shivaratri.
+
+        Maha Shivaratri is a Hindu festival dedicated to Lord Shiva. It is celebrated
+        on the 14th night of the Hindu month of Phalguna (February/March).
+        https://en.wikipedia.org/wiki/Maha_Shivaratri
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.maha_shivaratri_date(self._year)
+        )
+
+    def _add_mahavir_jayanti(self, name) -> Optional[date]:
+        """
+        Add Mahavir Jayanti.
+
+        Mahavir Jayanti celebrates the birth of Lord Mahavira, the 24th
+        Tirthankara of Jainism. It falls on the 13th day of Chaitra (March-April).
+        https://en.wikipedia.org/wiki/Mahavir_Jayanti
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.mahavir_jayanti_date(self._year)
+        )
+
+    def _add_makar_sankranti(self, name) -> Optional[date]:
+        """
+        Add Makar Sankranti.
+
+        Makar Sankranti is a Hindu festival that marks the transition of the Sun
+        into Capricorn (Makar). It is celebrated on January 14th or 15th every year.
+        https://en.wikipedia.org/wiki/Makar_Sankranti
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.makar_sankranti_date(self._year)
+        )
+
+    def _add_onam(self, name) -> Optional[date]:
+        """
+        Add Onam.
+
+        Onam is a major festival in Kerala, celebrating the homecoming of
+        King Mahabali. It falls in the month of Chingam (August-September).
+        https://en.wikipedia.org/wiki/Onam
+        """
+        return self._add_hindu_calendar_holiday(name, self._hindu_calendar.onam_date(self._year))
+
+    def _add_raksha_bandhan(self, name) -> Optional[date]:
+        """
+        Add Raksha Bandhan.
+
+        Raksha Bandhan is a Hindu festival that celebrates the bond between
+        brothers and sisters. It falls on the full moon day of the Hindu month
+        of Shravana (July/August).
+        https://en.wikipedia.org/wiki/Raksha_Bandhan
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.raksha_bandhan_date(self._year)
+        )
+
+    def _add_ram_navami(self, name) -> Optional[date]:
+        """
+        Add Ram Navami.
+
+        Ram Navami is a Hindu festival celebrating the birth of Lord Rama.
+        It is observed on the ninth day of the Hindu month of Chaitra (March/April).
+        https://en.wikipedia.org/wiki/Rama_Navami
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.ram_navami_date(self._year)
+        )
+
+    def _add_sharad_navratri(self, name) -> Optional[date]:
+        """
+        Add Navratri / Sharad Navratri.
+
+        Navratri is a Hindu festival dedicated to the worship of Goddess Durga.
+        It is celebrated over nine nights and occurs in the lunar month of Ashvin
+        (September/October).
+        https://en.wikipedia.org/wiki/Navratri
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.sharad_navratri_date(self._year)
+        )
+
     def _add_thaipusam(self, name) -> Optional[date]:
         """
         Add Thaipusam.
@@ -62,3 +305,15 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
         return self._add_hindu_calendar_holiday(
             name, self._hindu_calendar.thaipusam_date(self._year)
         )
+
+    def _add_vaisakhi(self, name) -> Optional[date]:
+        """
+        Add Vaisakhi.
+
+        Vaisakhi is a major Sikh festival marking the Sikh New Year and the
+        founding of the Khalsa. It falls on April 13 or 14.
+        https://en.wikipedia.org/wiki/Vaisakhi
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.vaisakhi_date(self._year)
+        )

holidays/groups/islamic.py

@@ -25,8 +25,9 @@ class IslamicHolidays(EasternCalendarHolidays):
     calendar consisting of 12 lunar months in a year of 354 or 355 days.
     """
 
-    def __init__(self, cls=None) -> None:
+    def __init__(self, cls=None, show_estimated=True) -> None:
         self._islamic_calendar = cls() if cls else _IslamicLunar()
+        self._islamic_calendar_show_estimated = show_estimated
 
     def _add_ali_al_rida_death_day(self, name) -> set[date]:
         """
@@ -262,7 +263,9 @@ class IslamicHolidays(EasternCalendarHolidays):
         """
         added_dates = set()
         for dts in dates:
-            if dt := self._add_eastern_calendar_holiday(name, dts, days_delta=days_delta):
+            if dt := self._add_eastern_calendar_holiday(
+                name, dts, self._islamic_calendar_show_estimated, days_delta
+            ):
                 added_dates.add(dt)
 
         return added_dates

holidays/holiday_base.py

@@ -361,40 +361,15 @@ class HolidayBase(dict[date, str]):
         self.expand = expand
         self.has_special_holidays = getattr(self, "has_special_holidays", False)
         self.has_substituted_holidays = has_substituted_holidays
-        self.language = language.lower() if language else None
+        self.language = language
         self.observed = observed
         self.subdiv = subdiv
         self.weekend_workdays = getattr(self, "weekend_workdays", set())
-
-        supported_languages = set(self.supported_languages)
-        if self._entity_code is not None:
-            fallback = language not in supported_languages
-            languages = [language] if language in supported_languages else None
-            locale_directory = str(Path(__file__).with_name("locale"))
-
-            # Add entity native content translations.
-            entity_translation = translation(
-                self._entity_code,
-                fallback=fallback,
-                languages=languages,
-                localedir=locale_directory,
-            )
-            # Add a fallback if entity has parent translations.
-            if parent_entity := self.parent_entity:
-                entity_translation.add_fallback(
-                    translation(
-                        parent_entity.country or parent_entity.market,
-                        fallback=fallback,
-                        languages=languages,
-                        localedir=locale_directory,
-                    )
-                )
-            self.tr = entity_translation.gettext
-        else:
-            self.tr = gettext
-
         self.years = _normalize_arguments(int, years)
 
+        # Configure l10n related attributes.
+        self._init_translation()
+
         # Populate holidays.
         for year in self.years:
             self._populate(year)
@@ -592,6 +567,12 @@ class HolidayBase(dict[date, str]):
 
         return dict.__getitem__(self, self.__keytransform__(key))
 
+    def __getstate__(self) -> dict[str, Any]:
+        """Return the object's state for serialization."""
+        state = self.__dict__.copy()
+        state.pop("tr", None)
+        return state
+
     def __keytransform__(self, key: DateLike) -> date:
         """Transforms the date from one of the following types:
 
@@ -699,6 +680,11 @@ class HolidayBase(dict[date, str]):
 
         dict.__setitem__(self, self.__keytransform__(key), value)
 
+    def __setstate__(self, state: dict[str, Any]) -> None:
+        """Restore the object's state after deserialization."""
+        self.__dict__.update(state)
+        self._init_translation()
+
     def __str__(self) -> str:
         if self:
             return super().__str__()
@@ -750,6 +736,35 @@ class HolidayBase(dict[date, str]):
 
         return subdivision_aliases
 
+    def _init_translation(self) -> None:
+        """Initialize translation function based on language settings."""
+        supported_languages = set(self.supported_languages)
+        if self._entity_code is not None:
+            fallback = self.language not in supported_languages
+            languages = [self.language] if self.language in supported_languages else None
+            locale_directory = str(Path(__file__).with_name("locale"))
+
+            # Add entity native content translations.
+            entity_translation = translation(
+                self._entity_code,
+                fallback=fallback,
+                languages=languages,
+                localedir=locale_directory,
+            )
+            # Add a fallback if entity has parent translations.
+            if parent_entity := self.parent_entity:
+                entity_translation.add_fallback(
+                    translation(
+                        parent_entity.country or parent_entity.market,
+                        fallback=fallback,
+                        languages=languages,
+                        localedir=locale_directory,
+                    )
+                )
+            self.tr = entity_translation.gettext
+        else:
+            self.tr = gettext
+
     def _is_leap_year(self) -> bool:
         """
         Returns True if the year is leap. Returns False otherwise.

holidays/registry.py

@@ -108,6 +108,7 @@ COUNTRIES: RegistryDict = {
     "liechtenstein": ("Liechtenstein", "LI", "LIE"),
     "lithuania": ("Lithuania", "LT", "LTU"),
     "luxembourg": ("Luxembourg", "LU", "LUX"),
+    "macau": ("Macau", "MO", "MAC"),
     "madagascar": ("Madagascar", "MG", "MDG"),
     "malawi": ("Malawi", "MW", "MWI"),
     "malaysia": ("Malaysia", "MY", "MYS"),

holidays/version.py

@@ -10,4 +10,4 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-__version__ = "0.68"
+__version__ = "0.69"

{holidays-0.68.dist-info → holidays-0.69.dist-info}/AUTHORS

@@ -13,6 +13,7 @@ Alexei Mikhailov
 Anders Wenhaug
 Andrei Klimenko
 Andres Marrugo
+Ankush Kapoor
 Anon Kangpanich
 Anthony Rose
 Anton Daitche

{holidays-0.68.dist-info → holidays-0.69.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: holidays
-Version: 0.68
+Version: 0.69
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -189,7 +189,7 @@ Available Countries
 .. _ISO 639-1 code: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _ISO 639-2 code: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
 
-We currently support 159 country codes. The standard way to refer to a country
+We currently support 160 country codes. The standard way to refer to a country
 is by using its `ISO 3166-1 alpha-2 code`_, the same used for domain names, and
 for a subdivision its `ISO 3166-2 code`_. Some countries have common or foreign
 names or abbreviations as aliases for their subdivisions. These are defined in
@@ -242,7 +242,7 @@ All other default values are highlighted with bold:
      - AS
      - Can also be loaded as country US, subdivision AS
      -
-     - UNOFFICIAL
+     - GOVERNMENT, UNOFFICIAL
    * - Andorra
      - AD
      - Parishes: 02, 03, 04, 05, 06, 07, 08
@@ -522,7 +522,7 @@ All other default values are highlighted with bold:
      - GU
      - Can also be loaded as country US, subdivision GU
      -
-     - UNOFFICIAL
+     - GOVERNMENT, UNOFFICIAL
    * - Guatemala
      - GT
      -
@@ -560,9 +560,9 @@ All other default values are highlighted with bold:
      - HALF_DAY
    * - India
      - IN
-     - States: AN, AP, AR, AS, BR, CG, CH, DH, DL, GA, GJ, HP, HR, JH, JK, KA, KL, LA, LD, MH, ML, MN, MP, MZ, NL, OD, PB, PY, RJ, SK, TN, TR, TS, UK, UP, WB
-     -
-     -
+     - States: AN (Andaman and Nicobar Islands), AP (Andhra Pradesh), AR (Arunachal Pradesh, Arunāchal Pradesh), AS (Assam), BR (Bihar, Bihār), CG (Chhattisgarh, Chhattīsgarh), CH (Chandigarh, Chandīgarh), DH (Dadra and Nagar Haveli and Daman and Diu, Dādra and Nagar Haveli and Damān and Diu), DL (Delhi), GA (Goa), GJ (Gujarat, Gujarāt), HP (Himachal Pradesh, Himāchal Pradesh), HR (Haryana, Haryāna), JH (Jharkhand, Jhārkhand), JK (Jammu and Kashmir, Jammu and Kashmīr), KA (Karnataka, Karnātaka), KL (Kerala), LA (Ladakh, Ladākh), LD (Lakshadweep), MH (Maharashtra, Mahārāshtra), ML (Meghalaya, Meghālaya), MN (Manipur), MP (Madhya Pradesh), MZ (Mizoram), NL (Nagaland, Nāgāland), OD (Odisha), PB (Punjab), PY (Puducherry), RJ (Rajasthan, Rājasthān), SK (Sikkim), TN (Tamil Nadu, Tamil Nādu), TR (Tripura), TS (Telangana, Telangāna), UK (Uttarakhand, Uttarākhand), UP (Uttar Pradesh), WB (West Bengal)
+     - **en_IN**, en_US, hi
+     - OPTIONAL
    * - Indonesia
      - ID
      -
@@ -663,6 +663,11 @@ All other default values are highlighted with bold:
      -
      - de, en_US, fr, **lb**, uk
      -
+   * - Macau
+     - MO
+     - Historical municipalities: I (Concelho das Ilhas, 海島市, 海岛市), M (Concelho de Macau, 澳門市, 澳门市)
+     - en_MO, en_US, pt_MO, th, zh_CN, **zh_MO**
+     - GOVERNMENT, MANDATORY
    * - Madagascar
      - MG
      -
@@ -757,7 +762,7 @@ All other default values are highlighted with bold:
      - MP
      - Can also be loaded as country US, subdivision MP
      -
-     - UNOFFICIAL
+     - GOVERNMENT, UNOFFICIAL
    * - North Macedonia
      - MK
      -
@@ -806,7 +811,7 @@ All other default values are highlighted with bold:
    * - Poland
      - PL
      -
-     - en_US, **pl**, uk
+     - de, en_US, **pl**, uk
      -
    * - Portugal
      - PT
@@ -817,7 +822,7 @@ All other default values are highlighted with bold:
      - PR
      - Can also be loaded as country US, subdivision PR
      -
-     - UNOFFICIAL
+     - GOVERNMENT, UNOFFICIAL
    * - Romania
      - RO
      -
@@ -912,7 +917,7 @@ All other default values are highlighted with bold:
      - TW
      -
      - en_US, th, zh_CN, **zh_TW**
-     -
+     - GOVERNMENT, OPTIONAL, SCHOOL, WORKDAY
    * - Tanzania
      - TZ
      -
@@ -967,17 +972,17 @@ All other default values are highlighted with bold:
      - UM
      - Can also be loaded as country US, subdivision UM
      -
-     - UNOFFICIAL
+     - GOVERNMENT, UNOFFICIAL
    * - United States of America (the)
      - US
      - States and territories: AK, AL, AR, AS, AZ, CA, CO, CT, DC, DE, FL, GA, GU, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MP, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, PR, RI, SC, SD, TN, TX, UM, UT, VA, VI, VT, WA, WI, WV, WY
      -
-     - UNOFFICIAL
+     - GOVERNMENT, UNOFFICIAL
    * - United States Virgin Islands (the)
      -
      - See Virgin Islands (U.S.)
      -
-     - UNOFFICIAL
+     -
    * - Uruguay
      - UY
      -
@@ -1012,7 +1017,7 @@ All other default values are highlighted with bold:
      - VI
      - Can also be loaded as country US, subdivision VI
      -
-     - UNOFFICIAL
+     - GOVERNMENT, UNOFFICIAL
    * - Zambia
      - ZM
      -