holidays 0.79__py3-none-any.whl → 0.80__py3-none-any.whl

holidays/countries/uganda.py

@@ -0,0 +1,101 @@
+#  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 holidays.groups import ChristianHolidays, InternationalHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Uganda(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays):
+    """Uganda holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Uganda>
+        * [Public Holidays Act, Cap. 255](https://web.archive.org/web/20250621140041/https://ulii.org/akn/ug/act/1965/23/eng@2000-12-31)
+        * [National Events and Calendar](https://web.archive.org/web/20250618053410/https://www.vicepresident.go.ug/national-events-and-calender/)
+        * [National Heroes Day](https://web.archive.org/web/20230622162351/https://publicholidays.africa/uganda/national-heroes-day/)
+        * [NRM Liberation Day](https://web.archive.org/web/20240124064853/https://thenilewires.com/38th-nrm-a-liberation-day-celebrations-minister-outlines-nrm-achievements/)
+        * [Archbishop Janani Luwum Day](https://web.archive.org/web/20200805133919/https://www.newvision.co.ug/news/1417242/uganda-declared-february-archbishop-janani-luwum-public-holiday)
+        * [School Calendar 2024](https://web.archive.org/web/20240519021615/https://www.education.go.ug/wp-content/uploads/2023/11/SCHOOL-CALENDAR.pdf)
+        * [Public Holidays 2025](https://web.archive.org/web/20250710193157/https://publicholidays.co.ug/)
+    """
+
+    country = "UG"
+    # %s (estimated).
+    estimated_label = "%s (estimated)"
+    # Uganda gained independence from the United Kingdom on October 9, 1962.
+    start_year = 1963
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+
+        if self._year >= 1987:
+            # NRM Liberation Day.
+            self._add_holiday_jan_26("NRM Liberation Day")
+
+        if self._year >= 2016:
+            # Archbishop Janani Luwum Day.
+            self._add_holiday_feb_16("Archbishop Janani Luwum Day")
+
+        # Women's Day.
+        self._add_womens_day("Women's Day")
+
+        # Good Friday.
+        self._add_good_friday("Good Friday")
+
+        # Easter Monday.
+        self._add_easter_monday("Easter Monday")
+
+        # Labor Day.
+        self._add_labor_day("Labour Day")
+
+        # Uganda Martyrs' Day.
+        self._add_holiday_jun_3("Uganda Martyrs' Day")
+
+        if self._year >= 2001:
+            # National Heroes' Day.
+            self._add_holiday_jun_9("National Heroes' Day")
+
+        # Independence Day.
+        self._add_holiday_oct_9("Independence Day")
+
+        # Christmas Day.
+        self._add_christmas_day("Christmas Day")
+
+        # Boxing Day.
+        self._add_christmas_day_two("Boxing Day")
+
+        # Eid al-Fitr.
+        self._add_eid_al_fitr_day("Eid al-Fitr")
+
+        # Eid al-Adha.
+        self._add_eid_al_adha_day("Eid al-Adha")
+
+
+class UG(Uganda):
+    pass
+
+
+class UGA(Uganda):
+    pass

holidays/financial/__init__.py

@@ -15,4 +15,9 @@
 from holidays.financial.brasil_bolsa_balcao import BrasilBolsaBalcao, BVMF, B3
 from holidays.financial.european_central_bank import EuropeanCentralBank, XECB, ECB, TAR
 from holidays.financial.ice_futures_europe import ICEFuturesEurope, IFEU
+from holidays.financial.national_stock_exchange_of_india import (
+    NationalStockExchangeOfIndia,
+    XNSE,
+    NSE,
+)
 from holidays.financial.ny_stock_exchange import NewYorkStockExchange, XNYS, NYSE

holidays/financial/national_stock_exchange_of_india.py

@@ -0,0 +1,169 @@
+#  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 gettext import gettext as tr
+
+from holidays.calendars import _CustomHinduHolidays, _CustomIslamicHolidays
+from holidays.calendars.gregorian import MAR, APR, MAY, JUN, JUL, AUG
+from holidays.groups import ChristianHolidays, HinduCalendarHolidays, IslamicHolidays
+from holidays.observed_holiday_base import ObservedHolidayBase, SAT_TO_NONE, SUN_TO_NONE
+
+
+class NationalStockExchangeOfIndia(
+    ObservedHolidayBase, HinduCalendarHolidays, ChristianHolidays, IslamicHolidays
+):
+    """National Stock Exchange of India (NSE) holidays.
+
+    References:
+        * <https://web.archive.org/web/20250821175252/https://www.nseindia.com/resources/exchange-communication-circulars>
+
+    Historical data:
+        * [2022](https://web.archive.org/web/20250821071611/https://nsearchives.nseindia.com/content/circulars/CMTR50560.pdf)
+        * [2023](https://web.archive.org/web/20250821071635/https://nsearchives.nseindia.com/content/circulars/CMTR54757.pdf)
+        * [2024](https://web.archive.org/web/20250821071650/https://nsearchives.nseindia.com/content/circulars/CMTR59722.pdf)
+        * [2025](https://web.archive.org/web/20250624132016/https://nsearchives.nseindia.com/content/circulars/CMTR65587.pdf)
+    """
+
+    market = "XNSE"
+    default_language = "en_IN"
+    # %s (estimated).
+    estimated_label = tr("%s (estimated)")
+    supported_languages = ("en_IN", "en_US", "hi")
+    start_year = 2001
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
+        ChristianHolidays.__init__(self)
+        HinduCalendarHolidays.__init__(self, cls=NationalStockExchangeOfIndiaHinduHolidays)
+        IslamicHolidays.__init__(
+            self,
+            cls=NationalStockExchangeOfIndiaIslamicHolidays,
+            show_estimated=islamic_show_estimated,
+        )
+        kwargs.setdefault("observed_rule", SAT_TO_NONE + SUN_TO_NONE)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # Republic Day.
+        self._move_holiday(self._add_holiday_jan_26(tr("Republic Day")))
+
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # Dr. Baba Saheb Ambedkar Jayanti.
+        self._move_holiday(self._add_holiday_apr_14(tr("Dr. Baba Saheb Ambedkar Jayanti")))
+
+        # Maharashtra Day.
+        self._move_holiday(self._add_holiday_may_1(tr("Maharashtra Day")))
+
+        # Independence Day.
+        self._move_holiday(self._add_holiday_aug_15(tr("Independence Day")))
+
+        # Mahatma Gandhi Jayanti.
+        self._move_holiday(self._add_holiday_oct_2(tr("Mahatma Gandhi Jayanti")))
+
+        # Christmas Day.
+        self._move_holiday(self._add_christmas_day(tr("Christmas Day")))
+
+        # Hindu Calendar Holidays.
+
+        # Maha Shivaratri.
+        self._move_holiday(self._add_maha_shivaratri(tr("Maha Shivaratri")))
+
+        # Holi.
+        self._move_holiday(self._add_holi(tr("Holi")))
+
+        # Ram Navami.
+        self._move_holiday(self._add_ram_navami(tr("Ram Navami")))
+
+        # Mahavir Jayanti.
+        self._move_holiday(self._add_mahavir_jayanti(tr("Mahavir Jayanti")))
+
+        # Ganesh Chaturthi.
+        self._move_holiday(self._add_ganesh_chaturthi(tr("Ganesh Chaturthi")))
+
+        # Dussehra.
+        self._move_holiday(self._add_dussehra(tr("Dussehra")))
+
+        # Diwali Laxmi Pujan.
+        self._move_holiday(self._add_gau_krida(tr("Diwali Laxmi Pujan")))
+
+        # Diwali Balipratipada.
+        name = tr("Diwali Balipratipada")
+        # NSE's calendar adds an extra-day gap in 2022–2023
+        # between Diwali Laxmi Pujan and Diwali Balipratipada.
+        self._move_holiday(
+            self._add_bhai_dooj(name)
+            if self._year in {2022, 2023}
+            else self._add_govardhan_puja(name)
+        )
+
+        # Guru Nanak Jayanti.
+        self._move_holiday(self._add_guru_nanak_jayanti(tr("Guru Nanak Jayanti")))
+
+        # Islamic Calendar Holidays.
+
+        # Ashura.
+        for dt in self._add_ashura_day(tr("Muharram")):
+            self._move_holiday(dt)
+
+        # Eid al-Fitr.
+        for dt in self._add_eid_al_fitr_day(tr("Id-Ul-Fitr (Ramadan Eid)")):
+            self._move_holiday(dt)
+
+        # Eid al-Adha.
+        for dt in self._add_eid_al_adha_day(tr("Bakri Id")):
+            self._move_holiday(dt)
+
+
+class XNSE(NationalStockExchangeOfIndia):
+    pass
+
+
+class NSE(NationalStockExchangeOfIndia):
+    pass
+
+
+class NationalStockExchangeOfIndiaHinduHolidays(_CustomHinduHolidays):
+    HOLI_DATES = {
+        2023: (MAR, 7),
+    }
+
+
+class NationalStockExchangeOfIndiaIslamicHolidays(_CustomIslamicHolidays):
+    ASHURA_DATES_CONFIRMED_YEARS = (2022, 2025)
+    ASHURA_DATES = {
+        2022: (AUG, 9),
+        2023: (JUL, 29),
+        2024: (JUL, 17),
+        2025: (JUL, 6),
+    }
+
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2022, 2025)
+    EID_AL_ADHA_DATES = {
+        2022: (JUL, 10),
+        2024: (JUN, 17),
+        2025: (JUN, 7),
+    }
+
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2022, 2025)
+    EID_AL_FITR_DATES = {
+        2022: (MAY, 3),
+        2023: (APR, 22),
+        2024: (APR, 11),
+        2025: (MAR, 31),
+    }

holidays/groups/eastern.py

@@ -33,7 +33,7 @@ class EasternCalendarHolidays:
 
         Adds customizable estimation label to holiday name if holiday date is an estimation.
         """
-        estimated_label = getattr(self, "estimated_label", "%s (estimated)")
+        estimated_label = getattr(self, "estimated_label", "%s")
         dt, is_estimated = dt_estimated
 
         if days_delta and dt:

holidays/registry.py

@@ -13,7 +13,7 @@
 import importlib
 from collections.abc import Iterable
 from threading import RLock
-from typing import Any, Optional, Union
+from typing import Any, Optional
 
 from holidays.holiday_base import HolidayBase
 
@@ -67,6 +67,7 @@ COUNTRIES: RegistryDict = {
     "christmas_island": ("ChristmasIsland", "CX", "CXR"),
     "cocos_islands": ("CocosIslands", "CC", "CCK"),
     "colombia": ("Colombia", "CO", "COL"),
+    "comoros": ("Comoros", "KM", "COM"),
     "congo": ("Congo", "CG", "COG"),
     "cook_islands": ("CookIslands", "CK", "COK"),
     "costa_rica": ("CostaRica", "CR", "CRI"),
@@ -85,6 +86,7 @@ COUNTRIES: RegistryDict = {
     "jordan": ("Jordan", "JO", "JOR"),
     "el_salvador": ("ElSalvador", "SV", "SLV"),
     "equatorial_guinea": ("EquatorialGuinea", "GQ", "GNQ"),
+    "eritrea": ("Eritrea", "ER", "ERI"),
     "estonia": ("Estonia", "EE", "EST"),
     "eswatini": ("Eswatini", "SZ", "SZW", "Swaziland"),
     "ethiopia": ("Ethiopia", "ET", "ETH"),
@@ -195,6 +197,7 @@ COUNTRIES: RegistryDict = {
     "reunion": ("Reunion", "RE", "REU", "HolidaysRE"),
     "romania": ("Romania", "RO", "ROU"),
     "russia": ("Russia", "RU", "RUS"),
+    "rwanda": ("Rwanda", "RW", "RWA"),
     "saint_barthelemy": ("SaintBarthelemy", "BL", "BLM", "HolidaysBL"),
     "saint_kitts_and_nevis": ("SaintKittsAndNevis", "KN", "KNA"),
     "saint_lucia": ("SaintLucia", "LC", "LCA"),
@@ -214,6 +217,7 @@ COUNTRIES: RegistryDict = {
     "slovakia": ("Slovakia", "SK", "SVK"),
     "slovenia": ("Slovenia", "SI", "SVN"),
     "solomon_islands": ("SolomonIslands", "SB", "SLB"),
+    "somalia": ("Somalia", "SO", "SOM"),
     "south_africa": ("SouthAfrica", "ZA", "ZAF"),
     "south_georgia_and_the_south_sandwich_islands": (
         "SouthGeorgiaAndTheSouthSandwichIslands",
@@ -221,6 +225,7 @@ COUNTRIES: RegistryDict = {
         "SGS",
     ),
     "south_korea": ("SouthKorea", "KR", "KOR", "Korea"),
+    "south_sudan": ("SouthSudan", "SS", "SSD"),
     "spain": ("Spain", "ES", "ESP"),
     "sri_lanka": ("SriLanka", "LK", "LKA"),
     "suriname": ("Suriname", "SR", "SUR"),
@@ -229,6 +234,7 @@ COUNTRIES: RegistryDict = {
     "switzerland": ("Switzerland", "CH", "CHE"),
     "syrian_arab_republic": ("SyrianArabRepublic", "SY", "SYR"),
     "taiwan": ("Taiwan", "TW", "TWN"),
+    "tajikistan": ("Tajikistan", "TJ", "TJK"),
     "tanzania": ("Tanzania", "TZ", "TZA"),
     "thailand": ("Thailand", "TH", "THA"),
     "timor_leste": ("TimorLeste", "TL", "TLS"),
@@ -241,6 +247,7 @@ COUNTRIES: RegistryDict = {
     "turkmenistan": ("Turkmenistan", "TM", "TKM"),
     "turks_and_caicos_islands": ("TurksAndCaicosIslands", "TC", "TCA"),
     "tuvalu": ("Tuvalu", "TV", "TUV"),
+    "uganda": ("Uganda", "UG", "UGA"),
     "ukraine": ("Ukraine", "UA", "UKR"),
     "united_arab_emirates": ("UnitedArabEmirates", "AE", "ARE"),
     "united_kingdom": ("UnitedKingdom", "GB", "GBR", "UK"),
@@ -265,10 +272,11 @@ COUNTRIES: RegistryDict = {
 }
 
 FINANCIAL: RegistryDict = {
+    "brasil_bolsa_balcao": ("BrasilBolsaBalcao", "BVMF", "B3"),
     "european_central_bank": ("EuropeanCentralBank", "XECB", "ECB", "TAR"),
     "ice_futures_europe": ("ICEFuturesEurope", "IFEU"),
+    "national_stock_exchange_of_india": ("NationalStockExchangeOfIndia", "XNSE", "NSE"),
     "ny_stock_exchange": ("NewYorkStockExchange", "XNYS", "NYSE"),
-    "brasil_bolsa_balcao": ("BrasilBolsaBalcao", "BVMF", "B3"),
 }
 
 # A re-entrant lock. Once a thread has acquired a re-entrant lock,
@@ -331,35 +339,46 @@ class EntityLoader:
     @staticmethod
     def _get_entity_codes(
         container: RegistryDict,
-        entity_length: Union[int, Iterable[int]],
         include_aliases: bool = True,
+        max_code_length: int = 3,
+        min_code_length: int = 2,
     ) -> Iterable[str]:
-        entity_length = {entity_length} if isinstance(entity_length, int) else set(entity_length)
         for entities in container.values():
-            for entity in entities:
-                if len(entity) in entity_length:
-                    yield entity
-                    # Assuming that the alpha-2 code goes first.
-                    if not include_aliases:
-                        break
+            for code in entities[1:]:
+                if min_code_length <= len(code) <= max_code_length:
+                    yield code
+
+                # Stop after the first matching code if aliases are not requested.
+                # Assuming that the alpha-2 code goes first.
+                if not include_aliases:
+                    break
 
     @staticmethod
     def get_country_codes(include_aliases: bool = True) -> Iterable[str]:
         """Get supported country codes.
 
         :param include_aliases:
-            Whether to include entity aliases (e.g. UK for GB).
+            Whether to include entity aliases (e.g. GBR and UK for GB,
+            UKR for UA, USA for US, etc).
         """
-        return EntityLoader._get_entity_codes(COUNTRIES, 2, include_aliases)
+        return EntityLoader._get_entity_codes(
+            COUNTRIES,
+            include_aliases=include_aliases,
+        )
 
     @staticmethod
     def get_financial_codes(include_aliases: bool = True) -> Iterable[str]:
         """Get supported financial codes.
 
         :param include_aliases:
-            Whether to include entity aliases(e.g. TAR for ECB, XNYS for NYSE).
+            Whether to include entity aliases (e.g. B3 for BVMF,
+            TAR for ECB, NYSE for XNYS, etc).
         """
-        return EntityLoader._get_entity_codes(FINANCIAL, (3, 4), include_aliases)
+        return EntityLoader._get_entity_codes(
+            FINANCIAL,
+            include_aliases=include_aliases,
+            max_code_length=4,
+        )
 
     @staticmethod
     def load(prefix: str, scope: dict) -> None:

holidays/version.py

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