Pody client utility

Pody CLI is a command-line tool that allows you to interact with the Pody API from client side. 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 mostly 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. 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

Podx

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

More

In addition to the above, the subcommand of pody can also be help, version and copy-id. The overall usage is as follows:

---

You can 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 │
└─────────────────┴─────────┴────────┘

TIP

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.

---

The copy-id command is used to copy your public key to the server, enabling SSH access to the containers:

pody copy-id instance_name [pub_key_path]

---

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.
In addition, you can use pody version --changelog to see the changelog of the software.

Please always use --help to see the details of each command.