add rust swapi client

Author: weiztech

.gitignore

@@ -0,0 +1,2 @@
+/target
+Cargo.lock

Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "swapi_client"
+version = "0.0.1"
+edition = "2018"
+authors = ["Jensen Wijaya <[email protected]>"]
+description = "Rust client for Star Wars API (https://swapi.co/)"
+license = "MIT"
+
+[dependencies]
+reqwest = { version = "0.11", features = ["blocking", "json"] }
+serde = { version = "1.0.130", features = ["derive"] }
+serde_json = "1.0"

src/common.rs

@@ -0,0 +1,32 @@
+//! Shared libs
+
+use std::error::Error;
+use std::fmt;
+
+#[derive(Debug, serde::Deserialize, Default, Clone)]
+pub struct ListData<T> {
+    pub count: usize,
+    pub next: Option<String>,
+    pub previous: Option<String>,
+    pub results: Vec<T>,
+}
+
+impl<T> IntoIterator for ListData<T> {
+    type Item = T;
+    type IntoIter = std::vec::IntoIter<Self::Item>;
+
+    fn into_iter(self) -> Self::IntoIter {
+        self.results.into_iter()
+    }
+}
+
+#[derive(Debug)]
+pub struct RequestFailed(pub reqwest::blocking::Response);
+
+impl fmt::Display for RequestFailed {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        write!(f, "Request failed")
+    }
+}
+
+impl Error for RequestFailed {}

src/lib.rs

@@ -0,0 +1,8 @@
+//! Rust client for Star Wars API
+
+pub mod common;
+pub mod objects;
+mod requests;
+
+pub use crate::objects::{Film, People, Planet, Species, Starship, Vehicle};
+pub use crate::requests::RequestHandler;

src/objects.rs

@@ -0,0 +1,152 @@
+//! Star Wars Objects
+
+use crate::requests::RequestHandler;
+
+use serde::Deserialize;
+
+/// Planet resource within the Star Wars universe.
+#[derive(Debug, Deserialize, Default, Clone)]
+
+pub struct Planet {
+    pub climate: String,
+    pub diameter: String,
+    pub gravity: String,
+    pub name: String,
+    pub orbital_period: String,
+    pub population: String,
+    pub residents: Vec<String>,
+    pub rotation_period: String,
+    pub surface_water: String,
+    pub terrain: String,
+    pub url: String,
+}
+
+/// People resource within the Star Wars universe.
+#[derive(Debug, Deserialize, Default, Clone)]
+pub struct People {
+    pub birth_year: String,
+    pub eye_color: String,
+    pub films: Vec<String>,
+    pub gender: String,
+    pub hair_color: String,
+    pub height: String,
+    pub homeworld: String,
+    pub mass: String,
+    pub name: String,
+    pub skin_color: String,
+    pub created: String,
+    pub edited: String,
+    pub species: Vec<String>,
+    pub starships: Vec<String>,
+    pub url: String,
+    pub vehicles: Vec<String>,
+}
+
+/// Film resource within the Star Wars universe.
+#[derive(Debug, Deserialize, Default, Clone)]
+pub struct Film {
+    characters: Vec<String>,
+    created: String,
+    director: String,
+    edited: String,
+    episode_id: usize,
+    opening_crawl: String,
+    planets: Vec<String>,
+    producer: String,
+    release_date: String,
+    species: Vec<String>,
+    starships: Vec<String>,
+    title: String,
+    url: String,
+    vehicles: Vec<String>,
+}
+
+/// Starship resource within the Star Wars universe.
+#[derive(Debug, Deserialize, Default, Clone)]
+pub struct Starship {
+    #[serde(alias = "MGLT")]
+    mglt: String,
+
+    cargo_capacity: String,
+    consumables: String,
+    cost_in_credits: String,
+    created: String,
+    crew: String,
+    edited: String,
+    hyperdrive_rating: String,
+    length: String,
+    manufacturer: String,
+    max_atmosphering_speed: String,
+    model: String,
+    name: String,
+    passengers: String,
+    films: Vec<String>,
+    pilots: Vec<String>,
+    starship_class: String,
+    url: String,
+}
+
+/// Vehicle resource within the Star Wars universe.
+#[derive(Debug, Deserialize, Default, Clone)]
+pub struct Vehicle {
+    cargo_capacity: String,
+    consumables: String,
+    cost_in_credits: String,
+    created: String,
+    crew: String,
+    edited: String,
+    length: String,
+    manufacturer: String,
+    max_atmosphering_speed: String,
+    model: String,
+    name: String,
+    passengers: String,
+    pilots: Vec<String>,
+    films: Vec<String>,
+    url: String,
+    vehicle_class: String,
+}
+
+/// Species resource within the Star Wars universe.
+#[derive(Debug, Deserialize, Default, Clone)]
+pub struct Species {
+    average_height: String,
+    average_lifespan: String,
+    classification: String,
+    created: String,
+    designation: String,
+    edited: String,
+    eye_colors: String,
+    hair_colors: String,
+    homeworld: Option<String>,
+    language: String,
+    name: String,
+    people: Vec<String>,
+    films: Vec<String>,
+    skin_colors: String,
+    url: String,
+}
+
+impl RequestHandler for Planet {
+    const URL_PATH: &'static str = "/planets/";
+}
+
+impl RequestHandler for People {
+    const URL_PATH: &'static str = "/people/";
+}
+
+impl RequestHandler for Film {
+    const URL_PATH: &'static str = "/films/";
+}
+
+impl RequestHandler for Starship {
+    const URL_PATH: &'static str = "/starships/";
+}
+
+impl RequestHandler for Vehicle {
+    const URL_PATH: &'static str = "/vehicles/";
+}
+
+impl RequestHandler for Species {
+    const URL_PATH: &'static str = "/species/";
+}

src/requests.rs

@@ -0,0 +1,45 @@
+use crate::common::{ListData, RequestFailed};
+
+use reqwest::StatusCode;
+use serde::de::DeserializeOwned;
+use std::error::Error;
+
+const API_URL: &'static str = "https://swapi.dev/api";
+
+type Output<T> = std::result::Result<T, Box<dyn Error>>;
+
+/// Main request handler for query starwars objects
+pub trait RequestHandler {
+    const URL_PATH: &'static str;
+
+    fn get(id: usize) -> Output<Box<Self>>
+    where
+        Self: DeserializeOwned,
+    {
+        match reqwest::blocking::get(API_URL.to_owned() + Self::URL_PATH + &id.to_string()) {
+            Ok(res) => match res.status() {
+                StatusCode::OK => Ok(Box::new(res.json::<Self>().unwrap())),
+                _ => Err(RequestFailed(res).into()),
+            },
+            Err(error) => Err(error.into()),
+        }
+    }
+
+    fn list(page: Option<usize>) -> Output<Box<ListData<Self>>>
+    where
+        Self: DeserializeOwned,
+    {
+        let page = match page {
+            Some(x) => "?page=".to_owned() + &x.to_string(),
+            None => String::from("?page=1"),
+        };
+
+        match reqwest::blocking::get(API_URL.to_owned() + Self::URL_PATH + &page) {
+            Ok(res) => match res.status() {
+                StatusCode::OK => Ok(Box::new(res.json::<ListData<Self>>().unwrap())),
+                _ => Err(RequestFailed(res).into()),
+            },
+            Err(error) => Err(error.into()),
+        }
+    }
+}