feat: add scripted/non-interactive usage support (#31)

* feat: add scripted/non-interactive usage support

Add four features for scripted/non-interactive CLI usage:

- Typed parameter substitution (|boolean, |number, |file) with validation
- Multipart file uploads via |file type params
- Non-interactive body handling (editor no longer opens by default, use -e)
- Structured JSON output via --json flag

Also resolves all pre-existing clippy warnings across the codebase and
bumps version to 0.6.0 (breaking: editor behavior change).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add one-time upgrade notice for v0.6.0 editor behavior change

Shows a one-time warning on first run after upgrading that the editor
no longer opens automatically for request bodies, and exits early so
the user can re-run with awareness of the --edit-body flag.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: update README with new v0.6.0 features

Add documentation for request body handling, typed parameters
(boolean, number, file), multipart file uploads, --edit-body,
--body-file, and --json output flags.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: meshde

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "hit-cli"
-version = "0.5.1"
+version = "0.6.0"
 edition = "2021"
 authors = ["Mehmood S. Deshmukh <meshde.md@gmail.com>"]
 homepage = "https://usehit.dev"
@@ -29,7 +29,7 @@ hyper = "1.3.1"
 inquire = "0.7.5"
 openapiv3 = "1.0.1"
 regex = "1.10.4"
-reqwest = {version="0.12.3", features=["json"]}
+reqwest = {version="0.12.3", features=["json", "multipart"]}
 serde = {version="1.0.200", features=["derive"]}
 serde_json = "1.0"
 serde_yaml = "0.9"
@@ -40,5 +40,6 @@ tokio = {version = "1.37.0", features = ["full"]}
 [dev-dependencies]
 assert_cmd = "2.0.17"
 insta = {version="1.43.1", features=["json"]}
+mockito = "1.7"
 predicates = "3.1.3"
 rstest = "0.25.0"

Cargo.toml

@@ -258,6 +258,135 @@ hit run users get --user-id 47
 ```
 
 
+### Request Body
+
+Commands that use `POST`, `PUT`, or `PATCH` methods can include a request body in the config. Parameters in the body work the same way as route params — prefix them with `:` and pass values as command-line options.
+
+```json
+{
+  "commands": {
+    "create-user": {
+      "url": "{{API_URL}}/users",
+      "method": "POST",
+      "body": {
+        "name": ":name",
+        "email": ":email"
+      }
+    }
+  }
+}
+```
+
+```bash
+hit run create-user --name "Jane Doe" --email "jane@example.com"
+```
+
+#### Editing the Body Before Sending
+
+If you want to review or modify the request body in your system editor before sending, use the `--edit-body` (or `-e`) flag:
+
+```bash
+hit run create-user --name "Jane Doe" --email "jane@example.com" --edit-body
+```
+
+#### Providing the Body from a File
+
+Instead of using the body defined in the config, you can provide a body from a file using `--body-file`:
+
+```bash
+hit run create-user --body-file payload.json
+```
+
+The file contents support environment variable substitution (double curly brace syntax) just like the config body.
+
+### Typed Parameters
+
+By default, all parameter values are substituted as strings. For JSON request bodies, you may need values to be a specific JSON type. `hit` supports type annotations on parameters using the `|type` suffix.
+
+#### Boolean Parameters
+
+Use `|boolean` to substitute the value as a JSON boolean (`true`/`false`) instead of a string:
+
+```json
+{
+  "commands": {
+    "update-setting": {
+      "url": "{{API_URL}}/settings",
+      "method": "POST",
+      "body": {
+        "dryRun": ":dryRun|boolean",
+        "name": ":name"
+      }
+    }
+  }
+}
+```
+
+```bash
+hit run update-setting --dry-run true --name "test"
+# Sends: {"dryRun": true, "name": "test"}
+```
+
+#### Number Parameters
+
+Use `|number` to substitute the value as a JSON number:
+
+```json
+{
+  "commands": {
+    "list-items": {
+      "url": "{{API_URL}}/items",
+      "method": "POST",
+      "body": {
+        "limit": ":limit|number"
+      }
+    }
+  }
+}
+```
+
+```bash
+hit run list-items --limit 42
+# Sends: {"limit": 42}
+```
+
+#### File Parameters
+
+Use `|file` to upload a file as part of a multipart form request. When a file parameter is present, the request is automatically sent as `multipart/form-data`:
+
+```json
+{
+  "commands": {
+    "upload": {
+      "url": "{{API_URL}}/upload",
+      "method": "POST",
+      "body": {
+        "document": ":filePath|file",
+        "description": ":description"
+      }
+    }
+  }
+}
+```
+
+```bash
+hit run upload --file-path ./report.pdf --description "Monthly report"
+```
+
+### JSON Output
+
+By default, `hit` pretty-prints the response body with syntax highlighting. For scripted or non-interactive usage, the `--json` flag outputs the full response (URL, status code, headers, and body) as a single JSON object:
+
+```bash
+hit run list-users --json
+```
+
+This is useful for piping into `jq` or other tools:
+
+```bash
+hit run list-users --json | jq '.body | fromjson | .[] | .name'
+```
+
 ### Inspecting the response of an API call
 
 Normally, running a command would simply output the body of the response of the API call being made. If you would like to inspect the entire response including the status code and response headers, this can be done by running the command:

README.md

@@ -7,5 +7,6 @@ pub struct EnvUseArguments {
 }
 
 pub fn init(args: EnvUseArguments) -> Result<(), Box<dyn std::error::Error>> {
-    Ok(set_env(args.env))
+    set_env(args.env);
+    Ok(())
 }

src/cli/env/use.rs

@@ -8,5 +8,6 @@ pub struct EphenvSetArguments {
 }
 
 pub fn init(args: EphenvSetArguments) -> Result<(), Box<dyn std::error::Error>> {
-    Ok(set_ephenv(args.key, args.value))
+    set_ephenv(args.key, args.value);
+    Ok(())
 }