id3_json/
input.rs

1use std::path::PathBuf;
2use std::ffi::OsString;
3
4use lexopt::prelude::*;
5
6#[derive(Debug, PartialEq, Eq, Default)]
7pub struct Args {
8    pub filename: PathBuf,
9    pub read: bool,
10    pub write: bool,
11    pub tag_version: Option<id3::Version>,
12    pub in_json: Option<PathBuf>,
13    pub out_json: Option<PathBuf>,
14}
15
16pub fn parse_args<I>(args: I) -> Result<Args, lexopt::Error>
17where
18    I: IntoIterator + 'static,
19    I::Item: Into<OsString>,
20{
21    let mut filename_input = None;
22    let mut tag_version = None;
23    let mut read = false;
24    let mut write = false;
25    let mut in_json = None;
26    let mut out_json = None;
27    let mut parser = lexopt::Parser::from_iter(args);
28
29    while let Some(arg) = parser.next()? {
30        match arg {
31            Short('r') | Long("read") => read = true,
32            Short('w') | Long("write") => write = true,
33            Long("tag-version") => {
34                let mut input = parser.value()?;
35                input.make_ascii_lowercase();
36
37                if input == "id3v2.2" {
38                    tag_version = Some(id3::Version::Id3v22);
39                } else if input == "id3v2.3" {
40                    tag_version = Some(id3::Version::Id3v23);
41                } else if input == "id3v2.4" {
42                    tag_version = Some(id3::Version::Id3v24);
43                } else {
44                    let error = format!("Unsupported ID3 version: {:?}. Expected ID3v2.{{2,3,4}}", input);
45                    return Err(lexopt::Error::Custom(error.into()));
46                }
47            },
48            Value(val) if filename_input.is_none() => {
49                filename_input = Some(PathBuf::from(val));
50            },
51            Short('i') | Long("in-json") => {
52                let input = parser.value()?.into();
53                in_json = Some(input);
54            },
55            Short('o') | Long("out-json") => {
56                let input = parser.value()?.into();
57                out_json = Some(input);
58            },
59            Short('V') | Long("version") => {
60                println!("id3-json {}", env!("CARGO_PKG_VERSION"));
61                std::process::exit(0);
62            },
63            Long("help") => {
64                print_help();
65                std::process::exit(0);
66            },
67            _ => return Err(arg.unexpected()),
68        }
69    }
70
71    let Some(filename) = filename_input else {
72        let error = String::from("Missing <filename.mp3>");
73        return Err(lexopt::Error::Custom(error.into()));
74    };
75
76    if !read && !write {
77        read = true;
78    }
79
80    Ok(Args { filename, read, write, tag_version, in_json, out_json })
81}
82
83fn print_help() {
84    println!("id3-json {}", env!("CARGO_PKG_VERSION"));
85    println!();
86    println!("USAGE:");
87    println!("    id3-json [FLAGS] <music-file.mp3>");
88    println!();
89    println!("FLAGS:");
90    println!("    -r, --read       Reads tags from the file and outputs them to STDOUT as JSON,");
91    println!("                     or writes them to the file given by --out-json.");
92    println!("                     If neither `read` nor `write` are given, will read by default.");
93    println!();
94    println!("    -w, --write      Write mode, expects a JSON on STDIN with valid tag values,");
95    println!("                     or reads the tags from the file given by --in-json.");
96    println!("                     If also given `read`, will print/write the resulting tags afterwards");
97    println!();
98    println!("    -i, --in-json <path/to.json>");
99    println!("                     File to read tags from. If not given, uses STDIN");
100    println!();
101    println!("    -o, --out-json <path/to.json>");
102    println!("                     File to write tags to. If not given, uses STDOUT");
103    println!();
104    println!("        --tag-version <ID3v2.{{2,3,4}}>");
105    println!("                     On write, sets the tags' version to 2.2, 2.3, or 2.4.");
106    println!();
107    println!("    -V, --version    Print version information");
108    println!();
109    println!("ARGS:");
110    println!("    <music-file.mp3>    Music file to read tags from or write tags to");
111}
id3_json/input.rs

id3_json/
input.rs
