holidays-rs

设计

python-holidays 是一个维护良好的包，用于动态生成节假日。另一方面，本库不是将 python-holidays 转移到 Rust，而是使用 python-holidays 的脚本静态生成节假日的 Rust 代码。由于本库的节假日数据库简化为一个线程安全的 HashMap（存在单线程使用选项），因此它在大多数情况下都非常快且灵活。

为了保持节假日数据库的新鲜性，我们计划使用 Github Actions 任务来自动

1. 使用脚本通过最新的 python-holidays 生成代码
2. 构建和运行测试
3. 如果有任何更改，它将增加版本并发布到 crates.io

使用方法

最简单的使用方法是调用 holidays::init 来在线程安全的 HashMap 中初始化节假日数据库。节假日数据库初始化后，您可以调用 holidays::contains 来检查指定日期是否为节假日。调用 holidays::get 生成一个包含国家代码、国家名称、日期和节假日名称的对象。

use chrono::NaiveDate;
use holidays::Country;

fn main() -> anyhow::Result<()> {
    holidays::init()?;

    let d = NaiveDate::from_ymd_opt(2022, 1, 1).expect("Invalid date");
    println!("Is {d} a holiday in Japan? Answer is {}", holidays::contains(Country::JP, d)?);
    println!("{:?}", holidays::get(Country::JP, d)?.unwrap());

    Ok(())
}

注意，holidays::init 会将所有支持的国家和年份的节假日加载到内存中，所以它相当重。 如果您需要某些国家和年份的节假日，请考虑使用 holidays::Builder 来限制它们。

holidays::Builder::new()
        .countries(&[Country::JP])
        .years(2022..2023)
        .init()?;

holidays = { version = "*", default-features = false, features = ["JP"] }