Crate mastodon_async

mastodon-async: API Wrapper around the Mastodon API.

Most of the api is documented on Mastodon’s website

use mastodon_async::{helpers::cli, prelude::*};
use futures_util::StreamExt;

tokio_test::block_on(async {
    let registration = Registration::new("https://botsin.space")
        .client_name("mastodon-async_test")
        .build()
        .await
        .unwrap();
    let mastodon = cli::authenticate(registration).await.unwrap();

    println!(
        "{:?}",
        mastodon
            .get_home_timeline()
            .await
            .unwrap()
            .items_iter()
            .take(100)
            .collect::<Vec<_>>()
            .await
    );
});

mastodon-async also supports Mastodon’s Streaming API:

Example

use mastodon_async::{prelude::*, entities::event::Event};
use futures_util::TryStreamExt;

let data = Data::default();
let client = Mastodon::from(data);
tokio_test::block_on(async {
    let stream = client.stream_user().await.unwrap();
    stream.try_for_each(|(event, _client)| async move {
        match event {
            Event::Update(ref status) => { /* .. */ },
            Event::Notification(ref notification) => { /* .. */ },
            Event::Delete(ref id) => { /* .. */ },
            Event::FiltersChanged => { /* .. */ },
        }
        Ok(())
    }).await.unwrap();
});

Re-exports

• pub use data::Data;
• pub use errors::ApiError;
• pub use errors::Error;
• pub use errors::Result;
• pub use mastodon::Mastodon;
• pub use mastodon::MastodonUnauthenticated;
• pub use registration::Registration;
• pub use requests::AddFilterRequest;
• pub use requests::AddPushRequest;
• pub use requests::StatusesRequest;
• pub use requests::UpdateCredsRequest;
• pub use requests::UpdatePushRequest;
• pub use status_builder::NewStatus;
• pub use status_builder::StatusBuilder;

Modules

• apps
  Registering your App
• data
  Contains the struct that holds the client auth data
• entities
  Entities returned from the API
• errors
  Errors
• event_stream
  Event stream generators
• helpers
  Collection of helpers for serializing/deserializing Data objects
• mastodon
  The mastodon client
• page
  Handling multiple pages of entities.
• polling_time
  How much time to wait before checking an endpoint again.
• prelude
  Automatically import the things you need
• registration
  Registering your app.
• requests
  Requests
• scopes
  OAuth Scopes
• status_builder
  Constructing a status

Macros

• format_err
  Used to easily create errors from strings
• log_serde
  Log metadata about this request based on the type given:

Enums

• Language
• Visibility
  The visibility of a status.