ZW is both an executable binary that can be run, and a library that can be used in Rust programs.

Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install zw

It will make the zw command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall zw uninstalls.

Adding `zw` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add zw

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

zw = "0.2.0"

The zw library will be automatically available globally. Read the zw library documentation.

Back to the crate overview.

Readme

ZW

Utility for encoding and decoding text using zero-width characters.

How it works

Subject text is first converted to its binary representation (e.g. "foo" -> "011001100110111101101111"), then each digit is replaced with a zero-width character (specifically: U+200B and U+200C). Decoding is simply the inverse of the same flow of operations.

Usage

As a module:

use zw;
// ...
let encoded = zw::encode("Hello");
let decoded = zw::decode(&encoded);

As a CLI tool:

zw [-e|--encode] [-d|--decode] [input]

If both -e and -d flags are omitted then conversion direction is guessed based on the first interpreted character.

Reads from stdin if an input string isn't provided in its arguments.

# Shell-ish
zw "Hello" > encoded.txt
cat encoded.txt | zw > decoded.txt

# MacOS clipboard encoding
pbpaste | zw | pbcopy

Installing the command-line executable

Adding zw library as a dependency

Adding `zw` library as a dependency