Merge branch 'develop/1.8'

Author: sunny-chung

CHANGELOG.md

@@ -6,7 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-Nothing yet.
+_Changes since 1.7.3_
+
+### Added
+- Cookie support (Default disabled. Enable in the Subproject Configuration Dialog)
+- On pre-flight, update environment variables according to request headers, query parameters and bodies
+- A "Save Raw" button at the response viewer to save raw response body to a file
+- A floating copy button, next to a literal value under the mouse cursor and in the response body JSON, for copying the literal value
+
+### Changed
+- The "Copy All" button near the response body viewer has been relocated to the upper level, as it copies the whole Request and Response rather than only response body
+- The "Copy All" button under the response tab "Raw" has been renamed to "Copy"
+- The copying content of the above two copy functions now includes the request name and example name as the heading
+
+### Fixed
+- Crash when selecting the last tab of a HTTP request then switching to a gRPC or WS request
 
 
 ## [1.7.3] -- 2025-04-29

build.gradle.kts

@@ -11,7 +11,7 @@ plugins {
 }
 
 group = "com.sunnychung.application"
-version = "1.7.3" // must be in 'x.y.z' for native distributions
+version = "1.8.0-SNAPSHOT" // must be in 'x.y.z' for native distributions
 
 repositories {
     google()
@@ -94,7 +94,10 @@ kotlin {
                 implementation("org.bouncycastle:bcpkix-jdk18on:1.79")
 
                 // text field
-                api("io.github.sunny-chung:bigtext-ui-composable:2.2.0")
+                api("io.github.sunny-chung:bigtext-ui-composable:2.3.0")
+
+                // for proguard to understand the code
+//                implementation("com.github.luben:zstd-jni:1.5.5-11")
             }
 
             resources.srcDir("$buildDir/resources")
@@ -216,5 +219,10 @@ compose.desktop {
                 iconFile.set(project.file("appicon/appicon.png"))
             }
         }
+
+        buildTypes.release.proguard {
+            version.set("7.5.0")
+            configurationFiles.from(project.file("proguard.pro"))
+        }
     }
 }

doc/_include/cookie-editor-1-in-environment.png

@@ -0,0 +1,51 @@
+---
+title: Cookie
+---
+
+# HTTP Cookie
+
+## Enable or Disable
+
+To enable Cookie support, first enable in the Subproject Configuration dialog. It would affect the whole Subproject.
+
+By default, Cookie is disabled.
+
+![Enable Cookie Step 1](../cookie-enable-step-1.png)
+
+![Enable Cookie Step 2](../cookie-enable-step-2.png)
+
+## Receive Cookie
+
+To receive Cookie from servers, an environment must be selected or created. Cookie storage is not shared among multiple environments.
+
+## Send Cookie
+
+If Cookie is enabled, the Cookie storing in the storage would be applied to matching requests automatically. To examine what Cookie would be applied, check the Cookie tab in the Request Example level.
+
+To send custom Cookie in additional to stored Cookie, one can insert Cookie in the Cookie tab in the Request Example level:
+
+![Cookie Editor in Request Example](../cookie-editor-in-request-example.png)
+
+or in the Environment level:
+
+![Cookie Editor 1 in Environment](../cookie-editor-1-in-environment.png)
+
+![Cookie Editor 2 in Environment](../cookie-editor-2-in-environment.png)
+
+## Variables and Functions
+
+Variables and functions are supported only in the "value" field.
+
+However, Cookie containing variable and function macros in the "Set-Cookie" response headers are automatically dropped for security reasons.
+
+For example, in the following response, only the cookie "cookie1" would be stored.
+
+```
+HTTP/1.1 204 No Content
+Set-Cookie: cookie0=some-${{var}}; Max-Age=3600
+Set-Cookie: cookie1=AbcDE; Max-Age=3600
+```
+
+## Applicable Transports
+
+All types of supported HTTP transport, including WebSocket, GraphQL and gRPC, support Cookie. Note that response headers "Set-Cookie" only take effect after the entire request is completed.

doc/_include/cookie-editor-2-in-environment.png

@@ -76,6 +76,8 @@ fun Request<*>.getResolvedUri(): String
  * Get variables merged from the selected environment, the base request example and the selected request example.
  */
 fun Request<*>.getApplicableVariables(): Map<String, String>
+
+fun Request<*>.getApplicableCookies(): Map<String, String>
 ```
 
 #### `MutableRequest`

doc/_include/cookie-editor-in-request-example.png

@@ -60,6 +60,9 @@ The copied text is in a markdown-like format for readability.
 
 Sample of copied text of a simple HTTP call:
 ``````markdown
+Test POST Request - with Unicode JSON body
+==========================================
+
 Request
 -------
 Start Time: 2024-02-18 23:33:31.426 (+08:00)
@@ -136,6 +139,9 @@ Body:
 
 Sample of copied text of a GraphQL subscription call:
 ``````markdown
+Test GraphQL subscription - Intervals
+=====================================
+
 Request
 -------
 Start Time: 2024-02-18 23:35:03.259 (+08:00)
@@ -217,6 +223,9 @@ Closed by us with code 1000
 
 Sample of copied text of a gRPC bidirectional call:
 ``````markdown
+My gRPC Request - Bidirectional
+===============================
+
 Request
 -------
 Start Time: 2024-02-18 23:49:43.670 (+08:00)
@@ -304,12 +313,15 @@ grpc-status: 0
 
 ### Copy Entire Transport Log
 
-Click "Copy All" button in the "Raw" tab.
+Click "Copy" button in the "Raw" tab.
 
 Copied texts are in a table format. It can be imported into spreadsheet softwares, or selected or manipulated in major code editors that support vertical selections, for example, Sublime Text. Don't forget to turn off "word wrap" while viewing the table in code editors.
 
 Sample of copied text:
 ``````
+Test POST Request - with Unicode JSON body
+==========================================
+
 Time                             | Dir | Stream | Detail                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        
 =================================|=====|========|===============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================
 2024-02-18 23:33:31.432 (+08:00) | -   | *      | DNS resolution of domain [httpbin.org] started