Metadata-Version: 2.1
Name: instachatbot
Version: 0.3
Summary: Simple framework for building Instagram chat bots with menu driven interface
Home-page: https://github.com/art-vasilyev/instachatbot
Author: Artem Vasilyev
Author-email: artem.v.vasilyev@gmail.com
License: MIT
Description: # instachatbot
        
        [![CircleCI](https://circleci.com/gh/art-vasilyev/instachatbot.svg?style=svg)](https://circleci.com/gh/art-vasilyev/instachatbot)
        [![codecov](https://codecov.io/gh/art-vasilyev/instachatbot/branch/master/graph/badge.svg)](https://codecov.io/gh/art-vasilyev/instachatbot)
        
        Simple framework for building Instagram chat bots with menu driven interface
        
        ## Installation
        
        ```
        pip install git+https://github.com/art-vasilyev/instachatbot.git
        ```
        
        ## How to use
        
        Create sample script `main.py`:
        ```python
        from instachatbot.bot import InstagramChatBot
        from instachatbot.nodes import (
            MenuNode, MenuItem, MessageNode, QuestionnaireNode, NotifyAdminNode)
        
        menu = MenuNode(
            '💡Choose menu:\n',
            [
                MenuItem(
                    'text message',
                    MessageNode('This is a message😀')),
                MenuItem(
                    'questionnaire',
                    QuestionnaireNode(
                        [
                            'What is your favourite book? 📚',
                            'What is your favourite fruit? 🍐 🍊 🍋'
                        ],
                        header='Please answer the following questions',
                        admin_username='<user to send results to>',
                        response='Thank your for your answers')),
                MenuItem(
                    'send notification to admin',
                    NotifyAdminNode(
                        'Thank you',
                        notification='Sample notification from bot user',
                        admin_username='<username to send notification to>'
                    )
                ),
            ],
            error_message='Failed to select menu.'
        )
        
        chatbot = InstagramChatBot(menu=menu)
        chatbot.login(
            username='<instagram-username>',
            password='<instagram-password>')
        chatbot.start()
        ```
        
        Run the script:
        ```
        python3.6 main.py
        ```
        
        ## Persistent conversation state
        
        By default conversation state is discarded on bot restart, to make it persistent you should provide persistent storage on bot initialization:
        ```python
        chatbot = InstagramChatBot(menu=menu, storage=FileStorage())
        ```
        
Keywords: chatbot,instagram
Platform: any
Requires-Python: >=3.5
Description-Content-Type: text/markdown
