chore: prepare 0.2.1 release

CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1]
+
 ### Breaking Changes
 
 - Rust generated clients now expose backend-native header maps from

Cargo.toml

@@ -7,7 +7,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.2.0"
+version = "0.2.1"
 edition = "2024"
 rust-version = "1.90"
 description = "OpenAPI 3.x multi-language code generator"

README.md

@@ -30,7 +30,7 @@ OpenAPI Nexus transforms OpenAPI specifications into type-safe client libraries.
 **Shell installer (no Rust toolchain needed):**
 
 ```sh
-curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-codegen-group/openapi-nexus/releases/download/0.2.0/openapi-nexus-installer.sh | sh
+curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-codegen-group/openapi-nexus/releases/download/0.2.1/openapi-nexus-installer.sh | sh
 ```
 
 **Nightly build (latest main):**

docs/src/getting_started.md

@@ -5,7 +5,7 @@
 **Shell installer (no Rust toolchain needed):**
 
 ```sh
-curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-codegen-group/openapi-nexus/releases/download/0.2.0/openapi-nexus-installer.sh | sh
+curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-codegen-group/openapi-nexus/releases/download/0.2.1/openapi-nexus-installer.sh | sh
 ```
 
 **Nightly build (latest main):**

docs/src/response_headers.md

@@ -39,6 +39,44 @@ paths:
               $ref: "#/components/headers/RetryAfter"
 ```
 
+## Reading headers
+
+Generated accessor names follow the operation and header names in the OpenAPI
+document. This Rust example uses an accessor for each declared header and falls
+back to the backend-native header map for an undeclared tracing header:
+
+```rust
+match api.create_resource(&request).await {
+    Ok(response) => {
+        let request_id = response.x_request_id_header();
+        let traceparent = response
+            .headers
+            .get("traceparent")
+            .and_then(|value| value.to_str().ok());
+
+        println!("request_id={request_id:?} traceparent={traceparent:?}");
+    }
+    Err(error) => {
+        let retry_after = error.retry_after_header().map(str::to_owned);
+
+        // Erase the payload type when only common response metadata is needed.
+        let error: ApiCallError = error.into();
+        let traceparent = error
+            .headers()
+            .and_then(|headers| headers.get("traceparent"))
+            .and_then(|value| value.to_str().ok());
+
+        eprintln!("retry_after={retry_after:?} traceparent={traceparent:?}");
+    }
+}
+```
+
+In this example, `X-Request-Id` and `Retry-After` are declared in OpenAPI, so
+the generator provides typed accessors. `traceparent` is undeclared and remains
+available through the native header map. Match the operation-specific error
+before converting it to `ApiCallError` when its decoded body is needed; see
+[Generated Error Handling](rust_config.md#generated-error-handling).
+
 ## Generated access
 
 | Generator | Successful response headers | Error response headers |