cloud_terrastodon_azure_devops 0.35.0

Helpers for interacting with Azure DevOps for the Cloud Terrastodon project
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

use chrono::DateTime;
use chrono::Utc;
use cloud_terrastodon_azure_devops_types::AzureDevOpsLicenseRule;
use cloud_terrastodon_azure_devops_types::AzureDevOpsLicenseType;
use cloud_terrastodon_azure_devops_types::AzureDevOpsOrganizationUrl;
use cloud_terrastodon_azure_devops_types::AzureDevOpsUserArgument;
use cloud_terrastodon_azure_devops_types::AzureDevOpsUserId;
use cloud_terrastodon_azure_devops_types::LastAccessedDate;
use cloud_terrastodon_command::CacheKey;
use cloud_terrastodon_command::CacheableCommand;
use cloud_terrastodon_command::CommandBuilder;
use cloud_terrastodon_command::CommandKind;
use cloud_terrastodon_command::async_trait;
use serde::Deserialize;
use serde_json::Value;
use std::path::PathBuf;
use std::time::Duration;
use tracing::debug;

/// <https://learn.microsoft.com/en-us/rest/api/azure/devops/memberentitlementmanagement/user-entitlements/update-user-entitlement?view=azure-devops-rest-7.1>
#[must_use = "This is an unsent request, you must .await it"]
pub struct AzureDevOpsUserLicenseEntitlementUpdateRequest<'a> {
    pub org_url: &'a AzureDevOpsOrganizationUrl,
    pub user: AzureDevOpsUserArgument<'a>,
    pub license_kind: AzureDevOpsLicenseType,
}

pub fn update_azure_devops_user_license_entitlement<'a>(
    org_url: &'a AzureDevOpsOrganizationUrl,
    user: impl Into<AzureDevOpsUserArgument<'a>>,
    license_kind: AzureDevOpsLicenseType,
) -> AzureDevOpsUserLicenseEntitlementUpdateRequest<'a> {
    AzureDevOpsUserLicenseEntitlementUpdateRequest {
        org_url,
        user: user.into(),
        license_kind,
    }
}

#[async_trait]
impl<'a> CacheableCommand for AzureDevOpsUserLicenseEntitlementUpdateRequest<'a> {
    type Output = AzureDevOpsLicenseEntitlementUpdateResponse;

    fn cache_key(&self) -> CacheKey {
        CacheKey {
            path: PathBuf::from_iter([
                "az",
                "devops",
                self.org_url.organization_name.as_ref(),
                "license",
                "entitlement",
                "update-user",
                &self.user.to_string(),
            ]),
            valid_for: Duration::ZERO, // this is an update operation, so no caching
        }
    }
    async fn run(self) -> eyre::Result<Self::Output> {
        debug!(
            user = %self.user,
            license_kind = ?self.license_kind,
            "Updating license entitlement for user",
        );
        let mut cmd = CommandBuilder::new(CommandKind::AzureCLI);
        cmd.args([
            "devops",
            "user",
            "update",
            "--user",
            &self.user.to_string(),
            "--organization",
            &self.org_url.to_string(),
            "--license-type",
            match &self.license_kind {
                AzureDevOpsLicenseType::AccountExpress => "express",
                AzureDevOpsLicenseType::AccountStakeholder => "stakeholder",
                AzureDevOpsLicenseType::AccountAdvanced => "advanced",
                AzureDevOpsLicenseType::MsdnEligible => "professional",
                AzureDevOpsLicenseType::MsdnEnterprise => "professional",
                AzureDevOpsLicenseType::MsdnProfessional => "professional",
                AzureDevOpsLicenseType::Other(s) => s,
                AzureDevOpsLicenseType::None => "none",
            },
        ]);
        cmd.cache(self.cache_key());
        Ok(cmd.run().await?)
    }
}

cloud_terrastodon_command::impl_cacheable_into_future!(AzureDevOpsUserLicenseEntitlementUpdateRequest<'a>, 'a);

#[derive(Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct AzureDevOpsLicenseEntitlementUpdateResponse {
    pub access_level: AzureDevOpsLicenseRule,
    pub date_created: DateTime<Utc>,
    pub extensions: Vec<Value>,
    pub group_assignments: Vec<Value>,
    pub id: AzureDevOpsUserId,
    pub last_accessed_date: LastAccessedDate,
    pub project_entitlements: Vec<Value>,
    pub user: Value,
}