Metadata-Version: 2.4
Name: iraqtel
Version: 0.1.0
Summary: Unofficial Python SDK for Iraqi telecom companies and e-wallets
Author-email: yassindev <developeryassin01@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/alexiq01/iraqtel
Project-URL: Repository, https://github.com/alexiq01/iraqtel
Project-URL: Issues, https://github.com/alexiq01/iraqtel
Keywords: iraq,asiacell,zain,korek,zaincash,fastpay,telecom,api,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: cryptography>=41.0.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: build; extra == "dev"
Provides-Extra: async
Requires-Dist: aiohttp>=3.8.0; extra == "async"
Dynamic: license-file

# iraqtel 🇮🇶

[![PyPI version](https://badge.fury.io/py/iraqtel.svg)](https://badge.fury.io/py/iraqtel)
[![Python Versions](https://img.shields.io/pypi/pyversions/iraqtel.svg)](https://pypi.org/project/iraqtel/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Unofficial Python SDK for Iraqi telecom companies and e-wallets.
مكتبة بايثون غير رسمية للتعامل مع شركات الاتصالات والمحافظ الإلكترونية العراقية.

## Supported Operators & Wallets
- **Asiacell** (077/078)
- **Zain Iraq** (077/079)
- **Korek Telecom** (075)
- **ZainCash** (E-Wallet)
- **FastPay** (E-Wallet)

## Installation
```bash
pip install iraqtel
```

## Quick Start

### Asiacell
```python
from iraqtel import AsiacellClient

client = AsiacellClient(phone="077XXXXXXXX", password="your_password")
client.login()
balance = client.get_balance()
print(f"Credit: {balance['credit']} IQD")
```

### ZainCash
```python
from iraqtel import ZainCashClient

wallet = ZainCashClient(phone="078XXXXXXXX", password="your_password", pin="1234")
wallet.login()
wallet.transfer(to_phone="077XXXXXXXX", amount=10000, note="Gift")
```

## Disclaimer
This project is **UNOFFICIAL** and not affiliated with any of the mentioned companies. Use it at your own risk. The developers are not responsible for any misuse or damage.
هذا المشروع غير رسمي وغير تابع لأي من الشركات المذكورة. استخدمه على مسؤوليتك الخاصة.

## Contributing
Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License
MIT
