holidays 0.42__tar.gz → 0.44__tar.gz

holidays-0.44/AUTHORS

@@ -0,0 +1,131 @@
+Python Holidays Authors
+=======================
+
+Aaron Picht
+Aart Goossens
+Akos Furton
+Alejandro Antunes
+Alexander Schulze
+Alexandre Carvalho
+Anders Wenhaug
+Andres Marrugo
+Anthony Rose
+Anton Daitche
+Arjun Anandkumar
+Arkadii Yakovets
+Artem Tserekh
+Bailey Thompson
+Ben Collerson
+Ben Letham
+Benjamin Lucas Wacha
+Bernhard M. Wiedemann
+Carlos Rocha
+Chanran Kim
+Chris McKeague
+Chris Turra
+Christian Alexander
+Dan Gentry
+Daniel Musketa
+Daniël Niemeijer
+David Hotham
+Diogo Rosa
+Dorian Monnier
+Douglas Franklin
+Eden Juscelino
+Edison Robles
+Edward Betts
+Eldar Mustafayev
+Emmanuel Arias
+Eugenio Panadero Maciá
+Fabian Affolter
+Felix Lee
+Filip Bednárik
+Gabriel L Martinez
+Gabriel Trabanco
+Giedrius Mauza
+Gordon Inggs
+Greg Rafferty
+Győző Papp
+Heikki Orsila
+Henrik Sozzi
+Hugh McNamara
+Hugo van Kemenade
+Jacky Han
+Jacob Punter
+Jahir Fiquitiva
+Jakob M. Kjær
+Jan Pipek
+Jason Jensen
+Jeremy Chrimes
+Jerry Agbesi
+John Laswell
+Joost van Driel
+Jorge Cadena Argote
+Jose Riha
+Joshua Adelman
+Joël van Amerongen
+Julian Broudou
+Jung Dong Ho
+Justin Asfour
+Kamil Leduchowski
+Kate Golovanova
+Kelsey Karin Hawley
+Koert van der Veer
+Koki Nomura
+Maina Kamau
+Malthe Borch
+Marek Šuppa
+Martin Becker
+Martin Thurau
+Maurizio Montel
+Max Härtwig
+Michael Thessel
+Mike Borsetti
+Mike Polyakovsky
+Miroslav Šedivý
+Monde Sinxi
+Nataliia Dmytriievska
+Nate Harris
+Nathan Ell
+Nicholas Spagnoletti
+Nico Albers
+Olivier Iffrig
+Ondřej Nový
+Osayd Abdu
+Oscar Romero
+Pablo Merino
+Patrick Nicholson
+Paulo Orrock
+Pavel Sofroniev
+Pedro Baptista
+Peter Zsak
+Pieter van der Westhuizen
+Piotr Staniów
+Raphael Borg Ellul Vincenti
+Raychel Mattheeuw
+Reinaldo Ramos
+Robert Frazier
+Robert Schmidtke
+Robert Tran
+Robin Emeršič
+Ryan McCrory
+Sam Tregar
+Santiago Feliu
+Sergi Almacellas Abellana
+Sergio Mayoral Martinez
+Shaurya Uppal
+Sho Hirose
+Simon Gurcke
+Sugato Ray
+Sylvain Pasche
+Sylvia van Os
+Takeshi Osoekawa
+Tasnim Nishat Islam
+Tewodros Meshesha
+Thomas Bøvith
+Tommy Sparber
+Tudor Văran
+Victor Luna
+Victor Miti
+Ville Skyttä
+Youhei Sakurai

{holidays-0.42 → holidays-0.44}/CHANGES

@@ -1,3 +1,29 @@
+Version 0.44
+============
+
+Released March 4, 2024
+
+- Update Ethiopia holidays (#1704 by @KJhellico)
+- Update RELEASE.rst (#1698 by @arkid15r)
+- Update Ukrainian translations (proper apostrophe) (#1714 by @KJhellico)
+- Update make clean action: delete docs autosummary (#1711 by @arkid15r)
+- Update snapshots: Portugal holidays (#1709 by @PPsyrius)
+- Update test coverage to 100% (#1715 by @KJhellico)
+- Add AUTHORS file (#1700 by @arkid15r)
+- Add `UNOFFICIAL` category for the United States (#1669 by @PPsyrius)
+- Rename repository branches (#1699 by @arkid15r)
+
+Version 0.43
+============
+
+Released February 19, 2024
+
+- Introduce subdivisions aliases (#1662 by @sphh, @arkid15r)
+- Update Ireland holidays (#1687 by @KJhellico)
+- Update Portugal holidays: fix Carnival date (#1694 by @DgRosa)
+- Update Taiwan holidays (#1688 by @KJhellico)
+- Update Thailand holidays: add Bridge Public Holiday on Apr 12, 2024 (#1690 by @PPsyrius)
+
 Version 0.42
 ============
 

{holidays-0.42 → holidays-0.44}/CONTRIBUTING.rst

@@ -3,7 +3,7 @@ Contributing
 ============
 
 .. _prs: https://github.com/vacanza/python-holidays/pulls
-.. _`beta branch`: https://github.com/vacanza/python-holidays/tree/beta
+.. _`dev branch`: https://github.com/vacanza/python-holidays/tree/dev
 .. |contributors| image:: https://img.shields.io/github/contributors/vacanza/python-holidays
     :target: https://github.com/vacanza/python-holidays/graphs/contributors
     :alt: contributors
@@ -15,7 +15,7 @@ Basics
 ------
 
 When contributing with fixes and new features, please start forking/branching
-from the `beta branch`_ to work on the latest code and reduce merging issues.
+from the `dev branch`_ to work on the latest code and reduce merging issues.
 If you add/change holiday official dates or names you must include references to
 all sources (government sites, archived web pages, wiki pages, etc) you've used
 while working on this PR. Contributed PRs_ are required to include valid test

{holidays-0.42 → holidays-0.44}/Makefile

@@ -23,6 +23,7 @@ clean:
 	rm -rf .mypy_cache/*
 	rm -rf .pytest_cache/*
 	rm -rf docs/build/*
+	rm -rf docs/source/_autosummary/*
 
 coverage:
 	pytest --cov=. --cov-config=pyproject.toml --cov-report term-missing --dist loadscope --no-cov-on-fail --numprocesses auto

{holidays-0.42 → holidays-0.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: holidays
-Version: 0.42
+Version: 0.44
 Summary: Generate and work with holidays in Python
 Author-email: Maurizio Montel <dr.prodigy.github@gmail.com>
 Maintainer-email: Arkadii Yakovets <ark@cho.red>, Serhii Murza <jhellico@gmail.com>
@@ -45,6 +45,7 @@ Classifier: Topic :: Software Development :: Localization
 Requires-Python: >=3.8
 Description-Content-Type: text/x-rst
 License-File: LICENSE
+License-File: AUTHORS
 Requires-Dist: python-dateutil
 
 ===============
@@ -91,7 +92,7 @@ flexible as possible.
         :target: https://github.com/psf/black
         :alt: Code style
 
-    .. image:: https://img.shields.io/coverallsCoverage/github/vacanza/python-holidays?branch=master&color=%2341B5BE&style=flat
+    .. image:: https://img.shields.io/coverallsCoverage/github/vacanza/python-holidays?branch=main&color=%2341B5BE&style=flat
         :target: https://coveralls.io/r/vacanza/python-holidays
         :alt: Code coverage
 
@@ -109,8 +110,8 @@ flexible as possible.
         :target: https://github.com/vacanza/python-holidays/graphs/contributors
         :alt: GitHub contributors
 
-    .. image:: https://img.shields.io/github/last-commit/vacanza/python-holidays/beta?color=%2341BE4A&style=flat
-        :target: https://github.com/vacanza/python-holidays/commits/beta
+    .. image:: https://img.shields.io/github/last-commit/vacanza/python-holidays/dev?color=%2341BE4A&style=flat
+        :target: https://github.com/vacanza/python-holidays/commits/dev
         :alt: GitHub last commit
 
 
@@ -123,14 +124,14 @@ The latest stable version can always be installed or updated via pip:
 
     $ pip install --upgrade holidays
 
-The latest development (beta) version can be installed directly from GitHub:
+The latest development (dev) version can be installed directly from GitHub:
 
 .. code-block:: shell
 
-    $ pip install --upgrade https://github.com/vacanza/python-holidays/tarball/beta
+    $ pip install --upgrade https://github.com/vacanza/python-holidays/tarball/dev
 
-All new features are always first pushed to beta branch, then released on
-master branch upon official version upgrades.
+All new features are always first pushed to dev branch, then released on
+main branch upon official version upgrades.
 
 Documentation
 -------------
@@ -193,8 +194,10 @@ Available Countries
 
 We currently support 143 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 of the countries support more
-than one language for holiday names output.
+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
+the (optional) ``subdivisions_aliases`` attribute.
+Some of the countries support more than one language for holiday names output.
 A default language is defined by ``default_language`` (optional) attribute
 for each entity and is used as a fallback when neither user specified
 language nor user locale language available. The default language code is
@@ -207,8 +210,9 @@ bank holidays, school holidays, additional (paid or non-paid) holidays, holidays
 public employees, religious holidays (valid only for these religions followers). A list of all
 categories supported by country is defined by ``supported_categories`` (optional) attribute.
 
-The following is a list of supported countries, their subdivisions, available languages and
-additional categories. All countries support **PUBLIC** holidays category by default.
+The following is a list of supported countries, their subdivisions followed by their
+aliases (if any) in brackets, available languages and additional holiday categories.
+All countries support **PUBLIC** holidays category by default.
 All other default values are highlighted with bold:
 
 
@@ -236,7 +240,7 @@ All other default values are highlighted with bold:
      - AS
      - Can also be loaded as country US, subdivision AS
      -
-     -
+     - UNOFFICIAL
    * - Andorra
      - AD
      - Parishes: 02, 03, 04, 05, 06, 07, 08
@@ -269,7 +273,7 @@ All other default values are highlighted with bold:
      -
    * - Austria
      - AT
-     - States: 1, 2, 3, 4, 5, 6, 7, 8, **9**
+     - States: 1 (Burgenland, Bgld, B), 2 (Kärnten, Ktn, K), 3 (Niederösterreich, NÖ, N), 4 (Oberösterreich, OÖ, O), 5 (Salzburg, Sbg, S), 6 (Steiermark, Stmk, St), 7 (Tirol, T), 8 (Vorarlberg, Vbg, V), 9 (Wien, W)
      - **de**, en_US, uk
      - BANK
    * - Azerbaijan
@@ -501,7 +505,7 @@ All other default values are highlighted with bold:
      - GU
      - Can also be loaded as country US, subdivision GU
      -
-     -
+     - UNOFFICIAL
    * - Guatemala
      - GT
      -
@@ -711,7 +715,7 @@ All other default values are highlighted with bold:
      - MP
      - Can also be loaded as country US, subdivision MP
      -
-     -
+     - UNOFFICIAL
    * - North Macedonia
      - MK
      -
@@ -766,7 +770,7 @@ All other default values are highlighted with bold:
      - PR
      - Can also be loaded as country US, subdivision PR
      -
-     -
+     - UNOFFICIAL
    * - Romania
      - RO
      -
@@ -886,17 +890,17 @@ All other default values are highlighted with bold:
      - UM
      - Can also be loaded as country US, subdivision UM
      -
-     -
+     - 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
    * - United States Virgin Islands (the)
      -
      - See Virgin Islands (U.S.)
      -
-     -
+     - UNOFFICIAL
    * - Uruguay
      - UY
      -
@@ -931,7 +935,7 @@ All other default values are highlighted with bold:
      - VI
      - Can also be loaded as country US, subdivision VI
      -
-     -
+     - UNOFFICIAL
    * - Zambia
      - ZM
      -

{holidays-0.42 → holidays-0.44}/README.rst

@@ -42,7 +42,7 @@ flexible as possible.
         :target: https://github.com/psf/black
         :alt: Code style
 
-    .. image:: https://img.shields.io/coverallsCoverage/github/vacanza/python-holidays?branch=master&color=%2341B5BE&style=flat
+    .. image:: https://img.shields.io/coverallsCoverage/github/vacanza/python-holidays?branch=main&color=%2341B5BE&style=flat
         :target: https://coveralls.io/r/vacanza/python-holidays
         :alt: Code coverage
 
@@ -60,8 +60,8 @@ flexible as possible.
         :target: https://github.com/vacanza/python-holidays/graphs/contributors
         :alt: GitHub contributors
 
-    .. image:: https://img.shields.io/github/last-commit/vacanza/python-holidays/beta?color=%2341BE4A&style=flat
-        :target: https://github.com/vacanza/python-holidays/commits/beta
+    .. image:: https://img.shields.io/github/last-commit/vacanza/python-holidays/dev?color=%2341BE4A&style=flat
+        :target: https://github.com/vacanza/python-holidays/commits/dev
         :alt: GitHub last commit
 
 
@@ -74,14 +74,14 @@ The latest stable version can always be installed or updated via pip:
 
     $ pip install --upgrade holidays
 
-The latest development (beta) version can be installed directly from GitHub:
+The latest development (dev) version can be installed directly from GitHub:
 
 .. code-block:: shell
 
-    $ pip install --upgrade https://github.com/vacanza/python-holidays/tarball/beta
+    $ pip install --upgrade https://github.com/vacanza/python-holidays/tarball/dev
 
-All new features are always first pushed to beta branch, then released on
-master branch upon official version upgrades.
+All new features are always first pushed to dev branch, then released on
+main branch upon official version upgrades.
 
 Documentation
 -------------
@@ -144,8 +144,10 @@ Available Countries
 
 We currently support 143 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 of the countries support more
-than one language for holiday names output.
+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
+the (optional) ``subdivisions_aliases`` attribute.
+Some of the countries support more than one language for holiday names output.
 A default language is defined by ``default_language`` (optional) attribute
 for each entity and is used as a fallback when neither user specified
 language nor user locale language available. The default language code is
@@ -158,8 +160,9 @@ bank holidays, school holidays, additional (paid or non-paid) holidays, holidays
 public employees, religious holidays (valid only for these religions followers). A list of all
 categories supported by country is defined by ``supported_categories`` (optional) attribute.
 
-The following is a list of supported countries, their subdivisions, available languages and
-additional categories. All countries support **PUBLIC** holidays category by default.
+The following is a list of supported countries, their subdivisions followed by their
+aliases (if any) in brackets, available languages and additional holiday categories.
+All countries support **PUBLIC** holidays category by default.
 All other default values are highlighted with bold:
 
 
@@ -187,7 +190,7 @@ All other default values are highlighted with bold:
      - AS
      - Can also be loaded as country US, subdivision AS
      -
-     -
+     - UNOFFICIAL
    * - Andorra
      - AD
      - Parishes: 02, 03, 04, 05, 06, 07, 08
@@ -220,7 +223,7 @@ All other default values are highlighted with bold:
      -
    * - Austria
      - AT
-     - States: 1, 2, 3, 4, 5, 6, 7, 8, **9**
+     - States: 1 (Burgenland, Bgld, B), 2 (Kärnten, Ktn, K), 3 (Niederösterreich, NÖ, N), 4 (Oberösterreich, OÖ, O), 5 (Salzburg, Sbg, S), 6 (Steiermark, Stmk, St), 7 (Tirol, T), 8 (Vorarlberg, Vbg, V), 9 (Wien, W)
      - **de**, en_US, uk
      - BANK
    * - Azerbaijan
@@ -452,7 +455,7 @@ All other default values are highlighted with bold:
      - GU
      - Can also be loaded as country US, subdivision GU
      -
-     -
+     - UNOFFICIAL
    * - Guatemala
      - GT
      -
@@ -662,7 +665,7 @@ All other default values are highlighted with bold:
      - MP
      - Can also be loaded as country US, subdivision MP
      -
-     -
+     - UNOFFICIAL
    * - North Macedonia
      - MK
      -
@@ -717,7 +720,7 @@ All other default values are highlighted with bold:
      - PR
      - Can also be loaded as country US, subdivision PR
      -
-     -
+     - UNOFFICIAL
    * - Romania
      - RO
      -
@@ -837,17 +840,17 @@ All other default values are highlighted with bold:
      - UM
      - Can also be loaded as country US, subdivision UM
      -
-     -
+     - 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
    * - United States Virgin Islands (the)
      -
      - See Virgin Islands (U.S.)
      -
-     -
+     - UNOFFICIAL
    * - Uruguay
      - UY
      -
@@ -882,7 +885,7 @@ All other default values are highlighted with bold:
      - VI
      - Can also be loaded as country US, subdivision VI
      -
-     -
+     - UNOFFICIAL
    * - Zambia
      - ZM
      -

{holidays-0.42 → holidays-0.44}/holidays/__init__.py

@@ -16,7 +16,7 @@ from holidays.holiday_base import *
 from holidays.registry import EntityLoader
 from holidays.utils import *
 
-__version__ = "0.42"
+__version__ = "0.44"
 
 
 EntityLoader.load("countries", globals())

{holidays-0.42 → holidays-0.44}/holidays/constants.py

@@ -44,6 +44,7 @@ HALF_DAY = "half_day"
 OPTIONAL = "optional"
 PUBLIC = "public"
 SCHOOL = "school"
+UNOFFICIAL = "unofficial"
 WORKDAY = "workday"
 
 CHINESE = "chinese"

{holidays-0.42 → holidays-0.44}/holidays/countries/american_samoa.py

@@ -9,6 +9,7 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
@@ -18,12 +19,17 @@ class HolidaysAS(US):
     # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
 
     country = "AS"
+    supported_categories = (PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "AS"
         super()._populate_public_holidays()
 
+    def _populate_unofficial_holidays(self) -> None:
+        self.subdiv = "AS"
+        super()._populate_unofficial_holidays()
+
 
 class AS(HolidaysAS):
     pass

{holidays-0.42 → holidays-0.44}/holidays/countries/austria.py

@@ -21,16 +21,48 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
     default_language = "de"
     supported_categories = (BANK, PUBLIC)
     supported_languages = ("de", "en_US", "uk")
-    subdivisions = ("1", "2", "3", "4", "5", "6", "7", "8", "9")
+    subdivisions = (
+        "1",  # Burgenland.
+        "2",  # Kärnten.
+        "3",  # Niederösterreich.
+        "4",  # Oberösterreich.
+        "5",  # Salzburg.
+        "6",  # Steiermark.
+        "7",  # Tirol.
+        "8",  # Vorarlberg.
+        "9",  # Wien.
+    )
+    subdivisions_aliases = {
+        "Burgenland": "1",
+        "Bgld": "1",
+        "B": "1",
+        "Kärnten": "2",
+        "Ktn": "2",
+        "K": "2",
+        "Niederösterreich": "3",
+        "NÖ": "3",
+        "N": "3",
+        "Oberösterreich": "4",
+        "OÖ": "4",
+        "O": "4",
+        "Salzburg": "5",
+        "Sbg": "5",
+        "S": "5",
+        "Steiermark": "6",
+        "Stmk": "6",
+        "St": "6",
+        "Tirol": "7",
+        "T": "7",
+        "Vorarlberg": "8",
+        "Vbg": "8",
+        "V": "8",
+        "Wien": "9",
+        "W": "9",
+    }
 
     def __init__(self, *args, **kwargs) -> None:
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
-
-        # Set the default subdivision.
-        if not kwargs.get("subdiv", kwargs.get("state")):
-            kwargs["subdiv"] = "9"
-
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
@@ -58,11 +90,12 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Assumption Day.
         self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
 
+        # National Day.
+        national_day = tr("Nationalfeiertag")
         if 1919 <= self._year <= 1934:
-            # National Day.
-            self._add_holiday_nov_12(tr("Nationalfeiertag"))
+            self._add_holiday_nov_12(national_day)
         if self._year >= 1967:
-            self._add_holiday_oct_26(tr("Nationalfeiertag"))
+            self._add_holiday_oct_26(national_day)
 
         # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
@@ -86,6 +119,46 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
         # New Year's Eve.
         self._add_new_years_eve(tr("Silvester"))
 
+    def _populate_subdiv_1_bank_holidays(self):
+        # St. Martin's Day.
+        self._add_holiday_nov_11(tr("Hl. Martin"))
+
+    def _populate_subdiv_2_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+        # 1920 Carinthian plebiscite.
+        self._add_holiday_oct_10(tr("Tag der Volksabstimmung"))
+
+    def _populate_subdiv_3_bank_holidays(self):
+        # St. Leopold's Day.
+        self._add_holiday_nov_15(tr("Hl. Leopold"))
+
+    def _populate_subdiv_4_bank_holidays(self):
+        if self._year >= 2004:
+            # St. Florian's Day.
+            self._add_holiday_may_4(tr("Hl. Florian"))
+
+    def _populate_subdiv_5_bank_holidays(self):
+        # St. Rupert's Day.
+        self._add_holiday_sep_24(tr("Hl. Rupert"))
+
+    def _populate_subdiv_6_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_7_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_8_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_9_bank_holidays(self):
+        # St. Leopold's Day.
+        self._add_holiday_nov_15(tr("Hl. Leopold"))
+
 
 class AT(Austria):
     pass