Skip to main content

ipatool_kit/
helpers.rs

1//! iTunes / App Store pure helpers (no network).
2
3use std::collections::BTreeMap;
4
5use serde::{Deserialize, Serialize};
6use serde_json::Value;
7
8#[derive(Debug, Clone, Default, Serialize, Deserialize, PartialEq)]
9pub struct App {
10    pub id: i64,
11    #[serde(rename = "bundleID", default)]
12    pub bundle_id: String,
13    #[serde(default)]
14    pub name: String,
15    #[serde(default)]
16    pub version: String,
17    #[serde(default)]
18    pub price: f64,
19}
20
21#[derive(Debug, Clone, Default, Serialize, Deserialize, PartialEq)]
22pub struct SearchResult {
23    pub count: i32,
24    pub results: Vec<App>,
25}
26
27pub fn url_encode(s: &str) -> String {
28    let mut out = String::new();
29    for b in s.bytes() {
30        match b {
31            b'A'..=b'Z' | b'a'..=b'z' | b'0'..=b'9' | b'-' | b'_' | b'.' | b'~' => {
32                out.push(b as char);
33            }
34            _ => {
35                out.push('%');
36                out.push_str(&format!("{b:02X}"));
37            }
38        }
39    }
40    out
41}
42
43pub fn build_query(params: &BTreeMap<String, String>) -> String {
44    let mut q = String::new();
45    for (k, v) in params {
46        if !q.is_empty() {
47            q.push('&');
48        }
49        q.push_str(&url_encode(k));
50        q.push('=');
51        q.push_str(&url_encode(v));
52    }
53    q
54}
55
56pub fn app_from_json(j: &Value) -> App {
57    let mut a = App::default();
58    if let Some(v) = j.get("trackId").and_then(|x| x.as_i64()) {
59        a.id = v;
60    }
61    if let Some(v) = j.get("bundleId").and_then(|x| x.as_str()) {
62        a.bundle_id = v.to_string();
63    }
64    if let Some(v) = j.get("trackName").and_then(|x| x.as_str()) {
65        a.name = v.to_string();
66    }
67    if let Some(v) = j.get("version").and_then(|x| x.as_str()) {
68        a.version = v.to_string();
69    }
70    if let Some(v) = j.get("price").and_then(|x| x.as_f64()) {
71        a.price = v;
72    }
73    a
74}
75
76pub fn parse_search_json(body: &str) -> SearchResult {
77    let mut out = SearchResult::default();
78    let Ok(j) = serde_json::from_str::<Value>(body) else {
79        return out;
80    };
81    if let Some(c) = j.get("resultCount").and_then(|x| x.as_i64()) {
82        out.count = c as i32;
83    }
84    if let Some(arr) = j.get("results").and_then(|x| x.as_array()) {
85        for item in arr {
86            out.results.push(app_from_json(item));
87        }
88    }
89    out
90}