smugmug 0.7.0

SmugMug APIv2 Client Library
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
93
94
95
96
97
98
99
100
101
102
103

/*
 * Copyright (c) 2025 Craig Hamilton and Contributors.
 * Licensed under either of
 *  - Apache License, Version 2.0 <http://www.apache.org/licenses/LICENSE-2.0> OR
 *  - MIT license <http://opensource.org/licenses/MIT>
 *  at your option.
 */

macro_rules! obj_from_url {
    ( $c:expr, $url: expr, $rt: ty, $r: ident) => {{
        let params = vec![("_verbosity", "1")];
        $c.get::<$rt>($url, Some(&params))
            .await?
            .payload
            .ok_or(SmugMugError::ResponseMissing())
            .map(|mut v| {
                v.$r.client = Some($c.clone());
                v.$r
            })
    }};
}

macro_rules! obj_update_from_url {
    ( $c:expr, $url: expr, $d: expr,$rt: ty, $r: ident) => {{
        let params = vec![("_verbosity", "1")];
        $c.patch::<$rt>($url, $d, Some(&params))
            .await?
            .payload
            .ok_or(SmugMugError::ResponseMissing())
            .map(|mut v| {
                v.$r.client = Some($c.clone());
                v.$r
            })
    }};
}

macro_rules! obj_update_from_uri {
    ( $c:expr, $uri: expr, $d: expr,$rt: ty, $r: ident) => {{
        let req_url = url::Url::parse(API_ORIGIN)?.join($uri)?;
        obj_update_from_url!($c, req_url.as_str(), $d, $rt, $r)
    }};
}

macro_rules! objs_from_id_slice {
    ( $c:expr, $ids:expr, $uri:expr, $rt: ty, $r: ident) => {{
        if $ids.is_empty() {
            return Ok(Vec::new());
        }
        let params = vec![("_verbosity", "1")];
        let req_url = url::Url::parse(API_ORIGIN)?
            .join($uri)?
            .join($ids.join(",").as_str())?;
        // println!("multi-get url: {}", req_url.as_str());
        $c.get::<$rt>(req_url.as_str(), Some(&params))
            .await?
            .payload
            .ok_or(SmugMugError::ResponseMissing())
            .map(|v| {
                v.$r.into_iter()
                    .map(|mut v| {
                        v.client = Some($c.clone());
                        v
                    })
                    .collect()
            })
    }};
}

macro_rules! stream_children_from_url {
    ( $c:expr, $url: expr, $params:expr, $rt: ty, $r: ident) => {{
        let params = vec![("_verbosity", "1")];

        try_stream! {
            if let Some(url) = $url {
                // The Pages->NextPage doesn't include verbosity so parsing original params
                // and dealing with verbosity seperately
                let mut req_url = url::Url::parse_with_params(API_ORIGIN, $params)?.join(url)?;
                loop {
                    let resp = $c.get::<$rt>(
                        req_url.as_str(), Some(&params)
                    ).await?
                    .payload
                    .ok_or(SmugMugError::ResponseMissing())?;
                    for mut item in resp.$r {
                        item.client = Some($c.clone());
                        yield item
                    }

                    if let Some(next_page) = resp.pages.and_then(|p| p.next_page) {
                        req_url = url::Url::parse(API_ORIGIN)?.join(&next_page)?;
                    } else {
                        break;
                    }
                }
            }
        }
    }};
}

pub(crate) use {
    obj_from_url, obj_update_from_uri, obj_update_from_url, objs_from_id_slice,
    stream_children_from_url,
};