go-gurl

README

go-gurl

TUI "curl" as a personal replacement of Postman. Postman just feels overly bloated in appearance and as a program. This is written purely in Golang and does not use curl under the hood.

I'm working on this while learning Go.

⚠️ This program has lots of problems. Most I may not even know about. But the following are the known limitations at the moment:

• Windows support (I don't have access to a windows machine at the moment)
• Cookies support
• Headers deletion
• Save/Manipulate response/request
• Edit/delete bookmarks and history
• Tests (I have some written)
• Commands
• Input validations

I'll be providing implementations as time goes by. Feel free to submit an issue as you try this out.

How to use

Installation

go install github.com/blackmann/go-gurl

Keybinds

Bind	Action
shift+tab	Alternate between views (address bar and viewport)
esc	Enter/leave command mode. In command mode, you can press the forward or back key to switch between the viewport tabs
ctrl+c	Quit
$	Show history. You can filter history with ID or annotation. See below on how to annotate history

History

When requests are made, they are saved into history. To trigger the history modal, enter a leading $. You can filter the history with ID number or annotation. Selecting a history item will prefill all request fields ( address, headers and body).

To annotate history, first find the history ID then enter command mode (esc) then type

/annotate $32 create-account

This feature is useful when you run a request very often when testing.

Bookmarks

Bookmarks allow to you create and use alias for base paths/endpoints. For example, if you mostly work with an endpoint https://jsonplaceholder.typicode.com, you can be able to create a bookmark with (in command mode esc)

@typicode https://jsonplaceholder.typicode.com

You can then use the bookmark in making requests (in the addressbar as)

POST @typicode/todos/

Save Response

You can save the response from a request to a file by doing (in command mode esc)

/save shops.json

You can also save a selected/queried parts of the response. For example, say you have a response with the following structure:

{
  "total": 3,
  "limit": 10,
  "skip": 0,
  "data": [
    {
      "name": "Angelina Cudjoe",
      "age": 100,
      "cute": true
    },
    {
      "name": "Jane Doe",
      "age": 80,
      "cute": false
    }
  ]
}

You can query and save the names from each object like this

/save people.json data.#.name

This saves ["Angelina Cudjoe", "Jane Doe"] to people.json. Queries are processed using this library gjson. Check it out for all the possible query formats.

Copy Response

You can copy the response to your clipboard. Do the following [with an optional selector just like the save command]

/copy optional.selector