Python-Websockets 项目中 WebSocketServer 连接列表的暴露

在 Python-Websockets 项目中，开发者提出并实现了一个简单但实用的功能改进：将 WebSocketServer 的活动连接列表作为属性暴露出来。这个改动虽然代码量很小，但对于开发者监控和管理 WebSocket 连接具有重要意义。

功能实现

核心实现非常简洁，通过在 WebSocketServer 类中添加一个只读属性来完成：

@property
def connections(self):
    return self.handlers.keys()

这个 connections 属性返回当前服务器上所有活动连接的键集合。由于使用了 @property 装饰器，开发者可以像访问普通属性一样使用它，而不需要调用方法。

技术背景

在 WebSocket 服务器实现中，通常需要维护所有活动连接的列表。Python-Websockets 内部使用 handlers 字典来管理这些连接，其中键是连接标识符，值是连接处理器对象。

之前版本中，开发者如果需要获取当前活动连接列表，可能需要直接访问内部 handlers 属性，这不符合封装原则。通过提供正式的 connections 属性接口，项目提供了更规范、更安全的访问方式。

应用场景

这个功能在以下场景中特别有用：

1. 连接监控：开发者可以实时查看当前活跃连接数量
2. 调试诊断：当出现连接问题时，可以快速检查哪些连接仍然活跃
3. 资源管理：在服务器关闭前，可以确保所有连接都已妥善处理
4. 统计功能：实现连接数统计、峰值监控等功能

文档更新

随着这个功能的加入，项目文档也相应更新，指导开发者如何正确使用这个新属性。文档中特别强调了：

• 该属性是只读的，不应尝试修改返回的集合
• 返回的连接标识符集合的具体含义和用途
• 在多线程环境下的使用注意事项

这个看似简单的改进体现了 Python-Websockets 项目对开发者体验的重视，通过提供更友好的 API 接口，让开发者能够更轻松地构建健壮的 WebSocket 应用。