Zign OAuth plugin for HTTPie
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE
MAINTAINERS
README.rst
httpie_zign.py
setup.py

README.rst

httpie-zign

STUPS Zign OAuth 2 plugin for the HTTPie command line HTTP client.

Zign is STUPS' command line client to generate OAuth2 access tokens.

Installation

$ pip install httpie-zign

You should now see zign under --auth-type in $ http --help output.

Usage

This plugin takes the Zign token name as the --auth username. The --auth password is used to specify to OAuth scopes. A named Zign OAuth 2 token is created and used with the specified scopes:

$ http --auth-type=zign --auth=mytok:myscope https://example.org
$ http --auth-type=zign -a mytok:myscope1,scope2 https://example.org
$ http --auth-type=zign -a mytok: https://example.org  # use default scopes

You can list the created tokens using the Zign CLI:

$ zign li

You can set the default --auth-type=zign option in the ~/.httpie/config.json file for convenience:

$ echo '{"default_options": ["--auth-type=zign"]}' > ~/.httpie/config.json
$ http -a mytok: https://example.org # that's much shorter now :-)