gen-types 0.1.5

gen — typed IR for the universal package-manager → build-system engine. One typed Manifest / Package / Dependency / Feature / Constraint / Lockfile / Workspace / BuildStep / Derivation shape that every ecosystem reduces to. Foundation crate; the only thing every adapter + renderer + cache backend depends on. See theory/GEN.md for the full design.
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

//! Typed [`Registry`] — where a package was fetched from.
//!
//! One variant per upstream registry the fleet's adapters speak to.
//! Adapters set the variant during parse; renderers consult it to
//! emit the correct download URL / cache key.

use serde::{Deserialize, Serialize};

/// Stable identifier for the upstream package registry.
#[derive(Clone, Debug, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(tag = "kind", rename_all = "kebab-case")]
pub enum Registry {
    /// crates.io (default for Cargo).
    CratesIo,
    /// npmjs.org (default for npm / yarn / pnpm).
    Npm,
    /// rubygems.org (default for Bundler / Gem).
    RubyGems,
    /// pypi.org (default for pip / poetry).
    PyPi,
    /// proxy.golang.org (default for go modules).
    GoProxy,
    /// hex.pm (default for Mix / Hex).
    Hex,
    /// hackage.haskell.org (default for Cabal).
    Hackage,
    /// packagist.org (default for Composer).
    Packagist,
    /// Maven Central + Gradle plugin portal.
    Maven,
    /// pub.dev (Dart / Flutter).
    Pub,
    /// OCI registry (helm charts via OCI, also caixa).
    Oci { registry_url: String },
    /// Operator-self-hosted private registry — adapters declare the
    /// URL + auth shape via shikumi config.
    Private {
        url: String,
        protocol: String,
    },
    /// Source-only — no registry; the package is consumed as a path
    /// or git ref, never published.
    None,
}

impl Registry {
    /// Stable short identifier (for cache keys + diagnostics).
    #[must_use]
    pub const fn as_str(&self) -> &'static str {
        match self {
            Self::CratesIo => "crates-io",
            Self::Npm => "npm",
            Self::RubyGems => "rubygems",
            Self::PyPi => "pypi",
            Self::GoProxy => "go-proxy",
            Self::Hex => "hex",
            Self::Hackage => "hackage",
            Self::Packagist => "packagist",
            Self::Maven => "maven",
            Self::Pub => "pub",
            Self::Oci { .. } => "oci",
            Self::Private { .. } => "private",
            Self::None => "none",
        }
    }
}

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

    #[test]
    fn as_str_covers_every_variant_stably() {
        for r in [
            Registry::CratesIo,
            Registry::Npm,
            Registry::RubyGems,
            Registry::PyPi,
            Registry::GoProxy,
            Registry::Hex,
            Registry::Hackage,
            Registry::Packagist,
            Registry::Maven,
            Registry::Pub,
            Registry::Oci {
                registry_url: "ghcr.io".into(),
            },
            Registry::Private {
                url: "https://internal".into(),
                protocol: "cargo-v1".into(),
            },
            Registry::None,
        ] {
            assert!(!r.as_str().is_empty());
        }
    }

    #[test]
    fn round_trips_through_serde() {
        let r = Registry::Oci {
            registry_url: "ghcr.io/pleme-io".into(),
        };
        let j = serde_json::to_string(&r).unwrap();
        let parsed: Registry = serde_json::from_str(&j).unwrap();
        assert_eq!(r, parsed);
    }
}