No project description provided
Project description
VK is library that allows to create chatbots for vk easy and fast
Quickstart
Easiest hi-bot
from VK import Bot
bot = Bot(api_token)
@bot.command('hi')
def greet(message):
return 'Hi'
bot.start()
Documentation
Bot
- main class
Parameters
access_token
- string to access apibot_admin
- id of user, that will gain maximum access for bot`s commandssession
-GroupSession
object to access api (will be created automatically if not passed)event_server
-CallBackServer
orLongPollServer
that will pass events to bot (LongPollServer will bew created automatically)log_file
- name of log_file (will bew created at /log directory)log_level
Commands
Bot.command()
- decorator for the functions that will be converted to a Command
object
Parameters
name
- the main name of command (by default the name of function)aliases
- the alternative names of commandaccess_level
- the minimum access level of access to run commandmessage_if_deny
- string, that will be replied to message, if access_level less thenaccess_level
use_doc
- weather or not use the documentation of function in auto-generated documentation
Commands can be declared both synchronous and asynchronous
bot.command()
def hi():
return 'Hi!'
bot.command()
async def bye():
return 'Bye-bye!'
You can add message
argument to the command-function to gain access to the message, that called the command
bot.command()
def hi(message):
return f'Hi, {message.sender}!'
Framework will automatically use the returned string as text of message to reply and ignore all other returned objects (including None)
AccessLevel
There are 3 access levels now
- USER - every user in conversations
- ADMIN - admins of conversation and any user in private chat with bot
- BOT_ADMIN - user, that was declared as
bot_admin
Regex (Experimental)
You can write functions, that will be automatically called if message matches given pattern
bot.regex('.*hi.*')
async def regex_hi(message):
await message.reply('Your message contains hi')
Message
Some description
Fields
date
- time.struct_time - sending time of messagetext
strchat
- Chat object, where message was sendsender
- User object, who send the message
Chat
User
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.