~gpanders/gandi-cli

Command line interface to Gandi API
62a1d1d3 — Greg Anders 2 months ago
Clarify usage examples in README
2e1b7abb — Greg Anders 2 months ago
Bump version number to 0.2.3
ee1fe273 — Greg Anders 2 months ago
Remove contributing information from README

clone

read-only
https://git.sr.ht/~gpanders/gandi-cli
read/write
git@git.sr.ht:~gpanders/gandi-cli

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

Gandi CLI Tool

Command line interface to the Gandi API.

Installation

pip

Install using pip:

pip3 install --user gandi

pipx

Install using pipx:

pipx install gandi

Configuration

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

Usage

gandi SUBCOMMAND OPTIONS

Subcommands

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 alias [-d DOMAIN] --list