Update deps and simplify Sphinx config

Author: Cito

.github/workflows/benchmark.yml

@@ -15,18 +15,18 @@ jobs:
     steps:
       - name: Checkout project
         id: checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
-      - name: Set up Python 3.13
+      - name: Set up Python 3.14
         id: setup-python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.13"
+          python-version: "3.14"
           architecture: x64
 
       - name: Install uv
         id: setup-uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
 
       - name: Install tox
         id: install-tox

.github/workflows/lint.yml

@@ -10,7 +10,7 @@ jobs:
     steps:
     - name: Checkout project
       id: checkout
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
 
     - name: Set up Python 3.14
       id: setup-python
@@ -20,7 +20,7 @@ jobs:
 
     - name: Install uv
       id: setup-uv
-      uses: astral-sh/setup-uv@v6
+      uses: astral-sh/setup-uv@v7
 
     - name: Install tox
       id: install-tox

.github/workflows/publish.yml

@@ -13,7 +13,7 @@ jobs:
     steps:
     - name: Checkout project
       id: checkout
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
 
     - name: Set up Python 3.14
       id: setup-python
@@ -23,7 +23,7 @@ jobs:
 
     - name: Install uv
       id: setup-uv
-      uses: astral-sh/setup-uv@v6
+      uses: astral-sh/setup-uv@v7
 
     - name: Build wheel and source tarball with uv
       id: build

.github/workflows/test.yml

@@ -14,7 +14,7 @@ jobs:
     steps:
       - name: Checkout project
         id: checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Set up Python ${{ matrix.python-version }}
         id: setup-python
@@ -24,7 +24,7 @@ jobs:
 
       - name: Install uv
         id: setup-uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
           cache-suffix: ${{ matrix.python-version }}

README.md

@@ -20,7 +20,7 @@ version 16.9.0 and supports Python versions 3.7 to 3.14.
 
 You can also try out the latest alpha version 3.3.0a11 of GraphQL-core,
 which is up-to-date with GraphQL.js version 17.0.0a5.
-This new minor version of GraphQL-core also supports Python versions 3.7 to 3.14.
+This new minor version of GraphQL-core also supports Python versions 3.10 to 3.14.
 
 Note that for various reasons, GraphQL-core does not use SemVer like GraphQL.js.
 Changes in the major version of GraphQL.js are reflected in the minor version of

docs/conf.py

@@ -52,7 +52,7 @@
 
 # General information about the project.
 project = "GraphQL-core 3"
-copyright = "2025, Christoph Zwerschke"
+copyright = "2026, Christoph Zwerschke"
 author = "Christoph Zwerschke"
 
 # The version info for the project you're documenting, acts as replacement for
@@ -95,13 +95,6 @@
 }
 autosummary_generate = True
 
-autodoc_type_aliases = {
-    "AwaitableOrValue": "graphql.pyutils.AwaitableOrValue",
-    "FormattedSourceLocation": "graphql.language.FormattedSourceLocation",
-    "Middleware": "graphql.execution.Middleware",
-    "TypeMap": "graphql.schema.TypeMap",
-}
-
 # GraphQL-core top level modules with submodules that can be omitted.
 # Sometimes autodoc cannot find classes since it is looking for the
 # qualified form, but the documentation has the shorter form.
@@ -123,201 +116,18 @@
     "validation": ["rules", "validation_context"],
 }
 
-# GraphQL-core classes that autodoc sometimes cannot find
-# (e.g. where specified as string in type hints).
-# We need to give autodoc a little help in this cases, too:
-graphql_classes = {
-    "GraphQLAbstractType": "type",
-    "GraphQLFieldResolver": "type",
-    "GraphQLObjectType": "type",
-    "GraphQLOutputType": "type",
-    "GraphQLTypeResolver": "type",
-    "AwaitableOrValue": "execution",
-    "Middleware": "execution",
-    "Node": "language",
-    "Source": "language",
-    "SourceLocation": "language",
-}
-
-# ignore the following undocumented or internal references:
-ignore_references = {
-    "GNT",
-    "GT",
-    "KT",
-    "T",
-    "VT",
-    "TContext",
-    "Enum",
-    "traceback",
-    "TypeMap",
-    "AwaitableOrValue",
-    "CancellableStreamRecord",
-    "DeferredFragmentRecord",
-    "DeferredGroupedFieldSetRecord",
-    "DeferredGroupedFieldSetResult",
-    "DeferUsage",
-    "EnterLeaveVisitor",
-    "ExperimentalIncrementalExecutionResults",
-    "FieldGroup",
-    "FormattedCompletedResult",
-    "FormattedIncrementalResult",
-    "FormattedPendingResult",
-    "FormattedSourceLocation",
-    "GraphQLAbstractType",
-    "GraphQLCompositeType",
-    "GraphQLEnumValueMap",
-    "GraphQLErrorExtensions",
-    "GraphQLFieldResolver",
-    "GraphQLInputType",
-    "GraphQLLeafType",
-    "GraphQLNullableType",
-    "GraphQLOutputType",
-    "GraphQLTypeResolver",
-    "GraphQLWrappedResult",
-    "GroupedFieldSet",
-    "IncrementalContext",
-    "IncrementalDataRecord",
-    "IncrementalResult",
-    "Middleware",
-    "PendingResult",
-    "StreamItemRecord",
-    "StreamItemResult",
-    "StreamItemsResult",
-    "StreamRecord",
-    "SubsequentDataRecord",
-    "SubsequentResultRecord",
-    "UndefinedType",
-    "asyncio.events.AbstractEventLoop",
-    "collections.abc.MutableMapping",
-    "collections.abc.MutableSet",
-    "enum.Enum",
-    "graphql.execution.build_field_plan.FieldGroup",
-    "graphql.execution.build_field_plan.FieldPlan",
-    "graphql.execution.collect_fields.CollectedFields",
-    "graphql.execution.collect_fields.DeferUsage",
-    "graphql.execution.collect_fields.FieldDetails",
-    "graphql.execution.execute.GraphQLWrappedResult",
-    "graphql.execution.execute.IncrementalContext",
-    "graphql.execution.execute.StreamArguments",
-    "graphql.execution.execute.SubFieldPlan",
-    "graphql.execution.execute.StreamUsage",
-    "graphql.execution.incremental_publisher.IncrementalPublisher",
-    "graphql.execution.incremental_publisher.IncrementalPublisherContext",
-    "graphql.execution.map_async_iterable.map_async_iterable",
-    "graphql.execution.Middleware",
-    "graphql.execution.types.BareDeferredGroupedFieldSetResult",
-    "graphql.execution.types.BareStreamItemsResult",
-    "graphql.execution.types.CancellableStreamRecord",
-    "graphql.execution.types.CompletedResult",
-    "graphql.execution.types.DeferredFragmentRecord",
-    "graphql.execution.types.DeferredGroupedFieldSetRecord",
-    "graphql.execution.types.FormattedCompletedResult",
-    "graphql.execution.types.FormattedPendingResult",
-    "graphql.execution.types.NonReconcilableStreamItemsResult",
-    "graphql.execution.types.PendingResult",
-    "graphql.execution.types.ReconcilableStreamItemsResult",
-    "graphql.execution.types.StreamItemResult",
-    "graphql.execution.types.StreamRecord",
-    "graphql.execution.types.SubsequentResultRecord",
-    "graphql.execution.types.TerminatingStreamItemsResult",
-    "graphql.language.lexer.EscapeSequence",
-    "graphql.language.visitor.EnterLeaveVisitor",
-    "graphql.pyutils.ref_map.K",
-    "graphql.pyutils.ref_map.V",
-    "graphql.type.definition.GT_co",
-    "graphql.type.definition.GNT_co",
-    "graphql.type.definition.TContext",
-    "graphql.type.schema.InterfaceImplementations",
-    "graphql.validation.validation_context.VariableUsage",
-    "graphql.validation.rules.known_argument_names.KnownArgumentNamesOnDirectivesRule",
-    "graphql.validation.rules.provided_required_arguments.ProvidedRequiredArgumentsOnDirectivesRule",
-}
-
-ignore_references.update(__builtins__)
-
-
-def on_missing_reference(app, env, node, contnode):
-    """Fix or skip any missing references."""
-    if node.get("refdomain") != "py":
-        return None
-    target = node.get("reftarget")
-    if not target:
-        return None
-    if target in ignore_references or target.endswith("Kwargs"):
-        return contnode
-    typ = node.get("reftype")
-    name = target.rsplit(".", 1)[-1]
-    if name in ("GT", "GNT", "KT", "T", "VT"):
-        return contnode
-    if (
-        typ == "obj"
-        and target.startswith("typing.")
-        and name in ("Any", "Optional", "Union")
-    ):
-        return contnode
-    if typ != "class":
-        return None
-    if "." in target:  # maybe too specific
-        base_module, target = target.split(".", 1)
-        if base_module == "graphql":
-            if "." not in target:
-                return None
-            base_module, target = target.split(".", 1)
-        if "." not in target:
-            return None
-        sub_modules = graphql_modules.get(base_module)
-        if not sub_modules:
-            return None
-        sub_module = target.split(".", 1)[0]
-        if sub_module not in sub_modules:
-            return None
-        target = "graphql." + base_module + "." + target.rsplit(".", 1)[-1]
-    else:  # maybe not specific enough
-        base_module = graphql_classes.get(target)
-        if not base_module:
-            return None
-        target = "graphql." + base_module + "." + target
-    # replace target
-    if contnode.__class__.__name__ == "Text":
-        contnode = contnode.__class__(target)
-    elif contnode.__class__.__name__ == "literal":
-        if len(contnode.children) != 1:
-            return None
-        textnode = contnode.children[0]
-        contnode.children[0] = textnode.__class__(target)
-    else:
-        return None
-    node["reftarget"] = target
-    fromdoc = node.get("refdoc")
-    if not fromdoc:
-        doc_module = node.get("py:module")
-        if doc_module:
-            if doc_module.startswith("graphql."):
-                doc_module = doc_module.split(".", 1)[-1]
-            if doc_module not in graphql_modules and doc_module != "graphql":
-                doc_module = None
-        fromdoc = "modules/" + (doc_module or base_module)
-    # try resolving again with replaced target
-    return env.domains["py"].resolve_xref(
-        env, fromdoc, app.builder, typ, target, node, contnode
-    )
-
-
-def on_skip_member(_app, what, name, _obj, skip, _options):
-    if what == "class" and name == "__init__":
-        # we could set "special-members" to "__init__",
-        # but this gives an error when documenting modules
-        return False
-    return skip
-
-
-def setup(app):
-    app.connect("missing-reference", on_missing_reference)
-    app.connect("autodoc-skip-member", on_skip_member)
-
-
 # be nitpicky (handle all possible problems in on_missing_reference)
 nitpicky = True
+nitpick_ignore = [
+    # TypeVars and internal types that can't be resolved
+    ("py:obj", "graphql.pyutils.ref_map.K"),
+    ("py:obj", "graphql.pyutils.ref_map.V"),
+    ("py:obj", "graphql.type.definition.GT_co"),
+    ("py:obj", "graphql.type.definition.GNT_co"),
+    ("py:obj", "graphql.type.definition.TContext"),
+]
+
+suppress_warnings = ["ref.class", "ref.python"]
 
 
 # The reST default role (used for this markup: `text`) to use for all

docs/requirements.txt

@@ -1,2 +1,2 @@
-sphinx>=7,<8
-sphinx_rtd_theme>=2,<3
+sphinx>=9,<10
+sphinx_rtd_theme>=3.1.0rc2,<4

pyproject.toml

@@ -29,37 +29,23 @@ Changelog = "https://github.com/graphql-python/graphql-core/releases"
 
 [dependency-groups]
 test = [
-    "anyio>=4.6; python_version>='3.9'",
-    "anyio>=3.7; python_version<'3.9'",
-    "pytest>=8.4; python_version>='3.9'",
-    "pytest>=8.3; python_version>='3.8' and python_version<'3.9'",
-    "pytest>=7.4,<8; python_version<'3.8'",
-    "pytest-benchmark>=5.2; python_version>='3.9'",
-    "pytest-benchmark>=4.0,<5; python_version<'3.9'",
-    "pytest-cov>=6.0; python_version>='3.9'",
-    "pytest-cov>=5.0,<6; python_version>='3.8' and python_version<'3.9'",
-    "pytest-cov>=4.1,<5; python_version<'3.8'",
-    "pytest-describe>=3.0; python_version>='3.9'",
-    "pytest-describe>=2.2; python_version<'3.9'",
-    "pytest-timeout>=2.4",
-    "pytest-codspeed>=3.1; python_version>='3.9'",
-    "pytest-codspeed>=2.2,<3; python_version<'3.8'",
-    "tox>=4.32; python_version>='3.10'",
-    "tox>=4.24; python_version>='3.8' and python_version<'3.10'",
-    "tox>=3.28,<4; python_version<'3.8'",
+    "anyio>=4.12,<5",
+    "pytest>=9,<10",
+    "pytest-benchmark>=5.2,<6",
+    "pytest-cov>=7,<8",
+    "pytest-describe>=3.1,<4",
+    "pytest-timeout>=2.4,<3",
+    "pytest-codspeed>=4.2",
+    "tox>=4.34,<5",
 ]
 lint = [
     "ruff>=0.14,<0.15",
-    "mypy>=1.18; python_version>='3.9'",
-    "mypy>=1.14; python_version>='3.8' and python_version<'3.9'",
-    "mypy>=1.4; python_version<'3.8'",
+    "mypy>=1.10,<2",
     "bump2version>=1,<2",
 ]
 doc = [
-    "sphinx>=8,<10; python_version>='3.10'",
-    "sphinx>=7,<9; python_version>='3.8' and python_version<'3.10'",
-    "sphinx>=4,<6; python_version<'3.8'",
-    "sphinx_rtd_theme>=2,<4",
+    "sphinx>=9,<10",
+    "sphinx_rtd_theme>=3.1.0rc2,<4",
 ]
 
 [tool.uv]

tox.ini

@@ -2,8 +2,8 @@
 envlist = py3{10,11,12,13,14}, pypy3{10,11}, ruff, mypy, docs
 isolated_build = true
 requires =
-    tox>=4.8
-    tox-uv>=1.12
+    tox>=4.34
+    tox-uv>=1.29
 installer = uv
 
 [gh-actions]
@@ -30,8 +30,6 @@ commands  =
 basepython = python3.14
 dependency_groups = lint, test
 skip_install = true
-#setenv =
-#    PYTHONPATH = {toxinidir}/src
 commands =
     python -m mypy src tests