, our weekly sponsor, makes communication and collaboration APIs that power apps all over the world, supported by easy to integrate SDKs for web, mobile, as well as most popular backend stacks. Pusher Get started. Realtime chat is virtually any online communication that provides a realtime or live transmission of text messages from sender to receiver. This tutorial will show you how to build a terminal chat using and Pusher Channels. realtime Python It’s lightweight to use the terminal for our chat, as there is no opening of the browser, loading of JS libraries or any frontend code. Also, it allows us to quickly test our ideas without worrying about what the user interface would look like. Python in this tutorial refers to Python 3.x Prerequisites A basic understanding of Python is needed to follow this tutorial. You also need to have Python 3 and pip installed and configured on your machine. Set up an app on Pusher is a hosted service that makes it super-easy to add realtime data and functionality to web and mobile applications. Pusher Pusher acts as a realtime layer between your servers and clients. Pusher maintains persistent connections to the clients — over Web-socket if possible and falling back to HTTP-based connectivity — so that as soon as your servers have new data they want to push to the clients they can do, via Pusher. If you do not already have one, head over to Pusher and create a free account. We will register a new app on the dashboard. The only compulsory options are the app name and cluster. A cluster represents the physical location of the Pusher server that will handle your app’s requests. Also, copy out your App ID, Key, and Secret from the App Keys section, as we will need them later on. Creating our application Initial steps First, we need to install a package called . Virtualenv helps to manage environments in Python. This is so we do not end up with conflicting libraries due to install operations from project to project. To install Virtualenv, we run: virtualenv For Windows users, open Powershell as admin, and run: Once the install is completed, we can verify by running: Next, let us create a new environment with Virtualenv: Once the environment is done creating, we move into the new directory created and we activate the environment: For Windows users, you can activate by running: We need to install libraries, which we will use during this project. To install them, run: What are these packages we have installed? And what do they do? I’ll explain. : ANSII Color formatting for output in the terminal. This package will format the color of the output to the terminal. Note that the colors won't display in Powershell or Windows Command Prompt. termcolor : the official Python library for interacting with the Pusher HTTP API. pusher : Python module for handling pusher WebSockets. This will handle event subscriptions using Pusher pysher : Python module that reads the key, value pair from file and adds them to the environment variable. python-dotenv .env Creating the entry point Let us create a new file which will hold our environment variables, which will be used in connecting to Pusher. Create a new file called and add your pusher app id, key, secret and cluster respectively: .env .env Next, create a file called and add: terminalChat.py What is going on in the code above? We import the colored module which will give colors to our console output and the module to load environment variables from our file. We then called the function. load_env .env load_env The class is then defined, with some properties: terminalChat : this property will hold the Pusher server instance once it is available. pusher : this property will hold the Pusher instance of the channel subscribed to. channel : this property will hold the name of the channel the user wants to chat in. chatroom : this property will hold the Pusher client instance once it is available. clientPusher : this property will hold the details of the currently logged in user. user : this property holds a static list of users who can log in, with their values as the password. In a real-world application, this would usually be gotten from some database users : this property holds a list of all available chat-rooms one can join. chatrooms Understanding the defined functions We have four functions defined, which I will explain how they work respectively: : this is the entry point into our application. Here, we call the function to log in, and the function to select a chat room. After this, we have a while loop that calls the function. This while loop means the function will always be running. This is to enable us always have an input to type in new messages to the terminal. main getInput getInput : the login function is as simple as the name implies. It is used to manage login into the app. In the function, we ask for both the username and password of the user. Next, we check if the username exists in our user’s dictionary. Also, we check if the password correlates with the user’s password. If all is well, we assign the user variable to the value of the user input. login Note: for the sake of this tutorial, we have a pre-defined dictionary of users. In your application, you may need to verify that the user exists in your database. : as the name implies, this function enables the user to select a chat-room. First, it informs the user of the available chat-rooms, before proceeding to ask us to select a chat-room. Once a valid chat-room has been selected, we assign the chat-room variable to the selected room, and we call a method called (which we will create soon), which initializes and sets up Pusher to send and receive messages. selectChatroom initPusher : this function is simple. It shows an input with the logged in user’s name in front, waiting for the user to enter a message and send. For now, it does nothing to the message, we will revisit this function once Pusher has been set up correctly. getInput Connecting the Pusher server and client to our app If we remember, in the previous section above, we discussed the method which initializes and sets up Pusher to send and receive messages. Here is where we implement that function. First, we need to add the following imports to the top of our file: initPusher Next, let’s go ahead and defined and some other functions within our terminalChat class: initPusher In the init function, we initialize a new Pusher instance to the variable, passing in our , , and respectively. Next, we initialize a new client for Pusher, passing in our . We then bind to the connection, the event, and pass the function as it’s callback. The reason we do this is to ensure that the client has been connected before we try to subscribe to a channel. After this is done, we call on the . pusher APP_ID APP_KEY APP_SECRET APP_CLUSTER Pysher APP_KEY pusher:connection_established connectHandler connect clientPusher You might have been wondering why we are using Pysher as the client library for Pusher here. It is because the default Pusher library only allows for triggering of events and not subscribing to them. Pysher is a community library which allows us to subscribe for events using Python on the server. In the function, we receive an argument called . This comprises connection data that comes from the established connection between the Pusher WebSockets. We subscribe to the channel, which has been chosen with Pusher, then bind to an event called , passing in the function as it’s callback. connectHandler data newmessage pusherCallback In the method, we receive an argument called , which returns the object of the new message received from Pusher. Here, we convert the message to a readable JSON format for Python, then check if the message isn't for the currently logged in user before printing the message to the screen alongside the sender’s name. We also print the logged in user’s name to the screen, with a colon in its front, so the user knows he can still type. pusherCallback message Updating the getInput function Let’s update our function, so we can trigger the message to Pusher once it is received: getInput Here, after receiving the message, we trigger a event to the current chat-room, passing the current user and the message sent. newmesage Bringing it all together as one piece Here is what our looks like: terminalChat.py Here is what our chat looks like if we run : python terminalChat.py Conclusion We’ve seen how straightforward it is to add realtime chats to our terminal, thanks to Pusher Channels. Our demo app is a simple example. The same functionality could be used in many real world scenarios. You can check out the source code of the completed application on , and dive deeper into Pusher services . GitHub here , our weekly sponsor, makes communication and collaboration APIs that power apps all over the world, supported by easy to integrate SDKs for web, mobile, as well as most popular backend stacks. Pusher Get started.
