a4-cli 0.13.0

CLI tool for generating TypeScript SDKs from Arete stream specifications
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

//! Latest-version pointer: `https://docs.arete.run/a4/latest.json`.
//!
//! Version discovery never uses the GitHub REST API (60 req/h unauthenticated)
//! and never `releases/latest` (this repo cuts many non-CLI releases). The
//! pointer is bumped by release-please (`release-please-config.json`,
//! `extra-files`) and served by the docs site.

use std::time::Duration;

use anyhow::{anyhow, Context, Result};
use serde::Deserialize;

use super::platform::latest_url;

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct LatestPointer {
    #[serde(default)]
    pub schema_version: u32,
    pub version: String,
}

/// Fetch the latest pointer with a hard timeout. Errors are returned, never
/// printed; callers decide whether silence is appropriate.
pub fn fetch_latest(timeout: Duration) -> Result<LatestPointer> {
    let url = latest_url();
    let client = reqwest::blocking::Client::builder()
        .timeout(timeout)
        .user_agent(format!("a4/{}", env!("CARGO_PKG_VERSION")))
        .build()
        .context("Failed to build HTTP client")?;
    let response = client
        .get(&url)
        .send()
        .with_context(|| format!("Failed to fetch {url}"))?;
    if !response.status().is_success() {
        return Err(anyhow!("{url} returned HTTP {}", response.status()));
    }
    let pointer: LatestPointer = response
        .json()
        .with_context(|| format!("{url} is not a valid latest.json"))?;
    semver::Version::parse(&pointer.version)
        .with_context(|| format!("{url} carries a non-semver version {:?}", pointer.version))?;
    Ok(pointer)
}

/// Compare two semver strings: `Some(true)` when `latest` is newer than
/// `current`, `None` when either fails to parse.
pub fn is_newer(latest: &str, current: &str) -> Option<bool> {
    let latest = semver::Version::parse(latest).ok()?;
    let current = semver::Version::parse(current).ok()?;
    Some(latest > current)
}

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

    #[test]
    fn newer_detection_handles_prerelease_and_garbage() {
        assert_eq!(is_newer("0.14.0", "0.13.0"), Some(true));
        assert_eq!(is_newer("0.13.0", "0.13.0"), Some(false));
        assert_eq!(is_newer("0.13.0", "0.14.0"), Some(false));
        assert_eq!(is_newer("0.13.0", "0.13.0-rc.1"), Some(true));
        assert_eq!(is_newer("latest", "0.13.0"), None);
    }
}