holidays 0.64__py3-none-any.whl → 0.66__py3-none-any.whl

holidays/groups/sinhala.py

@@ -0,0 +1,192 @@
+#  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 AUTHORS 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 collections.abc import Iterable
+from datetime import date
+from typing import Optional
+
+from holidays.calendars import _SinhalaLunar
+from holidays.groups.eastern import EasternCalendarHolidays
+
+
+class SinhalaCalendarHolidays(EasternCalendarHolidays):
+    """
+    Sinhala holidays.
+
+    Sinhala Buddhist Uposatha day calculation method is different from Thai LuniSolar
+    and Buddhist (Mahayana) used in East Asia.
+
+    Due to the fact that Poya (Uposatha) days are calculated astronomically
+    based on how close a particular day is closest to full moon at noon, and that
+    an extra month is added every 33 months interval, this is hardcoded for now.
+
+    Adhi month dates are instead hardcoded in Sri Lanka country implementation.
+    """
+
+    def __init__(self, cls=None, show_estimated=False) -> None:
+        self._sinhala_calendar = cls() if cls else _SinhalaLunar()
+        self._sinhala_calendar_show_estimated = show_estimated
+
+    def _add_sinhala_calendar_holiday(
+        self, name: str, dt_estimated: tuple[Optional[date], bool]
+    ) -> Optional[date]:
+        """
+        Add Sinhala calendar holiday.
+
+        Adds customizable estimation label to holiday name if holiday date
+        is an estimation.
+        """
+        return self._add_eastern_calendar_holiday(
+            name, dt_estimated, self._sinhala_calendar_show_estimated
+        )
+
+    def _add_sinhala_calendar_holiday_set(
+        self, name: str, dts_estimated: Iterable[tuple[date, bool]], days_delta: int = 0
+    ) -> set[date]:
+        """
+        Add Sinhala 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._sinhala_calendar_show_estimated, days_delta=days_delta
+            ):
+                added_dates.add(dt)
+
+        return added_dates
+
+    def _add_bak_poya(self, name) -> Optional[date]:
+        """
+        Add Bak Poya (first full moon day of the 5th lunar month).
+
+        https://us.lakpura.com/pages/bak-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.bak_poya_date(self._year)
+        )
+
+    def _add_binara_poya(self, name) -> Optional[date]:
+        """
+        Add Binara Poya (first full moon day of the 10th lunar month).
+
+        https://us.lakpura.com/pages/binara-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.binara_poya_date(self._year)
+        )
+
+    def _add_duruthu_poya(self, name) -> set[date]:
+        """
+        Add Duruthu Poya (first full moon day of the 2nd lunar month).
+
+        https://us.lakpura.com/pages/duruthu-poya
+        """
+        return self._add_sinhala_calendar_holiday_set(
+            name, self._sinhala_calendar.duruthu_poya_date(self._year)
+        )
+
+    def _add_esala_poya(self, name) -> Optional[date]:
+        """
+        Add Esala Poya (first full moon day of the 8th lunar month).
+
+        https://us.lakpura.com/pages/esala-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.esala_poya_date(self._year)
+        )
+
+    def _add_il_poya(self, name) -> Optional[date]:
+        """
+        Add Il Poya (first full moon day of the 12th lunar month).
+
+        Also known as "Ill Poya"
+        https://us.lakpura.com/pages/il-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.il_poya_date(self._year)
+        )
+
+    def _add_medin_poya(self, name) -> Optional[date]:
+        """
+        Add Medin Poya (first full moon day of the 4th lunar month).
+
+        https://us.lakpura.com/pages/medin-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.medin_poya_date(self._year)
+        )
+
+    def _add_nawam_poya(self, name) -> Optional[date]:
+        """
+        Add Nawam Poya (first full moon day of the 3rd lunar month).
+
+        Also known as "Navam Poya" and "Magha Puja".
+        https://us.lakpura.com/pages/navam-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.nawam_poya_date(self._year)
+        )
+
+    def _add_nikini_poya(self, name) -> Optional[date]:
+        """
+        Add Nikini Poya (first full moon day of the 9th lunar month).
+
+        https://us.lakpura.com/pages/nikini-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.nikini_poya_date(self._year)
+        )
+
+    def _add_poson_poya(self, name) -> Optional[date]:
+        """
+        Add Poson Poya (first full moon day of the 7th lunar month).
+
+        https://us.lakpura.com/pages/poson
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.poson_poya_date(self._year)
+        )
+
+    def _add_unduvap_poya(self, name) -> Optional[date]:
+        """
+        Add Unduvap Poya (first full moon day of the 1st lunar month).
+
+        Also known as "Undawap Poya".
+        https://us.lakpura.com/pages/unduvap-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.unduvap_poya_date(self._year)
+        )
+
+    def _add_vap_poya(self, name) -> Optional[date]:
+        """
+        Add Vap Poya (first full moon day of the 11th lunar month).
+
+        https://us.lakpura.com/pages/vap-poya
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.vap_poya_date(self._year)
+        )
+
+    def _add_vesak_poya(self, name) -> Optional[date]:
+        """
+        Add Vesak Poya (first full moon day of the 6th lunar month).
+
+        Also known as "Wesak Poya".
+        https://us.lakpura.com/pages/vesak
+        """
+        return self._add_sinhala_calendar_holiday(
+            name, self._sinhala_calendar.vesak_poya_date(self._year)
+        )

holidays/holiday_base.py

@@ -329,8 +329,7 @@ class HolidayBase(dict[date, str]):
             # Deprecated arguments.
             if prov_state := prov or state:
                 warnings.warn(
-                    "Arguments prov and state are deprecated, use "
-                    f"subdiv='{prov_state}' instead.",
+                    f"Arguments prov and state are deprecated, use subdiv='{prov_state}' instead.",
                     DeprecationWarning,
                 )
 
@@ -585,6 +584,7 @@ class HolidayBase(dict[date, str]):
 
         to :class:`datetime.date`, which is how it's stored by the class."""
 
+        dt: Optional[date] = None
         # Try to catch `date` and `str` type keys first.
         # Using type() here to skip date subclasses.
         # Key is `date`.
@@ -593,10 +593,17 @@ class HolidayBase(dict[date, str]):
 
         # Key is `str` instance.
         elif isinstance(key, str):
-            try:
-                dt = parse(key).date()
-            except (OverflowError, ValueError):
-                raise ValueError(f"Cannot parse date from string '{key}'")
+            # key possibly contains a date in YYYY-MM-DD or YYYYMMDD format.
+            if len(key) in {8, 10}:
+                try:
+                    dt = date.fromisoformat(key)
+                except ValueError:
+                    pass
+            if dt is None:
+                try:
+                    dt = parse(key).date()
+                except (OverflowError, ValueError):
+                    raise ValueError(f"Cannot parse date from string '{key}'")
 
         # Key is `datetime` instance.
         elif isinstance(key, datetime):

holidays/registry.py

@@ -153,6 +153,7 @@ COUNTRIES: RegistryDict = {
     "south_africa": ("SouthAfrica", "ZA", "ZAF"),
     "south_korea": ("SouthKorea", "KR", "KOR", "Korea"),
     "spain": ("Spain", "ES", "ESP"),
+    "sri_lanka": ("SriLanka", "LK", "LKA"),
     "sweden": ("Sweden", "SE", "SWE"),
     "switzerland": ("Switzerland", "CH", "CHE"),
     "taiwan": ("Taiwan", "TW", "TWN"),

holidays/version.py

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

{holidays-0.64.dist-info → holidays-0.66.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: holidays
-Version: 0.64
+Version: 0.66
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -183,7 +183,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 156 country codes. The standard way to refer to a country
+We currently support 157 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
@@ -551,7 +551,7 @@ All other default values are highlighted with bold:
      - IS
      -
      - en_US, **is**, uk
-     -
+     - 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
@@ -565,7 +565,7 @@ All other default values are highlighted with bold:
    * - Iran
      - IR
      -
-     - en_US, **fa**
+     - en_US, **fa_IR**
      -
    * - Ireland
      - IE
@@ -580,7 +580,7 @@ All other default values are highlighted with bold:
    * - Israel
      - IL
      -
-     - en_US, **he**, uk
+     - en_US, **he**, th, uk
      - OPTIONAL, SCHOOL
    * - Italy
      - IT
@@ -730,7 +730,7 @@ All other default values are highlighted with bold:
    * - Netherlands
      - NL
      -
-     - en_US, **nl**, uk
+     - en_US, fy, **nl**, uk
      - OPTIONAL
    * - New Zealand
      - NZ
@@ -866,7 +866,7 @@ All other default values are highlighted with bold:
      - SI
      -
      - en_US, **sl**, uk
-     -
+     - WORKDAY
    * - South Africa
      - ZA
      -
@@ -882,6 +882,11 @@ All other default values are highlighted with bold:
      - Autonomous communities: AN, AR, AS, CB, CE, CL, CM, CN, CT, EX, GA, IB, MC, MD, ML, NC, PV, RI, VC
      - en_US, **es**, uk
      -
+   * - Sri Lanka
+     - LK
+     -
+     - en_US, **si_LK**, ta_LK
+     - BANK, GOVERNMENT, WORKDAY
    * - Sweden
      - SE
      -
@@ -935,8 +940,8 @@ All other default values are highlighted with bold:
    * - United Arab Emirates
      - AE
      -
-     - **ar**, en_US
-     -
+     - **ar**, en_US, th
+     - GOVERNMENT, OPTIONAL
    * - United Kingdom
      - GB
      - Subdivisions: ENG (England), NIR (Northern Ireland), SCT (Scotland), WLS (Wales)
@@ -975,7 +980,7 @@ All other default values are highlighted with bold:
    * - Vatican City
      - VA
      -
-     -
+     - en_US, **it**, th
      -
    * - Venezuela
      - VE