Skip to content

Commit 2bf25eb

Browse files
authored
Merge pull request #2 from restcli/update_docs
Update docs
2 parents 0f78786 + 275fe9b commit 2bf25eb

16 files changed

+82
-16
lines changed

.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,3 +117,5 @@ dist
117117

118118
.docusaurus/
119119
build/
120+
121+
.idea/

docs/about.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,29 @@
22
id: about
33
title: About
44
sidebar_label: About
5+
slug: /
56
---
67

7-
### About
8+
A missing commandline application for execute IntelliJ HTTP Client file.
9+
10+
** Features **
11+
12+
* Written by Kotlin 🤩
13+
* Execute Intellij HTTP request files
14+
* Running test script including:
15+
- Embedded script inside HTTP request file
16+
- Include external javascript test file
17+
* Loading and inject environment variables from
18+
- http-client.env.json
19+
- http-client.private.env.json
20+
* Cross platform 💻🖥️
21+
- Windows, macOS and Linux ready.
22+
* Beautiful request log 🤑🤑🤑
23+
- Request & response detail
24+
- Test result table
25+
* Easy to custom via commandline arguments 😎
26+
- Custom logging request
27+
- Inject environment name
28+
* [Generate test report - junit format.](https://github.com/quangson91/demo_intellij_rest_cli) 🥰🥰🥰
29+
* [Support setNextRequest. So you can custom flexbile the test flow](https://github.com/quangson91/intellij_rest_cli/releases/tag/v1.5) ✨✨✨
30+

docs/features.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,15 @@ title: Features
44
sidebar_label: Features
55
---
66

7-
## Features
7+
### Show detail request/response including test result
88

9-
### Feature 1
9+
![request-with-test-success](/img/request-with-test-success.png)
10+
![request-with-test-failed](/img/request-with-test-failed.png)
1011

11-
### Feature 2
12+
### Test result table
1213

13-
### Feature 3
14+
![test-result-table](/img/test-result-table.png)
15+
16+
### Generate junit test report (xml) that can be viewed by other tools such as xunit-viewer
17+
18+
![generate-junit-test-report](/img/generate-junit-test-report.png)

docs/gitlab-pipeline-integration.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,5 @@ id: gitlab-pipeline-integration
33
title: Gitlab pipeline
44
---
55

6+
# TODO
67
Using rest-cli in gitlab pipeline

docs/how-to-use.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
id: how-to-use
3+
title: How to use
4+
sidebar_label: How to use
5+
---
6+
7+
```
8+
Usage: rest-cli [-hV] [-e=<environmentName>] [-l=<logLevel>]
9+
[-r=<testReportNames>] FILES...
10+
IntelliJ RestCli
11+
FILES... Path to one ore more http script files.
12+
-e, --env=<environmentName>
13+
Name of the environment in config file
14+
(http-client.env.json/http-client.private.env.json).
15+
-h, --help Show this help message and exit.
16+
-l, --log-level=<logLevel>
17+
Config log level while the executor running.
18+
Valid values: NONE, BASIC, HEADERS, BODY
19+
-r, --report-names=<testReportNames>
20+
Custom test report names inside folder "test-reports".
21+
The report names must separate by ':' character;
22+
If the split string of the report name is empty, then the
23+
test request file name will
24+
be used for report name
25+
Such as:
26+
java -jar restcli.jar -r custom_report1::custom_report3 test1.
27+
http test2.http test3.http
28+
Then the test report for test1.http will be custom_report1.xml
29+
test2.http -> test2.xml (Because the report name for test2.
30+
http is empty)
31+
test3.http -> custom_report3.xml
32+
-V, --version Print version information and exit.
33+
```

docs/jenkins-integration.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,5 @@ id: jenkins-ci-integration
33
title: Jenkins CI
44
---
55

6+
# TODO
67
Using rest-cli in jenkins

docs/roadmap.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,10 @@
11
---
22
id: roadmap
3-
title: Intro
4-
sidebar_label: Intro
3+
title: Roadmap
4+
sidebar_label: Roadmap
55
---
66

77
### Roadmap
8+
- Build docker image.
9+
- Support install via home-brew.
10+
- Add docs for integrates with CI tools such as: jenkins, travis, gitlab ci.

docs/travisci-integration.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,5 @@ id: travis-integration
33
title: Travis CI
44
---
55

6+
# TODO
67
Using rest-cli in Travis CI

docusaurus.config.js

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,6 @@ module.exports = {
3838
'@docusaurus/preset-classic',
3939
{
4040
docs: {
41-
// It is recommended to set document id as docs home page (`docs/` path).
42-
homePageId: 'about',
4341
sidebarPath: require.resolve('./sidebars.js'),
4442
// Please change this to your repo.
4543
editUrl:

sidebars.js

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,12 @@ module.exports = {
99
id: 'features',
1010
},
1111
{
12-
type: 'category',
13-
label: 'CI Integration',
14-
items: [
15-
'gitlab-pipeline-integration',
16-
'jenkins-ci-integration',
17-
'travis-integration',
18-
],
12+
type: 'doc',
13+
id: 'how-to-use',
14+
},
15+
{
16+
type: 'doc',
17+
id: 'roadmap',
1918
},
2019
],
2120
};

0 commit comments

Comments
 (0)