bottle-websocket

What it is and what it does

bottle-websocket is a plugin for the Bottle web framework that adds WebSocket capabilities by wrapping gevent-websocket and gevent. It allows you to define WebSocket handlers as Bottle routes using a decorator, receiving the WebSocket connection object as a route argument. The package provides GeventWebSocketServer, a server implementation that runs Bottle with WebSocket support enabled.

The package was last updated in 2015 and is no longer actively maintained. While it has no known security vulnerabilities, its age and abandonment status mean it has not been tested against modern Python versions, current Bottle releases, or recent versions of its gevent dependencies. Installation requires compiling gevent's C extensions, which adds friction on systems without build tools.

Use it for:

• Build a real-time chat application where Bottle routes handle WebSocket connections for bidirectional messaging.
• Create a live dashboard that pushes server updates to connected clients over WebSocket without polling.
• Implement a multiplayer game backend using Bottle with WebSocket for low-latency player communication.
• Add real-time notifications to a Bottle web application by broadcasting messages to subscribed WebSocket clients.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adds WebSocket support to the Bottle web framework by integrating gevent-websocket and gevent, enabling bidirectional communication on Bottle routes.

No. The package is abandoned (last release 2015-09-21, last commit 2020-11-15), has high install friction due to compiled dependencies, and lacks verification of compatibility with modern Python and Bottle versions. For new projects, use a maintained WebSocket library or framework. For legacy systems already running this package, proceed with caution and plan migration.

Install

bottle-websocket on PyPI

pip install bottle-websocket

uv add bottle-websocket

poetry add bottle-websocket

Installing bottle-websocket

Before you install

High install friction: the package is abandoned (last release 2015-09-21, last commit 2020-11-15) and depends on compiled components. No recent maintenance or updates.

License in practice

MIT license is permissive and poses no restrictions on use, modification, or distribution for commercial or private projects.

Quickstart

pip install bottle-websocket

from bottle.ext.websocket import GeventWebSocketServer, websocket
from bottle import get, run

@get('/websocket', apply=[websocket])
def echo(ws):
    while True:
        msg = ws.receive()
        if msg is not None:
            ws.send(msg)
        else:
            break

run(host='127.0.0.1', port=8080, server=GeventWebSocketServer)

Requires compiled C extensions from gevent; build tools must be available on the system.

Verify before relying

• Compatibility with modern Python versions and current Bottle releases is unknown.
• Whether gevent-websocket and gevent dependencies remain compatible with contemporary systems.
• Current state of the underlying gevent-websocket library and whether it is actively maintained.

Package facts

Evidence: bottle-websocket-0.2.9.tar.gz

Keywords: bottle, websockets

Tags

More Python Modules packages