bishop.rs

+----[drunken]----+
|..+.. oo+o.      |
| *.* o +.o.      |
|= = o * .E+      |
|+. ..+ = +..     |
|o  ...+ S.o      |
| .o .....= .     |
|.. o   .+ +      |
|.        = +     |
|        ..=      |
+----[bishop]-----+

Library and CLI app for visualizing data using The Drunken Bishop algorithm implemented in Rust

Drunken Bishop is the algorithm used in OpenSSH's ssh-keygen for visualising generated keys

Table of Contents:

Crates

Crate | Description | Version | -----------------------------------|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| bishop | Library | cargo docs | bishop-cli (source) | Command-line app | cargo |

Install

Rust library lives on crates.io

CLI app:

Platform | Package | ------------------------|-----------------------------------------------------------------------------| Arch Linux | TBD AUR | Prebuilts for Linux | Github releases |

Examples

Using as command-line app

```bash some_data=$(printf foobar | sha256sum | cut -d' ' -f1)

we are using cut here to crop the filename from sha256sum output

printf $some_data | bishop -sI hex

-s tells bishop to take data from stdin

#

-I hex tells bishop that input data will be in HEX format.

As an alternative, you might use xxd to turn hex data into binary:

printf $some_data | xxd -r -p | bishop -s

-I bin is implied by default

bishop -i <(printf $some_data) -I hex

-i tells bishop to take data from specified file.

We are using bash command substitution here, but

any valid path is allowed, like bishop -i ~/some.file

bishop $some_data

Without -i or -s bishop expects HEX encoded input in the first argument.

Note that -I is not supported if data is provided as argument

printf foobar | bishop -sI hash

-I hash tells bishop to hash all of its input

using sha256 before making a randomart.

Since maximum effective size of input data for random art with default size (17x9)

is somwhere around 64-128 bytes, this option is extremely useful for large inputs

```

All these bishop calls would print this art to console:

``` Fingerprint of: c3ab8ff13720e8ad9047dd39466b3c8974e592c2fa383d4a3960714caef0c4f2

+-----------------+ | . . | | . + . + | |o + + + = . | | * + + O = | | E o.o S | | . +.=.o.= | | o.B.=... | | +.+.* o | | o.o.o. . | +-----------------+ ```

Note that input will be echoed only if data is provided as argument or with -I hash. This behavior can be disabled using -q option.

You can read full usage for cli app (also available by --help option) here

Using as library

Cargo.toml

toml bishop = "0.2.0"

Use latest version as stated on cargo badge above

For AsRef<u8> (slices, vectors)

```rust extern crate bishop; use bishop::*;

fn main() { let data1 = [0u8; 16]; let data2 = vec![0u8; 16];

let mut art = BishopArt::new();
art.input(&data1);
art.input(&data2);
println!("{}", art.draw());

// Using chaining:

let drawn_art: String = BishopArt::new()
    .chain(&data1)
    .chain(&data2)
    .draw();
println!("{}", drawn_art);

} ```

Drawing options and result reusing

```rust use bishop::*;

fn randomart(data: &[u8]) { let opts1 = DrawingOptions { toptext: "pass 1".tostring(), ..Default::default() }; let opts2 = DrawingOptions { bottomtext: "pass 2".to_string(), ..Default::default() };

// compute field once
let field = BishopArt::new().chain(data).result();

// then draw it multiple times with different options
println!("{}", field.draw_with_opts(&opts1));
println!("{}", field.draw_with_opts(&opts2));

} ```

For Read (file, stdin, etc)

```rust use bishop::*; use std::io::{self, Read};

fn main() { // BishopArt implements Write trait let mut art = BishopArt::new(); io::copy(&mut io::stdin(), &mut art); println!("{}", art.draw()); } ```

Full API documentation is available on docs.rs

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.