nagendra-y / dummypy

Mesibo Python API

This repo contains the source code for Mesibo Real-Time Python API .

Mesibo offers everything to make your app real-time and scalable for your first billion users and the next. It's modular, lightweight and easy to integrate.

Mesibo supports almost all popular platforms and languages for you to quickly build your applications. Whether you are developing mobile apps (Android, iOS, Java, Objective-C, C++), web apps (Javascript), integrating with backend (Linux, MacOS, Windows, Python, C++) or creating cool devices using Raspberry Pi, mesibo has APIs for you.

Mesibo's high performance C++ and Python libraries enable you to interface your chat clients with various scientific computing and machine learning systems on your backend like TensorFlow, Matlab, Octave, NumPy etc to create a powerful chat experience.

• Website: https://mesibo.com
• Documentation: https://mesibo.com/documentation/

Prerequisites

Building Mesibo Python module requires the following software installed:

1. Mesibo C/C++ library

Install the shared library (On Linux based systems). For detailed instructions refer. Mesibo Python Module is a C extension module for mesibo C/C++ library

curl -fsSL https://raw.githubusercontent.com/mesibo/libmesibo/master/install.sh | sudo bash -
  

2. Python 3 (3.4.x or newer preferred) / Python 2 (2.7.x or newer preferred)

On CentOS,Debian and derivatives (Ubuntu): python, python-dev (or python3-dev/python2-dev)

Make sure that the Python package distutils is installed before continuing. For example, in Debian GNU/Linux, installing python-dev also installs distutils.

Debian/Ubuntu

apt-get install libffi-dev python-dev python3-dev

Centos/RHEL/Fedora

yum install libffi-devel python3-devel python-devel

3. Compiler

C/C++ compiler.GCC 4.x (and later)are recommended.

|-- include
|-- setup.py
|-- src
|-- tests

Basic Installation

To install the pre-release via pip

pip install --upgrade mesibo

To build and install mesibo python module

sudo python setup.py install

To perform an in-place build that can be run from the source folder run:

python setup.py build_ext --inplace

API Usage

from mesibo import Mesibo
from mesiboNotify.mesiboNotify import mesiboNotify

#Mesibo invokes various Listeners for various events.
#For example, when you receive a message, receive an incoming call etc
#mesiboNotify is a class of listeners that can be invoked to get real-time notification of events  


class test_mesiboNotify(mesiboNotify):

    def __init__(self):
        pass

    def on_status(self, status, sub_status, channel, p_from):
        print("===>on_status: " + str(status) + " substatus: " +
              str(sub_status) + " channel:" + str(channel) + "from: " + str(p_from))
        
        if(int(status) == 1 ): #Connection is setup and you are online
            pymesibo = Mesibo() #Instantiate Mesibo(Singleton already initialised)
            msg_params = {"id":pymesibo.random()}
            to = "91xxxxxxxxxx" #Destination user ID
            data = "Hello from mesibo"
            datalen = len(data)
            pymesibo.send_message(msg_params,to,data,datalen)


        return 1
        

    def on_message(self, message_params_dict, p_from, data, p_len):
        #invoked on receiving a new message or reading database messages 
        print("===>on_message: from " + str(p_from) + " of len " + str(p_len))
        print(data[:p_len])  # data buffer/Python bytes object
        print(str(data[:p_len], encoding='utf-8', errors='strict'))

        print("with message parmeters:")
        print(message_params_dict)

        return 1

    def on_messagestatus(self,  message_params_dict, p_from, last):
        #Invoked when the status of outgoing or sent message is changed
        print("===>on_messagestatus: from " +
              str(p_from) + " " + str(last))
        print("with message_parameters")
        print(message_params_dict)
        return 1


pymesibo = Mesibo() #Instantiate Mesibo
#Initialisation code
#get your accesstoken for the appname you registered from https://mesibo.com/console
pymesibo.set_accesstoken("your_access_token")
pymesibo.set_database("mesibo.db")
pymesibo.set_notify(test_mesiboNotify)
pymesibo.set_device(1, "your_device_id", "your_app_name", "1.0.0")
pymesibo.start()
pymesibo.wait()

For documentation and tutorials refer

Let's get Real-Time!

This is a simple tutorial for sending/recieving a text-message using mesibo python API. Before you begin please go through Get Started guide. Refer Write your First mesibo Enabled Application

1. Create your application

Create a new application from the Mesibo console Once your application is created, note down the App token. The App Token looks like following:

**cn9cvk6gnm15e7lrjb2k7ggggax5h90n5x7dp4sam6kwitl2hmg4cmwabet4zgdw**

Create Users (Endpoints)

Create users from the console by clicking on ‘New User’ button from the Application settings page. Note the user Address

2. Import mesibo API and initialise it

Import Mesibo Python Module and Notify/Listener Module

from mesibo import Mesibo
from mesiboNotify.mesiboNotify import mesiboNotify

Mesibo invokes various Listeners for various events. For example, when you receive a message, receive an incoming call,etc. mesiboNotify is a class of listeners that can be invoked to get real-time notification of events

class test_mesiboNotify(mesiboNotify):

    def __init__(self):
        pass

    def on_status(self, status, sub_status, channel, p_from):
        #You will receive the connection status here
        print("===>on_status: " + str(status) + " substatus: " +
              str(sub_status) + " channel:" + str(channel) + "from: " + str(p_from))
        
        return 1
        

    def on_message(self, message_params_dict, p_from, data, p_len):
        #invoked on receiving a new message or reading database messages
        #You will receive messages here.
        print("===>on_message: from " + str(p_from) + " of len " + str(p_len))
        print(data[:p_len])  # data buffer/Python bytes object
        print(str(data[:p_len], encoding='utf-8', errors='strict'))

        print("with message parmeters:")
        print(message_params_dict)

        return 1

    def on_messagestatus(self,  message_params_dict, p_from, last):
        #Invoked when the status of outgoing or sent message is changed
        #You will receive status of sent messages here
        print("===>on_messagestatus: from " +
              str(p_from) + " " + str(last))
        print("with message_parameters")
        print(message_params_dict)
        return 1

Initialization code :

pymesibo = Mesibo()
#set user authentication token obtained by creating user
pymesibo.set_accesstoken("cn9cvk6gnm15e7lrjb2k7ggggax5h90n5x7dp4sam6kwitl2hmg4cmwabet4zgdw") 
pymesibo.set_database("mesibo.db")
pymesibo.set_notify(test_mesiboNotify) #your custom listener class
pymesibo.set_device(1, "MyUser", "MyAppName", "1.0.0") 
pymesibo.start()
pymesibo.wait() 

3. Sending Messages

To send messages,you can use send_message real-time API for which you will need destination user, message id and message itself.

Invoke the following function from your code to send a text message

def send_text_message(to,message):
        pymesibo = Mesibo() #Instantiate Mesibo(Singleton already initialised)
        msg_params = {"id":pymesibo.random()}
        data = str(message)
        datalen = len(data)
        pymesibo.send_message(msg_params,to,data,datalen)

For example,Call this function from on_status to send a message when you are online.

    def on_status(self, status, sub_status, channel, p_from):
        print("===>on_status: " + str(status) + " substatus: " +
              str(sub_status) + " channel:" + str(channel) + "from: " + str(p_from))
        
        if(int(status) == 1 ): #Connection is setup and you are online
            #The destination address can even be a phone number like "91xxxxxxxxxx"
            send_text_message("TestUsr","Hello World! Mesibo is online"):

        return 1