mayohttp

README

Mayohttp

A TUI HTTP client written in Go with Pipelines on mind.

Table of Contents

• Main features
  • URL Compose
• Installation
  • 🚀 Automatic Install (Recommended)
  • ✋ Manual Install (Alternative)
• Neovim Plugin

Main features

• Terminal pipelines
• Filtering response before pipe-ing (eg. req header, req body, res header, res body)
• Sessions
• Environment file
• You can use env variables literally on anything (url, pipe, response, header) with $NAME syntax
• Open / Edit anything with your favorite editor (set the $EDITOR on your environment)
• URL Compose

URL Compose

URL Compose is a feature that allows you to compose the URL easily and quickly (to open it, press <c-u>), it's still experimental yet and any feedback are welcomed

• cd {val} to change the path (e.g cd .. to go up one level, cd / to go to root, cd testing to add testing to the pathname)
• {number}={val} to change the pathname at the index with the value
• {key}={val} to add or change (if already exists) a query param
• rm {key|number} to remove a query param or pathname at specific index

[!NOTE] The index 0 is preserved for the protocol (http, https etc), just like pathname, you can use 0=http to set it or rm 0 to remove it

🚀 Automatic Install (Recommended)

[!IMPORTANT]
✅ Supported OS: Linux and MacOS

# use curl
$ curl -fsSL https://raw.githubusercontent.com/Cybernetics354/mayohttp/main/.scripts/install.sh | sh

# use wget
$ wget -qO- https://raw.githubusercontent.com/Cybernetics354/mayohttp/main/.scripts/install.sh | sh

⚙️ Installation parameters

Variable	Parameter	Example	Remarks
VERSION	--version	VERSION=v0.0.2 or --version v0.0.2	Install specific version (default: latest release)
DESTINATION	--destination	DESTINATION=/usr/bin or --destination /usr/local/bin	Install to custom directory (default: ~/.local/bin)

Example:

$ export VERSION=v0.0.2
$ export DESTINATION=/usr/bin
$ curl -fsSL https://raw.githubusercontent.com/Cybernetics354/mayohttp/main/.scripts/install.sh | sh

# 😎 single liners
$ curl -fsSL https://raw.githubusercontent.com/Cybernetics354/mayohttp/main/.scripts/install.sh | VERSION=v0.0.2 DESTINATION=/usr/bin sh

✋ Manual Install (Alternative)

If you prefer, you can install manually by hand:

1. Go to the GitHub releases page

2. Download the asset matching your OS and architecture, e.g.:

mayohttp_0.0.2_linux_amd64.tar.gz

1. Download the checksum file:

mayohttp_0.0.2_checksums.txt

1. Verify the checksum:

$ grep " mayohttp_0.0.2_linux_amd64.tar.gz$" mayohttp_0.0.2_checksums.txt | sha256sum -c -

1. Extract the archive:

$ tar -xzf mayohttp_0.0.2_linux_amd64.tar.gz

1. Move the executable into your preferred directory:

$ chmod +x mayohttp
$ mv mayohttp ~/.local/bin/

1. If ~/.local/bin is not in your PATH, add it in your ~/.bashrc, ~/.zshrc or ~/.profile:

$ export PATH="$HOME/.local/bin:$PATH"

1. Reload the shell profile:

$ source ~/.profile

Neovim Plugin

If you use Neovim, you can install the mayohttp.nvim plugin.