# Ekadashi Python Module

A lightweight Python module to calculate **Vaishnava Ekadashi** dates using astronomical calculations.

Ekadashi is a sacred fasting day observed on the **eleventh lunar day (Ekadashi Tithi)** of each fortnight in the Hindu lunar calendar.
This module determines Ekadashi using **Sun–Moon angular calculations and traditional Vaishnava observance rules**.

## Installation

Install the module from PyPI:

```bash id="mpd3nt"
pip install ekadashi
```

## Usage

Once installed, you can simply import the module in Python:

```python id="zpqy2f"
import ekadashi

# Check if today is Ekadashi
print(ekadashi.is_ekadashi("2026-03-29"))

# Find the next upcoming Ekadashi
print(ekadashi.next_ekadashi())

# Get all Ekadashi dates for a given year
print(ekadashi.get_ekadashi_dates(2026))
```

Example output:

```
{
 "date": "2026-03-29",
 "paksha": "Shukla",
 "days_until": 14
}
```

## Features

* Accurate Ekadashi detection using **astronomical tithi calculations**
* Implements **Vaishnava Ekadashi observance rules**
* Handles **Dashami purity and Arunodaya conditions**
* Check if a specific date is Ekadashi
* Find the next upcoming Ekadashi
* Retrieve all Ekadashi dates for a given year
* Lightweight and easy to integrate into applications

## Example

```python id="g3rj0m"
import ekadashi

dates = ekadashi.get_ekadashi_dates(2026)

for d in dates:
    print(d)
```

## Use Cases

This module can be used for:

* Hindu calendar applications
* Panchang software
* Devotional reminder apps
* Astronomy-based calendar calculations
* Educational or research tools

## Author

Developed and maintained by **Hari Prajwal** ❤️
