Metadata-Version: 2.1
Name: vkwave
Version: 0.2.7
Summary: Framework for building high-performance & easy to scale projects interacting with VK's API.
Home-page: https://github.com/fscdev/vkwave
License: MIT
Keywords: vk,vkontakte,api,framework,wrapper,asyncio,bots
Author: prostomarkeloff
Requires-Python: >=3.7,<4.0
Classifier: Environment :: Console
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Typing :: Typed
Provides-Extra: all
Provides-Extra: storage-redis
Requires-Dist: aiohttp (>=3.6,<4.0)
Requires-Dist: aioredis (>=1.3,<2.0); extra == "storage-redis" or extra == "all"
Requires-Dist: pydantic (>=1.4,<2.0)
Requires-Dist: typing_extensions (>=3.7.4,<4.0.0)
Project-URL: Bug Tracker, https://github.com/fscdev/vkwave/issues
Project-URL: Repository, https://github.com/fscdev/vkwave
Description-Content-Type: text/markdown

![vkwave](https://user-images.githubusercontent.com/28061158/75329873-7f738200-5891-11ea-9565-fd117ea4fc9e.jpg)

> Пришло время избавиться от vk_api и vkbottle. VKWave здесь.

[Почему VKWave?](./why_vkwave.md)

```python
from vkwave.bots import SimpleLongPollBot

bot = SimpleLongPollBot(tokens="MyToken", group_id=123456789)

@bot.message_handler()
def handle(_) -> str:
    return "Hello world!"

bot.run_forever()

```

# Что это?

VKWave - это фреймворк для создания производительных и лёгких в расширении проектов, взаимодействующих с API ВКонтакте.

Он создан с использованием asyncio и аннотаций типов Python. Минимальная требуемая версия - это `3.7`.

Наш телеграм чат - [давайте общаться!](https://t.me/vkwave)

Текущий мейнтейнер этого проекта [@kesha1225](https://github.com/kesha1225)

## Установка

Установить тестированную и стабильную версию с PyPi:

```
pip install vkwave
```

Или с GitHub, со всеми свежими обновлениями.
```
pip install https://github.com/fscdev/vkwave/archive/master.zip
```


## Производительность

VKWave - это не самая быстрая библиотека, из-за нашей уверенности в том, что лёгкая настройка под себя, а также удобность при использовании во всех задач явлюятся более важными характеристиками библиотеки, чем скорость.

Но мы всегда заинтересованы в улучшении производительности, поэтому не стесняйтесь делать Pull Request-ы и обсуждать проблемы производительности.

## Сообщество

VKWave - это очень молодой проект.

### Чаты

Как упоминалось ранее, у нас есть [чат в Telegram](https://t.me/vkwave).

Во Вконтакте чата нет, но вы всегда можете создать свой собственный и получить его упоминание здесь.

### Дополнения

Если вы хотите создать дополнение для VKWave (например, более простой способ написания ботов, даже проще `vkwave.bots.addons.easy`), то вам следует назвать свой проект так: `vkwave-bots-really-easy`.

Общий паттерн для дополнений: `vkwave-<часть-vkwave>-<название-проекта>`.


