kex 0.2.6

Console application for streamed hex dumping
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

//! Module with builtin ASCII char formatter

use std::{fmt::Display};

use super::*;

/// Builtin ascii characters formatter
#[derive(Clone)]
pub struct CharFormatter {
    placeholder: Vec<u8>,
    pub(super) separators: Separators,
}

impl CharFormatter {
    pub fn new(placeholder: impl Display, separators: Separators) -> Self {
        let placeholder = Vec::from(placeholder.to_string().as_bytes());

        Self {
            placeholder,
            separators,
        }
    }
}

impl CharFormatting for CharFormatter {
    fn format<O: Write>(&self, bytes: &[u8], out: &mut O) -> Result<usize> {
        let placeholder = &self.placeholder[..];

        for i in 0..bytes.len() {
            match AsciiChar::from_ascii(bytes[i]) {
                Ok(chr) => {
                    if chr.is_ascii_printable() && !chr.is_ascii_control() {
                        out.write_all(&bytes[i..i + 1])?;
                    } else {
                        out.write_all(placeholder)?;
                    }
                }
                Err(_) => {
                    out.write_all(placeholder)?;
                }
            }
        }

        Ok(bytes.len())
    }

    fn format_padding<O: Write>(&self, byte_count: usize, out: &mut O) -> Result<()> {
        out.write_all(&b" ".repeat(byte_count))
    }

    fn separators(&self) -> &Separators {
        &self.separators
    }
}

impl Default for CharFormatter {
    fn default() -> Self {
        Self::new(".".to_string(), Separators::new("|", "|"))
    }
}