rlvgl 0.2.5

A modular, idiomatic Rust reimplementation of the LVGL graphics library for embedded and simulator use.
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! Tests for BSP mod generation and lib scanning.
#![cfg(feature = "creator")]
// The `#[path]` includes below pull in source modules from the
// `rlvgl-creator` binary; only a subset of their public surface is
// exercised by this test, so the unused helpers are expected.
#![allow(dead_code, clippy::too_many_arguments, clippy::duplicate_mod)]

#[path = "../src/bin/creator/bsp/af.rs"]
pub mod af;
#[path = "../src/bin/creator/bsp/ioc.rs"]
pub mod ioc;
#[path = "../src/bin/creator/bsp/ir.rs"]
pub mod ir;
mod bsp {
    pub use super::af;
    pub use super::ioc;
    pub use super::ir;
}
#[path = "../src/bin/creator/bsp_gen.rs"]
mod bsp_gen;
#[path = "../src/bin/creator/gen_lib.rs"]
mod gen_lib;

use minijinja::{Environment, context};
use std::collections::BTreeMap;
use std::fs;
use tempfile::tempdir;

#[test]
fn board_mod_respects_flags() {
    let tmp = tempdir().unwrap();
    bsp_gen::emit_board_mod(tmp.path(), true, false, true, false).unwrap();
    let text = fs::read_to_string(tmp.path().join("mod.rs")).unwrap();
    assert!(text.contains("pub mod hal;"));
    assert!(!text.contains("pub mod pac;"));
    assert!(text.contains("pub mod summary;"));
    assert!(!text.contains("pub mod pinreport;"));
}

#[test]
fn scan_tree_detects_forms() {
    let dir = tempdir().unwrap();
    let root = dir.path();
    fs::create_dir_all(root.join("foo/hal")).unwrap();
    fs::create_dir_all(root.join("foo/pac")).unwrap();
    fs::write(root.join("foo/hal/split.rs"), "").unwrap();
    fs::write(root.join("foo/pac/flat.rs"), "").unwrap();
    fs::write(root.join("foo/summary.rs"), "").unwrap();
    let mcus = gen_lib::scan_tree(root).unwrap();
    assert_eq!(mcus.len(), 1);
    let (slug, forms) = &mcus[0];
    assert_eq!(slug, "foo");
    assert!(forms.hal_split);
    assert!(!forms.hal_flat);
    assert!(!forms.pac_split);
    assert!(forms.pac_flat);
    assert!(forms.summary);
    assert!(!forms.pinreport);
}

#[test]
fn emit_lib_rs_uses_mod_files() {
    let dir = tempdir().unwrap();
    let root = dir.path();
    fs::create_dir_all(root.join("foo/hal")).unwrap();
    fs::write(root.join("foo/hal/split.rs"), "").unwrap();
    fs::write(root.join("foo/mod.rs"), "").unwrap();
    gen_lib::emit_lib_rs(root, root.join("lib.rs"), None, &[], None, false).unwrap();
    let text = fs::read_to_string(root.join("lib.rs")).unwrap();
    assert!(text.contains("pub mod foo;"));
}

#[test]
fn templates_skip_empty_pin_fns() {
    let mut env = Environment::new();
    env.add_template(
        "pac",
        include_str!("../src/bin/creator/bsp/templates/pac.rs.jinja"),
    )
    .unwrap();
    env.add_template(
        "hal",
        include_str!("../src/bin/creator/bsp/templates/hal.rs.jinja"),
    )
    .unwrap();
    let spec = context! {
        mcu => "STM32F0",
        pinctrl => Vec::<String>::new(),
        peripherals => BTreeMap::<String, String>::new(),
    };
    let pac = env
        .get_template("pac")
        .unwrap()
        .render(context! { spec => spec.clone(), grouped_writes => true, with_deinit => false })
        .unwrap();
    assert!(!pac.contains("pub fn configure_pins_pac"));
    let hal = env
        .get_template("hal")
        .unwrap()
        .render(context! { spec => spec, grouped_writes => true, with_deinit => false })
        .unwrap();
    assert!(!hal.contains("pub fn configure_pins_hal"));
}

#[test]
fn pac_split_omits_board_init() {
    let mut env = Environment::new();
    env.add_template(
        "pac",
        include_str!("../src/bin/creator/bsp/templates/pac.rs.jinja"),
    )
    .unwrap();
    let spec = context! {
        mcu => "STM32F0",
        pinctrl => Vec::<String>::new(),
        peripherals => BTreeMap::<String, String>::new(),
    };
    let pac = env
        .get_template("pac")
        .unwrap()
        .render(context! { spec => spec, grouped_writes => true, with_deinit => false, mod_name => "foo" })
        .unwrap();
    assert!(!pac.contains("init_board_pac"));
}