rh: user-friendly command-line HTTP client

rh is a user-friendly command-line tool to request HTTP APis. You can debug, test and verify any HTTP APi with rh in a simple and efficient way. rh is a standalone application with no runtime or garbage collector, so it doesn't require Python or Java installed on your machine for example. rh is based on Rust that is a blazing fast and memory-efficient language. The name rh stands for Rust HTTP.

Getting started

→ Installation guide

→ Contributing guide

Features

You can already use rh, some features are not available yet. And new features will come based on your requests (please file an issue to do so).

• [X] Simple syntax to be more intuitive
• [X] Easy file download & upload
• [X] JSON made simple for command-line
• [X] JSON-friendly
• [X] Headers made simple for command-line
• [ ] Don't repeat yourself with configurations
• [ ] Package manager
• [ ] More options with SSL
• [ ] Multi URLs

For now, the priority is:

• configurations
• package manager
• SSL options

Don't repeat yourself

This feature is in progress and not available yet.

If you're used to execute very often the same requests, you can save time. A config helps to change default values or create shortcuts. You can predefine what you like, it could be only the headers for example, or everything.

For example, someone could create a configuration mp1-status (that would stand for "my-project-1" for example). Let's say you want to execute the following command very often:

```bash

rh http://local-dev-mp1/status -uHhc X-Custom-Header:My-app ```

-uHhc to show the -uRL and the method + to show the request -Headers + to show the response -headers + to show a -compact response

```bash

rh config mp1-status http://local-dev-mp1/status -chuH X-App:My-app ```

So now, you can reuse this config:

```bash

rh mp1-status ```

→ See more about configurations

Examples

Who doesn't like "Hello, World!":

```bash

rh httpbin.org/get ```

Change the method:

```bash

rh HEAD https://httpbin.org/anything ```

Localhost with a particular port:

```bash

rh :9200 ```

You can POST data as JSON (it's the default format, see more about it):

```bash

rh https://httpbin.org/anything X-App:Super1 item1=Hello item2=World ```

You can POST data using the URL encoded format:

```bash

rh https://httpbin.org/anything key1=1 --form ```

You can POST raw data:

```bash

rh https://httpbin.org/anything --raw=hello ```

You can download a file and save it:

```bash

rh https://httpbin.org/image/jpeg > image.jpeg ```

→ More examples

Benchmarks

Some benchmarks have been carried out. But before publishing anything they've been reviewed since the aim is to be accurate and not misleading.

License

rh is distributed under the terms of the MIT license. See LICENSE for details.

Contributing

If you are interested in contributing to the rh project, please take a look at the contributing guide. If you'd like to request a feature or report a bug, please create a GitHub issue.

Thanks to the people developing the third party libraries used in this project.