re
/
websocket
forked from mirror/websocket
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
A fast, well-tested and widely used WebSocket implementation for Go.
44 Commits 2 Branches 9 Tags 942 KiB
Go 100%
Go to file
Gary Burd df94ef6daa Various improvements to Upgrader. 
- Revert back to using Subprotocols []string. The protocol negotiation
  using Subprotocols should meet the needs of most applications.
  Applications are not locked into using this negotiation. An
  application can pick a protocol some other way and specify the
  protocol using the Sec-Websocket-Protocol response header.
- Parse the origin using url.Parse. This is the correct function to use
  when parsing a full URL.
- Improve comments.
 		2014-04-20 11:38:35 -07:00
examples Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00
.gitignore Initial commit 2013-10-16 16:30:59 -07:00
.travis.yml Update Travis config, Go 1.0 not supported. 2013-12-23 11:41:02 -08:00
AUTHORS Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00
LICENSE Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00
README.md Improve comparison with other packages in readme. 2014-04-19 07:16:39 -07:00
client.go Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00
client_server_test.go Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00
conn.go Cleanup issues reported by golint. 2014-04-20 07:20:03 -07:00
conn_test.go Cleanup issues reported by golint. 2014-04-20 07:20:03 -07:00
doc.go Various improvements to Upgrader. 2014-04-20 11:38:35 -07:00
json.go Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00
json_test.go Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00
server.go Various improvements to Upgrader. 2014-04-20 11:38:35 -07:00
server_test.go Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00
util.go Relicense to the Gorilla WebSocket Authors. 2014-04-18 14:25:11 -07:00

README.md

Gorilla WebSocket

Gorilla WebSocket is a Go implementation of the WebSocket protocol.

Documentation

Status

The Gorilla WebSocket package provides a complete and tested implementation of the WebSocket protocol. The package API is stable.

Installation

go get github.com/gorilla/websocket

Protocol Compliance

The Gorilla WebSocket package passes the server tests in the Autobahn WebSockets Test Suite using the application in the examples/autobahn subdirectory.

Gorilla WebSocket compared with other packages

gorilla go.net
Protocol supportRFC 6455RFC 6455, see notes
Limit size of received messageYesNo
Send pings and receive pongsYesNo
Send close messageYesNo
Read message using io.ReaderYesNo, see notes
Write message using io.WriteCloserYesNo, see notes
Encode, decode JSON messageYesYes

Notes:

  • The go.net package does not handle fragmented messages.
  • The go.net io.Reader and io.Writer operate across WebSocket frame boundaries. Read returns when the input buffer is full or a frame boundary is encountered, Each call to Write sends a single frame message. The Gorilla io.Reader and io.WriteCloser operate on a single WebSocket message.