Skip to main content

Python package with Czech public holidays

Project description

Python package with Czech public holidays.

Installation

From PyPI:

pip install czech-holidays

In case you have an adventurous mind, give a try to the source:

pip install git+https://github.com/honzajavorek/czech-holidays.git#egg=czech-holidays

Examples

Czech Holidays provides the following interface:

>>> from czech_holidays import czech_holidays
>>> holidays = czech_holidays(2022)
>>> holidays[:3]
[Holiday(date=datetime.date(2022, 1, 1), name='Nový rok', name_en="New Year's Day"),
 Holiday(date=datetime.date(2022, 1, 1), name='Den obnovy samostatného českého státu', name_en='Restoration Day of the Independent Czech State'),
 Holiday(date=datetime.date(2022, 4, 18), name='Velikonoční pondělí', name_en='Easter Monday')]

The function accepts year as a single argument and returns a list of named tuples:

>>> holidays[0].date
datetime.date(2022, 1, 1)
>>> holidays[0].name
'Nový rok'
>>> holidays[0].name_en
"New Year's Day"

Albeit named, it’s still just a tuple:

>>> holidays[0][0]
datetime.date(2022, 1, 1)
>>> holidays[0][1]
'Nový rok'
>>> holidays[0][2]
"New Year's Day"
>>> tuple(holidays[0])
(datetime.date(2022, 1, 1), 'Nový rok', "New Year's Day")
>>> holidays[0] < holidays[5]
True

Two shortcuts are available:

>>> from czech_holidays import czech_easter, czech_christmas
>>> czech_easter(2022)
Holiday(date=datetime.date(2022, 4, 18), name='Velikonoční pondělí', name_en='Easter Monday')
>>> czech_christmas(2022)
Holiday(date=datetime.date(2022, 12, 24), name='Štědrý den', name_en='Christmas Eve')

The aim of this library is to simplify work with Czech public holidays in current applications, thus it does not provide any historical data:

>>> czech_holidays(2013)
Traceback (most recent call last):
NotImplementedError: ...

Development

Install using poetry:

git clone git@github.com:honzajavorek/czech-holidays.git
cd czech-holidays
poetry install

Then run tests:

pytest

License: MIT

© 2022 Honza Javorek <mail@honzajavorek.cz>

This work is licensed under MIT license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

czech-holidays-1.0.0.tar.gz (3.9 kB view hashes)

Uploaded Source

Built Distribution

czech_holidays-1.0.0-py3-none-any.whl (3.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page