Python’s socket module is a powerful tool for creating network applications. In this tutorial, you will learn the basics of Python socket programming, including how to create a simple client-server architecture, handle multiple clients using threading, and understand the differences between TCP and UDP sockets. You will learn how to establish connections, send and receive data, and build robust network applications using Python.
To understand Python socket programming, we need to know about three interesting topics - Socket Server, Socket Client, and Socket.
So, what is a server? Well, a server is software that waits for client requests and serves or processes them accordingly.
On the other hand, a client is a requester of this service. A client program requests some resources from the server, and the server responds to that request.
The socket is the endpoint of a bidirectional communications channel between the server and the client. Sockets may communicate within a process, between processes on the same machine, or between processes on different machines. For any communication with a remote program, we have to connect through a socket port. The main objective of this socket programming tutorial is to familiarize you with how socket servers and clients communicate with each other. You will also learn how to write a Python socket server program.
We have said earlier that a socket client requests for some resources to the socket server and the server responds to that request. So we will design both server and client model so that each can communicate with them. The steps can be considered like this.
We will save the Python socket server program as socket_server.py
. To use python socket connection, we need to import socket module. Then, sequentially we need to perform some task to establish connection between server and client. We can obtain host address by using socket.gethostname()
function. It is recommended to user port address above 1024 because port number lesser than 1024 are reserved for standard internet protocol. See the below python socket server example code, the comments will help you to understand the code.
So our python socket server is running on port 5000 and it will wait for client request. If you want the server to not quit when the client connection is closed, just remove the if condition and break
the statement. Python while loop is used to run the server program indefinitely and keep waiting for client request.
We will save python socket client program as socket_client.py
. This program is similar to the server program, except binding. The main difference between server and client program is, in server program, it needs to bind host address and port address together. See the below python socket client example code, the comment will help you to understand the code.
To see the output, first run the socket server program. Then run the socket client program. After that, write something from client program. Then again write reply from server program. At last, write bye from client program to terminate both program. Below short video will show how it worked on my test run of socket server and client example programs.
Notice that socket server is running on port 5000 but client also requires a socket port to connect to the server. This port is assigned randomly by client connect call. In this case, it’s 57822
.
A server can utilize threads to handle multiple clients simultaneously. This approach allows the server to process multiple client connections concurrently, enhancing its responsiveness and ability to handle a large number of clients efficiently.
Here’s an example of how this can be achieved in Python using the threading
module:
In socket programming, sockets can operate in either blocking or non-blocking mode. This mode determines how the socket behaves when it is waiting for data to be received or sent.
Blocking Sockets: In blocking mode, operations like recv()
and accept()
will block the execution of the program until data is available. This means that the program will pause and wait for data to be received or a connection to be accepted. While this approach is simple to implement, it can lead to performance issues and unresponsiveness in applications that need to handle multiple tasks concurrently.
Non-Blocking Sockets: Non-blocking sockets, on the other hand, return immediately if no data is available. This approach prevents the application from freezing or becoming unresponsive due to socket operations. Non-blocking sockets are particularly useful in applications that need to handle multiple connections simultaneously, such as web servers or chat servers. However, they require more complex programming to handle the asynchronous nature of the operations.
Feature | TCP (Transmission Control Protocol) | UDP (User Datagram Protocol) |
---|---|---|
Connection | Connection-oriented | Connectionless |
Reliability | Reliable, ensures data integrity | Unreliable, no guarantee |
Use Cases | Web browsing, file transfer | Video streaming, gaming |
TCP (Transmission Control Protocol) and UDP (User Datagram Protocol) are two fundamental protocols in the internet protocol suite that enable communication over the internet. The key differences between them lie in their approach to establishing connections and ensuring data reliability.
TCP is a connection-oriented protocol, which means a connection is established between the sender and receiver before data is sent. This ensures that data packets are delivered in the correct order and retransmitted if lost or corrupted, ensuring data integrity. TCP is suitable for applications that require guaranteed delivery of data, such as web browsing and file transfer.
On the other hand, UDP is a connectionless protocol, which means there is no dedicated end-to-end connection. Data is sent as a series of packets, and the receiver does not send an acknowledgement. This makes UDP faster but less reliable than TCP. UDP is commonly used for applications that require fast transmission and can tolerate some loss of data, such as video streaming and gaming.
Address Already in Use Error
: This error occurs when a process is already using the port you’re trying to use. To resolve this, you can use the following command to identify the process using the port:
Once you’ve identified the process, you can either stop the process or use a different port for your application.
Connection Refused Error
: This error occurs when the client attempts to connect to a server that is not running or not listening on the specified port. To resolve this, ensure that the server is running and listening on the correct port before the client attempts to connect. Here’s a simple Python code block to check if a server is listening on a specific port:
Here is an example of how to create a Python socket server:
TCP provides reliable communication, whereas UDP is faster but does not guarantee data integrity.
Feature | TCP | UDP |
---|---|---|
Connection | Connection-oriented | Connectionless |
Reliability | Guaranteed delivery | No guarantee of delivery |
Ordering | Ensures correct order | No guarantee of order |
Error-checking | Error-checking and correction | Error-checking but no correction |
Speed | Slower due to error-checking | Faster due to no error-checking |
Use Cases | File transfer, email, web browsing | Online gaming, video streaming, VoIP |
You can use threading to manage multiple clients concurrently. Here’s an example of how you can modify the server code to handle multiple clients using threading:
In this tutorial, you learned the basics of Python socket programming, including how to create a simple client-server architecture, handle multiple clients using threading, and understand the differences between TCP and UDP sockets. To further enhance your knowledge of Python programming, we recommend checking out the following tutorials:
These tutorials will provide you with a deeper understanding of Python and its applications in network programming.
Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.
Great little example, thanks!
- Synapsensalat
Good Job
- amrane
your server code is wrong you have to use different names to send the data data = conn.recv(1024).decode() if not data: # if data is not received break break print("from connected user: " + str(data)) message = input(’ -> ') #use different name at the place of data conn.send(message.encode()) # send data to the client
- Aditya raj
host = socket.gethostname() AttributeError: ‘module’ object has no attribute ‘gethostname’ im getting this error…
- adarsh
how do we chat with different persons should we give client program to them and ask to run. and i would host the server in my pc
- sanjay
File “C:/Users/hp/AppData/Local/Programs/Python/Python37/socket_client.py”, line 25, in client_program() File “C:/Users/hp/AppData/Local/Programs/Python/Python37/socket_client.py”, line 9, in client_program client_socket.connect((host, port)) # connect to the server ConnectionRefusedError: [WinError 10061] No connection could be made because the target machine actively refused it I am getting this error
- sdd
It works at localhost nicely… Thank you friend
- Basavaraj Hunshal
Simple example. Thanks.
- Nagesh
Very nice from you. Just carry on.
- Mihailo Raskovic
How can we compile this with python not with python3
- bindu