fluxer-rust 0.1.7

Rust API wrapper for Fluxer
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

# Fluxer-Rust

A Rust written API Wrapper for the Discord alternative [Fluxer](https://fluxer.app/).

**Note: the crate is** `fluxer-rust` **but the library name is** `fluxer`, **so imports use** `use fluxer::prelude::*`.

```
cargo add fluxer-rust
```

## Usage

```rust
use fluxer::prelude::*;

struct Handler;

#[async_trait]
impl EventHandler for Handler {
    async fn on_ready(&self, _ctx: Context, ready: Ready) {
        println!("Logged in as {}", ready.user.username);
    }

    async fn on_message(&self, ctx: Context, msg: Message) {
        if msg.content.as_deref() == Some("!ping") {
            let ch = msg.channel_id.as_deref().unwrap_or_default();
            let _ = ctx.http.send_message(ch, "Pong!").await;
        }
    }
}

#[tokio::main]
async fn main() {
    let token = std::env::var("FLUXER_TOKEN").expect("FLUXER_TOKEN not set");
    let mut client = Client::builder(&token)
        .event_handler(Handler)
        .build();

    if let Err(e) = client.start().await {
        eprintln!("{}", e);
    }
}
```

## Voice

Requires ffmpeg. On Ubuntu/Debian you also need a few system packages:

```
sudo apt-get install -y pkg-config libglib2.0-dev libva-dev
```

```rust
let conn = ctx.join_voice(guild_id, channel_id).await?;
let handle = conn.play_music("track.mp3", ctx.http.clone(), channel_id.to_string()).await?;
handle.abort(); // stop playback
ctx.leave_voice(guild_id).await?;
```

## Selfbot

To connect as a user account rather than a bot, pass `.user_token()` to the builder.

```rust
Client::builder(&token).user_token().event_handler(Handler).build()
```

## Self-hosted Instances

To use the API of a self-hosted instance rather than fluxer's API, pass `.api_url("<API url>")` to the builder.

```rust
Client::builder(&token).api_url("http://localhost:48763/api/v1").event_handler(Handler).build()
```

## Examples

[Examples](examples/)

```
cargo run --example bot          # simple bot
cargo run --example voice        # voice join/play/stop
cargo run --example event_logger # logs all gateway events
cargo run --example selfbot      # user token selfbot
```

## License

Apache-2.0

## Donations

Paypal: [paypal.me/vesaber](https://paypal.me/vesaber)\
Monero: `46yingAoPTfECB2fXLQPiq9uwPezBQYjPhn3B4yScozaLiaiM4NpmRqS4MJ4Ja5gewJs5pLzV2RMV9USvwDNhQvbF6LExTU`\
Bitcoin: `bc1q5wudz9xqctkswrzphjc48kt5hurkz63e74jece`