X-Holidays

A comprehensive Python library for managing Persian (Jalali), International, and Islamic holidays, as well as famous birthdays.

Features

• Jalali Date Support
• National & Seasonal Holidays
• International Observances
• Famous Birthdays
• Islamic Holidays

Files

X-Holidays/
├── LICENSE
├── MANIFEST.in
├── README.md
├── requirements.txt
├── setup.py
├── test_app.py
└── x_holidays/
---->├── init.py
---->├── utils.py
---->├── seasons.py
---->├── global_events.py
---->├── birthdays.py
---->└── islamic.py

Installation

pip install git+https://github.com/Amir-X/X-Holidays.git

• Or:

pip install X-Holidays

• Or clone and install locally:

git clone https://github.com/Amir-X/X-Holidays.git

cd X-Holidays

pip install -e .

Usage

from x_holidays import Holiday

manager = Holiday()

# Get all holidays for Jalali Year 1403
holidays = manager.get_all_holidays(1403)
for h in holidays[:5]:
    print(h)

# Search for a keyword
results = manager.search_by_keyword("nowruz", year=1403)
print(results)

# Check if a specific date is a holiday
import jdatetime
date_to_check = jdatetime.date(1403, 1, 1)
if manager.is_holiday(date_to_check):
    print(f"{date_to_check} is a holiday!")

# Calculate working days
wd_count = manager.count_working_days("1403-01-01", "1403-01-10")
print(f"Working days: {wd_count}")

Author

Amir-X

Requirements

jdatetime>=4.1.0
hijri-converter>=2.2.0