Jetbrains released a new cli client.
Please check it.
This repository will no longer active development.
Thank you for trying & feedback.
I learn so much from all you guys here.
Blog: http-client-cli-run-requests-and-tests-on-ci
A missing commandline application for execute IntelliJ HTTP Client file.
Key Features • How To Use • Download • Credits • License • Producthunt
- Written in Kotlin 🤩
- Execute Intellij HTTP request files
- Running test script including:
- Embedded script inside HTTP request file
- Include external javascript test file
- Loading and inject environment variables from
- http-client.env.json
- http-client.private.env.json
- Cross-platform 💻🖥️
- Windows, macOS, and Linux ready.
- Beautiful request log 🤑🤑🤑
- Request & response detail
- Test result table
- Easy to custom via command-line arguments 😎
- Custom logging request
- Inject environment name
- Generate test report - JUnit format. 🥰🥰🥰
- Support setNextRequest. So you can custom flexible the test flow. ✨✨✨
1. Show detail request/response including test result
2. Test result table
3. Generate JUnit test report (XML) that can be viewed by other tools such as xunit-viewer
The fastest way to get rest cli is to download the jar from releases tab
Usage: rest-cli [-hkV] [-d=<environmentFilesDirectory>] [-D=<decorator>]
[-e=<environmentName>] [-l=<logLevel>] [-t=<requestTimeout>]
[-G=<String=String>]... [-P=<String=String>]... FILES...
IntelliJ RestCli
FILES... Path to one ore more http script files.
-d, --env-dir=<environmentFilesDirectory>
Directory where config files are (default: current directory)
(http-client.env.json/http-client.private.env.json).
-D, --decorator=<decorator>
Decorator for private env variables
Valid values: NOOP, THREE_STAR, FULL_STAR, MIDDLE_STAR
-e, --env=<environmentName>
Name of the environment in config file
(http-client.env.json/http-client.private.env.json).
-G, --global-env=<String=String>
Public environment variables
-h, --help Show this help message and exit.
-k, --insecure Disable ssl validation
-l, --log-level=<logLevel>
Config log level while the executor running.
Valid values: NONE, BASIC, HEADERS, BODY
-P, --private-env=<String=String>
Private environment variables
-t, --timeout=<requestTimeout>
Number of milliseconds for request timeout, default=3000
-V, --version Print version information and exit.
# Move to the folder that contains your http files.
$ cd requests
$ tree
├── get-requests.http
├── http-client.env.json
├── http-client.private.env.json
├── post-requests.http
├── request-form-data.json
├── requests-with-authorization.http
├── requests-with-tests.http
└── test_script.js
$ java -jar /path/to/restcli.jar -e "test" get-requests.http
Note: This application required you to install java
on your machine.
You can download the latest version of restcli for Windows, macOS, and Linux.
This software uses the following open-source packages:
- Jflex - a lexical analyzer generator (also known as scanner generator) for Java.
- PicoCli - a mighty tiny command line interface
- okhttp - the way modern applications network. It’s how we exchange data & media. Doing HTTP efficiently makes your stuff load faster and saves bandwidth.
- picnic - A Kotlin DSL and Java/Kotlin builder API for constructing HTML-like tables that can be rendered to text.
- mordant - Full-featured text styling for Kotlin command-line applications.
Thanks Jetbrains for a free license
If you need help, please don't hesitate to file an issue.
This application is free and can be used for free, open-source, and commercial applications. restcli
is under the MIT License (MIT). So hit the magic ⭐ button; I appreciate it!!! 🙏
I appreciate your support and feedback!
Please file issues if you find bugs and have feature requests. If you can send small PRs to improve or fix bugs, that would be awesome too.
For larger PRs, please ping @quangson91 to discuss first.
MIT License
Copyright (c) 2020 Duong Quang Son
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the software, and to permit persons to whom the software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
restcli.github.io · GitHub @quangson91 · Twitter @quangson91
- restcli-node Node docker image with rest-cli command installed.
Thanks goes to these wonderful people (emoji key):
Martin Qvistgård 📓 |
Robert Jack Will 🤔 |
gsobczyk 💻 |
Vlad 📓 |
Nicolas Peters 💻 |
xargon180 💻 |
Hannes U. 💻 |
sbenoistmics 💻 |
Kwangsu Kim 💻 |
This project follows the all-contributors specification. Contributions of any kind welcome!