2024-05-24 14:08:09 -07:00
|
|
|
# gorilla/websocket
|
2018-08-06 12:47:05 -07:00
|
|
|
|
2024-05-24 14:08:09 -07:00
|
|
|
![testing](https://github.com/gorilla/websocket/actions/workflows/test.yml/badge.svg)
|
|
|
|
[![codecov](https://codecov.io/github/gorilla/websocket/branch/main/graph/badge.svg)](https://codecov.io/github/gorilla/websocket)
|
|
|
|
[![godoc](https://godoc.org/github.com/gorilla/websocket?status.svg)](https://godoc.org/github.com/gorilla/websocket)
|
|
|
|
[![sourcegraph](https://sourcegraph.com/github.com/gorilla/websocket/-/badge.svg)](https://sourcegraph.com/github.com/gorilla/websocket?badge)
|
2019-09-07 13:46:58 -07:00
|
|
|
|
2024-05-24 14:08:09 -07:00
|
|
|
Gorilla WebSocket is a [Go](http://golang.org/) implementation of the [WebSocket](http://www.rfc-editor.org/rfc/rfc6455.txt) protocol.
|
2018-08-06 12:47:05 -07:00
|
|
|
|
2024-05-24 14:08:09 -07:00
|
|
|
![Gorilla Logo](https://github.com/gorilla/.github/assets/53367916/d92caabf-98e0-473e-bfbf-ab554ba435e5)
|
2022-03-12 10:41:07 -08:00
|
|
|
|
|
|
|
|
2018-08-06 12:47:05 -07:00
|
|
|
### Documentation
|
|
|
|
|
2020-05-23 15:06:21 -07:00
|
|
|
* [API Reference](https://pkg.go.dev/github.com/gorilla/websocket?tab=doc)
|
2018-08-06 12:47:05 -07:00
|
|
|
* [Chat example](https://github.com/gorilla/websocket/tree/master/examples/chat)
|
|
|
|
* [Command example](https://github.com/gorilla/websocket/tree/master/examples/command)
|
|
|
|
* [Client and server example](https://github.com/gorilla/websocket/tree/master/examples/echo)
|
|
|
|
* [File watch example](https://github.com/gorilla/websocket/tree/master/examples/filewatch)
|
2024-05-24 14:08:09 -07:00
|
|
|
* [Write buffer pool example](https://github.com/gorilla/websocket/tree/master/examples/bufferpool)
|
2018-08-06 12:47:05 -07:00
|
|
|
|
|
|
|
### Status
|
|
|
|
|
|
|
|
The Gorilla WebSocket package provides a complete and tested implementation of
|
|
|
|
the [WebSocket](http://www.rfc-editor.org/rfc/rfc6455.txt) 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 Test
|
2019-09-07 13:46:58 -07:00
|
|
|
Suite](https://github.com/crossbario/autobahn-testsuite) using the application in the [examples/autobahn
|
2018-08-06 12:47:05 -07:00
|
|
|
subdirectory](https://github.com/gorilla/websocket/tree/master/examples/autobahn).
|