clb6 / jarvis-cli

Jarvis command-line interface
Apache License 2.0
0 stars 0 forks source link

jarvis-cli

jarvis-cli is a Python command-line tool used to interact with the jarvis-api.

Commands

Environment Variables

Variable Name Description
EDITOR Editor application to use

Configuration File

A configuration file is required. jarvis-cli assists in the generation of the configuration file when one does not already exist.

The configuration file is written to $HOME/.jarvis/cli_config.ini.

In the configuration file, each subsection is an environment and each environment has its own set of parameters. Example:

[default]
api_url = http://your-jarvis-api.com/

The environment can be selected with the --environment command argument. The default environment is the default environment and does not have to be specified.

Configuration parameters

Parameter Name Description
author Author name to use
api_url jarvis-api URL
data_directory Local jarvis-api data directory used to perform backups
snapshots_directory Directory where the backup snapshots are stored

Viewing Markdown

jarvis-cli uses the webbrowser Python module.

On Unix machines

webbrowser uses xdg to perform the launching of files. If you wish to open the markdown files in your default browser because you have installed a markdown previewing extension, change the mimeapps.list file to map the markdown mime type to the appropriate application like so:

[Added Associations]
text/x-markdown=chromium-browser.desktop

The full documentation on mimeapps.list can be found here. The mimeapps.list can probably be found in your home directory ~/.local/share/applications/.