code_passenger 0.3.0

Scans a Rust workspace with klepto and does the writing: feature gates across every crate from one features document, proven by cargo check, Cargo.toml edits, file headers from the plan, and the history of it.
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

use serde::{Deserialize, Serialize};
use std::collections::BTreeMap;

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PassengerConfig {
    pub schema: u32,
    pub passenger_version: String,  // e.g. "0.3.1"
    pub default_branch: String,     // e.g. "main"
    pub hash_algo: String,          // "sha256"
    pub compress: bool,             // store blobs compressed
    /// What is tracked: the files klepto's scan reads and the features document.
    #[serde(default = "tracked_default")]
    pub tracked: String,
}

fn tracked_default() -> String {
    "klepto-scan+features-document".to_string()
}

impl Default for PassengerConfig {
    fn default() -> Self {
        Self {
            schema: 1,
            passenger_version: "0.1.0".to_string(),
            default_branch: "main".to_string(),
            hash_algo: "sha256".to_string(),
            compress: true,
            tracked: tracked_default(),
        }
    }
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PassengerState {
    pub schema: u32,
    pub created_ms: i64,
    /// passenger_version -> next sequence integer
    pub next_seq: BTreeMap<String, u64>,
}

impl Default for PassengerState {
    fn default() -> Self {
        Self {
            schema: 1,
            created_ms: chrono::Utc::now().timestamp_millis(),
            next_seq: BTreeMap::new(),
        }
    }
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PassengerCommit {
    pub schema: u32,
    pub id: String,                 // "S000042"
    pub ts_ms: i64,
    pub passenger_version: String,
    pub branch: String,
    pub parents: Vec<String>,
    pub manifest: Manifest,
    pub stats: CommitStats,
    pub note: Option<String>,
    pub prev_hash: Option<String>,
    pub hash: String,               // hash of this commit content (chainable)
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Manifest {
    pub kind: ManifestKind,
    pub base: Option<String>, // if delta
    pub files: BTreeMap<String, FileEntry>, // rel_path -> entry
    pub deleted: Vec<String>, // if delta
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum ManifestKind {
    Full,
    Delta,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FileEntry {
    pub hash: String,   // sha256 hex
    pub bytes: u64,
    pub lines: u64,
    /// klepto could not parse the file (the parser's message): its bytes are
    /// kept by digest all the same; the scan beside the snapshot leaves it out.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub unparsed: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct CommitStats {
    pub changed_files: usize,
    pub added_lines: usize,
    pub removed_lines: usize,
    pub paste_score: f32,   // placeholder for later
}