#discord #discord-api #twilight

twilight-gateway

Discord Gateway implementation for the Twilight ecosystem

31 releases

new 0.5.5 Jul 25, 2021
0.5.1 Jun 24, 2021
0.3.3 Mar 14, 2021
0.2.6 Dec 29, 2020
0.2.5 Nov 29, 2020

#9 in WebSocket

Download history 415/week @ 2021-04-07 202/week @ 2021-04-14 147/week @ 2021-04-21 161/week @ 2021-04-28 167/week @ 2021-05-05 381/week @ 2021-05-12 309/week @ 2021-05-19 148/week @ 2021-05-26 105/week @ 2021-06-02 451/week @ 2021-06-09 149/week @ 2021-06-16 232/week @ 2021-06-23 256/week @ 2021-06-30 193/week @ 2021-07-07 299/week @ 2021-07-14 265/week @ 2021-07-21

1,016 downloads per month
Used in 5 crates

ISC license

1.5MB
39K SLoC

twilight-gateway

discord badge github badge license badge rust badge

twilight-gateway is an implementation of Discord's sharding gateway sessions. This is responsible for receiving stateful events in real-time from Discord and sending some stateful information.

It includes two primary types: the Shard and Cluster.

The Shard handles a single websocket connection and can manage up to 2500 guilds. If you manage a small bot in under about 2000 guilds, then this is what you use. See the Discord docs for more information on sharding.

The Cluster is an interface which manages the health of the shards it manages and proxies all of their events under one unified stream. This is useful to use if you have a large bot in over 1000 or 2000 guilds.

Features

Deserialization

twilight-gateway supports serde_json and simd-json for deserializing and serializing events.

simd-json

The simd-json feature enables simd-json support to use simd features of modern cpus to deserialize responses faster. It is not enabled by default.

To use this feature you need to also add these lines to <project root>/.cargo/config:

[build]
rustflags = ["-C", "target-cpu=native"]

you can also use this environment variable RUSTFLAGS="-C target-cpu=native".

[dependencies]
twilight-gateway = { default-features = false, features = ["rustls", "simd-json"], version = "0.2" }

TLS

twilight-gateway has features to enable async-tungstenite and twilight-http's TLS features. These features are mutually exclusive. rustls is enabled by default.

native

The native feature enables async-tungstenite's tokio-native-tls feature as well as twilight-http's native feature which is mostly equivalent to using native-tls.

To enable native, do something like this in your Cargo.toml:

[dependencies]
twilight-gateway = { default-features = false, features = ["native"], version = "0.2" }

rustls

The rustls feature enables async-tungstenite's tokio-rustls feature and twilight-http's rustls feature, which use rustls as the TLS backend.

This is enabled by default.

zlib

zlib is enabled with the feature compression and one of the two zlib features described below. Enabling any of the two features below will also enable compression. compression is enabled by default.

There are 2 zlib features zlib-stock and zlib-simd for the library to work one of them has to be enabled. If both are enabled it will use zlib-stock

zlib-stock enabled by default.

Enabling only zlib-simd will make the library use zlib-ng which is a modern fork of zlib that is faster and more effective, but it needs cmake to compile.

Metrics

The metrics feature provides metrics information via the metrics crate. Some of the metrics logged are counters about received event counts and their types and gauges about the capacity and efficiency of the inflater of each shard.

This is disabled by default.

Dependencies

~12–18MB
~369K SLoC