3 unstable releases

0.2.0 Jul 30, 2023
0.1.1 Jul 29, 2023
0.1.0 Jul 29, 2023

#2086 in Command line utilities

42 downloads per month

MIT license

36KB
264 lines

CLI utility for encoding and decoding data to/from binary representations using the Braille Patterns Unicode Block characters

See also the bbd-lib library crate.

Usage

$ bbd -h
Binary Braille Dump

Encode/decode data to/from Braille Patterns Unicode Block characters

Usage: bbd [OPTIONS] [PATH]...

Arguments:
  [PATH]...  Input file(s); [default: "-" (stdin)]

Options:
  -d              Decode Braille characters to bytes using the given style; ignores wrapping
  -s <STYLE>      Style (1) [default: nlbb] [possible values: bcd, direct, nlbb, nlbt, nrbb, nrbt]
  -c <N>          Wrap to N columns ("bytes") per line; 0: disable wrapping [default: 64]
  -m              Markdown output
  -h, --help      Print help
  -V, --version   Print version

---

Notes:

1. Styles:
    * `bcd`: Binary Coded Decimal of byte values 0-99
    * `direct`: Direct encoding using the standard Braille dot values
    * `nlbb`: Most significant nibble (MSN) left column, most significant bit
      (MSB) bottom row. This is the default style.
    * `nlbt`: MSN left column, MSB top row
    * `nrbb`: MSN right column, MSB bottom row
    * `nrbt`: MSN right column, MSB top row

Examples

$ echo Hello |bbd
⢄⠮⢦⢦⢾⢐
$ echo "⢄⠮⢦⢦⢾⢐" |bbd -d
Hello

Dependencies

~3–13MB
~148K SLoC