cli-tutor 0.3.0

Interactive terminal app for learning Unix command-line tools
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

// free_practice.VIEW.1 — sandbox view with no expected-output matching
use crate::app::{App, SubmitState};
use crate::ui::input_bar;
use ratatui::{
    layout::{Constraint, Direction, Layout, Rect},
    style::{Color, Modifier, Style},
    text::{Line, Span},
    widgets::{Block, Borders, Paragraph, Wrap},
    Frame,
};

pub fn render(app: &App, frame: &mut Frame, area: Rect) {
    let nc = app.config.no_color;

    let chunks = Layout::default()
        .direction(Direction::Vertical)
        .constraints([
            Constraint::Length(3), // header info
            Constraint::Length(3), // input bar
            Constraint::Min(4),    // output
        ])
        .split(area);

    // free_practice.VIEW.2 — informational header
    let header = Paragraph::new(Line::from(vec![
        Span::styled(
            "Free Practice",
            crate::ui::s(
                Style::default()
                    .fg(Color::Cyan)
                    .add_modifier(Modifier::BOLD),
                nc,
            ),
        ),
        Span::raw("  — type any command and press Enter. No expected output is checked."),
    ]))
    .block(Block::default().borders(Borders::ALL));
    frame.render_widget(header, chunks[0]);

    // free_practice.VIEW.3 — shared input bar
    input_bar::render(app, frame, chunks[1]);

    // free_practice.VIEW.4 — output panel
    let (output_text, output_style) = match app.submit_state {
        SubmitState::Error => (
            app.last_output
                .as_ref()
                .map(|o| format!("Error: {}", o.stderr))
                .unwrap_or_else(|| "Error".to_string()),
            crate::ui::s(Style::default().fg(Color::Yellow), nc),
        ),
        _ => {
            let text = app
                .last_output
                .as_ref()
                .map(|o| {
                    if o.timed_out {
                        "Command timed out after 3s".to_string()
                    } else if !o.stderr.is_empty() && o.stdout.is_empty() {
                        format!("stderr: {}", o.stderr)
                    } else {
                        o.stdout.clone()
                    }
                })
                .unwrap_or_default();
            (text, Style::default())
        }
    };

    let output_para = Paragraph::new(output_text)
        .block(Block::default().borders(Borders::ALL).title("Output"))
        .style(output_style)
        .wrap(Wrap { trim: false })
        .scroll((app.output_scroll, 0));
    frame.render_widget(output_para, chunks[2]);
}