Skip to content
This repository has been archived by the owner on Dec 20, 2022. It is now read-only.

restcli/restcli

Repository files navigation

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

All Contributors


restcli
restcli

A missing commandline application for execute IntelliJ HTTP Client file.

restcli restcli

Key FeaturesHow To UseDownloadCreditsLicenseProducthunt

screenshot

Key Features

  • 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. ✨✨✨
Demo

demo-rest-cli

1. Show detail request/response including test result

request-with-test-success

request-with-test-failed

2. Test result table

test-result-table

3. Generate JUnit test report (XML) that can be viewed by other tools such as xunit-viewer

generate-junit-test-report

How To Use

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.

Example

# 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.

Download

You can download the latest version of restcli for Windows, macOS, and Linux.

Credits

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

JetBrains Logo (Main) logo.

Support

If you need help, please don't hesitate to file an issue.

Sponsoring

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!!! 🙏

🤝 Contributing

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.

📝 License

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.

Made with by quangson91

restcli.github.io  ·  GitHub @quangson91  ·  Twitter @quangson91

Reference

  • restcli-node Node docker image with rest-cli command installed.

Contributors ✨

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!