soar-registry 0.1.1

Registry management for soar package manager
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

//! Nest data structures.
//!
//! Nests are user-defined package collections that can be added to soar,
//! similar to PPAs in apt or custom repositories.

use serde::{Deserialize, Serialize};

/// Represents a user-defined package collection (nest).
///
/// Nests allow users to add custom package sources beyond the default
/// repositories. They can be hosted on GitHub or any HTTP server that
/// serves JSON metadata.
///
/// # URL Formats
///
/// Nests support two URL formats:
/// - `github:owner/repo` - Fetches from GitHub releases
/// - Direct HTTP/HTTPS URLs - Fetches from the specified URL
#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Nest {
    /// Unique identifier for the nest in the local database.
    pub id: i64,
    /// Human-readable name for the nest.
    pub name: String,
    /// URL or GitHub shorthand for fetching nest metadata.
    pub url: String,
}

impl Nest {
    /// Creates a new nest with the specified parameters.
    ///
    /// # Arguments
    ///
    /// * `id` - Database identifier
    /// * `name` - Display name for the nest
    /// * `url` - Metadata URL (can be `github:owner/repo` or a direct URL)
    pub fn new(id: i64, name: String, url: String) -> Self {
        Self {
            id,
            name,
            url,
        }
    }
}