Python-Holidays库中巴西狂欢节(Carnaval)的获取方法变更说明

背景介绍

Python-Holidays是一个用于处理各国节假日的Python库，它提供了便捷的接口来查询不同国家/地区的法定假日信息。在巴西的节假日体系中，狂欢节(Carnaval)是一个重要的传统节日，但它在库中的处理方式在v0.33版本后发生了变化。

版本变更细节

在Python-Holidays库的v0.33版本之前，巴西的狂欢节被归类为公共假日(PUBLIC)，可以直接通过默认查询获取。但从v0.33版本开始，开发团队对巴西节假日分类进行了调整：

1. 狂欢节被重新归类为可选假日(OPTIONAL)
2. 这种调整更准确地反映了巴西节假日体系的实际情况
3. 需要显式指定OPTIONAL类别才能查询到这类节日

新版使用方法

要正确获取巴西的所有节假日（包括狂欢节），现在需要使用以下代码结构：

from holidays.constants import OPTIONAL, PUBLIC
from holidays.utils import country_holidays

# 获取所有节假日（包括公共假日和可选假日）
br_holidays = country_holidays("BR", years=2023, categories=(OPTIONAL, PUBLIC))

# 如果只需要获取可选假日（如狂欢节）
br_optional = country_holidays("BR", years=2023, categories=OPTIONAL)

技术建议

1. 对于依赖特定节假日数据的应用，建议在代码中明确指定categories参数
2. 升级库版本时，应注意检查节假日分类的变更情况
3. 可以通过查看库的更新日志了解各国节假日分类的具体变化

总结

Python-Holidays库通过更精细的节假日分类，提供了更准确的国家节假日数据。开发者在使用时需要注意不同版本间的行为差异，特别是对于像巴西狂欢节这样被重新分类的节假日。明确指定查询类别可以确保获取到完整的节假日数据。