Metadata-Version: 2.1
Name: pishropayamak-sms
Version: 1.0.0
Summary: پکیج رسمی ارسال پیامک پیشرو پیامک برای پایتون
Home-page: https://github.com/MohammadrezaRahpeyma/pishropayamak-python-sms
Author: پیشرو پیامک
Author-email: info@pishropayamak.com
Project-URL: Bug Reports, https://github.com/MohammadrezaRahpeyma/pishropayamak-python-sms/issues
Project-URL: Source, https://github.com/MohammadrezaRahpeyma/pishropayamak-python-sms
Project-URL: Documentation, https://github.com/MohammadrezaRahpeyma/pishropayamak-python-sms#readme
Keywords: sms,pishropayamak,پیشرو پیامک,python,sms-gateway,otp,verification
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Communications :: Telephony
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests >=2.28.0

# 📱 پکیج رسمی پیشرو پیامک برای پایتون

پکیج رسمی **پیشرو پیامک** برای ارسال آسان پیامک در پروژه‌های پایتون.

## ✨ ویژگی‌ها

- ارسال پیامک با احراز هویت توکن
- ارسال گروهی به چندین گیرنده
- پشتیبانی از پیامک معمولی و فلش
- دریافت کد پیگیری
- مدیریت خطاهای حرفه‌ای
- تست شده و قابل اطمینان

## 📦 نصب

```bash
pip install pishropayamak-sms

🚀 استفاده
روش اول: استفاده از کلاس اصلی
python

from pishropayamak_sms import SmsService

sms_service = SmsService('your_token_here')

result = sms_service.send_sms(
    from_number='9444xxxxxx',
    recipients=['09121234567'],
    message='سلام! به پیشرو پیامک خوش آمدید.'
)

if result['success']:
    print(f"کد پیگیری: {result['id']}")
else:
    print(f"خطا: {result['error']}")

ارسال گروهی
python

result = sms_service.send_sms(
    from_number='9444xxxxxx',
    recipients=['09121234567', '09129876543', '09123456789'],
    message='تخفیف ویژه تا ۲۴ ساعت دیگر!'
)

ارسال پیام فلش
python

result = sms_service.send_sms(
    from_number='9444xxxxxx',
    recipients=['09121234567'],
    message='پیام فوری!',
    msg_type=1  # نوع فلش
)

📝 پارامترهای متد send_sms
پارامتر	نوع	ضروری	توضیح
from_number	str	بله	شماره فرستنده (خط اختصاصی)
recipients	List[str]	بله	لیست شماره گیرندگان
message	str	بله	متن پیامک
msg_type	int	خیر	0=معمولی، 1=فلش
🔧 مدیریت خطاها
python

from pishropayamak_sms import SmsService
from pishropayamak_sms.exceptions import (
    AuthenticationError,
    NetworkError,
    SendError,
    ValidationError
)

try:
    result = sms_service.send_sms(...)
except ValidationError as e:
    print(f"خطای اعتبارسنجی: {e}")
except AuthenticationError as e:
    print(f"خطای احراز هویت: {e}")
except NetworkError as e:
    print(f"خطای شبکه: {e}")
except SendError as e:
    print(f"خطای ارسال: {e}")

🔒 نکات امنیتی

    توکن را در کد قرار ندهید! از متغیرهای محیطی استفاده کنید.

    همیشه از HTTPS برای ارتباط استفاده کنید.

    توکن را به‌طور دوره‌ای تمدید کنید.

🌐 وب‌سایت رسمی

https://pishropayamak.ir
🔗 مخزن گیت‌هاب

https://github.com/MohammadrezaRahpeyma/pishropayamak-python-sms
📄 مجوز

این پکیج تحت مجوز MIT منتشر شده است.

ساخته شده با ❤️ توسط پیشرو پیامک
