cat2-client – Command-line Caterva2 client#

This program allows interacting with a Caterva2 server from the command line, in interactive shell sessions or invoked by other programs. To use it, the clients extra needs to be installed:

python -m pip install caterva2[clients]

Running cat2-client --help should provide a list of supported commands that may be invoked like this:

cat2-client [GENERIC_OPTION...] COMMAND [COMMAND_OPTION...] COMMAND_ARGUMENTS...

Another relevant generic option besides --help is --server, which overrides the base of server URLs used by default. It should be a HTTP(S) URL, for example http://sub.edu.example.org:3126. Finally, the generic options --username and --password may be used in case your server requires user authentication.

--help is also available as a command option which shows the options and arguments accepted by that command (e.g. cat2-client roots --help). Another command option is --json, which forces the output of commands that accept it to be in JSON format, as that may be more amenable for parsing by other programs.

cat2-client may use a TOML configuration file (caterva2.toml in the current directory unless overridden with the generic --conf option). It may get the server address from there (urlbase or http settings in [server] section), as well as user authentication options (in the [client] section). Command-line options override settings read from the configuration file.

For a short tutorial on cat2-client, see Using the command-line client.

Note: This is the primary command-line client for Caterva2.