A clean, modular and typed Python SDK for HolidayAPI (https://holidayapi.com).
Provides a structured interface to access holidays, countries, languages, workdays, and workday endpoints.
This is an unofficial SDK and is not affiliated with HolidayAPI.
Install directly from GitHub:
pip install git+https://github.com/your-username/holidayapi-sdk.git
Or clone the repository manually.
from holidayapi_sdk import HolidayAPI
from holidayapi_sdk.models.holidays_query import HolidaysQuery
api = HolidayAPI("your_api_key")
query = HolidaysQuery(
country="RU",
year=2024,
pretty=True
)
response = api.holidays.get(query)
print(response)- Resource-based SDK (.holidays, .countries, .languages, .workdays, .workday)
- Request models powered by pydantic
- Explicit .get() method per resource
- Query serialization via .to_query()
- Designed for simplicity and clarity
- Async support (HolidayAPIAsync)
- Typed response models (instead of raw dict)
- Custom exception classes
- Unit and integration test suite
- PyPI packaging and release
- Docs generation
MIT License. See LICENSE for full details.