Tutorial

This tutorial builds a small Socket.IO chat server inside a Django project. It uses one Socket.IO namespace, one room, browser JavaScript as the first client, and optional Python tests at the end.

What you will build

By the end you will have:

• a Django project configured for Channels and django-sio;

• a ChatConsumer mounted at the Socket.IO path /socket.io;

• a /chat namespace;

• a lobby room;

• a chat_message event with acknowledgement support;

• browser client code using the official Socket.IO JavaScript client;

• a basic integration-test pattern using python-socketio.AsyncClient.

Tutorial parts

• Tutorial Part 1: Basic setup
• Tutorial Part 2: Write a chat consumer
• Tutorial Part 3: Routing and browser client
• Tutorial Part 4: Rooms and acknowledgements
• Tutorial Part 5: Testing