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

use crate::error::{PassengerError, Result};
use crate::model::{FeatureNote, FileReport, PlanSection};
use std::collections::BTreeSet;

pub trait HeaderPlan: Send + Sync {
    fn id(&self) -> &'static str;

    /// Rust rendering (pack supplies markers; plan decides sections + gate selection).
    fn render_for_rust(&self, report: &FileReport, begin: &str, end: &str) -> String;
}

/// v2 plan metadata: section ordering + gate selection rules.
/// (Doesn't replace HeaderPlan yet; it complements it.)
pub trait HeaderPlanV2: Send + Sync {
    fn id(&self) -> &'static str;

    fn sections(&self) -> &[PlanSection];

    fn select_gates(&self, notes: &[FeatureNote]) -> Vec<String> {
        let mut set = BTreeSet::<String>::new();
        for n in notes {
            if n.corpus && n.used_in_file {
                set.insert(n.feature_name.clone());
            }
        }
        set.into_iter().collect()
    }
}

#[cfg(feature = "plan_verbose")]
pub mod verbose;
#[cfg(feature = "plan_compact")]
pub mod compact;

/// A plan's gate selection (`HeaderPlanV2::select_gates`), by name.
pub fn get_plan_v2(plan: &str) -> Result<Box<dyn HeaderPlanV2>> {
    match plan {
        #[cfg(feature = "plan_verbose")]
        "verbose" => Ok(Box::new(verbose::VerbosePlan)),
        #[cfg(feature = "plan_compact")]
        "compact" => Ok(Box::new(compact::CompactPlan)),
        _ => Err(PassengerError::unsupported(format!("header plan '{plan}' not available"))),
    }
}

pub fn get_plan(plan: &str) -> Result<Box<dyn HeaderPlan>> {
    match plan {
        #[cfg(feature = "plan_verbose")]
        "verbose" => Ok(Box::new(verbose::VerbosePlan)),
        #[cfg(feature = "plan_compact")]
        "compact" => Ok(Box::new(compact::CompactPlan)),
        _ => Err(PassengerError::unsupported(format!("header plan '{plan}' not available"))),
    }
}