Metadata-Version: 1.1
Name: permabots
Version: 2.2.3
Summary: Connect chats bots to your API apps
Home-page: https://github.com/jlmadurga/permabots
Author: Juan Madurga
Author-email: jlmadurga@gmail.com
License: BSD
Description: =============================
        Permabots
        =============================
        
        .. image:: https://github.com/jlmadurga/permabots/raw/master/docs/images/logos/permabots.png
            :target: http://www.permabots.com
        
        
        CI:
        
        .. image:: https://travis-ci.org/jlmadurga/permabots.svg?branch=master
            :target: https://travis-ci.org/jlmadurga/permabots
        
        .. image:: https://coveralls.io/repos/github/jlmadurga/permabots/badge.svg?branch=master 
        	:target: https://coveralls.io/github/jlmadurga/permabots?branch=master
          
        .. image:: https://requires.io/github/jlmadurga/permabots/requirements.svg?branch=master
             :target: https://requires.io/github/jlmadurga/permabots/requirements/?branch=master
             :alt: Requirements Status
             
        PyPI:
        
        
        .. image:: https://img.shields.io/pypi/v/permabots.svg
                :target: https://pypi.python.org/pypi/permabots
        
        Docs:
        
        .. image:: https://readthedocs.org/projects/permabots/badge/?version=latest
                :target: https://readthedocs.org/projects/permabots/?badge=latest
                :alt: Documentation Status
        
        
        Build chat bots and connect then to your app APIs. 
        
        With Permabots you can build chat bots and with the same configuration use it for several instant messaging providers. Permabots
        was born to be a microservice to connect messaging providers to your apps using REST APIs.
        
        .. image:: https://github.com/jlmadurga/permabots/raw/master/docs/images/demo.gif
            :target: http://www.permabots.com
        
        
        Documentation
        -------------
        
        The full documentation is at https://permabots.readthedocs.org.
        
        
        Features
        --------
        
        * Telegram, Kik and Facebook Messenger bots
        * Message handling definition with regex, as django urls.
        * HTTP methods: GET/POST/PUT/DELETE/PATCH
        * Text responses and keyboards with Jinja2 templates
        * Chat State handling
        * Asynchronous processing of messages
        * Media messages not supported
        
        Quickstart
        ----------
        
        
        Install permabots::
        
            pip install permabots
            
        Add ``permabots`` to your ``INSTALLED_APPS``, and run::
        
        	$ python manage.py migrate permabots
        	
        Instant messaging providers uses webhooks to send messages to your bots. Add permabots processing urls to your urlpatterns::
        
        	url(r'^processing/', include('permabots.urls_processing', namespace="permabots"))
        	
        Webhooks are generated with ``django.contrib.sites``. You need it installed and ``SITE_ID`` configured. If you want to generate webhook manually you can do it::
        
        	MICROBOT_WEBHOOK_DOMAIN = 'https://yourdomain.herokuapp.com' 
        
        It is usefull when you don't have ``https`` in your public domain but you have it in your autogenerated domain. i.e. heroku.
        	
        Bots are associated to Django Users. You need at least one user, for example admin user.
        
        Then you can create all permabots data, Bots, Conversation Handlers, Notitication Hooks,... via Django admin or with REST API (recommended).
        
        Remember there is an online implementation in www.permabots.com to use it for free.		
        
        Demo
        --------------
        
        You can check and deploy a Permabots demo https://github.com/jlmadurga/permabots-demo
        
        .. image:: https://www.herokucdn.com/deploy/button.svg
            :target: https://heroku.com/deploy?template=https://github.com/jlmadurga/permabots-demo/tree/master
        
        Running Tests
        --------------
        
        Does the code actually work?
        
        ::
        
            source <YOURVIRTUALENV>/bin/activate
            (myenv) $ pip install -r requirements/test.txt
            (myenv) $ make test
            (myenv) $ make test-all
        
        
        
        
        
        
        History
        -------
        
        0.1.0 (2016-05-16)
        ++++++++++++++++++
        
        * First release on PyPI.
        
Keywords: permabots
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
