a2kit 2.2.0

Apple II disk image and language utility
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

//! ## get from image
//! 
//! Handles getting item types that do not require resolution of the file system.
//! This is invoked from the `get` module.

use clap;
use std::io::Write;
use std::str::FromStr;
use log::{debug,error};
use super::{ItemType,CommandError};
use crate::img::DiskImage;
use crate::{STDRESULT,DYNERR};

const RCH: &str = "unreachable was reached";

fn parse_sector(farg: &str) -> Result<[usize;3],DYNERR> {
    let fcopy = String::from(farg);
    let it: Vec<&str> = fcopy.split(',').collect();
    if it.len()!=3 {
        error!("sector specification should be in form `cylinder,head,sector`");
        return Err(Box::new(CommandError::InvalidCommand));
    }
    let cyl = usize::from_str(it[0])?;
    let head = usize::from_str(it[1])?;
    let sec = usize::from_str(it[2])?;
    debug!("user requested cyl {} head {} sec {}",cyl,head,sec);
    Ok([cyl,head,sec])
}

fn parse_track(farg: &str) -> Result<[usize;2],DYNERR> {
    let fcopy = String::from(farg);
    let it: Vec<&str> = fcopy.split(',').collect();
    if it.len()!=2 {
        error!("track specification should be in form `cylinder,head`");
        return Err(Box::new(CommandError::InvalidCommand));
    }
    let cyl = usize::from_str(it[0])?;
    let head = usize::from_str(it[1])?;
    debug!("user requested cyl {} head {}",cyl,head);
    Ok([cyl,head])
}

fn output_get(dat: Vec<u8>,typ: ItemType,img: Box<dyn DiskImage>) {
    if atty::is(atty::Stream::Stdout) {
        match typ {
            ItemType::Track => println!("{}",img.display_track(&dat)),
            _ => crate::display_block(0,&dat)
        };
    } else {
        std::io::stdout().write_all(&dat).expect("could not write stdout")
    }
}

pub fn get(cmd: &clap::ArgMatches) -> STDRESULT {
    // presence of arguments should already be resolved
    let src_path = cmd.get_one::<String>("file").expect(RCH);
    let typ = ItemType::from_str(&cmd.get_one::<String>("type").expect(RCH)).expect(RCH);
    let img_path = cmd.get_one::<String>("dimg").expect(RCH);

    match crate::create_img_from_file(&img_path) {
        Ok(mut img) => {
            let bytes = match typ {
                ItemType::Sector => {
                    let [cyl,head,sec] = parse_sector(&src_path)?;
                    img.read_sector(cyl, head, sec)?
                },
                ItemType::Track => {
                    let [cyl,head] = parse_track(&src_path)?;
                    img.get_track_nibbles(cyl, head)?
                },
                ItemType::RawTrack => {
                    let [cyl,head] = parse_track(&src_path)?;
                    img.get_track_buf(cyl, head)?
                },
                _ => panic!("{}",RCH)
            };
            return Ok(output_get(bytes,typ,img));
        },
        Err(e) => return Err(e)
    }
}

pub fn get_meta(cmd: &clap::ArgMatches) -> STDRESULT {
    // presence of arguments should already be resolved
    let maybe_selection = cmd.get_one::<String>("file");
    let img_path = cmd.get_one::<String>("dimg").expect(RCH);

    match crate::create_img_from_file(&img_path) {
        Ok(img) => {
            match maybe_selection {
                None => {
                    println!("{}",img.get_metadata(4));
                    Ok(())
                }
                Some(selection) => {
                    if selection.chars().next()!=Some('/') {
                        error!("selection string should start with `/`");
                        return Err(Box::new(CommandError::KeyNotFound));
                    }
                    match json::parse(&img.get_metadata(0)) {
                        Ok(parsed) => {
                            let mut keys = selection.split('/');
                            let mut obj = parsed;
                            keys.next();
                            while let Some(key) = keys.next() {
                                if key=="" {
                                    break;
                                }
                                match obj[key].clone() {
                                    json::JsonValue::Null => return Err(Box::new(CommandError::KeyNotFound)),
                                    x => { obj = x }
                                };
                            }
                            println!("{}",json::stringify_pretty(obj, 4));
                            Ok(())
                        },
                        Err(e) => Err(Box::new(e))
                    }
                }
            }
        },
        Err(e) => return Err(e)
    }
}