Release notes from graphql-core

v3.3.0a12

2026-03-05T16:42:07Z

Alpha release GraphQL-core v3.3.0a12, based on GraphQL.js v17.0.0a7.

This patch-release supports Python 3.10 to 3.14.

Notable improvements since the last alpha release, in addition to the upstream improvements in v17.0.0.a7:

Add serialization benchmark (#250)
Use tuples instead of lists for all AST collection fields (#251)
De-support Python 3.7 to 3.9 (#252)
Make visitor immutable friendly (#253)
Fix parser type safety for stricter AST types (#255)
Convert AST nodes to frozen dataclasses (#256)
Support custom async iterables (#258)
Improve type hints using Self (#259)

Thanks to @jkimbo for sponsoring this project, and to @bellini666, @bigfootjon and @corydolphin for contributing to this release.

v3.2.8

2026-03-05T20:00:37Z

Patch-release GraphQL-core v3.2.8, based on GraphQL.js v16.9.0.

This patch-release supports Python 3.7 to 3.14.

One change has been backported from the v3.3 branch:

Require non-empty directive locations

Also, for backward compatibility, introspection.TypeResolvers is available again, as alias for TypeFields.

Thanks to all who are sponsoring me (@Cito) for maintaining this project.

v3.3.0a11

2025-11-01T18:09:35Z

Alpha release GraphQL-core v3.3.0a11, based on GraphQL.js v17.0.0a5.

Notable improvements since the last alpha release:

Python 3.14 is now officially supported
Enum values, input fields and schemas now keep extensions on sorting (#245)
Various refactorings and changes concerning @defer and @stream
Early execution on incremental delivery is now disabled by default
New recommended validation rule for max introspection depth
GraphQLEnumType values can now be specified via a callable

Thanks to @jkimbo for sponsoring this project, and to @erikwrede for contributing to this release.

v3.2.7

2025-11-01T22:48:16Z

Patch-release GraphQL-core v3.2.7, based on GraphQL.js v16.9.0.

This patch-release supports Python 3.7 to 3.14.

The following changes have been backported from the v3.3 branch:

Keep extensions when sorting schemas
Introduce "recommended" validation rules
Implement OneOf Input Objects via @OneOf directive
Values can now be passed to GraphQLEnumType as a thunk
Solved issues with pickled schemas

Thanks to all who are sponsoring me (@Cito) for maintaining this project.

v3.3.0a10

2025-09-28T19:11:49Z

Alpha release GraphQL-core v3.3.0a10, still based on GraphQL.js v17.0.0a3.

Notable improvements since the last alpha release:

Fixed attribute error on exception with bad source (#240)
Add @oneOf support to introspection query (#241)
Use AnyIO instead of pytest-asyncio for running async tests (#242)
introduced GraphQLWrappedResult to avoid filtering in incremental delivery
Use uv instead of poetry as default packaging tool
Some performance improvements and refactorings from upstream
Various code cleanups

Thanks to @jkimbo for sponsoring this project, and to @agronholm, @erikwrede and @kimjh12 for contributing to this release.

v3.3.0a9

2025-11-01T16:25:44Z

Alpha release GraphQL-core v3.3.0a9, based on GraphQL.js v17.0.0a3.

Notable improvements since the last alpha release:

Allow nested defers at the same level
Skip empty subsequent results

Thanks to @patrick91 and @jkimbo for sponsoring this project.

v3.3.0a8

2025-05-24T20:05:52Z

Alpha release GraphQL-core v3.3.0a8, based on GraphQL.js v17.0.0a3.

Notable improvements since the last alpha release:

Fix IntrospectionQuery type definition (#234)
Cancel remaining fields on exceptions (#236 and #238)
Cancel remaining list and iterator items on exceptions
Cancel remaining type resolvers on exceptions
Suppress records for deferred fragments that are completely empty
Add support for @OneOf directives in print_schema

Thanks again to the sponsors of this project, @patrick91, @jkimbo, and to @erikwrede, @magikmark, @mgorven, @sobolevn and @willemt for contributing to this release.

Sorry for lagging behind upstream a bit and not always responding as quickly as I want to.

v3.3.0a7

2025-05-24T19:50:32Z

Alpha release GraphQL-core v3.3.0a7, based on GraphQL.js v17.0.0a3.

Notable improvements since the last alpha release:

This release also supports Python 3.13
New incremental response format using id and subPath and pending notifications
OneOf Input Objects via @oneOf directive
Speedup sorting and building/extending schema
Support for fourfold nested lists in introspection
Transform input objects used as default values (#206)
Support deep copy of schema with directive with arg of custom type (#210)
Allow injecting custom data to custom execution context (#226)
ValidationAbortedError can now be imported (#227)
Benchmarking with CodSpeed (#230)

Thanks again to the sponsors of this project, @patrick91, @jkimbo, @getsentry, and to @erikwrede, @menma1234, @patrick91, @rafalp and @trim21 for contributing to this release.

Sorry for lagging behind upstream a bit and not always responding as quickly as I want to.

v3.2.6

2025-01-26T16:45:46Z

Patch-release GraphQL-core v3.2.6, based on GraphQL.js v16.8.2.

This patch-release supports Python 3.6 to 3.13. Notable fixes:

Transform input objects used as default values (#206)
Allow deep copy of schema with directive with args of custom type (#210)

Thanks to all who are sponsoring me (@Cito) for maintaining this project.

v3.2.5

2024-10-13T18:30:08Z

Patch-release GraphQL-core v3.2.5, based on GraphQL.js v16.8.2.

This patch-release supports Python 3.6 to 3.13.

Thanks to all who are sponsoring me (@Cito) for maintaining this project.