coursemap 0.1.5

A tool to visualize course dependencies from Quarto/Markdown documents
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

//! Command-line interface for the course map tool

use clap::{Parser, Subcommand, ValueEnum};
use std::path::PathBuf;

#[derive(Parser)]
#[command(about = "Generate course dependency maps from Quarto/Markdown documents")]
#[command(version)]
#[command(subcommand_precedence_over_arg = true)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Option<Commands>,

    /// Input directory containing course documents (when no subcommand is used)
    pub input: Option<PathBuf>,

    /// Output file path
    #[arg(short, long, default_value = "course_map.svg")]
    pub output: PathBuf,

    /// Output format
    #[arg(short, long, default_value = "svg")]
    pub format: OutputFormat,

    /// Configuration file path
    #[arg(short, long)]
    pub config: Option<PathBuf>,

    /// Verbose output
    #[arg(short, long)]
    pub verbose: bool,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Show current configuration
    #[command(name = "show-config")]
    ShowConfig {
        /// Configuration file path
        #[arg(short, long)]
        config: Option<PathBuf>,
    },
}

#[derive(Clone, ValueEnum)]
pub enum OutputFormat {
    /// SVG format
    Svg,
    /// PNG format
    Png,
    /// DOT format (Graphviz source)
    Dot,
}

impl std::fmt::Display for OutputFormat {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            OutputFormat::Svg => write!(f, "svg"),
            OutputFormat::Png => write!(f, "png"),
            OutputFormat::Dot => write!(f, "dot"),
        }
    }
}

impl Cli {
    /// Parse command line arguments
    pub fn parse_args() -> Self {
        Self::parse()
    }

    /// Get the input directory as a string
    pub fn input_dir(&self) -> Option<&str> {
        self.input.as_ref().and_then(|p| p.to_str())
    }

    /// Get the output path as a string
    pub fn output_path(&self) -> &str {
        self.output.to_str().unwrap_or("course_map.svg")
    }

    /// Get the format as a string
    pub fn format_str(&self) -> String {
        self.format.to_string()
    }
}