caber

Embed binary data into JavaScript and TypeScript projects.

Install

cargo install caber --features cli

How-to

> caber --help
caber 0.1.1
Gerald Nash (aunyks)
Embed binary data into JavaScript and TypeScript projects.

USAGE:
    caber [OPTIONS] <INPUT_FILE>

ARGS:
    <INPUT_FILE>    The binary to be embedded

OPTIONS:
    -h, --help                         Print help information
    -l, --output-lang <OUTPUT_LANG>    The output language of the binary (javascript / ecmascript,
                                       typescript, etc)
    -m, --export-mode <EXPORT_MODE>    The export mode of the typed array (default, object, or none)
    -o, --output-file <OUTPUT_FILE>    The output file containing the embedded file
    -V, --version                      Print version information

Examples

Embed a file.bin file and export the typed array with export default .... The result is written to stdout.

> caber ./file.bin
const binary = new Uint8Array([104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]);

export { binary };

Embed a file.bin file into a file.ts TypeScript file and export the typed array with export default ....

> caber ./file.bin --output-lang typescript --export-mode default --output-file file.ts

Embed a file.bin file as JavaScript and export the typed array with export { ... }. The result is written to stdout.

> caber ./file.bin --output-lang javascript --export-mode object
const binary = new Uint8Array([104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]);

export { binary };

Embed a file.bin file as JavaScript and export the typed array with export default .... The result is written to stdout.

> caber ./file.bin --output-lang javascript --export-mode default
const binary = new Uint8Array([104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]);

export default binary;

License

Fair Source License, Version 0.9
Copyright © 2022 Gerald Nash