Crate cp437_tools

source ·

Expand description

logo

CP437 tools

A small collection of tools to handle CP437 files.

§Binaries

These require rust nightly, since they make use of the nightly feature try_trait_v2.

§Meta handling

cp437-check-meta

Reads a file’s metadata and run some validations to see if there’s any issues with it.
cp437-read-meta

Reads and prints a file’s metadata, highlighting values to show potential errors, as well as showing the effective value when a real one is missing.
cp437-remove-meta

Takes a file and strips its metadata, piping the resulting file to stdout.
cp437-set-meta

Takes a file and modifies its metadata, piping the resulting file to stdout.

If the file has no metadata, it will add one filled with default values, and then proceed to add set the given field.

§Rendering

cp437-to-png

Renders the given file as a PNG image, piping the resulting file to stdout.

It will also embed the file’s metadata, if available.
cp437-to-svg

NOTE: This binary is still a WIP. Redering seems to be kinda wonky.

Renders the given file as an SVG image, piping the resulting file to stdout.

It will also embed the file’s metadata, if available.
cp437-to-txt

Takes the contents of the file and transpiles them to UTF-8 encoding, piping the resulting file to stdout.

§Library

Note that this crate is primary written to supply the CLI commands shown above, not as a reusable library. As such, by default it will pull unnecessary dependencies.

To avoid this, disable the default “binaries” feature.

(see cargo#1982 issue for more details on why this workaround is even needed)

Modules§