Pody client utility

Pody client CLI utility is a command-line tool that allows you to interact with the Pody API. It act like curl but is more fiendly for Pody API.

The utility is written in Python and can be installed using pip:

pip install pody

Configuration

The authentication is done by setup the environment variables PODY_API_BASE, PODY_USERNAME and PODY_PASSWORD.
One way to do this is to set them in your shell profile file (e.g. .bashrc, .zshrc):

export PODY_API_BASE="http://localhost:5000"
export PODY_USERNAME="username"
export PODY_PASSWORD="password"

Another way is to use a configuration file, e.g. you can create a directory to store your credentials:

mkdir -p ~/pody-credentials
vi ~/pody-credentials/node1.sh     # set the variables as above

Then you can source the file in your shell profile to login to the server 😊🚀:

source ~/pody-credentials/node1.sh

The latter method is more flexible and allows you to switch between different servers easily.

Usage

The usage follows folloiwing pattern:

pody [METHOD] [ROUTE] [OPTIONS...]

For example, to restart a pod you can run:

pody post pod/restart ins:myins

The method is not strictly a HTTP method, it can be one of get, post, fetch, help, version. Notebly, fetch is used to automatically select appropriate method based on the route. So the above command can be written as:

pody fetch pod/restart ins:myins

Use shorthand! 🚀

pody fetch is the most used command, a simple shorthand podx is provided for it. Which means podx ... is equivalent to pody fetch .... The above command can be written as :

podx pod/restart ins:myins

Help

You can also use help to get help on a specific route, or a subset of routes:

pody help pod/restart
pody help pod/

Example

pody help user/

┏━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━┓
┃ Path            ┃ Methods ┃ Params ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━┩
│ /user/info      │ GET     │        │
│ /user/list      │ GET     │        │
│ /user/ch-passwd │ POST    │ passwd │
└─────────────────┴─────────┴────────┘

Another shorthand 😊

The get/post/fetch methods, when applied to a route, will invoke the help method instead,
i.e. pody get user/ or podx user/ will invoke pody help user/ and show the parameters.

To get the version of the utility:

pody version

You should use this command to check if the utility version is in sync with the server version.