bcur-cli 3.0.0

Command-line Uniform Resource encoder with terminal QR output
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

//! `bcur decode` — UR strings back to payload bytes.

use std::path::PathBuf;

use bcur::ur::Decoder;
use bcur::{State, UrType};
use clap::Args;

use crate::error::{Error, Result};
use crate::io_util::{read_text, write_bytes};

/// Decode single-part or fountain UR lines to the original payload.
#[derive(Debug, Args)]
pub(crate) struct DecodeArgs {
    /// Require this UR type on every part.
    #[arg(long = "type")]
    ur_type: Option<String>,
    /// Write the payload as lowercase hex.
    #[arg(long)]
    hex: bool,
    /// Output file. Omit or `-` writes stdout.
    #[arg(short, long)]
    out: Option<PathBuf>,
    /// Input file of UR lines. Omit or `-` reads stdin.
    input: Option<PathBuf>,
}

pub(crate) fn run(args: &DecodeArgs) -> Result<()> {
    let text = read_text(args.input.as_deref())?;
    let lines: Vec<(usize, &str)> = text
        .lines()
        .enumerate()
        .map(|(i, line)| (i + 1, line.trim()))
        .filter(|(_, line)| !line.is_empty())
        .collect();
    if lines.is_empty() {
        return Err(Error::msg("no UR lines in input"));
    }

    let mut decoder = Decoder::default();
    if let Some(t) = args.ur_type.as_deref() {
        decoder = decoder.accept([UrType::new(t)?]);
    }

    for (lineno, line) in lines {
        match decoder.receive(line) {
            Ok(_) => {
                let progress = decoder.progress();
                if progress.fragment_count() > 0 {
                    eprintln!(
                        "part {} rank={}/{} recovered={}",
                        lineno,
                        progress.rank(),
                        progress.fragment_count(),
                        progress.recovered(),
                    );
                }
                if matches!(decoder.state(), State::Complete(_)) {
                    let data = decoder.into_decoded()?.into_parts().1;
                    return write_bytes(args.out.as_deref(), &data, args.hex);
                }
            }
            Err(error) if error.is_fatal() => return Err(error.into()),
            Err(error) => eprintln!("bcur: skipped line {lineno}: {error}"),
        }
    }
    Err(Error::msg(
        "stream ended before the fountain message completed",
    ))
}