Metadata-Version: 2.4
Name: x-holidays
Version: 1.0.0
Summary: A comprehensive library for Persian and international holidays.
Home-page: https://github.com/VY1-pick/X-Holidays
Author: Amir-X
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: jdatetime>=4.1.0
Requires-Dist: hijri-converter>=2.2.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 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/<br>
├── LICENSE<br>
├── MANIFEST.in<br>
├── README.md<br>
├── requirements.txt<br>
├── setup.py<br>
├── test_app.py<br>
└── x\_holidays/<br>
---->├── **init**.py<br>
---->├── utils.py <br>
---->├── seasons.py<br>
---->├── global\_events.py<br>
---->├── birthdays.py<br>
---->└── islamic.py

## Installation

```bash

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

```

* Or:

```bash

pip install X-Holidays

```

* Or clone and install locally:

```bash

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

cd X-Holidays

pip install -e .

```

## Usage

```bash
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<br>
hijri-converter>=2.2.0

---
