About
- š Are you tired of your UI http client asking you to sign in/sign up so
they can create proper
workspace
for you? (and get your email to send you marketing emails) - :hourglass_flowing_sand: Are you waiting for ages until your UI http client loads all itās functionalities and plugins that you donāt need?
- šļø Are you spending lots of time trying to find requests youāve sent to given api months ago?
- š¬ Are you searching how to change request method in
curl
because you donāt usecurl
that often? - š Are you working with modern json http apiās?
- :dash: Do you want to write smoke tests for your api?
jsonr
is a simple CLI tool for interacting with json http apiās and writing simple smoke
tests. Itās available from your terminal anytime when you need it (so you donāt
need to switch context) and itās not aimed to be an ultimate solution for
everything. Thatās why itās so simple to use. No more need to browse lots of documentation about
tons of features that you donāt need. 5 minutes and you are ready to send any requests.
Run jsonr --help
for details.
Prerequisites
Deno runtime environment https://deno.land
Installation
deno install -f -r --allow-net --allow-read --allow-write https://deno.land/x/jsonr/main.js
--allow-write
permission is needed only if you are planning to use -o
parameter (write response body to file, check jsonr --help
for details)
If your requests are failing due to certificate validation errors (and you trust
target server) you can run temporary
command like:
deno run --allow-net --unsafely-ignore-certificate-errors https://deno.land/x/jsonr/main.js ...
It will display warning about disable ssl verification, but you should be able
to perform requests. If you work frequently with such unsafe servers you can
consider introducing jsonr-unsafe
sitting next to your main jsonr
instance:
deno install -n jsonr-unsafe -f -r --unsafely-ignore-certificate-errors --allow-net --allow-read --allow-write https://deno.land/x/jsonr/main.js
Usage
Sample usage:
jsonr -h "Authorization: Bearer MyToken" my-request.http
my-request.http
file content:
POST http://my-api.com/endpoint
{
"someKey": "someValue"
}
Type jsonr --help
for more details on usage once you have a tool installed.
Hints
If you want to disable colors (at least for main log messages), you can use:
NO_COLOR=1 jsonr ...
Contribution
If you want to implement/request new features you are more than welcome to contribute. Please keep in mind that this tool is supposed to be super simple to use and cover ~80% of use cases for playing around with JSON HTTP APIās. Instructions (āhelp) for this tool should be possible to read in less than 5 minutes. If more features will be added this may be hard to achieve.