Prepare for release 5.1.0.

CHANGELOG.md

@@ -5,6 +5,19 @@ Change Log
 
 See [4.x Change log](https://square.github.io/okhttp/changelogs/changelog_4x/) for the stable version changelogs.
 
+## Version 5.1.0
+
+_2025-07-07_
+
+ *  New: `Response.peekTrailers()`. When we changed `Response.trailers()` to block instead of
+    throwing in 5.0.0, we inadvertently removed the ability for callers to peek the trailers
+    (by catching the `IllegalStateException` if they weren't available). This new API restores that
+    capability.
+
+ *  Fix: Don't crash on `trailers()` if the response doesn't have a body. We broke [Retrofit] users
+    who read the trailers on the `raw()` OkHttp response, after its body was decoded.
+
+
 ## Version 5.0.0
 
 _2025-07-02_
@@ -630,6 +643,7 @@ release is the version name.
 [GraalVM]: https://www.graalvm.org/
 [Gradle module metadata]: https://docs.gradle.org/current/userguide/publishing_gradle_module_metadata.html
 [Ktor]: https://ktor.io/
+[Retrofit]: https://square.github.io/retrofit/
 [annotation_1_9_1]: https://developer.android.com/jetpack/androidx/releases/annotation#annotation-1.9.1
 [assertk]: https://github.com/willowtreeapps/assertk
 [coroutines_1_10_2]: https://github.com/Kotlin/kotlinx.coroutines/releases/tag/1.10.2

README.md

@@ -120,10 +120,10 @@ Releases
 
 Our [change log][changelog] has release history.
 
-The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/okhttp/5.0.0/jar).
+The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/okhttp/5.1.0/jar).
 
 ```kotlin
-implementation("com.squareup.okhttp3:okhttp:5.0.0")
+implementation("com.squareup.okhttp3:okhttp:5.1.0")
 ```
 
 Snapshot builds are [available][snap]. [R8 and ProGuard][r8_proguard] rules are available.
@@ -133,7 +133,7 @@ Also, we have a [bill of materials (BOM)][bom] available to help you keep OkHttp
 ```kotlin
     dependencies {
        // define a BOM and its version
-       implementation(platform("com.squareup.okhttp3:okhttp-bom:5.0.0"))
+       implementation(platform("com.squareup.okhttp3:okhttp-bom:5.1.0"))
 
        // define any required OkHttp artifacts without version
        implementation("com.squareup.okhttp3:okhttp")
@@ -146,10 +146,10 @@ MockWebServer
 
 OkHttp includes a library for testing HTTP, HTTPS, and HTTP/2 clients.
 
-The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/mockwebserver/5.0.0/jar).
+The latest release is available on [Maven Central](https://search.maven.org/artifact/com.squareup.okhttp3/mockwebserver/5.1.0/jar).
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:mockwebserver3:5.0.0")
+testImplementation("com.squareup.okhttp3:mockwebserver3:5.1.0")
 ```
 
 MockWebServer is used for firstly for internal testing, and for basic testing of apps using OkHttp client.

build.gradle.kts

@@ -52,7 +52,7 @@ configure<SpotlessExtension> {
 
 allprojects {
   group = "com.squareup.okhttp3"
-  version = "5.1.0-SNAPSHOT"
+  version = "5.1.0"
 
   repositories {
     mavenCentral()

mockwebserver-junit4/README.md

@@ -6,7 +6,7 @@ This module integrates mockwebserver3.MockWebServer with JUnit 4.
 To use, first add this library as a test dependency:
 
 ```
-testImplementation("com.squareup.okhttp3:mockwebserver3-junit4:5.0.0")
+testImplementation("com.squareup.okhttp3:mockwebserver3-junit4:5.1.0")
 ```
 
 Then in tests annotated `@org.junit.Test`, you may declare a field with the `@Rule` annotation:

mockwebserver-junit5/README.md

@@ -6,7 +6,7 @@ This module integrates mockwebserver3.MockWebServer with JUnit 5.
 To use, first add this library as a test dependency:
 
 ```
-testImplementation("com.squareup.okhttp3:mockwebserver3-junit5:5.0.0")
+testImplementation("com.squareup.okhttp3:mockwebserver3-junit5:5.1.0")
 ```
 
 Annotate fields in test classes with `@StartStop`. The server will be started and shut down

mockwebserver/README.md

@@ -142,7 +142,7 @@ server.setDispatcher(dispatcher);
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:mockwebserver3:5.0.0")
+testImplementation("com.squareup.okhttp3:mockwebserver3:5.1.0")
 ```
 
 ### License

okhttp-brotli/README.md

@@ -14,7 +14,7 @@ OkHttpClient client = new OkHttpClient.Builder()
 ```
 
 ```kotlin
-implementation("com.squareup.okhttp3:okhttp-brotli:5.0.0")
+implementation("com.squareup.okhttp3:okhttp-brotli:5.1.0")
 ```
 
  [1]: https://github.com/google/brotli

okhttp-dnsoverhttps/README.md

@@ -6,7 +6,7 @@ This module is an implementation of [DNS over HTTPS][1] using OkHttp.
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-dnsoverhttps:5.0.0")
+testImplementation("com.squareup.okhttp3:okhttp-dnsoverhttps:5.1.0")
 ```
 
 ### Usage

okhttp-java-net-cookiejar/README.md

@@ -7,5 +7,5 @@ This used to be part of `okhttp-urlconnection`
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-java-net-cookiehandler:5.0.0")
+testImplementation("com.squareup.okhttp3:okhttp-java-net-cookiehandler:5.1.0")
 ```

okhttp-logging-interceptor/README.md

@@ -37,7 +37,7 @@ Download
 --------
 
 ```kotlin
-implementation("com.squareup.okhttp3:logging-interceptor:5.0.0")
+implementation("com.squareup.okhttp3:logging-interceptor:5.1.0")
 ```
 
 

okhttp-sse/README.md

@@ -7,5 +7,5 @@ API is not considered stable and may change at any time.
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-sse:5.0.0")
+testImplementation("com.squareup.okhttp3:okhttp-sse:5.1.0")
 ```

okhttp-tls/README.md

@@ -225,7 +225,7 @@ Download
 --------
 
 ```kotlin
-implementation("com.squareup.okhttp3:okhttp-tls:5.0.0")
+implementation("com.squareup.okhttp3:okhttp-tls:5.1.0")
 ```
 
  [held_certificate]: https://square.github.io/okhttp/4.x/okhttp-tls/okhttp3.tls/-held-certificate/

okhttp-urlconnection/README.md

@@ -8,5 +8,5 @@ This module is obsolete; prefer `okhttp-java-net-cookiejar`.
 ### Download
 
 ```kotlin
-testImplementation("com.squareup.okhttp3:okhttp-urlconnection:5.0.0")
+testImplementation("com.squareup.okhttp3:okhttp-urlconnection:5.1.0")
 ```