rustybook 0.2.1

An ergonomic Facebook client in Rust
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

#![doc = include_str!("../README.md")]

#[cfg(all(feature = "cache", not(feature = "messenger")))]
compile_error!("feature `cache` requires feature `messenger`");

mod builder;
pub mod error;
mod extractor;
mod session;

use std::sync::Arc;

use rustybook_http::client::Client;
#[cfg(feature = "messenger")]
use rustybook_messenger::client::MessengerClient;

use crate::builder::RustybookBuilder;
use crate::error::*;

#[cfg(feature = "messenger")]
pub use rustybook_messenger::client::models::{
    Message,
    Presence,
    Typing,
    User,
};
#[cfg(feature = "messenger")]
pub use rustybook_messenger::client::{
    context::Context,
    events::{
        ErrorEvent,
        EventHandler,
    },
};

pub(crate) struct Inner {
    http: Client,
    #[cfg(feature = "messenger")]
    messenger: MessengerClient,
    #[cfg(feature = "messenger")]
    handler: Option<Arc<dyn EventHandler>>,
}

/// Rustybook is a client for interacting with Facebook services.
#[derive(Clone)]
pub struct Rustybook {
    inner: Arc<Inner>,
}

impl Rustybook {
    /// Creates a new Rustybook client with default settings.
    pub fn new() -> Result<Rustybook, Error> {
        RustybookBuilder::new().build()
    }

    /// Returns a builder for configuring the client.
    pub fn builder() -> RustybookBuilder {
        RustybookBuilder::new()
    }

    /// Starts the messenger client
    #[cfg(feature = "messenger")]
    pub async fn start(&self) -> Result<(), Error> {
        if let Some(handler) = self.inner.handler.as_ref() {
            self.inner
                .messenger
                .start_with_handler(handler.clone())
                .await?;
        } else {
            self.inner.messenger.start().await?;
        }
        Ok(())
    }
}