kiutils_kicad 0.3.0

Typed KiCad document model and codecs for seamless, lossless edit round-trips
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

use crate::diagnostic::{Diagnostic, Severity};
use crate::version::VersionPolicy;

pub(crate) fn collect_version_diagnostics(version: Option<i32>) -> Vec<Diagnostic> {
    let policy = VersionPolicy::default();
    let mut diagnostics = Vec::new();

    if let Some(v) = version {
        if policy.reject_older && !policy.accepts(v) {
            diagnostics.push(Diagnostic {
                severity: Severity::Warning,
                code: "legacy_format",
                message: format!(
                    "version {v} is older than v9 target; parsing in compatibility mode"
                ),
                span: None,
                hint: Some("parser support for pre-v9 token variants is best-effort".to_string()),
            });
        }

        if policy.is_future_for_target(v) {
            diagnostics.push(Diagnostic {
                severity: Severity::Warning,
                code: "future_format",
                message: format!(
                    "version {v} is newer than target {:?}; keeping lossless CST for compatibility",
                    policy.target
                ),
                span: None,
                hint: Some("consider newer parser coverage for this token set".to_string()),
            });
        }
    }

    diagnostics
}