Skip to main content

An interactive HTTP command-line client

Project description

PyPI Build Coverage

HTTP Prompt is an interactive command-line HTTP client featuring autocomplete and syntax highlighting, built on HTTPie and prompt_toolkit.

http-prompt.gif

Installation

Just install it like a regular Python package:

$ pip install http-prompt

You’ll probably see some permission errors if you’re trying to install it on the system-wide Python. It isn’t recommended. But if that’s what you want to do, you need to sudo:

$ sudo pip install http-prompt

Another alternative is to use --user option to install the package into your user directory:

$ pip install --user http-prompt

To upgrade HTTP Prompt, do:

$ pip install -U http-prompt

Quickstart

Starting a session:

$ http-prompt http://httpbin.org

To change URL address, use cd:

> cd api/v1
> cd http://localhost/api

To add headers, querystring, or body parameters, use the syntax as in HTTPie. The following are all valid:

> Content-Type:application/json username=john
> 'name=John Doe' apikey==abc
> Authorization:"Bearer auth_token"

You can also add HTTPie options like this:

> --form --auth user:pass
> --verify=no username=jane

To preview how HTTP Prompt is going to call HTTPie, do:

> httpie post
http --auth user:pass --form POST http://localhost/api apikey==abc username=john

You can temporarily override the request parameters. The current session won’t be modified:

> httpie /api/something page==2 --json
http --json http://localhost/api/something page==2

> httpie
http http://localhost

To actually send a request, enter one of the HTTP methods:

> get
> post
> put
> patch
> delete
> head

The above HTTP methods also support temporary overriding:

> post /api/v1 --form name=jane
...

> httpie
http http://localhost

To remove an existing header, querystring, body parameter, or HTTPie option:

> rm -h Content-Type
> rm -q apikey
> rm -b username
> rm -o --auth

Roadmap

  • User configuration file, i.e., an RC file

  • More HTTP headers for autocomplete

  • More tests, e.g., integration test and testing on Windows

  • More documentation

  • Support for advanced HTTPie syntax, e.g, field:=json and field=@file.json

  • Inline shell command evaluation

  • HTTP/2 support

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

http-prompt-0.2.0.tar.gz (11.4 kB view hashes)

Uploaded Source

Built Distribution

http_prompt-0.2.0-py3-none-any.whl (14.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page