botovod

Description

This is a simple and easy-to-use library for interacting with the Instagram. The library works through the web interface of the Instagram and does not depend on the official API

Contents

=================

• Release Notes
  • 0.1.4
  • 0.1.5
  • 0.1.6
  • 0.1.7
  • 0.1.8
• Getting Started
  • Installation from Pip
  • Installation from GitHub
  • Quick Start
• User Guide
  • What is Botovod
  • What is Agent
• Handlers
• Examples
• Help the author
  • Contribute repo
  • Donate

Release Notes

Version 0.1.4

• Add new dbdriver - Gino
• Fix bugs

Version 0.1.5

• Add new methods for telegram Agent
• Add emoji

Version 0.1.6

• Fix gino getting follower
• Adding item assignments for Botovod objects

Version 0.1.7

• Add new features for telegram agent
• Add start_dialog and start_async_dialog functions
• Fix gino driver bugs

Version 0.1.8

• Fix utils handlers
• Add new methods for telegram
• Optimize interaction with DB

Version 0.1.9

• Change Botovod API
• Fix telegram agent
• Remove old info from README.md

Getting Started

Installation from Pip

For installation botovod library from pip you should have pip with python (prefer python3.6 or later)

pip install botovod

Installation from GitHub

To basic installation from GitHub repository you should have git, python3 (prefer python3.6 or later), pip (optionally) in your system

git clone https://github.com/OlegYurchik/botovod.git
cd botovod
pip install .

or

git clone https://github.com/OlegYurchik/botovod.git
cd botovod
python setup.py install

Quick Start

After installation, you can use the library in your code. Below is a sneak example of using the library

from botovod import Botovod
from botovod.agents import TelegramAgent


def echo(agent, chat, messsage, follower=None):
    agent.send_message(chat, text=message.text)


botovod = Botovod()
botovod.add_handler(echo)

telegram_agent = TelegramAgent(token="your-telegram-token", method="polling)
botovod.add_agent("telegram", telegram_agent)

botovod.start()

This code setup and run Telegram echo-bot by polling

from botovod import Botovod
from botovod.agents import TelegramAgent
from botovod.dbdrivers.sqlalchemy import DBDriver
from botovod.dialogs import Dialog


class RegisterDialog(Dialog):
    def start(self):
        self.reply(text="Hello, my friend!")
        self.reply(text="What is your name?")
        self.set_next_step(self.what_name)

    def what_name(self):
        name = self.message.text
        self.follower.set_value("name", name)
        self.reply(text="Nice to meet you, %s. What would you want?" % name)
        self.set_next_step(self.menu)

    def menu(self):
        pass
        # your code


dbdriver = DBDriver()
dbdriver.connect(engine="sqlite", database="file.db")
botovod = Botovod(dbdriver)

botovod.add_handler(RegisterDialog)

telegram_agent = TelegramAgent(token="your-telegram-token")
botovod.add_agent("telegram", telegram_agent)

botovod.start()

This code setup and run telegram code which working with database and followers