Add support for dictionary config and deprecate StrawberryConfig class

Author: patrick91

docs/breaking-changes.md

@@ -4,6 +4,7 @@ title: List of breaking changes and deprecations
 
 # List of breaking changes and deprecations
 
+- [Version 0.285.0 - Deprecate StrawberryConfig Class - 30 October 2025](./breaking-changes/0.285.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,57 @@
+---
+title: 0.285.0 Deprecations
+slug: breaking-changes/0.285.0
+---
+
+# v0.285.0 Deprecations
+
+In this release, we've simplified the schema configuration API by migrating from
+a class-based approach to a dictionary-based approach.
+
+## What Changed
+
+The `StrawberryConfig` class syntax is now **deprecated** and will show a
+`DeprecationWarning`. The class will be removed in a future release.
+
+Instead of instantiating a config class, you should now pass a plain Python
+dictionary to the `config` parameter when creating a schema.
+
+## Migration
+
+Convert the class instantiation to a dictionary:
+
+**Before (deprecated):**
+
+```python
+from strawberry.schema.config import StrawberryConfig
+
+schema = strawberry.Schema(
+    query=Query,
+    config=StrawberryConfig(
+        auto_camel_case=True,
+        relay_max_results=50,
+    ),
+)
+```
+
+**After (recommended):**
+
+```python
+schema = strawberry.Schema(
+    query=Query,
+    config={
+        "auto_camel_case": True,
+        "relay_max_results": 50,
+    },
+)
+```
+
+The old syntax will continue to work but will show this warning:
+
+```
+DeprecationWarning: Using StrawberryConfig as a class is deprecated as of v0.285.0.
+Use dictionary syntax instead: config={'auto_camel_case': True}.
+```
+
+For more information, see the
+[Schema Configurations](../types/schema-configurations.md) documentation.

docs/guides/query-batching.md

@@ -16,17 +16,14 @@ and how to integrate it into your application with an example using FastAPI.
 
 ## Enabling Query Batching
 
-To enable query batching in Strawberry, you need to configure the
-`StrawberryConfig` when defining your GraphQL schema. The batching configuration
-is provided as a typed dictionary. Batching is disabled by default, if no
-configuration is provided.
+To enable query batching in Strawberry, you need to configure the schema config
+when defining your GraphQL schema. The batching configuration is provided as a
+dictionary. Batching is disabled by default, if no configuration is provided.
 
 ### Basic Configuration
 
 ```python
-from strawberry.schema.config import StrawberryConfig
-
-config = StrawberryConfig(batching_config={"max_operations": 10})
+config = {"batching_config": {"max_operations": 10}}
 ```
 
 ### Configuring Maximum Operations
@@ -35,9 +32,7 @@ To set a limit on the number of operations in a batch request, use the
 `max_operations` key:
 
 ```python
-from strawberry.schema.config import StrawberryConfig
-
-config = StrawberryConfig(batching_config={"max_operations": 5})
+config = {"batching_config": {"max_operations": 5}}
 ```
 
 When batching is enabled, the server can handle a list of operations
@@ -52,7 +47,6 @@ Below is an example of how to enable query batching in a FastAPI application:
 import strawberry
 from fastapi import FastAPI
 from strawberry.fastapi import GraphQLRouter
-from strawberry.schema.config import StrawberryConfig
 
 
 @strawberry.type
@@ -64,7 +58,7 @@ class Query:
 
 schema = strawberry.Schema(
     Query,
-    config=StrawberryConfig(batching_config={"max_operations": 5}),
+    config={"batching_config": {"max_operations": 5}},
 )
 
 graphql_app = GraphQLRouter(schema)

docs/types/defer-and-stream.md

@@ -31,7 +31,6 @@ incremental execution in your schema configuration:
 
 ```python
 import strawberry
-from strawberry.schema.config import StrawberryConfig
 
 
 @strawberry.type
@@ -41,7 +40,7 @@ class Query:
 
 
 schema = strawberry.Schema(
-    query=Query, config=StrawberryConfig(enable_experimental_incremental_execution=True)
+    query=Query, config={"enable_experimental_incremental_execution": True}
 )
 ```
 

docs/types/schema-configurations.md

@@ -4,24 +4,22 @@ title: Schema Configurations
 
 # Schema Configurations
 
-Strawberry allows to customise how the schema is generated by passing
-configurations.
+Strawberry allows you to customise how the schema is generated by passing
+configuration options as a dictionary.
 
-To customise the schema you can create an instance of `StrawberryConfig`, as
-shown in the example below:
+To customise the schema, you can pass a configuration dictionary to the `config`
+parameter, as shown in the example below:
 
 ```python
 import strawberry
 
-from strawberry.schema.config import StrawberryConfig
-
 
 @strawberry.type
 class Query:
     example_field: str
 
 
-schema = strawberry.Schema(query=Query, config=StrawberryConfig(auto_camel_case=False))
+schema = strawberry.Schema(query=Query, config={"auto_camel_case": False})
 ```
 
 In this case we are disabling the auto camel casing feature, so your output
@@ -33,6 +31,14 @@ type Query {
 }
 ```
 
+<Note>
+
+**Upgrading from v0.284.0 or earlier?** See the
+[v0.285.0 breaking changes](../breaking-changes/0.285.0.md) for migration
+instructions if you were using the old `StrawberryConfig` class syntax.
+
+</Note>
+
 ## Available configurations
 
 Here's a list of the available configurations:
@@ -44,7 +50,7 @@ like `example_field` will be converted to `exampleField`. You can disable this
 feature by setting `auto_camel_case` to `False`.
 
 ```python
-schema = strawberry.Schema(query=Query, config=StrawberryConfig(auto_camel_case=False))
+schema = strawberry.Schema(query=Query, config={"auto_camel_case": False})
 ```
 
 ### default_resolver
@@ -58,8 +64,6 @@ resolver.
 ```python
 import strawberry
 
-from strawberry.schema.config import StrawberryConfig
-
 
 def custom_resolver(obj, field):
     try:
@@ -80,9 +84,7 @@ class Query:
         return {"name": "Patrick"}
 
 
-schema = strawberry.Schema(
-    query=Query, config=StrawberryConfig(default_resolver=custom_resolver)
-)
+schema = strawberry.Schema(query=Query, config={"default_resolver": custom_resolver})
 ```
 
 ### relay_max_results
@@ -91,7 +93,7 @@ By default Strawberry's max limit for relay connections is 100. You can
 customise this by setting the `relay_max_results` configuration.
 
 ```python
-schema = strawberry.Schema(query=Query, config=StrawberryConfig(relay_max_results=50))
+schema = strawberry.Schema(query=Query, config={"relay_max_results": 50})
 ```
 
 ### disable_field_suggestions
@@ -101,9 +103,7 @@ schema. You can disable this feature by setting `disable_field_suggestions` to
 `True`.
 
 ```python
-schema = strawberry.Schema(
-    query=Query, config=StrawberryConfig(disable_field_suggestions=True)
-)
+schema = strawberry.Schema(query=Query, config={"disable_field_suggestions": True})
 ```
 
 ### info_class
@@ -123,7 +123,7 @@ class CustomInfo(Info):
         return self.context["response"].headers
 
 
-schema = strawberry.Schema(query=Query, config=StrawberryConfig(info_class=CustomInfo))
+schema = strawberry.Schema(query=Query, config={"info_class": CustomInfo})
 ```
 
 ### enable_experimental_incremental_execution
@@ -142,7 +142,7 @@ response to be delivered incrementally.
 
 ```python
 schema = strawberry.Schema(
-    query=Query, config=StrawberryConfig(enable_experimental_incremental_execution=True)
+    query=Query, config={"enable_experimental_incremental_execution": True}
 )
 ```
 

strawberry/extensions/directives.py

@@ -86,7 +86,7 @@ def process_directive(
             field_name=info.field_name,
             type_name=info.parent_type.name,
         )
-        arguments[info_parameter.name] = schema.config.info_class(
+        arguments[info_parameter.name] = schema.config["info_class"](
             _raw_info=info, _field=field
         )
     if value_parameter:

strawberry/federation/schema.py

@@ -238,7 +238,7 @@ def _add_link_for_composed_directive(
             return
 
         import_url = directive.compose_options.import_url
-        name = self.config.name_converter.from_directive(directive)
+        name = self.config["name_converter"].from_directive(directive)
 
         # import url is required by Apollo Federation, this might change in
         # future to be optional, so for now, when it is not passed we
@@ -290,7 +290,7 @@ def _add_compose_directives(self) -> list["ComposeDirective"]:
             )
 
             if is_federation_schema_directive and definition.compose_options:
-                name = self.config.name_converter.from_directive(definition)
+                name = self.config["name_converter"].from_directive(definition)
 
                 compose_directives.append(
                     ComposeDirective(

strawberry/http/base.py

@@ -88,15 +88,15 @@ def _is_multipart_subscriptions(
     def _validate_batch_request(
         self, request_data: list[GraphQLRequestData], protocol: str
     ) -> None:
-        if self.schema.config.batching_config is None:
+        if self.schema.config["batching_config"] is None:
             raise HTTPException(400, "Batching is not enabled")
 
         if protocol == "multipart-subscription":
             raise HTTPException(
                 400, "Batching is not supported for multipart subscriptions"
             )
 
-        if len(request_data) > self.schema.config.batching_config["max_operations"]:
+        if len(request_data) > self.schema.config["batching_config"]["max_operations"]:
             raise HTTPException(400, "Too many operations")
 
 

strawberry/printer/printer.py

@@ -131,7 +131,7 @@ def print_schema_directive_params(
             ast = ast_from_value(
                 _serialize_dataclasses(
                     value,
-                    name_converter=schema.config.name_converter.apply_naming_config,
+                    name_converter=schema.config["name_converter"].apply_naming_config,
                 ),
                 arg.type,
             )
@@ -157,7 +157,7 @@ def print_schema_directive(
     params = print_schema_directive_params(
         gql_directive,
         {
-            schema.config.name_converter.get_graphql_name(f): getattr(
+            schema.config["name_converter"].get_graphql_name(f): getattr(
                 directive, f.python_name or f.name, UNSET
             )
             for f in strawberry_directive.fields
@@ -616,7 +616,7 @@ def print_schema(schema: BaseSchema) -> str:
         if (printed_directive := print_directive(directive, schema=schema)) is not None
     ]
 
-    if schema.config.enable_experimental_incremental_execution:
+    if schema.config["enable_experimental_incremental_execution"]:
         directives.append(
             "directive @defer(if: Boolean, label: String) on FRAGMENT_SPREAD | INLINE_FRAGMENT"
         )

strawberry/relay/utils.py

@@ -131,7 +131,7 @@ def from_arguments(
         max_results = (
             max_results
             if max_results is not None
-            else info.schema.config.relay_max_results
+            else info.schema.config["relay_max_results"]
         )
         start = 0
         end: int | None = None