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

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.