~gpanders/gandi-cli unlisted

Command line interface to Gandi API
Add project metadata
Fix typo in README
62a1d1d3 — Greg Anders 1 year, 29 days ago
Clarify usage examples in README



You can also use your local clone with git send-email.

#Gandi CLI Tool

Command line interface to the Gandi API.



Install using pip:

pip3 install --user gandi


Install using pipx:

pipx install gandi


Run gandi setup to create a configuration file at $XDG_CONFIG_HOME/gandi/config. This will ask for your Gandi API key as well as an (optional) default domain name and an (optional) default mailbox ID.

If you specify a domain name and mailbox ID, subcommands that require these parameters will use the values supplied in your config file instead of requiring them as commandline flags.

Parameters can also be specified using environment variables, e.g.:

GANDI_API_KEY=... gandi mbox -d DOMAIN --list




setup: Setup the Gandi CLI config file

gandi setup

alias: Manage email aliases

gandi alias [-d DOMAIN] [-m MAILBOXID] (--list | --add ALIAS | --remove ALIAS)

List existing email aliases:

gandi alias -l

Add a new alias:

gandi alias -a ALIAS

Remove an alias:

gandi alias -r ALIAS

mbox: Manage email mailboxes

gandi mbox [-d DOMAIN] --list