Home

Awesome

zws-im/cli

A command line interface for ZWS instances.

Usage

zws [options] [url]
zws [options] shorten [url]
zws [options] stats [url]
zws [options] config
FlagsDescription
-h, --helpPrint help and exit.
-v, --versionPrint version and exit.
--jsonOutput JSON.
--plainOutput without formatting.
--no-inputDisable reading from stdin.

Subcommands

shorten (default)

Shortens the provided URL.

zws [options] [url]
zws [options] shorten [url]

If no URL is provided and --no-input is not provided and the terminal is not a TTY it will be read from stdin.

stats

View total statistics for the configured ZWS instance.

zws [options] stats

stats <url>

View usage statistics for a shortened URL.

zws [options] stats <url>

config

Print the current configuration. You can view the config path and if it's being loaded with the -h or --help flag.

zws [options] config

Config

The config is stored as zws.ini in the config directory of the current user for applications as the Nim configuration file format.

Full example

[Api]
url = "https://api.example.com"
token = "YTdaKVdfGPxdkKaayRwaVHvLXtVkPdPz"

[Shortened]
baseUrl = "https://example.com"

Api

KeyDescriptionDefault
urlThe URL of the ZWS instance.https://api.zws.im
tokenThe API token to use in requests. Only required for custom instances with authentication configured.

Shortened

KeyDescriptionDefault
DEPRECATED baseUrlThe URL shortened IDs should be appended to. You only need to set this if you can't set the base URL on the API side.https://zws.im if Api.url is set to default, otherwise the value of Api.url

Installation

Nimble is the preferred way to install the CLI and is the best option for regular use.

Docker is easiest for testing but containers are slower compared to native host execution.

Nimble

  1. Install Nim and Nimble

  2. Install via Nimble

    nimble install zws
    

Docker

An official Docker image is published on Docker Hub as zwsim/cli.

docker run --rm zwsim/cli [options] url

Manual installation

  1. Download a binary from the latest release
  2. Add the binary to your PATH
  3. Windows users will also need to add these DLLs to their PATH