gitlab/api/groups/members/
member.rs

1// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
2// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
3// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
4// option. This file may not be copied, modified, or distributed
5// except according to those terms.
6
7use derive_builder::Builder;
8
9use crate::api::common::NameOrId;
10use crate::api::endpoint_prelude::*;
11
12/// Query a single member of a group.
13#[derive(Debug, Builder, Clone)]
14pub struct GroupMember<'a> {
15    /// The group to query for membership.
16    #[builder(setter(into))]
17    group: NameOrId<'a>,
18    /// The ID of the user.
19    user: u64,
20}
21
22impl<'a> GroupMember<'a> {
23    /// Create a builder for the endpoint.
24    pub fn builder() -> GroupMemberBuilder<'a> {
25        GroupMemberBuilder::default()
26    }
27}
28
29impl Endpoint for GroupMember<'_> {
30    fn method(&self) -> Method {
31        Method::GET
32    }
33
34    fn endpoint(&self) -> Cow<'static, str> {
35        format!("groups/{}/members/{}", self.group, self.user).into()
36    }
37}
38
39#[cfg(test)]
40mod tests {
41    use crate::api::groups::members::{GroupMember, GroupMemberBuilderError};
42    use crate::api::{self, Query};
43    use crate::test::client::{ExpectedUrl, SingleTestClient};
44
45    #[test]
46    fn group_and_user_are_needed() {
47        let err = GroupMember::builder().build().unwrap_err();
48        crate::test::assert_missing_field!(err, GroupMemberBuilderError, "group");
49    }
50
51    #[test]
52    fn group_is_needed() {
53        let err = GroupMember::builder().user(1).build().unwrap_err();
54        crate::test::assert_missing_field!(err, GroupMemberBuilderError, "group");
55    }
56
57    #[test]
58    fn user_is_needed() {
59        let err = GroupMember::builder().group(1).build().unwrap_err();
60        crate::test::assert_missing_field!(err, GroupMemberBuilderError, "user");
61    }
62
63    #[test]
64    fn group_and_user_are_sufficient() {
65        GroupMember::builder().group(1).user(1).build().unwrap();
66    }
67
68    #[test]
69    fn endpoint() {
70        let endpoint = ExpectedUrl::builder()
71            .endpoint("groups/group%2Fsubgroup/members/1")
72            .build()
73            .unwrap();
74        let client = SingleTestClient::new_raw(endpoint, "");
75
76        let endpoint = GroupMember::builder()
77            .group("group/subgroup")
78            .user(1)
79            .build()
80            .unwrap();
81        api::ignore(endpoint).query(&client).unwrap();
82    }
83}
gitlab/api/groups/members/member.rs

gitlab/api/groups/members/
member.rs
