This binary is a wrapper around the data-encoding [library].

Installation

You can run make install to install the binary from the [github] repository. By default, it will be installed as ~/.cargo/bin/data-encoding. You can also run cargo install data-encoding-bin to install the latest version published on crates.io. This second alternative does not require to clone the repository.

Usage

You can run data-encoding --help (assuming ~/.cargo/bin is in your PATH environment variable) to see the usage:

``` Usage: data-encoding --mode= --base= [] Usage: data-encoding --mode= --symbols= []

Options: -m, --mode {encode|decode|describe} -b, --base {16|hex|32|32hex|64|64url} -i, --input read from instead of standard input -o, --output write to instead of standard output --block read blocks of about bytes -p, --padding pad with -g, --ignore when decoding, ignore characters in -w, --width when encoding, wrap every characters -s, --separator when encoding, wrap with --symbols define a custom base using --translate when decoding, translate as --ignoretrailingbits when decoding, ignore non-zero trailing bits --leastsignificantbit_first use least significant bit first bit-order

Examples: # Encode using the RFC4648 base64 encoding data-encoding -mencode -b64 # without padding data-encoding -mencode -b64 -p= # with padding

# Encode using the MIME base64 encoding
data-encoding -mencode -b64 -p= -w76 -s$'\r\n'

# Show base information for the permissive hexadecimal encoding
data-encoding --mode=describe --base=hex

# Decode using the DNSCurve base32 encoding
data-encoding -mdecode \
    --symbols=0123456789bcdfghjklmnpqrstuvwxyz \
    --translate=BCDFGHJKLMNPQRSTUVWXYZbcdfghjklmnpqrstuvwxyz \
    --least_significant_bit_first

```

Performance

The performance of this binary is similar or faster than the GNU base64 program (see how to run the benchmarks on [github]).