Holidata
holidata is a utility for algorithmically producing holiday data.
It is used e.g. by Taskwarrior and Timewarrior, as well as for holidata.net.
Holiday data can be produced for a given year in a supported locale and output format.
Installation
holidata is published on PyPI and can be installed as a command-line tool with:
uv tool install holidata
Alternatively, run it once without installing via uvx:
uvx holidata --year=<value> --locale=<value> [--output=<value>]
uvx holidata --year=<value> --country=<value> [--lang=<value>] [--output=<value>]
For development setup, see CONTRIBUTING.md.
Call holidata --help for more detailed information.
Examples
-
Create holiday data of year
2026for localede-DE:$ holidata --year=2026 --locale=de-DE -
Create holiday data of year
2026for countryBEand languagefr:$ holidata --year=2026 --country=BE --lang=fr -
Create holiday data of year
2026for countryUS(default languageen):$ holidata --year=2026 --country=US
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 in a 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, jsonline, yaml, and xml.
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.
Contributing
Take a look at CONTRIBUTING.md on how you can contribute. ❤️
License
holidata is released under the MIT license.
For details check the LICENSE file.
1 maintainer
Metadata
1 maintainer
Release files for holidata 2026.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| holidata-2026.9.0.tar.gz | 44.5 kB | Without provenance | Details for holidata-2026.9.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| holidata-2026.9.0-py3-none-any.whl | Python 3 | none | any | Details for holidata-2026.9.0-py3-none-any.whl |
Total release size: 122.4 kB
Release files / holidata-2026.9.0.tar.gz
| Download URL | holidata-2026.9.0.tar.gz |
|---|---|
| Size | 44.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
48541e79d3dd07d8f617b325a45b422bd2d26ff2554fa905e6cf3953cf16f834
|
|
BLAKE2b-256 checksum How to use checksums |
c8f4ccd93607121ff1d890ccd15245ab419aac1dded472d0cbca8ba27b47f236
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / holidata-2026.9.0-py3-none-any.whl
| Download URL | holidata-2026.9.0-py3-none-any.whl |
|---|---|
| Size | 77.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe9ea6ac640352263ce5ab794124be8dd12a0c5bbc5f621a5fe419f09872e38b
|
|
BLAKE2b-256 checksum How to use checksums |
7b0456befed2405fae694adc3485907b7027bc845c3eb1005b05dad6e8da3546
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for holidata 2026.9.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
