docs: update changelog for pact-python/3.0.0a1

Author: JP-Ellis

CHANGELOG.md

@@ -6,6 +6,82 @@ All notable changes to this project will be documented in this file.
 <!-- markdownlint-disable emph-style -->
 <!-- markdownlint-disable strong-style -->
 
+## [pact-python/3.0.0a1] _2025-08-12_
+
+### 🚀 Features
+
+-   Create pact-python-cli package
+-   _(cli)_ Build abi-agnostic wheels
+-   _(ffi)_ Add standalone ffi package
+-   _(v3)_ [**breaking**] Remove pact.v3.ffi module
+    > `pact.v3.ffi` is removed, and to be replaced by `pact_ffi`. That is, `pact.v3.ffi.$fn` should be replaced by `pact_ffi.$fn`.
+-   [**breaking**] Prepare for v3 release
+    > This prepares for version 3. Pact Python v2 will be still accessible under `pact.v2` and all imports should be appropriate renamed. Everyone is encouraged to migrate to Pact Python v3.
+-   [**breaking**] Simplify `given`
+    > The signature of `Interaction.given` has been updated. The following changes are required: - Change `given("state", key="user_id", value=123)` to `given("state", user_id=123)`. This can take an arbitrary number of keyword arguments. If the key is not a valid Python keyword argument, use the dictionary input below. - Change `given("state", parameters={"user_id": 123})` to `given("state", {"user_id": 123})`.
+-   [**breaking**] Deserialize metadata values
+    > As the metadata values are now deserialised, the type of the metadata values may change. For example, setting metadata `user_id=123` will now pass `{"user_id": 123}` through to the function handler. Previously, this would have been `{"user_id": "123"}`.
+
+### 🐛 Bug Fixes
+
+-   Matcher type variance
+-   With metadata function signature
+-   [**breaking**] Use correct datetime default format
+    > If you relied on the previous default (undocumented) behaviour, prefer specifying the format explicitly now: `match.datetime(regex="%Y-%m-%dT%H:%M:%S.%f%z")`.
+-   Handle empty state callback
+-   _(verifier)_ [**breaking**] Propagate branch
+    > If a branch is set through either `set_publish_options` or `provider_branch`, the value will be saved and used as a default for both in subsequent calls.
+
+### 🚜 Refactor
+
+-   Functional state handler
+
+### 📚 Documentation
+
+-   Update changelog for v2.3.3
+-   _(blog)_ Fix v3 references
+-   Fix v3 references
+-   V3 review
+-   Update git cliff configuration
+
+### ⚙️ Miscellaneous Tasks
+
+-   Update pre-commit hooks
+-   Use the new `pact_cli` package
+-   Remove packaging of pact cli
+-   _(ci)_ Incorporate tests of pact cli
+-   _(ci)_ Use new `pact-python/*` tags
+-   _(ci)_ Add build cli pipeline
+-   Exclude hatch_build from mypy checks
+-   _(ci)_ Narrow token permissions
+-   Remove macosx deployment target
+-   _(ci)_ Fix cli publish permissions
+-   Properly extract tag version
+-   Update gitignore
+-   _(ci)_ Fix core package build
+-   Split out dependencies and tests
+-   _(ci)_ Update labels
+-   _(ci)_ Fix labels
+-   _(tests)_ Re-organise tests
+-   Fix bad copy-paste in tests
+-   Log exceptions from apply_args
+-   Improve logging from apply_args
+-   _(examples)_ Start examples overhaul
+-   _(ci)_ Use new examples
+-   Update protobuf examples
+-   _(ci)_ Cancel ci on PRs
+-   Add vscode settings and extensions
+-   Add envrc
+-   Replace yamlfix with yamlfmt
+-   Remove deptry config
+-   Support pre and post release tags
+-   Fix typo
+
+### Contributors
+
+-   @JP-Ellis
+-   @kevinrvaz
+
 ## [2.3.3] _2025-07-17_
 
 ### 🚀 Features
@@ -1441,4 +1517,4 @@ All notable changes to this project will be documented in this file.
 -   @matthewbalvanz-wf
 -   @mefellows
 
-<!-- generated by git-cliff on 2025-07-17-->
+<!-- generated by git-cliff on 2025-08-12-->