Holidata is a utility for algorithmically producing holidays for a given locale and year
Project description
holidata
holidata
is a utility for algorithmically producing holiday data.
Its purpose is mainly for holidata.net.
Holiday data can be produced for a given year in a supported locale and output format.
Usage
Call holidata
providing the necessary data, e.g.
$ holidata --year=2020 --locale=de-DE
Call holidata
with the --usage
or --help
option to get usage info or help respectively.
Data
For each holiday the following data is provided:
locale
- language and country the holiday is defined forregion
- region code of the given subdivision the holiday is defined fordate
- actual date the holiday takes placedescription
- name of the holiday in the given languagetype
- holiday type flagsnotes
- additional information
Locales
Holidata provides holiday data in different locales, i.e. for a given country and a in given language. See holidata.net for a complete overview of the currently provided locales.
If you think a locale is missing, open a feature request on github.
Output Formats
Holidata supports different output formats, currently csv
, json
, yaml
, and xml
.
If you think an output format is missing, open a feature request on github.
Limitations
Holidata focuses on holidays which are defined by law on which business or work are suspended or reduced (there may be some exceptions to that rule).
Holidata only provides data for countries and their principal subdivisions (both as they are defined in ISO 3166). Holidays for other subdivisions are either merged or ignored. There is also no explicit representation of partial holidays.
License
holidata
is released under the MIT license. For details check the LICENSE file.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for holidata-2022.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 44b49a4bdbd5934216220df732e57a24ac16e77e0514518cff64ac569a88460d |
|
MD5 | 299d7112441599df2b763f6fcd6ce082 |
|
BLAKE2b-256 | ecc47c2abdf381723c21e7730350c704857fb59ca10add735ac12023bee6add4 |