# Ethiopian Calendar Converter 🇪🇹
A modern, lightweight PHP library for seamless conversion between
Ethiopian and Gregorian calendars. Ideal for applications serving
Ethiopian users, historical calculations, and multicultural systems.
------------------------------------------------------------------------
## ✨ Features
- 🔄 **Bidirectional Conversion** --- Ethiopian ↔ Gregorian\
- 📅 **Real-time Date Handling** --- Get current dates in both
calendars\
- ✅ **Robust Validation** --- Clear error messages for invalid dates\
- 🎯 **Leap Year Support** --- Accurate handling of Pagume 5/6 days\
- 🚀 **High Performance** --- Zero dependencies, optimized
calculations\
- 💪 **Type Safe** --- PHP 8.0+ with strict type declarations\
- 🧪 **Fully Tested** --- PHPUnit test coverage included\
- 🌍 **English Month Names** --- Avoid encoding issues
------------------------------------------------------------------------
## 📦 Installation
``` bash
composer require eliasdebelo/ethiopian-calendar
```
------------------------------------------------------------------------
## 🚀 Quick Start
``` php
\*Pagume has 5 days in common years, 6 days in leap years.
------------------------------------------------------------------------
## 🧪 Running Tests
``` bash
composer install
vendor/bin/phpunit --testdox
vendor/bin/phpunit --coverage-html coverage
```
------------------------------------------------------------------------
## 🔧 Requirements
- PHP 8.0+\
- Composer
------------------------------------------------------------------------
## 📄 License
MIT License --- Open source.
------------------------------------------------------------------------
## 🤝 Contributing
1. Fork the repo\
2. Create a branch (`git checkout -b feature/awesome`)\
3. Commit changes (`git commit -m "Add feature"`)\
4. Push (`git push origin feature/awesome`)\
5. Open a Pull Request
------------------------------------------------------------------------
## 🐛 Issues & Supp …