piston-mc 0.1.2-beta

A library for interacting with mojangs piston-mc api
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

use anyhow::Result;
use serde::{Deserialize, Serialize};

const PISTON_URL: &str = "https://launchercontent.mojang.com/news.json";
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct News {
    pub version: u8,
    pub entries: Vec<NewsReport>,
}
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct NewsReport {
    pub id: String,
    pub title: String,
    pub category: Category,
    pub date: String,
    pub text: String,
    #[serde(rename = "playPageImage")]
    pub play_page_image: NewsImage,
    #[serde(rename = "newsPageImage")]
    pub news_page_image: NewsImage,
    #[serde(rename = "readMoreLink")]
    pub read_more_link: String,
    #[serde(rename = "newsType")]
    pub news_type: Vec<String>,
    #[serde(rename = "cardBorder")]
    pub card_border: Option<bool>,
    pub tag: Option<String>,
}
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct NewsImage {
    pub title: String,
    pub url: String,
    pub dimensions: Option<ImageDimensions>,
}

#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Eq)]
pub enum Category {
    #[serde(rename = "Minecraft Legends")]
    MinecraftLegends,
    #[serde(rename = "Minecraft for Windows")]
    MinecraftForWindows,
    #[serde(rename = "Minecraft: Java Edition")]
    MinecraftJavaEdition,
    #[serde(rename = "Minecraft Dungeons")]
    MinecraftDungeons,
}

#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct ImageDimensions {
    pub width: u16,
    pub height: u16,
}

impl News {
    pub async fn fetch() -> Result<News> {
        let response = reqwest::get(PISTON_URL).await?;
        Ok(response.json().await?)
    }
    pub async fn java_edition(&self) -> Vec<NewsReport> {
        self.get_news_by_category(Category::MinecraftJavaEdition)
    }

    pub async fn minecraft_windows(&self) -> Vec<NewsReport> {
        self.get_news_by_category(Category::MinecraftForWindows)
    }

    pub async fn dungeons(&self) -> Vec<NewsReport> {
        self.get_news_by_category(Category::MinecraftDungeons)
    }

    pub async fn legends(&self) -> Vec<NewsReport> {
        self.get_news_by_category(Category::MinecraftLegends)
    }

    pub fn get_news_by_category(&self, category: Category) -> Vec<NewsReport> {
        self.entries.iter().filter(|entry| entry.category == category).cloned().collect()
    }
}

#[cfg(test)]
mod test {
    use crate::news::News;
    #[cfg(feature = "log")]
    use crate::setup_logging;
    #[tokio::test]
    async fn get_news() {
        #[cfg(feature = "log")]
        setup_logging();
        let news = News::fetch().await.unwrap();
        assert!(!news.entries.is_empty())
    }
}