Merge branch 'main' into issue-3998

Author: patrick91

CHANGELOG.md

@@ -1,6 +1,76 @@
 CHANGELOG
 =========
 
+0.285.0 - 2025-11-10
+--------------------
+
+This release removes support for Apollo Federation v1 and improves Federation v2 support with explicit version control and new directives.
+
+## Breaking Changes
+
+- **Removed support for Apollo Federation v1**: All schemas now use Federation v2
+- **Removed `enable_federation_2` parameter**: Replaced with `federation_version` parameter
+- Federation v2 is now always enabled with version 2.11 as the default
+
+## Migration
+
+### If you were using `enable_federation_2=True`
+
+Remove the parameter:
+
+```python
+# Before
+schema = strawberry.federation.Schema(query=Query, enable_federation_2=True)
+
+# After
+schema = strawberry.federation.Schema(query=Query)
+```
+
+### If you were using Federation v1
+
+You must migrate to Federation v2. See the [breaking changes documentation](https://strawberry.rocks/docs/breaking-changes/0.285.0) for detailed migration instructions.
+
+## New Features
+
+- **Version control**: Specify Federation v2 versions (2.0 - 2.11):
+
+```python
+schema = strawberry.federation.Schema(
+    query=Query, federation_version="2.5"  # Specify a specific version if needed
+)
+```
+
+- **New directives**: Added support for `@context`, `@fromContext`, `@cost`, and `@listSize` directives (v2.7+)
+- **Automatic validation**: Ensures directives are compatible with your chosen federation version
+- **Improved performance**: Faster version parsing using dictionary lookups
+
+Contributed by [Patrick Arminio](https://github.com/patrick91) via [PR #4045](https://github.com/strawberry-graphql/strawberry/pull/4045/)
+
+
+0.284.4 - 2025-11-10
+--------------------
+
+Bumped minimum Typer version to fix strawberry CLI commands.
+
+Contributed by [Val Liu](https://github.com/valliu) via [PR #4049](https://github.com/strawberry-graphql/strawberry/pull/4049/)
+
+
+0.284.3 - 2025-11-10
+--------------------
+
+Removed `Transfer-Encoding: chunked` header from multipart streaming responses. This fixes HTTP 405 errors on Vercel and other serverless platforms. The server/gateway will handle chunked encoding automatically when needed.
+
+Contributed by [Louis Amon](https://github.com/LouisAmon) via [PR #4047](https://github.com/strawberry-graphql/strawberry/pull/4047/)
+
+
+0.284.2 - 2025-11-05
+--------------------
+
+Update typing of `variables` in the test clients to match the actual flexibility of this field.
+
+Contributed by [Ben XO](https://github.com/ben-xo) via [PR #4044](https://github.com/strawberry-graphql/strawberry/pull/4044/)
+
+
 0.284.1 - 2025-10-18
 --------------------
 

docs/breaking-changes.md

@@ -4,6 +4,8 @@ title: List of breaking changes and deprecations
 
 # List of breaking changes and deprecations
 
+- [Version 0.285.0 - 10 November 2025](./breaking-changes/0.285.0.md)
+- [Version 0.285.0 - 6 October 2025](./breaking-changes/0.283.0.md)
 - [Version 0.279.0 - 19 August 2025](./breaking-changes/0.279.0.md)
 - [Version 0.278.1 - 5 August 2025](./breaking-changes/0.278.1.md)
 - [Version 0.268.0 - 10 May 2025](./breaking-changes/0.268.0.md)

docs/breaking-changes/0.285.0.md

@@ -0,0 +1,174 @@
+---
+title: 0.285.0 Breaking Changes
+slug: breaking-changes/0.285.0
+---
+
+# v0.285.0 Breaking Changes
+
+This release removes support for Apollo Federation v1 and updates the federation
+API to always use Federation v2.
+
+## What Changed
+
+The `enable_federation_2` parameter has been removed and replaced with
+`federation_version`. Federation v2 is now always enabled, with version 2.11 as
+the default.
+
+```python
+# Before (0.284.x and earlier)
+schema = strawberry.federation.Schema(
+    query=Query, enable_federation_2=True  # Opt-in to Federation 2
+)
+
+# After (0.285.0+)
+schema = strawberry.federation.Schema(
+    query=Query, federation_version="2.11"  # Defaults to "2.11", always Federation 2
+)
+```
+
+## Impact on Your Code
+
+### Federation v2 Users
+
+If you were already using `enable_federation_2=True`, you can remove that
+parameter:
+
+```python
+# Before
+schema = strawberry.federation.Schema(query=Query, enable_federation_2=True)
+
+# After
+schema = strawberry.federation.Schema(query=Query)
+```
+
+Your schemas will continue to work without changes and will now default to
+Federation v2.11.
+
+### Federation v1 Users
+
+If you were using Federation v1 (without `enable_federation_2`), you **must**
+migrate to Federation v2. Apollo Federation v1 is no longer supported by
+Strawberry.
+
+Federation v2 provides better schema composition and additional features. Most
+v1 schemas can be migrated with minimal changes:
+
+```python
+# Before (Federation v1)
+schema = strawberry.federation.Schema(query=Query)
+
+# After (Federation v2)
+schema = strawberry.federation.Schema(query=Query)  # Now uses v2.11
+```
+
+Key differences in Federation v2:
+
+1. **No `extend` keyword needed**: Types no longer need to be marked as
+   extensions
+2. **No `@external` required**: The `@key` directive alone is sufficient in most
+   cases
+3. **`@shareable` directive**: Use this to indicate fields that can be resolved
+   by multiple subgraphs
+4. **`@link` directive**: Automatically added to declare federation spec version
+
+See the
+[Apollo Federation v2 migration guide](https://www.apollographql.com/docs/federation/federation-2/moving-to-federation-2/)
+for more details.
+
+## Specifying Federation Version
+
+You can now specify which Federation v2 version to use:
+
+```python
+schema = strawberry.federation.Schema(
+    query=Query, federation_version="2.5"  # Use a specific version
+)
+```
+
+Supported versions: 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 2.10, 2.11
+
+This is useful if you need to ensure compatibility with a specific Apollo Router
+or Gateway version, or if you want to avoid using newer directives.
+
+### Version Validation
+
+Strawberry validates that directives are compatible with your chosen federation
+version:
+
+```python
+from strawberry.federation.schema_directives import Cost
+
+
+@strawberry.federation.type
+class Product:
+    name: str = strawberry.federation.field(
+        directives=[Cost(weight=10)]  # Requires v2.9+
+    )
+
+
+# This will raise an error because @cost requires v2.9+
+schema = strawberry.federation.Schema(
+    query=Query, federation_version="2.5"  # Too old for @cost
+)
+```
+
+## Why This Change?
+
+1. **Apollo Federation v1 is deprecated**: Apollo has moved to Federation v2 as
+   the standard
+2. **Simpler API**: Removes the boolean flag in favor of explicit version
+   control
+3. **Better features**: Federation v2 provides improved schema composition and
+   new directives
+4. **Version control**: Users can now specify exact federation versions for
+   compatibility
+
+## Migration Steps
+
+### Step 1: Check Your Current Usage
+
+If you're using `enable_federation_2=False` or not setting it at all, you're
+using Federation v1 and need to migrate.
+
+### Step 2: Remove Federation v1 Code
+
+```python
+# Remove this parameter
+schema = strawberry.federation.Schema(
+    query=Query, enable_federation_2=True  # Remove this line
+)
+```
+
+### Step 3: Update Federation v1 Patterns
+
+If you were using Federation v1 patterns like `extend=True` and explicit
+`@external` fields, you can simplify:
+
+```python
+# Before (Federation v1)
+@strawberry.federation.type(keys=["id"], extend=True)
+class Product:
+    id: strawberry.ID = strawberry.federation.field(external=True)
+    reviews: list[Review]
+
+
+# After (Federation v2)
+@strawberry.federation.type(keys=["id"])
+class Product:
+    id: strawberry.ID
+    reviews: list[Review]
+```
+
+### Step 4: Test Your Schema
+
+Run your schema composition and tests to ensure everything works correctly with
+Federation v2.
+
+## Need Help?
+
+- See the [Federation guide](../guides/federation.md) for comprehensive usage
+  examples
+- Review the
+  [Apollo Federation v2 documentation](https://www.apollographql.com/docs/federation/federation-2/new-in-federation-2/)
+- If you encounter issues, please
+  [report them on GitHub](https://github.com/strawberry-graphql/strawberry/issues)

docs/guides/federation.md

@@ -70,13 +70,22 @@ class Query:
     all_books: List[Book] = strawberry.field(resolver=get_all_books)
 
 
-schema = strawberry.federation.Schema(query=Query, enable_federation_2=True)
+schema = strawberry.federation.Schema(query=Query)
 ```
 
 <Note>
 
-`enable_federation_2=True` is used to enable Apollo Federation 2 and currently
-defaults to `False`. This will change in a future version of Strawberry.
+Strawberry supports Apollo Federation 2 only. By default, schemas use Federation
+version 2.11 (the latest supported version). You can specify a different version
+if needed:
+
+```python
+schema = strawberry.federation.Schema(
+    query=Query, federation_version="2.5"  # Specify a specific version if needed
+)
+```
+
+Supported versions: 2.0 - 2.11
 
 </Note>
 
@@ -142,9 +151,7 @@ class Query:
     _hi: str = strawberry.field(resolver=lambda: "Hello World!")
 
 
-schema = strawberry.federation.Schema(
-    query=Query, types=[Book, Review], enable_federation_2=True
-)
+schema = strawberry.federation.Schema(query=Query, types=[Book, Review])
 ```
 
 Now things are looking more interesting; the `Review` type is a GraphQL type
@@ -327,7 +334,7 @@ Strawberry and Federation. The repo is available here:
 
 Strawberry provides implementations for
 [Apollo federation-specific GraphQL directives](https://www.apollographql.com/docs/federation/federated-types/federated-directives/)
-up to federation spec v2.7.
+up to federation spec v2.11.
 
 Some of these directives may not be necessary to directly include in your code,
 and are accessed through other means.
@@ -376,7 +383,7 @@ Will result in the following GraphQL schema:
 ```graphql
 schema
   @link(
-    url: "https://specs.apollo.dev/federation/v2.7"
+    url: "https://specs.apollo.dev/federation/v2.11"
     import: ["@key", "@inaccessible", "@shareable", "@tag"]
   ) {
   query: Query

federation-compatibility/schema.py

@@ -309,5 +309,5 @@ def deprecated_product(self, sku: str, package: str) -> DeprecatedProduct | None
 
 
 schema = strawberry.federation.Schema(
-    query=Query, enable_federation_2=True, types=[Inventory]
+    query=Query, types=[Inventory], federation_version="2.7"
 )

poetry.lock

@@ -1,6 +1,6 @@
 [project]
 name = "strawberry-graphql"
-version = "0.284.1"
+version = "0.285.0"
 description = "A library for creating GraphQL APIs"
 authors = [{ name = "Patrick Arminio", email = "[email protected]" }]
 license = { text = "MIT" }
@@ -45,7 +45,7 @@ debug-server = [
   "uvicorn>=0.11.6",
   "websockets>=15.0.1,<16",
   "python-multipart>=0.0.7",
-  "typer>=0.7.0",
+  "typer>=0.12.4",
   "pygments~=2.3",
   "rich>=12.0.0",
   "libcst",
@@ -60,7 +60,7 @@ sanic = ["sanic>=20.12.2"]
 fastapi = ["fastapi>=0.65.2", "python-multipart>=0.0.7"]
 chalice = ["chalice~=1.22"]
 cli = [
-  "typer>=0.7.0",
+  "typer>=0.12.4",
   "pygments~=2.3",
   "rich>=12.0.0",
   "libcst",
@@ -97,7 +97,7 @@ dev = [
   "python-multipart (>=0.0.7)",
   "rich (>=12.5.1)",
   "sanic-testing (>=22.9,<24.0)",
-  "typer (>=0.7.0)",
+  "typer (>=0.12.4)",
   "types-aiofiles (>=24.1.0.20250326,<25.0.0.0)",
   "types-certifi (>=2021.10.8,<2022.0.0)",
   "types-chardet (>=5.0.4,<6.0.0)",
@@ -225,6 +225,8 @@ src = ["strawberry", "tests"]
 [tool.ruff.lint]
 select = ["ALL"]
 ignore = [
+  # × this should be fine to use :)
+  "RUF002",
   # we use asserts in tests and to hint mypy
   "S101",
 

pyproject.toml

@@ -1,22 +1,16 @@
 from __future__ import annotations
 
 import warnings
-from typing import (
-    TYPE_CHECKING,
-    Any,
-)
+from typing import Any
 
 from strawberry.test.client import BaseGraphQLTestClient, Response
 
-if TYPE_CHECKING:
-    from collections.abc import Mapping
-
 
 class GraphQLTestClient(BaseGraphQLTestClient):
     async def query(
         self,
         query: str,
-        variables: dict[str, Mapping] | None = None,
+        variables: dict[str, Any] | None = None,
         headers: dict[str, object] | None = None,
         asserts_errors: bool | None = None,
         files: dict[str, object] | None = None,