79 releases (13 breaking)

0.13.1 Sep 9, 2020
0.12.4 Aug 29, 2020
0.11.8 Jul 4, 2020
0.9.3 Mar 30, 2020
0.3.0 Mar 26, 2019

#45 in Network programming

Download history 190/week @ 2020-05-29 144/week @ 2020-06-05 108/week @ 2020-06-12 46/week @ 2020-06-19 73/week @ 2020-06-26 214/week @ 2020-07-03 236/week @ 2020-07-10 13/week @ 2020-07-17 65/week @ 2020-07-24 100/week @ 2020-07-31 274/week @ 2020-08-07 245/week @ 2020-08-14 128/week @ 2020-08-21 177/week @ 2020-08-28 398/week @ 2020-09-04 62/week @ 2020-09-11

654 downloads per month

MIT/Apache

375KB
9K SLoC

twitchchat

Documentation Crates Actions

This crate provides a way to interact with Twitch's chat.

Along with parse messages as Rust types, it provides methods for sending messages.

It also provides an 'event' loop which you can use to make a bot.

Opt-in features

By default, this crate depends on zero external crates -- but it makes it rather limited in scope. It can just parse/decode/encode to standard trait types (std::io::{Read, Write}).

To use the AsyncRunner (an async-event loop) you must able the async feature.

NOTE This is a breaking change from 0.12 which had the async stuff enabled by default.

twitchchat = { version = "0.13", features = ["async"] }

To use a specific TcpStream/TlStream refer to the runtime table below.

Serde support

To enable serde support, simply enable the optional serde feature

Runtime

This crate is runtime agonostic. To use..

Read/Write provider Features
async_io async-io
smol smol
async_std async-std
tokio tokio and tokio-util

TLS

If you want TLS supports, enable the above runtime and also enable the cooresponding features:

Read/Write provider Runtime Features TLS backend
async_io async_io "async-tls" rustls
smol smol "async-tls" rustls
async_std async_std "async-tls" rustls
tokio tokio "tokio-util", "tokio-rustls", "webpki-roots" rustls
tokio tokio "tokio-util", "tokio-native-tls", "native-tls" native-tls

Examples

Using async_io to connect with..

Using async_std to connect with..

Using smol to connect with..

Using tokio to connect with..

How to use the crate as just a message parser(decoder)/encoder

An a simple example of how one could built a bot with this

License

twitchchat is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT for details.

Dependencies

~0–3.5MB
~78K SLoC