1 unstable release
0.1.0 | Feb 2, 2023 |
---|
#264 in Date and time
7MB
102K
SLoC
holidays-rs
Design
python-holidays is a well maintained package to generate holidays dynamically. This crate is on the other hand, rather than porting python-holidays
into Rust, statically generates the Rust code of holidays by the script using python-holidays
. Since the holiday database of this crate boils down to a thread-safe HashMap
(There is an option for single thread use case) in Rust, it's ultra fast and flexible to use in most of the cases.
To keep freshness of the holiday database, we're planning to have Github Actions job to automate
- Generating code by the script using the latest
python-holidays
- Build and run tests
- If there is any change, it will bump the version and publish to crates.io
Usage
The simplest usage is to call holidays::init
to initialize holiday database in thread-safe HashMap
. After holiday database is initialized, you can call holidays::contains
to check if the specified date is a holiday or not. Calls holidays::get
to gen an object which contains country code, country name, date and name of the holiday.
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(())
}
Note that holidays::init will load the holidays of all the supported countries and years into memory, so it's quite heavy.
If you need holidays of certain countries and years, please consider using holidays::Builder
to limit them.
holidays::Builder::new()
.countries(&[Country::JP])
.years(2022..2023)
.init()?;
If you know what countries are needed at compile-time, you can specify the country code in Cargo.toml
. This can improve the build performance significantly.
holidays = { version = "*", default-features = false, features = ["JP"] }
Available countries and years
holidays-rs supports countries listed in the below link from 2000 to 2023.
https://github.com/dr-prodigy/python-holidays#available-countries
FAQ
- Q: How can I use this crate in a single threaded environment?
- A: Don't call
init
norholidays::Builder
sinit
methods. Instead, you can get the internal HashMap by callingholidays::Builder
'sbuild
method.
Acknowledgement
Thank you so much python-holidays contributors for maintaining such a great package! 🙏
License
This project is licensed under the MIT license.
Dependencies
~1.2–2MB
~35K SLoC