covet 2.1.0

CLI and web frontend for scanning with HP Envy printer / scanners
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
125
126
127
128
129
130
131
132
133
134
135
136
137

use clap::builder::TypedValueParser as _;
use clap::{Parser, ValueEnum};
use serde::Deserialize;
use std::path::PathBuf;

#[derive(Debug, Clone, Copy, ValueEnum, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum Source {
    Auto,
    Adf,
    Glass,
}

#[derive(Debug, Clone, Copy, ValueEnum)]
pub enum Format {
    Pdf,
    Jpeg,
}

#[derive(Debug, Clone, Copy, ValueEnum)]
pub enum ColorSpace {
    Gray,
    Color,
}

#[derive(Parser, Debug)]
pub struct ScannerOpt {
    /// The hostname of the scanner
    #[arg(name = "SCANNER")]
    pub scanner: String,

    /// Do not use TLS to secure the connection to the scanner
    #[arg(long)]
    pub no_tls: bool,
}

#[derive(Parser, Debug)]
pub struct ScanOpt {
    #[clap(flatten)]
    pub scanner_opts: ScannerOpt,

    /// The document source
    #[arg(
        short,
        long,
        name = "SOURCE",
        default_value = "auto",
        ignore_case(true)
    )]
    pub source: Source,

    /// The format of the output
    #[arg(short, long, name = "FORMAT", default_value = "pdf", ignore_case(true))]
    pub format: Format,

    /// The color space of the output
    #[arg(
        short,
        long,
        name = "COLORSPACE",
        default_value = "color",
        ignore_case(true)
    )]
    pub color: ColorSpace,

    /// The scan resolution in dpi
    #[arg(
        short,
        long,
        name = "RESOLUTION",
        default_value_t = 300,
        value_parser = clap::builder::PossibleValuesParser::new(["300", "600"])
            .map(|s| s.parse::<u32>().unwrap()),
    )]
    pub resolution: u32,

    /// Compression quality level (lower is better)
    #[arg(
        short = 'q',
        long = "compression-quality",
        name = "QUALITY",
        default_value = "25"
    )]
    pub compression_quality: u32,

    /// Do not fix the heigt of JPEG files scanned from the automatic document feeder
    #[arg(long)]
    pub disable_jpeg_fix: bool,
}

#[derive(Parser, Debug)]
pub struct WebOpt {
    #[clap(flatten)]
    pub scanner_opts: ScannerOpt,

    /// Port to use for the web server
    #[arg(short, long, name = "PORT", default_value = "3000")]
    pub port: u16,

    /// Listen address to use for the web server
    #[arg(short, long, name = "ADDR", default_value = "127.0.0.1")]
    pub listen: String,

    /// Do not fix the heigt of JPEG files scanned from the automatic document feeder
    #[arg(long)]
    pub disable_jpeg_fix: bool,
}

#[derive(Parser, Debug)]
#[clap(version)]
pub enum Opt {
    /// Display the status of the scanner
    Status(ScannerOpt),

    /// Scan a document
    Scan(ScanOpt),

    /// Start a web server to handle scan jobs
    Web(WebOpt),

    /// Sets the height of the given JPEG to the number provided in a `Define Number of Lines` segment
    FixJpegHeight(FixJpegHeightOpt),
}

#[derive(Parser, Debug)]
pub struct FixJpegHeightOpt {
    /// Input file
    pub input: PathBuf,
    /// Output file
    pub output: PathBuf,
}

#[test]
fn verify_app() {
    use clap::CommandFactory;
    Opt::command().debug_assert()
}