rustmotion 0.8.0

A CLI tool that renders motion design videos from JSON scenarios. No browser, no Node.js — just a single Rust binary.
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

use rustmotion::engine::preload::scenario_icon_names;
use rustmotion::engine::renderer::{
    icon_cache_dir, icon_source_cache_file, set_remote_icon_policy, RemoteIconPolicy,
};
use rustmotion::error::Result;
use rustmotion::loader::load_scenario_from_source;
use std::path::{Path, PathBuf};

fn scenario_at(file: &Path) -> Result<rustmotion::schema::ResolvedScenario> {
    load_scenario_from_source(Some(&PathBuf::from(file)), None)
}

fn icons_named_by(file: &Path) -> Result<Vec<String>> {
    Ok(scenario_icon_names(&scenario_at(file)?))
}

fn split_by_cache_presence(icons: &[String]) -> (Vec<String>, Vec<String>) {
    let cache_dir = icon_cache_dir();
    icons.iter().cloned().partition(|icon| {
        icon_source_cache_file(&cache_dir, icon)
            .metadata()
            .is_ok_and(|m| m.len() > 0)
    })
}

pub fn cmd_icons_check(file: &Path, quiet: bool) -> Result<()> {
    let icons = icons_named_by(file)?;
    let (cached, missing) = split_by_cache_presence(&icons);

    if quiet {
        for icon in &missing {
            println!("{icon}");
        }
        return Ok(());
    }

    println!("Icon cache: {}", icon_cache_dir().display());
    println!(
        "{} icon(s) named, {} already cached",
        icons.len(),
        cached.len()
    );

    if missing.is_empty() {
        println!("Nothing to fetch — this scenario renders offline.");
        return Ok(());
    }

    println!("\n{} missing:", missing.len());
    for icon in &missing {
        println!("  {icon}");
    }
    println!(
        "\nRun `rustmotion icons prefetch -f {}` to download them.",
        file.display()
    );
    Ok(())
}

pub fn cmd_icons_prefetch(file: &Path, quiet: bool) -> Result<()> {
    let icons = icons_named_by(file)?;
    let (_, missing) = split_by_cache_presence(&icons);

    if missing.is_empty() {
        if !quiet {
            println!(
                "All {} icon(s) are already in {}.",
                icons.len(),
                icon_cache_dir().display()
            );
        }
        return Ok(());
    }

    set_remote_icon_policy(RemoteIconPolicy::Allow);

    let scenario = scenario_at(file)?;
    for view in &scenario.views {
        rustmotion::engine::preload::prefetch_icons(&view.scenes)?;
    }

    let (cached_after, still_missing) = split_by_cache_presence(&icons);
    if !quiet {
        println!(
            "Fetched {} icon(s) into {}. {} of {} now cached.",
            missing.len() - still_missing.len(),
            icon_cache_dir().display(),
            cached_after.len(),
            icons.len()
        );
    }
    Ok(())
}