skip to navigation
skip to content

Not Logged In

stargate 0.4

Real time communication for pyramid using WebSockets

Introduction
============

Stargate is a package for adding WebSockets_ support to
pyramid applications using the excellent eventlet library for long running
connections

What is a WebSocket?
====================

From wikipedia::

    WebSockets is a technology providing for bi-directional, full-duplex
    communications channels, over a single TCP socket

The WebSocket protocol provides a persistent low latency, low complexity way to
achieve two way communication from the browser to server.

From a client point of view using websocket is very simple::

    var ws = new WebSocket('ws://somehost/some/url');
    ws.onopen = function(msg){
        //do some cool setup
    }
    ws.onmessage = function(msg){
        //do something cool
    }
    ws.onclose = function(msg){
        //do some clean up... stay cool
    }

    // later:
    ws.send('How cool am I?!');

That's pretty much all there is to it.

Normally the websocket communication in a web app is implemented as a stand alone
server (perhaps running on a different port). rpz.websocket allows you to connect
persistent connection directly to the same objects that serve your HTML.

Documentation
=============

.. note:: Still under construction

Documentation is maintained at http://boothead.github.com/stargate

References
==========

.. [WebSockets] http://en.wikipedia.org/wiki/Web_Sockets
.. [spec] http://tools.ietf.org/html/draft-hixie-thewebsocketprotocol-76



Changelog
=========

0.4
---

- Add support for the HyBi version of WebSockets (specifically version-10). This version was released to solve some previous security concerns and
will be the version in Firefox 7/8 and Chrome 14 onwards accoring to Wikipedia.
- Introduces a dependency on ws4py

- See http://tools.ietf.org/html/draft-ietf-hybi-thewebsocketprotocol-10

0.3
---

- Fix bug in setup.py
- Improve documentation and consistency with pyramid naming

0.2
---

- Support for version 76 of the websocket handshake

0.1
---

- Initial release, ported from rpz.websocket and repoze.bfg to pyramid
 
File Type Py Version Uploaded on Size
stargate-0.4.tar.gz (md5) Source 2011-09-05 409KB
  • Downloads (All Versions):
  • 3 downloads in the last day
  • 61 downloads in the last week
  • 280 downloads in the last month