Room-based messaging in Flask - Step-by-Step Execution

Concept Flow - Room-based messaging

Client connects

↓

Join Room Request

↓

Server adds client to room

↓

Client sends message

↓

Server receives message

↓

Server broadcasts message to room

↓

Clients in room receive message

↓

Client disconnects or leaves room

Clients connect, join a room, send messages, and the server broadcasts messages only to clients in that room.

Execution Sample

Flask

from flask import Flask
from flask_socketio import SocketIO, join_room, leave_room, send

app = Flask(__name__)
socketio = SocketIO(app)

@socketio.on('join')
def on_join(data):
    join_room(data['room'])

This code lets a client join a specific room on the server.

Execution Table

Step	Event	Data	Server Action	Room State	Message Broadcast
1	Client connects	N/A	Connection established	No rooms yet	No
2	Client sends 'join' with room='room1'	{'room': 'room1'}	Add client to 'room1'	room1: [client1]	No
3	Client sends message 'Hello' to 'room1'	{'room': 'room1', 'msg': 'Hello'}	Broadcast 'Hello' to 'room1'	room1: [client1]	Message sent to client1
4	Second client connects	N/A	Connection established	room1: [client1]	No
5	Second client joins 'room1'	{'room': 'room1'}	Add client2 to 'room1'	room1: [client1, client2]	No
6	Client2 sends message 'Hi there' to 'room1'	{'room': 'room1', 'msg': 'Hi there'}	Broadcast 'Hi there' to 'room1'	room1: [client1, client2]	Message sent to client1 and client2
7	Client1 leaves 'room1'	{'room': 'room1'}	Remove client1 from 'room1'	room1: [client2]	No
8	Client1 disconnects	N/A	Remove client1 from all rooms	room1: [client2]	No
9	Client2 sends message 'Bye' to 'room1'	{'room': 'room1', 'msg': 'Bye'}	Broadcast 'Bye' to 'room1'	room1: [client2]	Message sent to client2
10	Client2 disconnects	N/A	Remove client2 from all rooms	room1: []	No

💡 All clients disconnected, no rooms have members, messaging stops.

Variable Tracker

Variable	Start	After Step 2	After Step 5	After Step 7	After Step 10
room1 members	[]	[client1]	[client1, client2]	[client2]	[]
client1 connected	False	True	True	True	False
client2 connected	False	False	True	True	False

Key Moments - 3 Insights

Why does a message only go to clients in the same room?

Because the server uses the room membership (see execution_table steps 3 and 6) to broadcast messages only to clients joined in that room.

What happens if a client sends a message without joining a room?

The server cannot broadcast it to a room, so no clients receive the message. This is shown by the absence of room membership before step 2.

Why do we remove clients from rooms on disconnect?

To keep room membership accurate and avoid sending messages to disconnected clients, as shown in steps 8 and 10.

Visual Quiz - 3 Questions

Look at the execution_table at step 6, who receives the message 'Hi there'?

A Both client1 and client2

B Only client2

C Only client1

D No clients

💡 Hint

Check the 'Room State' and 'Message Broadcast' columns at step 6.

At which step does client1 leave the room 'room1'?

A Step 5

B Step 7

C Step 8

D Step 10

💡 Hint

Look for the 'Server Action' column mentioning removal from 'room1'.

If client2 disconnects earlier at step 6, what happens to the room members?

A client2 stays in room1 until step 10

B room1 members become empty immediately

C client1 remains in room1

D Both clients are removed from room1

💡 Hint

Refer to variable_tracker for client connection and room membership changes.

Concept Snapshot

Room-based messaging in Flask:
- Clients connect and join named rooms.
- Server tracks which clients are in which rooms.
- Messages sent to a room go only to clients in that room.
- Clients can leave rooms or disconnect, updating membership.
- Use join_room() and leave_room() to manage rooms.

Full Transcript

Room-based messaging lets clients join named groups called rooms. When a client connects, it can send a request to join a room. The server adds the client to that room's list. When a client sends a message to a room, the server sends that message only to clients in that room. If a client leaves or disconnects, the server removes it from the room to keep the list accurate. This way, messages are shared only among clients who share the same room, like a private chat group.