Ninjas Practicing Multidimensionality

    encode-cli
    TypeScript icon, indicating that this package has built-in type declarations

    1.6.0 • Public • Published

    encode-cli

    npm version

    Build Status

    Intro

    Encode CLI is a CLI wrapper for the @znetstar/encode-tools-native npm package. Each of the subcommands map directly to a function on the EncodeTools class in @znetstar/encode-tools-native and retain same arguments.

    All subcommands can be accessed using the encli command,

    For example, the EncodeTools.hash function can be called as follows

      echo 'hash me!' | npx encode-cli hash -a md5 -f base64

    Which is equivalent to

    (async () => {
      const enc = new (require('@znetstar/encode-tools-native/lib/EncodeTools').EncodeTools)();
      const buf = await enc.hash('hash me!', 'md5');
      process.stdout.end(buf.toString('base64'));
    })();

    Docker

    I've provided two Docker images with encode-cli installed. znetstar/encode-cli which is based on ubuntu:20.10 and Node.js 14 from the NodeSource PPA, and znetstar/encode-cli:slim which is based off of node:14-slim.

    The former includes the native modules (discussed in the section below), and the latter does not and is 3 times smaller.

    Example using Docker

      echo 'hash me!' | docker run --rm -i znetstar/encode-cli hash -a md5 -f base64

    Important

    Two deviations from the library exist to better accommodate the command line.

    First, input and output can be directed to/from a file or standard input/output. Second, the output of each command can be re-encoded as any format accepted by encodeBuffer using the -f flag.

    The serializeObject, deseralizeObject, encodeObject and decodeObject methods have been replaced with a single convertObject method, because the original methods don't make sense in the context of a command line tool.

    Configuration

    The defaults which are passed to the constructor of EncodeTools are those found in DEFAULT_ENCODE_TOOLS_OPTIONS which the exception being the default binaryEncoding which is nodeBuffer instead of base64.

    You can set the defaults for each value in EncodingOptions by setting an environment variable prefixed with ENCLI_ and the name of property in uppercase with underscores instead of camel case.

    So to set EncodingOptions.binaryEncoding = "base64url" you can use ENCLI_BINARY_ENCODING=base64url.

    Alternatively, you can set all the defaults at once by adding a JSON file at ./.enclirc, $HOME/.enclirc, or by setting the ENCLIRC environment variable to the path of the JSON file.

    The defaults can also be passed by setting the environment variable ENCLIRC with raw JSON containing the defaults.

    Documentation

    For documentation refer to the @znetstar/encode-tools-native documentation, all subcommands accept the --help argument which will print the required syntax.

    License

    This project is licensed under the GNU LGPL-3.0 a copy of which is located in LICENSE.txt.

    Keywords

    Install

    npm i encode-cli

    DownloadsWeekly Downloads

    2

    Version

    1.6.0

    License

    LGPL-3.0

    Unpacked Size

    81.7 kB

    Total Files

    34

    Last publish

    Collaborators

    • znetstar