rust-discord-activity 0.3.0

A lightweight library to control Discord Rich Presence
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

//! # Rust Discord Activity
//! _A lightweight Rust library to control Discord Rich Presence_
//!
//! ## Installation
//! Rust Discord Activity is available directly on [crates.io](https://crates.io/crates/rust-discord-activity):
//! `cargo add rust-discord-activity`
//!
//! ## How to use
//! 1. Instantiate a new DiscordClient
//! 2. Create your Activity and set desired data using provided structs
//! 3. Create a new Payload with your Activity
//! 4. Send your Payload through the DiscordClient
//!
//! Et voilà !
//!
//! ## Example
//! ```rust
//! let mut client = DiscordClient::new("<application_id>");
//!
//! let limg = Some(String::from("https://placehold.co/600x400/png"));
//! let simg = Some(String::from("https://placehold.co/200x100/png"));
//! let asset = Asset::new(limg, None, simg, None);
//! let now_in_millis = SystemTime::now().duration_since(UNIX_EPOCH).unwrap().as_millis();
//! let timestamp = Timestamp::new(Some(now_in_millis - 10000), None);
//!
//! let party = Party::new(None, Some((2, 4)));
//! let mut button_vec = vec![];
//! button_vec.push(Button::new("First Button".into(), "https://google.com".into()));
//! button_vec.push(Button::new("Second Button".into(), "https://yahoo.com".into()));
//!
//! let mut activity = Activity::new();
//!
//! activity
//!     .set_state(Some("This is State".into()))
//!     .set_activity_type(Some(ActivityType::LISTENING))
//!     .set_details(Some("This is Details".parse().unwrap()))
//!     .set_timestamps(Some(timestamp))
//!     .set_assets(Some(asset))
//!     .set_party(Some(party))
//!     .set_instance(Some(true))
//!     .set_buttons(Some(button_vec));
//!
//! let payload = Payload::new(EventName::Activity, EventData::Activity(activity));
//!
//! let _ = client.send_payload(payload);
//!
//! ```
//!
//! And voilà! This sets-up a new Activity for the current Discord user:
//!
//! <img alt="Discord Rich Presence" src="https://imgur.com/gf9pOen.png" width="300"/>
//!
//! ## Limitations
//! For the moment, the library only works with MacOS and local Discord application.
//!
//! ## Next Steps
//! - Write proper documentation for this library
//! - Write unit tests

mod client;
mod models;

pub use client::ipc::DiscordClient;
pub use models::activity::Activity;
pub use models::activity_data::{
    activity_flag::ActivityFlag, activity_type::ActivityType, asset::Asset, button::Button,
    emoji::Emoji, party::Party, secret::Secret, timestamp::Timestamp,
};
pub use models::client::{event::EventData, event::EventName, payload::Payload};