The command-line tool uhepp automates simple routine tasks. The
invocation requires a subcommand. This document summarizes the available
subcommands. The tool ships with the default installation and should be placed
automatically into the user’s
All subcommands accept the two options
--api-url overrides the API root-endpoint otherwise taken from the environment
UHEPP_API. Please make sure that it includes a trailing slash.
--api-key is the API token used for authentication. If the option is
missing, the token is taken from environment variable
both methods fail, an anonymous connection to the API is set up.
uhepp pull subcommand downloads a plot from the central hub.
The required argument
UUID identifies the plot on the remote server. The JSON
data from the server is saved in a local file. The filename is either given as a
second argument, or if missing, taken from the uhepp metadata with the added suffix
If the optional flag
--render is added, the plot’s
render() method is
called and the graphics file is written to disk. If the output filename is inferred
from the metadata, the suffix
The command prints the new filename.
uhepp push subcommand uploads a plot from the central hub.
The required arguments are the
collection id (not the URL) and a
containing the plot in JSON format.
The command prints the front end URL of the new plot.
uhepp show subcommand shows local or remote plots.
The subcommand takes only a single positional argument. It can either be a
UUID or the name of a local file. If the given string matches the format of a
UUID, it is used to download the plot from the central hub. Otherwise, the
given string is used as an input filename.
In both cases, the loaded plot is then shown in an interactive window.
uhepp show subcommand renders local or remote plots.
The first argument can be either a
UUID or a
Command: show. The second argument is the destination file. The plot is
rendered as a graphics file to the destination file.
uhepp cpull subcommand downloads all visible plots from a collection.
The first argument must be the
collection id. The optional second argument
destination path where downloaded plots are placed. The
destination directory is created if it does not exist. The file names are
inferred from the plot’s metadata. By default, the plots are stored as JSON. The
filenames receive the suffix
If the optional flag
--render is given, the plots are converted to a graphics
file. The filenames receive the suffix
The command prints the names of the created files.
If the filenames inferred from the plot’s metadata are not unique, the command will silently overwrite freshly downloaded plots with other freshly downloaded plots.