v3: Move away from gorilla/websocket

[diamondburned]

As of the time writing this issue, gorilla/websocket is now officially archived and will no longer receive any updates. Although we don't try to update dependencies very often, we still want to use a reasonably maintained library.

A few alternatives exist, none of which I actually want to use:

• gobwas/ws seems too low-level, and I'm unsure if it's well-maintained either.
• nhooyr/websocket depends on klauspost/compress, which I (and a few other people) do not want to use because it's ~50MB to download, which a lot of people struggle with.
• x/net/websocket is deprecated.

Any other alternatives proposed are welcome; please put them as comments under this issue. For now, we'll stick to using gorilla/websocket.

[lemondevxyz]

I'd vouch for gobwas/ws because it is well maintained from what I could tell. That and the author of the library works at Mail.ru which means maintenance is guaranteed(They serve over 3 million users simultaneously).

I also have used the library myself and find the library pleasant. While gobwas/ws is very low level, gobwas/ws/wsutil is used for high level operations.

gobwas/ws/wsutil makes things very easy because it uses interfaces like io.Writer and io.Reader.

To help you get familiar with gobwas/ws/wsutil, here are the methods you'd use in diamondburned/arikawa/v3/utils/ws/conn.go:

• ws.Dialer{}.Dial: Use this because Discord requires a certain amount of headers and the regular ws.Dial does not support Headers.
• ws/wsutil.WriteServerMessage: Since diamondburned/arikawa/v3/utils/ws/conn.go uses gorilla/websocket.WriteMessage to write [Text] and [Close] messages, ws/wsutil/WriteServerMessage is preferred over WriteServerText because it is more vesatile.

Do note: WriteServerMessage is meant to be used by clients. The naming scheme comes from where the message is supposed to written to.

There are other facets to wsutil that I haven't covered but I don't think that'll be necessary since both gorilla/websocket and gobwas/ws share net.Conn which should cover all your needs.

[ayn2op]

The Gorilla toolkit has new maintainers; this issue can be closed.