shopify-client 1.2.0

Type-safe, async Rust client for the Shopify Admin and Storefront APIs
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

pub mod queries;
pub mod remote;

use std::sync::Arc;

use crate::common::types::{APIError, RequestCallbacks};
use crate::common::ServiceContext;
use crate::storefront::generated::types::content::{
    GetArticlesArgs, GetBlogArticlesArgs, GetBlogsArgs, GetPagesArgs,
};
use crate::storefront::generated::types::responses::{
    ArticleResponse, ArticlesResponse, BlogResponse, BlogsResponse, MenuResponse, PageResponse,
    PagesResponse,
};

/// Selector for `ContentBlogs.get_with_articles`.
pub enum BlogRef {
    Id(String),
    Handle(String),
}

pub struct Content {
    pub pages: ContentPages,
    pub blogs: ContentBlogs,
    pub articles: ContentArticles,
    pub menus: ContentMenus,
}

impl Content {
    pub fn new(
        shop_url: Arc<String>,
        version: Arc<String>,
        access_token: Arc<String>,
        callbacks: Arc<RequestCallbacks>,
    ) -> Self {
        Self::with_ctx(ServiceContext::new(
            shop_url,
            version,
            access_token,
            callbacks,
        ))
    }

    /// Build the service from a shared `ServiceContext`.
    pub fn with_ctx(ctx: ServiceContext) -> Self {
        Self {
            pages: ContentPages { ctx: ctx.clone() },
            blogs: ContentBlogs { ctx: ctx.clone() },
            articles: ContentArticles { ctx: ctx.clone() },
            // Last sub-service consumes the ctx.
            menus: ContentMenus { ctx },
        }
    }
}

pub struct ContentPages {
    pub(crate) ctx: ServiceContext,
}

impl ContentPages {
    pub async fn get_by_id(&self, id: &str) -> Result<PageResponse, APIError> {
        remote::get_page_by_id(&self.ctx, id).await
    }

    pub async fn get_by_handle(&self, handle: &str) -> Result<PageResponse, APIError> {
        remote::get_page_by_handle(&self.ctx, handle).await
    }

    pub async fn get_many(&self, args: GetPagesArgs) -> Result<PagesResponse, APIError> {
        remote::get_pages(&self.ctx, args).await
    }
}

pub struct ContentBlogs {
    pub(crate) ctx: ServiceContext,
}

impl ContentBlogs {
    pub async fn get_by_id(&self, id: &str) -> Result<BlogResponse, APIError> {
        remote::get_blog_by_id(&self.ctx, id).await
    }

    pub async fn get_by_handle(&self, handle: &str) -> Result<BlogResponse, APIError> {
        remote::get_blog_by_handle(&self.ctx, handle).await
    }

    pub async fn get_many(&self, args: GetBlogsArgs) -> Result<BlogsResponse, APIError> {
        remote::get_blogs(&self.ctx, args).await
    }

    pub async fn get_with_articles(
        &self,
        selector: BlogRef,
        args: GetBlogArticlesArgs,
    ) -> Result<BlogResponse, APIError> {
        remote::get_blog_with_articles(&self.ctx, selector, args).await
    }
}

pub struct ContentArticles {
    pub(crate) ctx: ServiceContext,
}

impl ContentArticles {
    pub async fn get_by_id(&self, id: &str) -> Result<ArticleResponse, APIError> {
        remote::get_article_by_id(&self.ctx, id).await
    }

    pub async fn get_many(&self, args: GetArticlesArgs) -> Result<ArticlesResponse, APIError> {
        remote::get_articles(&self.ctx, args).await
    }
}

pub struct ContentMenus {
    pub(crate) ctx: ServiceContext,
}

impl ContentMenus {
    pub async fn get_by_handle(&self, handle: &str) -> Result<MenuResponse, APIError> {
        remote::get_menu(&self.ctx, handle).await
    }
}