vkclient 6.0.0

Vk Api client implementation
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

use crate::Version;
use serde::de::DeserializeOwned;

/// # API method description
/// Wrapper for strong typed API method description.
///
/// Example
/// ```rust
/// use vkclient::{List, Version, VkApi, VkApiWrapper};
/// use serde::{Serialize, Deserialize};
///
/// #[derive(Serialize, Debug)]
/// struct UsersGetRequest<'a> {
///     user_ids: List<Vec<usize>>,
///     fields: List<Vec<&'a str>>,
/// }
///
/// #[derive(Deserialize, Debug)]
/// struct UsersGetResponse {
///     id: i64,
///     first_name: String,
///     last_name: String,
///     sex: usize,
/// }
///
/// impl<'a> VkApiWrapper for UsersGetRequest<'a> {
///     type Response = UsersGetResponse;
///
///     fn get_method_name() -> &'static str {
///         "users.get"
///     }
///
///     fn get_version() -> Version {
///         Version(5, 131)
///     }
/// }
///
/// fn demo() {
///     let access_token = String::new();
///     let client: VkApi = vkclient::VkApiBuilder::new(access_token).into();
///
///     async {
///         let users: UsersGetResponse = client
///             .send_request_with_wrapper(UsersGetRequest {
///                 user_ids: List(vec![1, 2]),
///                 fields: List(vec!["id", "sex"]),
///             })
///             .await
///             .expect("vk api error");
///         let _ = users;
///     };
/// }
/// ```
pub trait VkApiWrapper {
    type Response: DeserializeOwned;

    /// Method name
    fn get_method_name() -> &'static str;

    /// API version that required for this method
    fn get_version() -> Version {
        Version::default()
    }
}