holidays 0.65__tar.gz → 0.67__tar.gz

{holidays-0.65 → holidays-0.67}/AUTHORS

@@ -29,6 +29,7 @@ Chanran Kim
 Chris McKeague
 Chris Turra
 Christian Alexander
+Colin Watson
 Dan Gentry
 Daniel Musketa
 Daniël Niemeijer

{holidays-0.65 → holidays-0.67}/CHANGES

@@ -1,3 +1,49 @@
+Version 0.67
+============
+
+Released February 17, 2025
+
+- Add Saint Lucia holidays (#2266 by @Prateekshit73)
+- Add Tuvalu holidays (#2295 by @Prateekshit73, @arkid15r)
+- Update Greenland holidays l10n (#2288 by @KJhellico)
+- Update Hong Kong holidays: add l10n support (#2268 by @PPsyrius)
+- Update Hong Kong holidays: fix `th` l10n typo (#2293 by @PPsyrius)
+- Update Panama holidays, add l10n support (#2275 by @KJhellico)
+- Update README: add DOI (#2286 by @arkid15r)
+- Update United Kingdom & Isle of Man holidays: add l10n support (#2258 by @PPsyrius, @arkid15r, @KJhellico)
+- Update internal scripts (#2284 by @KJhellico)
+- Update subdivision names for Presidents' Day in the United States (#2299 by @parkerbxyz, @arkid15r, @KJhellico)
+- Add Python syntax check with ruff-pyupgrade rules (#2294 by @KJhellico)
+- Add make script for Windows (#2277 by @KJhellico)
+- Check .mo rather than .po files in TestListLocalizedEntities (#2273 by @cjwatson, @arkid15r)
+- Implement HolidayBase::get_closest_holiday functionality (#2211 by @Rosi2143, @arkid15r)
+- Unify certain holidays names translation (#2285 by @KJhellico)
+
+Version 0.66
+============
+
+Released February 3, 2025
+
+- Add Sri Lanka holidays (#2228 by @Prateekshit73, @arkid15r, @KJhellico, @PPsyrius)
+- Fix typo in CONTRIBUTING.rst (#2264 by @KJhellico)
+- Update Czechia holidays (#2248 by @KJhellico)
+- Update Germany holidays: add Corpus Christi in CATHOLIC category (#2253 by @KJhellico)
+- Update Iceland holidays: add HALF_DAY holidays (#2249 by @KJhellico)
+- Update Iran holidays (#2234 by @KJhellico)
+- Update PR exclusion logic (#2233 by @arkid15r)
+- Update Slovakia holidays: Constitution Day is working day since 2024 (#2235 by @KJhellico, @arkid15r)
+- Update Slovenia holidays (#2237 by @KJhellico)
+- Update Sweden holidays: fix All Saints' Day (#2252 by @KJhellico)
+- Update Thailand holidays: refactor Royal Ploughing Ceremony code (#2247 by @PPsyrius)
+- Update United Arab Emirates holidays: add `th` l10n, exact 2017-2025 entries (#2263 by @PPsyrius)
+- Update Vatican City holidays: add missing holidays, l10n support (#2250 by @PPsyrius)
+- Update automatic snapshots update workflow (#2254 by @KJhellico)
+- Update some holidays Ukrainian translations (#2265 by @KJhellico)
+- Add Israel holidays localization: th (#2262 by @PPsyrius)
+- Add West Frisian language (#2246 by @waarissyb, @arkid15r)
+- Pin CI/CD Ubuntu version (#2245 by @arkid15r)
+- Remove .po files from distribution bundles (#2243 by @KJhellico)
+
 Version 0.65
 ============
 

{holidays-0.65 → holidays-0.67}/CONTRIBUTING.rst

@@ -52,7 +52,7 @@ If you want to retrieve uncovered lines too:
 
     $ make coverage
 
-You can specific tests using ``pytest`` command:
+You can run specific tests using the ``pytest`` command:
 
 .. code-block:: shell
 

{holidays-0.65 → holidays-0.67}/MANIFEST.in

@@ -5,7 +5,6 @@ include Makefile
 
 recursive-include docs *
 recursive-include holidays/locale *.mo
-recursive-include holidays/locale *.po
 recursive-include requirements *
 
 prune docs/build

{holidays-0.65 → holidays-0.67}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: holidays
-Version: 0.65
+Version: 0.67
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -96,15 +96,21 @@ flexible as possible.
     :target: https://github.com/vacanza/holidays/commits/dev
     :alt: GitHub last commit
 
-+--------+------------------------------------------------+
-| PyPI   | |downloads| |version| |release date|           |
-+--------+------------------------------------------------+
-| CI/CD  | |status| |documentation|                       |
-+--------+------------------------------------------------+
-| Code   | |license| |python versions| |style| |coverage| |
-+--------+------------------------------------------------+
-| GitHub | |stars| |forks| |contributors| |last commit|   |
-+--------+------------------------------------------------+
+.. |doi| image:: https://img.shields.io/badge/DOI-10.5281/zenodo.14847397-41B5BE?style=flat
+    :target: https://doi.org/10.5281/zenodo.14847397
+    :alt: Open World Holidays Franework DOI
+
++----------+------------------------------------------------+
+| PyPI     | |downloads| |version| |release date|           |
++----------+------------------------------------------------+
+| CI/CD    | |status| |documentation|                       |
++----------+------------------------------------------------+
+| Code     | |license| |python versions| |style| |coverage| |
++----------+------------------------------------------------+
+| GitHub   | |stars| |forks| |contributors| |last commit|   |
++----------+------------------------------------------------+
+| Citation | |doi|                                          |
++----------+------------------------------------------------+
 
 Install
 -------
@@ -183,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 156 country codes. The standard way to refer to a country
+We currently support 159 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
@@ -510,7 +516,7 @@ All other default values are highlighted with bold:
    * - Greenland
      - GL
      -
-     - da, en_US, **kl**
+     - da, en_US, fi, is, **kl**, no, sv, uk
      - OPTIONAL
    * - Guam
      - GU
@@ -540,7 +546,7 @@ All other default values are highlighted with bold:
    * - Hong Kong
      - HK
      -
-     -
+     - en_HK, en_US, th, zh_CN, **zh_HK**
      - OPTIONAL
    * - Hungary
      - HU
@@ -551,7 +557,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 +571,7 @@ All other default values are highlighted with bold:
    * - Iran
      - IR
      -
-     - en_US, **fa**
+     - en_US, **fa_IR**
      -
    * - Ireland
      - IE
@@ -575,12 +581,12 @@ All other default values are highlighted with bold:
    * - Isle of Man
      - IM
      -
-     -
+     - **en_GB**, en_US, th
      -
    * - Israel
      - IL
      -
-     - en_US, **he**, uk
+     - en_US, **he**, th, uk
      - OPTIONAL, SCHOOL
    * - Italy
      - IT
@@ -730,7 +736,7 @@ All other default values are highlighted with bold:
    * - Netherlands
      - NL
      -
-     - en_US, **nl**, uk
+     - en_US, fy, **nl**, uk
      - OPTIONAL
    * - New Zealand
      - NZ
@@ -775,8 +781,8 @@ All other default values are highlighted with bold:
    * - Panama
      - PA
      -
-     -
-     -
+     - en_US, **es**, uk
+     - BANK
    * - Papua New Guinea
      - PG
      -
@@ -827,6 +833,11 @@ All other default values are highlighted with bold:
      -
      -
      - HALF_DAY, WORKDAY
+   * - Saint Lucia
+     - LC
+     -
+     - **en_LC**, en_US
+     -
    * - Samoa
      - WS
      -
@@ -866,7 +877,7 @@ All other default values are highlighted with bold:
      - SI
      -
      - en_US, **sl**, uk
-     -
+     - WORKDAY
    * - South Africa
      - ZA
      -
@@ -882,6 +893,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
      -
@@ -927,6 +943,11 @@ All other default values are highlighted with bold:
      -
      - en_US, **tr**, uk
      - HALF_DAY
+   * - Tuvalu
+     - TV
+     - Town/Island Councils: FUN (Funafuti), NIT (Niutao), NKF (Nukufetau), NKL (Nukulaelae), NMA (Nanumea), NMG (Nanumaga, Nanumanga), NUI (Nui), VAI (Vaitupu)
+     - en_GB, en_US, **tvl**
+     -
    * - Ukraine
      - UA
      -
@@ -935,12 +956,12 @@ 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)
-     -
+     - **en_GB**, en_US, th
      -
    * - United States Minor Outlying Islands
      - UM
@@ -975,7 +996,7 @@ All other default values are highlighted with bold:
    * - Vatican City
      - VA
      -
-     -
+     - en_US, **it**, th
      -
    * - Venezuela
      - VE

{holidays-0.65 → holidays-0.67}/README.rst

@@ -59,15 +59,21 @@ flexible as possible.
     :target: https://github.com/vacanza/holidays/commits/dev
     :alt: GitHub last commit
 
-+--------+------------------------------------------------+
-| PyPI   | |downloads| |version| |release date|           |
-+--------+------------------------------------------------+
-| CI/CD  | |status| |documentation|                       |
-+--------+------------------------------------------------+
-| Code   | |license| |python versions| |style| |coverage| |
-+--------+------------------------------------------------+
-| GitHub | |stars| |forks| |contributors| |last commit|   |
-+--------+------------------------------------------------+
+.. |doi| image:: https://img.shields.io/badge/DOI-10.5281/zenodo.14847397-41B5BE?style=flat
+    :target: https://doi.org/10.5281/zenodo.14847397
+    :alt: Open World Holidays Franework DOI
+
++----------+------------------------------------------------+
+| PyPI     | |downloads| |version| |release date|           |
++----------+------------------------------------------------+
+| CI/CD    | |status| |documentation|                       |
++----------+------------------------------------------------+
+| Code     | |license| |python versions| |style| |coverage| |
++----------+------------------------------------------------+
+| GitHub   | |stars| |forks| |contributors| |last commit|   |
++----------+------------------------------------------------+
+| Citation | |doi|                                          |
++----------+------------------------------------------------+
 
 Install
 -------
@@ -146,7 +152,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 159 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
@@ -473,7 +479,7 @@ All other default values are highlighted with bold:
    * - Greenland
      - GL
      -
-     - da, en_US, **kl**
+     - da, en_US, fi, is, **kl**, no, sv, uk
      - OPTIONAL
    * - Guam
      - GU
@@ -503,7 +509,7 @@ All other default values are highlighted with bold:
    * - Hong Kong
      - HK
      -
-     -
+     - en_HK, en_US, th, zh_CN, **zh_HK**
      - OPTIONAL
    * - Hungary
      - HU
@@ -514,7 +520,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
@@ -528,7 +534,7 @@ All other default values are highlighted with bold:
    * - Iran
      - IR
      -
-     - en_US, **fa**
+     - en_US, **fa_IR**
      -
    * - Ireland
      - IE
@@ -538,12 +544,12 @@ All other default values are highlighted with bold:
    * - Isle of Man
      - IM
      -
-     -
+     - **en_GB**, en_US, th
      -
    * - Israel
      - IL
      -
-     - en_US, **he**, uk
+     - en_US, **he**, th, uk
      - OPTIONAL, SCHOOL
    * - Italy
      - IT
@@ -693,7 +699,7 @@ All other default values are highlighted with bold:
    * - Netherlands
      - NL
      -
-     - en_US, **nl**, uk
+     - en_US, fy, **nl**, uk
      - OPTIONAL
    * - New Zealand
      - NZ
@@ -738,8 +744,8 @@ All other default values are highlighted with bold:
    * - Panama
      - PA
      -
-     -
-     -
+     - en_US, **es**, uk
+     - BANK
    * - Papua New Guinea
      - PG
      -
@@ -790,6 +796,11 @@ All other default values are highlighted with bold:
      -
      -
      - HALF_DAY, WORKDAY
+   * - Saint Lucia
+     - LC
+     -
+     - **en_LC**, en_US
+     -
    * - Samoa
      - WS
      -
@@ -829,7 +840,7 @@ All other default values are highlighted with bold:
      - SI
      -
      - en_US, **sl**, uk
-     -
+     - WORKDAY
    * - South Africa
      - ZA
      -
@@ -845,6 +856,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
      -
@@ -890,6 +906,11 @@ All other default values are highlighted with bold:
      -
      - en_US, **tr**, uk
      - HALF_DAY
+   * - Tuvalu
+     - TV
+     - Town/Island Councils: FUN (Funafuti), NIT (Niutao), NKF (Nukufetau), NKL (Nukulaelae), NMA (Nanumea), NMG (Nanumaga, Nanumanga), NUI (Nui), VAI (Vaitupu)
+     - en_GB, en_US, **tvl**
+     -
    * - Ukraine
      - UA
      -
@@ -898,12 +919,12 @@ 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)
-     -
+     - **en_GB**, en_US, th
      -
    * - United States Minor Outlying Islands
      - UM
@@ -938,7 +959,7 @@ All other default values are highlighted with bold:
    * - Vatican City
      - VA
      -
-     -
+     - en_US, **it**, th
      -
    * - Venezuela
      - VE

{holidays-0.65 → holidays-0.67}/docs/source/examples.rst

@@ -214,6 +214,53 @@ To calculate the number or working days between two specified dates:
 
 Here we calculate the number of working days in Q2 2024.
 
+Getting the closest (next or previous) holiday
+----------------------------------------------
+
+You can fetch next or previous holiday for a target date of your selected calendar.
+The function returns found holiday's date and name excluding the target date.
+
+Get the next holiday for the current date:
+
+.. code-block:: python
+
+   >>> us_holidays = holidays.US(years=2025)
+   >>> us_holidays.get_closest_holiday()
+   (datetime.date(2025, 1, 20), 'Martin Luther King Jr. Day')
+
+Get the previous holiday for the current date:
+
+.. code-block:: python
+
+   >>> us_holidays = holidays.US(years=2025)
+   >>> us_holidays.get_closest_holiday(direction="backward")
+   (datetime.date(2025, 1, 1), "New Year's Day")
+
+Get the next holiday for a specific target date:
+
+.. code-block:: python
+
+   >>> us_holidays = holidays.US(years=2025)
+   >>> us_holidays.get_closest_holiday("2025-02-01")
+   (datetime.date(2025, 2, 17), "Washington's Birthday")
+
+Get the previous holiday for a specific target date:
+
+.. code-block:: python
+
+   >>> us_holidays = holidays.US(years=2025)
+   >>> us_holidays.get_closest_holiday("2025-02-01", direction="backward")
+   (datetime.date(2025, 1, 20), 'Martin Luther King Jr. Day')
+
+If the closest holiday cannot be found None is returned.
+
+.. code-block:: python
+
+   >>> print(us_holidays.get_closest_holiday("2100-12-31"))
+   None
+   >>> print(us_holidays.get_closest_holiday("1777-01-01", direction="backward"))
+   None
+
 Date from holiday name
 ----------------------
 

{holidays-0.65 → holidays-0.67}/holidays/calendars/__init__.py

@@ -22,4 +22,5 @@ from holidays.calendars.islamic import _CustomIslamicHolidays, _IslamicLunar
 from holidays.calendars.julian import JULIAN_CALENDAR
 from holidays.calendars.julian_revised import JULIAN_REVISED_CALENDAR
 from holidays.calendars.persian import _Persian
+from holidays.calendars.sinhala import _SinhalaLunar, _CustomSinhalaHolidays
 from holidays.calendars.thai import _ThaiLunisolar, KHMER_CALENDAR, THAI_CALENDAR

{holidays-0.65 → holidays-0.67}/holidays/calendars/persian.py

@@ -26,6 +26,12 @@ class _Persian:
     START_YEAR = 1901
     END_YEAR = 2100
 
+    def is_leap_year(self, year: int) -> bool:
+        """
+        Is Persian year that begins in the specified Gregorian year a leap year.
+        """
+        return (year % 33) in {3, 7, 11, 16, 20, 24, 28, 32}
+
     def new_year_date(self, year: int) -> Optional[date]:
         """
         Return Gregorian date of Persian new year (1 Farvardin) in a given Gregorian year.