dvcli 0.4.0

CLI client for querying Gradle build information from Develocity
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

//! Data models for the Gradle Network Activity API response.
//!
//! Maps to `GET /api/builds/{id}/gradle-network-activity`.
//! Requires Gradle 3.5+ with Develocity Gradle Plugin 1.6+.

use serde::Deserialize;
use std::collections::HashMap;

/// Top-level response from `/api/builds/{id}/gradle-network-activity`.
#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct GradleNetworkActivity {
    /// Total number of network requests.
    pub network_request_count: i64,
    /// Total serial network request time in milliseconds.
    pub serial_network_request_time: i64,
    /// Total wall-clock network request time in milliseconds.
    pub wall_clock_network_request_time: i64,
    /// Total number of file downloads.
    pub file_download_count: i64,
    /// Total file download size in bytes.
    pub file_download_size: i64,
    /// Metrics broken down by HTTP method (e.g., "GET", "PUT").
    #[serde(default)]
    pub methods: HashMap<String, NetworkActivityMetrics>,
    /// Metrics broken down by repository URL.
    #[serde(default)]
    pub repositories: HashMap<String, NetworkActivityMetrics>,
    /// Metrics broken down by HTTP method + repository URL.
    #[serde(default)]
    pub repository_methods: HashMap<String, NetworkActivityMetrics>,
}

/// Network activity metrics for a subset of requests.
#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct NetworkActivityMetrics {
    /// Number of network requests.
    pub network_request_count: i64,
    /// Serial network request time in milliseconds.
    pub serial_network_request_time: i64,
    /// Number of file downloads.
    pub file_download_count: i64,
    /// File download size in bytes.
    pub file_download_size: i64,
    /// Wall-clock network request time in milliseconds.
    pub wall_clock_network_request_time: i64,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_gradle_network_activity_deserialize() {
        let json = r#"{
            "networkRequestCount": 42,
            "serialNetworkRequestTime": 5000,
            "wallClockNetworkRequestTime": 3000,
            "fileDownloadCount": 10,
            "fileDownloadSize": 1048576,
            "methods": {
                "GET": {
                    "networkRequestCount": 38,
                    "serialNetworkRequestTime": 4800,
                    "fileDownloadCount": 10,
                    "fileDownloadSize": 1048576,
                    "wallClockNetworkRequestTime": 2800
                },
                "HEAD": {
                    "networkRequestCount": 4,
                    "serialNetworkRequestTime": 200,
                    "fileDownloadCount": 0,
                    "fileDownloadSize": 0,
                    "wallClockNetworkRequestTime": 200
                }
            },
            "repositories": {
                "https://repo.example.com/maven2/": {
                    "networkRequestCount": 42,
                    "serialNetworkRequestTime": 5000,
                    "fileDownloadCount": 10,
                    "fileDownloadSize": 1048576,
                    "wallClockNetworkRequestTime": 3000
                }
            },
            "repositoryMethods": {
                "GET https://repo.example.com/maven2/": {
                    "networkRequestCount": 38,
                    "serialNetworkRequestTime": 4800,
                    "fileDownloadCount": 10,
                    "fileDownloadSize": 1048576,
                    "wallClockNetworkRequestTime": 2800
                }
            }
        }"#;

        let activity: GradleNetworkActivity = serde_json::from_str(json).unwrap();
        assert_eq!(activity.network_request_count, 42);
        assert_eq!(activity.serial_network_request_time, 5000);
        assert_eq!(activity.wall_clock_network_request_time, 3000);
        assert_eq!(activity.file_download_count, 10);
        assert_eq!(activity.file_download_size, 1048576);
        assert_eq!(activity.methods.len(), 2);
        assert_eq!(activity.methods["GET"].network_request_count, 38);
        assert_eq!(activity.methods["HEAD"].file_download_count, 0);
        assert_eq!(activity.repositories.len(), 1);
        assert_eq!(activity.repository_methods.len(), 1);
    }

    #[test]
    fn test_network_activity_metrics_deserialize() {
        let json = r#"{
            "networkRequestCount": 5,
            "serialNetworkRequestTime": 1200,
            "fileDownloadCount": 3,
            "fileDownloadSize": 204800,
            "wallClockNetworkRequestTime": 900
        }"#;

        let metrics: NetworkActivityMetrics = serde_json::from_str(json).unwrap();
        assert_eq!(metrics.network_request_count, 5);
        assert_eq!(metrics.serial_network_request_time, 1200);
        assert_eq!(metrics.file_download_count, 3);
        assert_eq!(metrics.file_download_size, 204800);
        assert_eq!(metrics.wall_clock_network_request_time, 900);
    }

    #[test]
    fn test_gradle_network_activity_empty_maps() {
        let json = r#"{
            "networkRequestCount": 0,
            "serialNetworkRequestTime": 0,
            "wallClockNetworkRequestTime": 0,
            "fileDownloadCount": 0,
            "fileDownloadSize": 0,
            "methods": {},
            "repositories": {},
            "repositoryMethods": {}
        }"#;

        let activity: GradleNetworkActivity = serde_json::from_str(json).unwrap();
        assert_eq!(activity.network_request_count, 0);
        assert!(activity.methods.is_empty());
        assert!(activity.repositories.is_empty());
        assert!(activity.repository_methods.is_empty());
    }
}