Metadata-Version: 2.4
Name: vplus
Version: 1.0.0
Summary: کتابخانه رسمی سروش پلاس
Home-page: https://github.com/yourusername/vplus
Author: Vplus Team
Author-email: your@email.com
Project-URL: Documentation, https://github.com/yourusername/vplus
Project-URL: Source, https://github.com/yourusername/vplus
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.8.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Vplus

کتابخانه رسمی و فوق‌سریع سروش‌پلاس برای پایتون

[![PyPI version](https://img.shields.io/pypi/v/vplus.svg)](https://pypi.org/project/vplus/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

---

## 📖 درباره

**Vplus** یک کتابخانه کامل و قدرتمند برای ارتباط با API سروش‌پلاس است. با این کتابخانه می‌توانید به سادگی بات‌های حرفه‌ای برای پیام‌رسان سروش‌پلاس بسازید.

> direct splus > @Berlmevandi

### ویژگی‌ها

- ✅ پشتیبانی از **همه متدهای API** رسمی سروش‌پلاس
- ✅ **دکوریتورهای ساده** برای ثبت هندلرها
- ✅ **فیلترهای پیش‌ساخته** (private, group, text, photo, video, sticker, ...)
- ✅ **مدیریت خودکار offset** (ذخیره در فایل، بدون پیام تکراری)
- ✅ **پشتیبانی کامل از asyncio**
- ✅ **Type hints** برای تجربه بهتر در IDE
- ✅ **مدیریت خطا** و **لاگینگ** داخلی
- ✅ **Lightweight** با فقط یک وابستگی (aiohttp)

---

## 🚀 نصب

```bash
pip install vplus
