holidays 0.59__py3-none-any.whl → 0.61__py3-none-any.whl

holidays/countries/brazil.py

@@ -11,53 +11,87 @@
 #  License: MIT (see LICENSE file)
 
 from datetime import date
+from gettext import gettext as tr
 
-from holidays.calendars.gregorian import JAN, MAR, SEP, NOV, FRI, _get_nth_weekday_from
+from holidays.calendars.gregorian import JAN, MAR, SEP, NOV
 from holidays.constants import OPTIONAL, PUBLIC
 from holidays.groups import ChristianHolidays, InternationalHolidays
-from holidays.holiday_base import HolidayBase
+from holidays.observed_holiday_base import ObservedHolidayBase, TUE_WED_THU_TO_NEXT_FRI
 
 
-class Brazil(HolidayBase, ChristianHolidays, InternationalHolidays):
+class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
     """
     References:
         - https://pt.wikipedia.org/wiki/Feriados_no_Brasil
         - `Decreto n. 155-B, de 14.01.1890 <https://www2.camara.leg.br/legin/fed/decret/1824-1899/decreto-155-b-14-janeiro-1890-517534-publicacaooriginal-1-pe.html>`_
         - `Decreto n. 19.488, de 15.12.1930 <https://www2.camara.leg.br/legin/fed/decret/1930-1939/decreto-19488-15-dezembro-1930-508040-republicacao-85201-pe.html>`_
-        - `Lei n. 14.759/23 <https://www2.camara.leg.br/legin/fed/lei/2023/lei-14759-21-dezembro-2023-795091-publicacaooriginal-170522-pl.html>`_
+        - `Lei n. 662, de 6.04.1949 <https://www2.camara.leg.br/legin/fed/lei/1940-1949/lei-662-6-abril-1949-347136-publicacaooriginal-1-pl.html>`_
+        - `Lei n. 14.759, de 21.12.2023 <https://www2.camara.leg.br/legin/fed/lei/2023/lei-14759-21-dezembro-2023-795091-publicacaooriginal-170522-pl.html>`_
     """
 
     country = "BR"
+    default_language = "pt_BR"
     subdivisions = (
-        "AC",  # Acre
-        "AL",  # Alagoas
-        "AM",  # Amazonas
-        "AP",  # Amapá
-        "BA",  # Bahia
-        "CE",  # Ceará
-        "DF",  # Distrito Federal
-        "ES",  # Espírito Santo
-        "GO",  # Goiás
-        "MA",  # Maranhão
-        "MG",  # Minas Gerais
-        "MS",  # Mato Grosso do Sul
-        "MT",  # Mato Grosso
-        "PA",  # Pará
-        "PB",  # Paraíba
-        "PE",  # Pernambuco
-        "PI",  # Piauí
-        "PR",  # Paraná
-        "RJ",  # Rio de Janeiro
-        "RN",  # Rio Grande do Norte
-        "RO",  # Rondônia
-        "RR",  # Roraima
-        "RS",  # Rio Grande do Sul
-        "SC",  # Santa Catarina
-        "SE",  # Sergipe
-        "SP",  # São Paulo
-        "TO",  # Tocantins
+        "AC",
+        "AL",
+        "AM",
+        "AP",
+        "BA",
+        "CE",
+        "DF",
+        "ES",
+        "GO",
+        "MA",
+        "MG",
+        "MS",
+        "MT",
+        "PA",
+        "PB",
+        "PE",
+        "PI",
+        "PR",
+        "RJ",
+        "RN",
+        "RO",
+        "RR",
+        "RS",
+        "SC",
+        "SE",
+        "SP",
+        "TO",
     )
+    subdivisions_aliases = {
+        "Acre": "AC",
+        "Alagoas": "AL",
+        "Amazonas": "AM",
+        "Amapá": "AP",
+        "Bahia": "BA",
+        "Ceará": "CE",
+        "Distrito Federal": "DF",
+        "Espírito Santo": "ES",
+        "Goiás": "GO",
+        "Maranhão": "MA",
+        "Minas Gerais": "MG",
+        "Mato Grosso do Sul": "MS",
+        "Mato Grosso": "MT",
+        "Pará": "PA",
+        "Paraíba": "PB",
+        "Pernambuco": "PE",
+        "Piauí": "PI",
+        "Paraná": "PR",
+        "Rio de Janeiro": "RJ",
+        "Rio Grande do Norte": "RN",
+        "Rondônia": "RO",
+        "Roraima": "RR",
+        "Rio Grande do Sul": "RS",
+        "Santa Catarina": "SC",
+        "Sergipe": "SE",
+        "São Paulo": "SP",
+        "Tocantins": "TO",
+    }
+
     supported_categories = (OPTIONAL, PUBLIC)
+    supported_languages = ("en_US", "pt_BR", "uk")
 
     def __init__(self, *args, **kwargs) -> None:
         ChristianHolidays.__init__(self)
@@ -69,77 +103,83 @@ class Brazil(HolidayBase, ChristianHolidays, InternationalHolidays):
         if self._year <= 1889:
             return None
 
-        # New Year's Day.
-        self._add_new_years_day("Confraternização Universal")
+        # Universal Fraternization Day.
+        self._add_new_years_day(tr("Confraternização Universal"))
 
         if 1892 <= self._year <= 1930:
             # Republic Constitution Day.
-            self._add_holiday_feb_24("Constituição da Republica")
+            self._add_holiday_feb_24(tr("Constituição da Republica"))
 
         # Good Friday.
-        self._add_good_friday("Sexta-feira Santa")
+        self._add_good_friday(tr("Sexta-feira Santa"))
 
         if self._year not in {1931, 1932}:
             # Tiradentes' Day.
-            self._add_holiday_apr_21("Tiradentes")
+            self._add_holiday_apr_21(tr("Tiradentes"))
 
         if self._year >= 1925:
-            # Labor Day.
-            self._add_labor_day("Dia do Trabalhador")
+            # Worker's Day.
+            self._add_labor_day(tr("Dia do Trabalhador"))
 
-        if self._year <= 1930:
+        if self._year <= 1930 or 1936 <= self._year <= 1948:
             # Discovery of Brazil.
-            self._add_holiday_may_3("Descobrimento do Brasil")
+            self._add_holiday_may_3(tr("Descobrimento do Brasil"))
 
+        if self._year <= 1930:
             # Abolition of slavery in Brazil.
-            self._add_holiday_may_13("Abolição da escravidão no Brasil")
+            self._add_holiday_may_13(tr("Abolição da escravidão no Brasil"))
 
             # Freedom and Independence of American Peoples.
-            self._add_holiday_jul_14("Liberdade e Independência dos Povos Americanos")
+            self._add_holiday_jul_14(tr("Liberdade e Independência dos Povos Americanos"))
 
         # Independence Day.
-        self._add_holiday_sep_7("Independência do Brasil")
+        self._add_holiday_sep_7(tr("Independência do Brasil"))
+
+        if self._year <= 1930 or 1936 <= self._year <= 1948:
+            # Discovery of America.
+            self._add_columbus_day(tr("Descobrimento da América"))
 
-        if self._year <= 1930 or self._year >= 1980:
+        if self._year >= 1980:
             # Our Lady of Aparecida.
-            self._add_holiday_oct_12("Nossa Senhora Aparecida")
+            self._add_holiday_oct_12(tr("Nossa Senhora Aparecida"))
 
         # All Souls' Day.
-        self._add_all_souls_day("Finados")
+        self._add_all_souls_day(tr("Finados"))
 
         # Republic Proclamation Day.
-        self._add_holiday_nov_15("Proclamação da República")
+        self._add_holiday_nov_15(tr("Proclamação da República"))
 
         if self._year >= 2024:
             # National Day of Zumbi and Black Awareness.
-            self._add_holiday_nov_20("Dia Nacional de Zumbi e da Consciência Negra")
+            self._add_holiday_nov_20(tr("Dia Nacional de Zumbi e da Consciência Negra"))
 
         if self._year >= 1922:
             # Christmas Day.
-            self._add_christmas_day("Natal")
+            self._add_christmas_day(tr("Natal"))
 
     def _populate_optional_holidays(self):
         if self._year <= 1889:
             return None
 
         # Carnival.
-        self._add_carnival_monday("Carnaval")
-        self._add_carnival_tuesday("Carnaval")
+        name = tr("Carnaval")
+        self._add_carnival_monday(name)
+        self._add_carnival_tuesday(name)
 
         # Ash Wednesday.
-        self._add_ash_wednesday("Início da Quaresma")
+        self._add_ash_wednesday(tr("Início da Quaresma"))
 
         # Corpus Christi.
-        self._add_corpus_christi_day("Corpus Christi")
+        self._add_corpus_christi_day(tr("Corpus Christi"))
 
         # Public Servant's Day.
-        self._add_holiday_oct_28("Dia do Servidor Público")
+        self._add_holiday_oct_28(tr("Dia do Servidor Público"))
 
         # Christmas Eve.
-        self._add_christmas_eve("Véspera de Natal")
+        self._add_christmas_eve(tr("Véspera de Natal"))
 
         # New Year's Eve.
-        self._add_new_years_eve("Véspera de Ano-Novo")
+        self._add_new_years_eve(tr("Véspera de Ano-Novo"))
 
     def _populate_subdiv_holidays(self):
         # Lei n. 9.093, de 12.09.1995
@@ -150,179 +190,179 @@ class Brazil(HolidayBase, ChristianHolidays, InternationalHolidays):
         def get_movable_acre(*args) -> date:
             dt = date(self._year, *args)
             return (
-                _get_nth_weekday_from(+1, FRI, dt)
+                dt_observed
                 if self._year >= 2009
-                and (self._is_tuesday(dt) or self._is_wednesday(dt) or self._is_thursday(dt))
+                and (dt_observed := self._get_observed_date(dt, TUE_WED_THU_TO_NEXT_FRI))
                 else dt
             )
 
         if self._year >= 2005:
             # Evangelical Day.
-            self._add_holiday("Dia do Evangélico", get_movable_acre(JAN, 23))
+            self._add_holiday(tr("Dia do Evangélico"), get_movable_acre(JAN, 23))
 
         if self._year >= 2002:
             # International Women's Day.
-            self._add_holiday("Dia Internacional da Mulher", get_movable_acre(MAR, 8))
+            self._add_holiday(tr("Dia Internacional da Mulher"), get_movable_acre(MAR, 8))
 
         # Founding of Acre.
-        self._add_holiday_jun_15("Aniversário do Acre")
+        self._add_holiday_jun_15(tr("Aniversário do Acre"))
 
         if self._year >= 2004:
             # Amazonia Day.
-            self._add_holiday("Dia da Amazônia", get_movable_acre(SEP, 5))
+            self._add_holiday(tr("Dia da Amazônia"), get_movable_acre(SEP, 5))
 
         # Signing of the Petropolis Treaty.
-        self._add_holiday("Assinatura do Tratado de Petrópolis", get_movable_acre(NOV, 17))
+        self._add_holiday(tr("Assinatura do Tratado de Petrópolis"), get_movable_acre(NOV, 17))
 
     def _populate_subdiv_al_public_holidays(self):
         # Saint John's Day.
-        self._add_saint_johns_day("São João")
+        self._add_saint_johns_day(tr("São João"))
 
         # Saint Peter's Day.
-        self._add_saints_peter_and_paul_day("São Pedro")
+        self._add_saints_peter_and_paul_day(tr("São Pedro"))
 
         # Political Emancipation of Alagoas.
-        self._add_holiday_sep_16("Emancipação Política de Alagoas")
+        self._add_holiday_sep_16(tr("Emancipação Política de Alagoas"))
 
         if self._year <= 2023:
             # Black Awareness Day.
-            self._add_holiday_nov_20("Consciência Negra")
+            self._add_holiday_nov_20(tr("Consciência Negra"))
 
         if self._year >= 2013:
-            self._add_holiday_nov_30("Dia do Evangélico")
+            self._add_holiday_nov_30(tr("Dia do Evangélico"))
 
     def _populate_subdiv_am_public_holidays(self):
         # Elevation of Amazonas to province.
-        self._add_holiday_sep_5("Elevação do Amazonas à categoria de província")
+        self._add_holiday_sep_5(tr("Elevação do Amazonas à categoria de província"))
 
         if 2010 <= self._year <= 2023:
-            self._add_holiday_nov_20("Consciência Negra")
+            self._add_holiday_nov_20(tr("Consciência Negra"))
 
     def _populate_subdiv_ap_public_holidays(self):
         if self._year >= 2003:
             # Saint Joseph's Day.
-            self._add_saint_josephs_day("São José")
+            self._add_saint_josephs_day(tr("São José"))
 
         if self._year >= 2012:
             # Saint James' Day.
-            self._add_saint_james_day("São Tiago")
+            self._add_saint_james_day(tr("São Tiago"))
 
         # Creation of the Federal Territory.
-        self._add_holiday_sep_13("Criação do Território Federal")
+        self._add_holiday_sep_13(tr("Criação do Território Federal"))
 
         if 2008 <= self._year <= 2023:
-            self._add_holiday_nov_20("Consciência Negra")
+            self._add_holiday_nov_20(tr("Consciência Negra"))
 
     def _populate_subdiv_ba_public_holidays(self):
         # Bahia Independence Day.
-        self._add_holiday_jul_2("Independência da Bahia")
+        self._add_holiday_jul_2(tr("Independência da Bahia"))
 
     def _populate_subdiv_ce_public_holidays(self):
-        self._add_saint_josephs_day("São José")
+        self._add_saint_josephs_day(tr("São José"))
 
         # Abolition of slavery in Ceará.
-        self._add_holiday_mar_25("Abolição da escravidão no Ceará")
+        self._add_holiday_mar_25(tr("Abolição da escravidão no Ceará"))
 
         if self._year >= 2004:
             # Our Lady of Assumption.
-            self._add_assumption_of_mary_day("Nossa Senhora da Assunção")
+            self._add_assumption_of_mary_day(tr("Nossa Senhora da Assunção"))
 
     def _populate_subdiv_df_public_holidays(self):
         # Founding of Brasilia.
-        self._add_holiday_apr_21("Fundação de Brasília")
+        self._add_holiday_apr_21(tr("Fundação de Brasília"))
 
-        self._add_holiday_nov_30("Dia do Evangélico")
+        self._add_holiday_nov_30(tr("Dia do Evangélico"))
 
     def _populate_subdiv_es_public_holidays(self):
         if self._year >= 2020:
             # Our Lady of Penha.
-            self._add_holiday_8_days_past_easter("Nossa Senhora da Penha")
+            self._add_holiday_8_days_past_easter(tr("Nossa Senhora da Penha"))
 
     def _populate_subdiv_go_public_holidays(self):
         # Foundation of Goiás city.
-        self._add_holiday_jul_26("Fundação da cidade de Goiás")
+        self._add_holiday_jul_26(tr("Fundação da cidade de Goiás"))
 
         # Foundation of Goiânia.
-        self._add_holiday_oct_24("Pedra fundamental de Goiânia")
+        self._add_holiday_oct_24(tr("Pedra fundamental de Goiânia"))
 
     def _populate_subdiv_ma_public_holidays(self):
         # Maranhão joining to independence of Brazil.
-        self._add_holiday_jul_28("Adesão do Maranhão à independência do Brasil")
+        self._add_holiday_jul_28(tr("Adesão do Maranhão à independência do Brasil"))
 
     def _populate_subdiv_mg_public_holidays(self):
         # Tiradentes' Execution.
-        self._add_holiday_apr_21("Execução de Tiradentes")
+        self._add_holiday_apr_21(tr("Execução de Tiradentes"))
 
     def _populate_subdiv_ms_public_holidays(self):
         # State Creation Day.
-        self._add_holiday_oct_11("Criação do Estado")
+        self._add_holiday_oct_11(tr("Criação do Estado"))
 
     def _populate_subdiv_mt_public_holidays(self):
         if 2003 <= self._year <= 2023:
-            self._add_holiday_nov_20("Consciência Negra")
+            self._add_holiday_nov_20(tr("Consciência Negra"))
 
     def _populate_subdiv_pa_public_holidays(self):
         # Grão-Pará joining to independence of Brazil.
-        self._add_holiday_aug_15("Adesão do Grão-Pará à independência do Brasil")
+        self._add_holiday_aug_15(tr("Adesão do Grão-Pará à independência do Brasil"))
 
     def _populate_subdiv_pb_public_holidays(self):
         # State Founding Day.
-        self._add_holiday_aug_5("Fundação do Estado")
+        self._add_holiday_aug_5(tr("Fundação do Estado"))
 
     def _populate_subdiv_pe_public_holidays(self):
         if self._year >= 2008:
             # Pernambuco Revolution.
-            self._add_holiday_1st_sun_of_mar("Revolução Pernambucana")
+            self._add_holiday_1st_sun_of_mar(tr("Revolução Pernambucana"))
 
     def _populate_subdiv_pi_public_holidays(self):
         # Piauí Day.
-        self._add_holiday_oct_19("Dia do Piauí")
+        self._add_holiday_oct_19(tr("Dia do Piauí"))
 
     def _populate_subdiv_pr_public_holidays(self):
-        # Emancipation of Paraná.
-        self._add_holiday_dec_19("Emancipação do Paraná")
+        # Political Emancipation of Paraná.
+        self._add_holiday_dec_19(tr("Emancipação do Paraná"))
 
     def _populate_subdiv_rj_public_holidays(self):
         if self._year >= 2008:
             # Saint George's Day.
-            self._add_saint_georges_day("São Jorge")
+            self._add_saint_georges_day(tr("São Jorge"))
 
         if 2002 <= self._year <= 2023:
-            self._add_holiday_nov_20("Consciência Negra")
+            self._add_holiday_nov_20(tr("Consciência Negra"))
 
     def _populate_subdiv_rn_public_holidays(self):
         if self._year >= 2000:
             # Rio Grande do Norte Day.
-            self._add_holiday_aug_7("Dia do Rio Grande do Norte")
+            self._add_holiday_aug_7(tr("Dia do Rio Grande do Norte"))
 
         if self._year >= 2007:
-            # Uruaçú and Cunhaú Martyrs Day.
-            self._add_holiday_oct_3("Mártires de Cunhaú e Uruaçuu")
+            # Uruaçu and Cunhaú Martyrs Day.
+            self._add_holiday_oct_3(tr("Mártires de Cunhaú e Uruaçu"))
 
     def _populate_subdiv_ro_public_holidays(self):
-        self._add_holiday_jan_4("Criação do Estado")
+        self._add_holiday_jan_4(tr("Criação do Estado"))
 
         if self._year >= 2002:
-            self._add_holiday_jun_18("Dia do Evangélico")
+            self._add_holiday_jun_18(tr("Dia do Evangélico"))
 
     def _populate_subdiv_rr_public_holidays(self):
-        self._add_holiday_oct_5("Criação do Estado")
+        self._add_holiday_oct_5(tr("Criação do Estado"))
 
     def _populate_subdiv_rs_public_holidays(self):
         # Gaucho Day.
-        self._add_holiday_sep_20("Dia do Gaúcho")
+        self._add_holiday_sep_20(tr("Dia do Gaúcho"))
 
     def _populate_subdiv_sc_public_holidays(self):
         if self._year >= 2004:
             # Santa Catarina State Day.
-            name = "Dia do Estado de Santa Catarina"
+            name = tr("Dia do Estado de Santa Catarina")
             if self._year >= 2005:
                 self._add_holiday_1st_sun_from_aug_11(name)
             else:
                 self._add_holiday_aug_11(name)
 
         # Saint Catherine of Alexandria Day.
-        name = "Dia de Santa Catarina de Alexandria"
+        name = tr("Dia de Santa Catarina de Alexandria")
         if 1999 <= self._year != 2004:
             self._add_holiday_1st_sun_from_nov_25(name)
         else:
@@ -330,22 +370,22 @@ class Brazil(HolidayBase, ChristianHolidays, InternationalHolidays):
 
     def _populate_subdiv_se_public_holidays(self):
         # Sergipe Political Emancipation Day.
-        self._add_holiday_jul_8("Emancipação política de Sergipe")
+        self._add_holiday_jul_8(tr("Emancipação política de Sergipe"))
 
     def _populate_subdiv_sp_public_holidays(self):
         if self._year >= 1997:
             # Constitutionalist Revolution.
-            self._add_holiday_jul_9("Revolução Constitucionalista")
+            self._add_holiday_jul_9(tr("Revolução Constitucionalista"))
 
     def _populate_subdiv_to_public_holidays(self):
         if self._year >= 1998:
             # Autonomy Day.
-            self._add_holiday_mar_18("Dia da Autonomia")
+            self._add_holiday_mar_18(tr("Dia da Autonomia"))
 
         # Our Lady of Nativity.
-        self._add_nativity_of_mary_day("Nossa Senhora da Natividade")
+        self._add_nativity_of_mary_day(tr("Nossa Senhora da Natividade"))
 
-        self._add_holiday_oct_5("Criação do Estado")
+        self._add_holiday_oct_5(tr("Criação do Estado"))
 
 
 class BR(Brazil):