From 4cc74abc40d8d567adf208eed0cd005424f62326 Mon Sep 17 00:00:00 2001
From: Will Ockmore <will.ockmore@gmail.com>
Date: Mon, 20 Apr 2026 08:49:05 +0800
Subject: [PATCH] version 0.5.0

---
 CHANGELOG.md         | 15 +++++++++++++++
 docs/contributing.md |  5 +----
 pyproject.toml       |  2 +-
 3 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0fc50e5..dd09319 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-04-20
+
+### Added
+- `total_timeout` parameter on `Retry` to cap the cumulative time spent sleeping across retry attempts on a single request.
+- FAQ section explaining retry behaviour for read errors.
+- Security note in the logging docs warning that DEBUG logs include full request URLs, including query strings.
+
+### Changed
+- Dropped support for Python 3.9; added classifiers for Python 3.13 and 3.14.
+- Non-standard HTTP methods are now accepted without raising; `Retry.allowed_methods` stores uppercase strings rather than `http.HTTPMethod` members.
+
+### Fixed
+- Log a warning when a `Retry-After` HTTP-date value is parsed without timezone info, instead of silently using the local offset.
+- `parse_retry_after` now rejects non-ASCII digit characters per RFC 7231.
+
 ## [0.4.6] - 2026-02-18
 
 ### Fixed
diff --git a/docs/contributing.md b/docs/contributing.md
index cad23ec..828fe8e 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -82,10 +82,7 @@ To release a new version:
 
 1. Update version in `pyproject.toml` following [Semantic versioning](https://semver.org/spec/v2.0.0.html) (for example: `0.2.4`)
 2. Update `CHANGELOG.md`, following [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
-3. Create a new release on GitHub:
-   - Tag version like `0.2.4`
-   - Title `0.2.4`
-   - Description copied from the changelog
+3. Create a new release on GitHub. Tag version like `0.2.4`. Title `0.2.4`. Description copied from the changelog, including references to PRs for changes.
 4. The GitHub release will automatically trigger a PyPI publish
 
 If the PyPI publish fails, you can manually publish using:
diff --git a/pyproject.toml b/pyproject.toml
index 57d19bb..d4df1f4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "httpx-retries"
-version = "0.4.6"
+version = "0.5.0"
 description = "A retry layer for HTTPX."
 requires-python = ">=3.10"
 authors = [{ name = "Will Ockmore", email = "will.ockmore@gmail.com" }]