amagi 0.1.1

Rust SDK, CLI, and Web API service skeleton for multi-platform social web adapters.
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

use axum::{
    Json,
    extract::{Path, Query, State},
    http::HeaderMap,
};

use super::super::support::{FetchResult, fetch_error_response, twitter_fetcher};
use super::types::{TwitterRepliesQuery, TwitterSearchQuery, TwitterTimelineQuery};
use crate::platforms::twitter::{
    TwitterTweet, TwitterTweetPage, TwitterTweetSearchPage, TwitterUserPage,
};
use crate::server::state::AppState;

/// Search Twitter/X tweets through the web API.
pub async fn twitter_search_tweets(
    Query(query): Query<TwitterSearchQuery>,
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<TwitterTweetSearchPage> {
    twitter_fetcher(&state, &headers)
        .search_tweets(
            &query.query,
            query.search_type,
            query.count,
            query.cursor.as_deref(),
        )
        .await
        .map(Json)
        .map_err(fetch_error_response)
}

/// Fetch one Twitter/X tweet detail through the web API.
pub async fn twitter_tweet_detail(
    Path(tweet_id): Path<String>,
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<TwitterTweet> {
    twitter_fetcher(&state, &headers)
        .fetch_tweet_detail(&tweet_id)
        .await
        .map(Json)
        .map_err(fetch_error_response)
}

/// Fetch replies to one Twitter/X tweet through the web API.
pub async fn twitter_tweet_replies(
    Path(tweet_id): Path<String>,
    Query(query): Query<TwitterRepliesQuery>,
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<TwitterTweetPage> {
    twitter_fetcher(&state, &headers)
        .fetch_tweet_replies(&tweet_id, query.cursor.as_deref(), query.sort_by)
        .await
        .map(Json)
        .map_err(fetch_error_response)
}

/// Fetch users who liked one Twitter/X tweet through the web API.
pub async fn twitter_tweet_likers(
    Path(tweet_id): Path<String>,
    Query(query): Query<TwitterTimelineQuery>,
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<TwitterUserPage> {
    twitter_fetcher(&state, &headers)
        .fetch_tweet_likers(&tweet_id, query.count, query.cursor.as_deref())
        .await
        .map(Json)
        .map_err(fetch_error_response)
}

/// Fetch users who retweeted one Twitter/X tweet through the web API.
pub async fn twitter_tweet_retweeters(
    Path(tweet_id): Path<String>,
    Query(query): Query<TwitterTimelineQuery>,
    headers: HeaderMap,
    State(state): State<AppState>,
) -> FetchResult<TwitterUserPage> {
    twitter_fetcher(&state, &headers)
        .fetch_tweet_retweeters(&tweet_id, query.count, query.cursor.as_deref())
        .await
        .map(Json)
        .map_err(fetch_error_response)
}