gevent-socketio-hartwork 0.3.6.post201803091952

请注意

这里显示的是由Sebastian Pipping (@hartwork) 维护的gevent-socketio的0.3.6之后的Git版本，以gevent-socketio-hartwork为品牌在PyPI上区分。

目的是尽可能少地偏离上游gevent-socketio，并镜像未修改的master分支。维护工作在hartwork-master分支上进行。

在0.3.6版本以上，以下是一些值得注意的提交，从最新到最旧：

• 添加对Django 1.10的支持 由Lucas Connors (@RevolutionTech)

• 删除对Django 1.3的支持 由Lucas Connors (@RevolutionTech)

• 修复导入以支持Django>=1.9 由Chris Spencer (@chrisspen)

• 领导笔记 由Alexandre Bourget (@abourget)

• 全Python 2+3支持 由 Eugene Pankov (@Eugeny) 提供

本文档剩余部分为原始文档，除链接已调整外。请享受。

Sebastian Pipping

演示

gevent-socketio 是一个基于 Socket.IO 协议的 Python 实现，最初由 LearnBoost 为 Node.js 开发，后来移植到其他语言。Socket.IO 允许浏览器和服务器之间使用类似 WebSocket 的 API 进行实时网络通信。该项目的一个目标是为不同的基于 WSGI 的 Web 框架（Pyramid、Pylons、Flask、web2py、Django 等）提供一个单一的基于 gevent 的 API。只需 ~3 行代码即可在您的框架中集成 gevent-socketio。注意：您需要使用 gevent Python WSGI 服务器来使用 gevent-socketio。

社区，站起来！

公告：本项目需要一个坚实的维护者来处理 27+ 个开放的 Pull Requests，合并需要合并的内容，并继续进行新的开发。@abourget 这些天在这项项目上投入的时间不如他希望的那么多。该项目在 GitHub 上有近 1000 个 Stars，被大型企业使用。这是一个你可以领导的优秀项目。请联系 @abourget 在 Twitter @bourgetalexndre 以承担更多领导责任。

技术概述

gevent-socketio 的实现大部分是纯 Python。显然依赖于 gevent，还依赖于 gevent-websocket。有 Pyramid、Flask、Django 和 BYOF（带来你自己的框架！）的集成示例。

文档和参考

您可以在以下位置阅读渲染的 Sphinx 文档：

• http://readthedocs.org/docs/gevent-socketio/en/latest/

讨论发生在 GitHub 问题跟踪中

• https://github.com/hartwork/gevent-socketio/issues

• (和 https://github.com/abourget/gevent-socketio/issues)

您也可以联系维护者

• sebastian@pipping.org

安装

您可以使用标准的 Python 方法进行安装

pip install gevent-socketio-hartwork

或从源码安装

git clone git://github.com/hartwork/gevent-socketio.git
cd gevent-socketio
python setup.py install

对于开发，运行 install 代替

python setup.py develop

如果您想在 virtualenv 中完成所有这些，请运行

virtualenv env
. env/bin/activate
python setup.py develop   # or install

To execute all tests, run

tox

要为特定 Python 版本执行所有测试，请运行类似以下命令：

tox -e py27

要为特定 Python 版本执行特定测试，请运行类似以下命令：

tox -e py27 – test_packet.py::TestEncodeMessage::test_encode_event