add feature test tutorial

Author: 0hsn

docs/assets/http-resp-xkcdcom.png

@@ -0,0 +1,91 @@
+---
+title: Write feature test for API
+---
+
+:::note
+- **Prerequisite**: First, [setup **CHKware**](/setup) to continue
+- Find [More `testcase` examples](/examples/testcase-examples) here
+:::
+
+Let's continue to test our [_XKCD.com JSON API http client_](/tutorials/http-client) that we covered earlier. Please do as follows:
+
+- Create a file called `xkcd-joke-test.chk` on the same directory where your created `xkcd-joke.chk` early.
+- Open `xkcd-joke-test.chk` file, and add following spec. 
+
+  As you can see, it's possible to combine both `http` request and `testcase` spec on same file. See [Testcase example](/examples/testcase-examples) for other asserts you can write.
+
+  ```yaml
+  ---
+  version: default:testcase:0.7.2
+  request:
+    url: https://xkcd.com/614/info.0.json
+    method: GET
+
+  spec:
+    asserts:
+      - {type: AssertEqual, actual: $_response.code, expected: 200}
+      - {type: AssertIsInt, actual: $_response.body.num}
+      - {type: AssertEqual, actual: $_response.body.year, expected: 2009}
+  ```
+
+  Here notice the `verison` string **`version: default:testcase:0.7.2`**, this is important for this specification to be a [testcase specification](/references/testcase-reference).
+
+- Open a terminal. Hit enter after writing following command on terminal.
+
+  ```bash
+  chk testcase xkcd-joke-test.chk
+  ```
+
+  You'll get output like following. Data will vary depending on the day you are doing it.
+
+  ```bash
+  File: xkcd-joke-test.chk
+
+  - Making request [Success]
+  - Process data for assertion [Success]
+  - Prepare exposable [Success]
+
+  ---
+  -> Running `AssertEqual` on `$_response.code` [Success]
+  -> Running `AssertIsInt` on `$_response.body.num` [Success]
+  -> Running `AssertEqual` on `$_response.body.year` [Success]
+  ```
+
+  You just tested a live API :rocket::star2:.
+
+  Let us go through the testcase spec. we wrote. If you call the API `https://xkcd.com/614/info.0.json` in any Firefox, the response will be shown like this:
+
+  ![CHKware](../assets/http-resp-xkcdcom.png)
+
+  Please notice that the response contains node `num` and `year` on it. Thus on the spec. in `asserts` we are doing three assertions.
+  - If response we got, has code 200; otherwise whether the response was successful.
+  - If response body contains a node `num`, and does it hold an integer value.
+  - If response body contains a node `year`, and does it hold value `2009`.
+
+- Now If you add `--result` or `-r` flag to the command then it should show you the result in formatted output.
+  ```bash
+  chk testcase xkcd-joke-test.chk --result
+  ```
+  
+  You should be able to see following if no exception occurs.
+
+  ```bash 
+  -> Running `AssertEqual` on `$_response.code` [Success]
+  -> Running `AssertIsInt` on `$_response.body.num` [Success]
+  -> Running `AssertEqual` on `$_response.body.year` [Success]
+  ```
+
+- These above response are coming as formatted output. If you want to see all JSON just pass the `--no-fomat` or `-nf` option flag.
+  ```bash
+  chk testcase xkcd-joke-test.chk --result --no-format
+  ```
+  and response looks like this.
+
+  ```bash
+  [[{"name": "AssertEqual", "name_run": "AssertEqual_bf476fda9fa211ed8f6dca2350850d2e", "actual_original": "$_response.code", "is_success": true, "message": "", "assert_fn": ""}, {"name": "AssertIsInt", "name_run": "AssertIsInt_bf4783309fa211ed8f6dca2350850d2e", "actual_original": "$_response.body.num", "is_success": true, "message": "", "assert_fn": ""}, {"name": "AssertEqual", "name_run": "AssertEqual_bf4784709fa211ed8f6dca2350850d2e", "actual_original": "$_response.body.year", "is_success": true, "message": "", "assert_fn": ""}]]
+  ```
+---
+
+This way you can write API feature test. More [testcase examples](/examples/testcase-examples) here.
+
+:wink::tada::confetti_ball:

docs/tutorials/feature-test.md

@@ -104,7 +104,8 @@ Let's call the [_XKCD.com JSON API_](https://xkcd.com/json.html) that returns a
   [{"code": 200, "version": "HTTP/1.1", "reason": "OK", "headers": {"Connection": "keep-alive", "Content-Length": "660", "Server": "nginx", "Content-Type": "application/json", "Last-Modified": "Fri, 27 Jan 2023 12:54:53 GMT", "ETag": "W/\"63d3c99d-5ac\"", "Expires": "Sat, 28 Jan 2023 21:16:28 GMT", "Cache-Control": "max-age=300", "Content-Encoding": "gzip", "Via": "1.1 varnish, 1.1 varnish", "Accept-Ranges": "bytes", "Date": "Sun, 29 Jan 2023 06:13:14 GMT", "Age": "0", "X-Served-By": "cache-dfw-kdfw8210071-DFW, cache-qpg1267-QPG", "X-Cache": "HIT, HIT", "X-Cache-Hits": "1, 1", "X-Timer": "S1674972795.677591,VS0,VE316", "Vary": "Accept-Encoding"}, "body": {"month": "7", "num": 614, "link": "", "year": "2009", "news": "", "safe_title": "Woodpecker", "transcript": "[[A man with a beret and a woman are standing on a boardwalk, leaning on a handrail.]]\nMan: A woodpecker!\n<<Pop pop pop>>\nWoman: Yup.\n\n[[The woodpecker is banging its head against a tree.]]\nWoman: He hatched about this time last year.\n<<Pop pop pop pop>>\n\n[[The woman walks away.  The man is still standing at the handrail.]]\n\nMan: ... woodpecker?\nMan: It's your birthday!\n\nMan: Did you know?\n\nMan: Did... did nobody tell you?\n\n[[The man stands, looking.]]\n\n[[The man walks away.]]\n\n[[There is a tree.]]\n\n[[The man approaches the tree with a present in a box, tied up with ribbon.]]\n\n[[The man sets the present down at the base of the tree and looks up.]]\n\n[[The man walks away.]]\n\n[[The present is sitting at the bottom of the tree.]]\n\n[[The woodpecker looks down at the present.]]\n\n[[The woodpecker sits on the present.]]\n\n[[The woodpecker pulls on the ribbon tying the present closed.]]\n\n((full width panel))\n[[The woodpecker is flying, with an electric drill dangling from its feet, held by the cord.]]\n\n{{Title text: If you don't have an extension cord I can get that too.  Because we're friends!  Right?}}", "alt": "If you don't have an extension cord I can get that too.  Because we're friends!  Right?", "img": "https://imgs.xkcd.com/comics/woodpecker.png", "title": "Woodpecker", "day": "24"}}]
   ```
 ---
+This way you can use `chk http` as your script-able http client.
 
-This way you can use `chk http` as your script-able http client. Let's write a feature test or [testcase](/examples/testcase-examples) for this request.
+Next, let's write a feature test or [testcase](/tutorials/feature-test) for this request.
 
 :wink::tada::confetti_ball:

docs/tutorials/http-client.md

@@ -43,6 +43,7 @@ const sidebars = {
           label: "Tutorial",
           items: [
             "tutorials/http-client",
+            "tutorials/feature-test",
           ],
         },
         "examples/http-examples",