Metadata-Version: 2.4
Name: geezdate
Version: 0.1.3
Summary: A package for Ethiopian (Geez) date calculations and conversions.
Author-email: Kidus <kidus.meab@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/kidusdev/geezdate
Project-URL: Repository, https://github.com/kidusdev/geezdate
Project-URL: Issues, https://github.com/kidusdev/geezdate/issues
Keywords: ethiopian,geez,calendar,date,conversion
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# GeezDate

A Python package for calculating and converting dates between the Ethiopian (Geez) and Gregorian calendars.

## Features

- Convert dates between Ethiopian (Geez) and Gregorian calendars.
- Format Ethiopian dates in Amharic, Tigrigna, or English.
- Simple, intuitive API for developers.
- Utility functions for date formatting and localization.

## Installation

```bash
pip install geezdate
```

> **Requirements**: Python 3.11 or later.

## Usage

Basic usage with conversion and formatting:

```python
from geezdate import GeezDate, FormatType
import datetime

# Convert Gregorian to Ethiopian (Geez)
gregorian = datetime.date(2024, 5, 1)
geez = GeezDate.from_date(gregorian)
print(f"Gregorian: {gregorian} → Geez: {geez}")  # Example: Gregorian: 2024-05-01 → Geez: 2016-08-23

# Convert Geez back to Gregorian
print(f"Geez: {geez} → Gregorian: {geez.to_date}")

# Format the Geez date in different languages
print(geez.format('.d/.m/.y', FormatType.Amharic))   # 23/08/2016 (Amharic)
print(geez.format('.D .M .Y', FormatType.Tigrigna))  # ረቡዕ ግንቦት 2016 (Tigrigna)
print(geez.format('.D, .M .y (.E)', FormatType.English))  # WEDNESDAY, MAY 16 (GC)
```

## Project Structure

```
geezdate/
│
├── src/
│   ├── __init__.py
│   ├── geezdate.py
│   ├── format.py
│   └── demo.py
├── test/
│   └── main.py
└── pyproject.toml
```

## Development

Run the test/demo script:

```bash
python test/main.py
```

Or to run the simple demo:

```bash
python -m src
```

## License

This project is licensed under the [MIT License](LICENSE).

## Contact

- **Author:** Kidus
- **Email:** kidus.meab@gmail.com
- **GitHub:** [kidusdev/geezdate](https://github.com/kidusdev/geezdate)

## Issues

Found a bug or have a feature request? [Open an issue](https://github.com/kidusdev/geezdate/issues).
