#hex-dump #hex #io #dump #streamed

bin+lib kex

Console application for streamed hex dumping

17 releases

0.2.6 Jul 1, 2023
0.2.5 Jul 1, 2023
0.2.4 Jun 28, 2023
0.1.9 Jun 19, 2023

#495 in Parser implementations

26 downloads per month
Used in schnauzer

Apache-2.0

55KB
1.5K SLoC

kex

Crates.io Documentation

Streamed hex dumping library.

Features

  • Streamed I/O.
  • Works with output, implementing Write trait.
  • Customizable formatting
  • Row deduplication
  • Very fast

Demo

demo

Binary

Short guide

# Example
kex -a h8 -b h -g 8/2 -s 40 -n 10 file1 file2 file3 ...

Will print specified files sequentally as single stream. If no files specified, program will expect input from stdin

Arguments

-a <format>[min_width] - the address format. (Defaults to h8)

<format> - address representation. Accepts values:

  • h - hexadecimal
  • b - binary
  • d - decimal
  • o - octal

<min_width> - minimum width of displayed address. All, but decimal will be padded by zeros. Decimal padded with empty spaces

-b <format> - format of the raw data (defaults to h)

<format> - byte representation. Accepts values:

  • h - hexadecimal
  • b - binary
  • d - decimal
  • o - octal
  • c - ASCII characters. (Excludes characters/third column)
  • C - Caret notation + ASCII characters. (Excludes characters/third column)

-g group_size[/number_of_groups] (defaults to 8/2)

or

-g bytes_per_row

-s num_of_bytes_to_skip (defaults to 0)

-n num_of_bytes_to_rear (if not specified, data will be read until EOF)

Library

Examples

One of examples

use kex::*;
use std::fs::File;
use std::io::stdout;
use std::io::{Read, Write};

fn main() {

    let mut buf = [0u8; 4096];

    // let stdin = std::io::stdin();
    // let mut handle = stdin.lock();

    let config = Config::new(
        Some(AddressFormatter::new(AddressStyle::Hex(16), Default::default())),
        ByteFormatter::new(Groupping::RepeatingGroup(Group::new(4, " "), 4), false, Default::default()),
        Some(CharFormatter::default()),
        true,
    );
    let mut printer = Printer::new(stdout(), 0, config);
    
    let mut file = File::open("/bin/cat").expect("Can't open file");

    while let Ok(size) = file.read(&mut buf) {
        if size == 0 {
            break;
        }
        assert!(printer.write_all(&mut buf[..size]).is_ok());
    }

    printer.finish();
}


See all the examples in examples directory in the crate root

Deduplication

0000000000000000 cafebabe 00000002 01000007 00000003 |................|
0000000000000010 00004000 000111c0 0000000e 0100000c |..@.............|
0000000000000020 80000002 00018000 0000d0f0 0000000e |................|
0000000000000030 00000000 00000000 00000000 00000000 |................|
*
0000000000004000 cffaedfe 07000001 03000000 02000000 |................|
0000000000004010 11000000 08060000 85002000 00000000 |.......... .....|
0000000000004020 19000000 48000000 5f5f5041 47455a45 |....H...__PAGEZE|
0000000000004030 524f0000 00000000 00000000 00000000 |RO..............|

Customized formatting

       0🤩deadbeef#deadbeef#deadbeef#deadbeef 💥................💨
*
      32🤩deadbeef#deadbeef#43757374#6f6d2070 💥........Custom p💨
      48🤩72696e74#696e67fe#edfafeed#fafeedfa 💥rinting.........💨
      64🤩feedfafe#edfafeed#fafeedfa#feedfafe 💥................💨
      80🤩edfafeed#fafeedfa*
      88🤩

Bug reports or feature requests

https://github.com/Arsynth/kex/issues

Dependencies

~585KB