Export GRAPHQL_MAX_INT and GRAPHQL_MIN_INT

Replicates graphql/graphql-js@11a0802

Author: Cito

docs/modules/type.rst

@@ -172,7 +172,13 @@ Definitions
 .. autoclass:: GraphQLInt
 .. autoclass:: GraphQLString
 
-A tuple with all specified directives is available as :data:`specified_directives`.
+.. data:: GRAPHQL_MAX_INT
+
+   Maximum possible Int value as per GraphQL Spec (32-bit signed integer)
+
+.. data:: GRAPHQL_MIN_INT
+
+   Minimum possible Int value as per GraphQL Spec (32-bit signed integer)
 
 
 Schema

src/graphql/__init__.py

@@ -247,6 +247,9 @@
     GraphQLString,
     GraphQLBoolean,
     GraphQLID,
+    # Int boundaries constants
+    GRAPHQL_MAX_INT,
+    GRAPHQL_MIN_INT,
     # Built-in Directives defined by the Spec
     specified_directives,
     GraphQLIncludeDirective,
@@ -471,6 +474,8 @@
     "GraphQLString",
     "GraphQLBoolean",
     "GraphQLID",
+    "GRAPHQL_MAX_INT",
+    "GRAPHQL_MIN_INT",
     "specified_directives",
     "GraphQLIncludeDirective",
     "GraphQLSkipDirective",

src/graphql/type/__init__.py

@@ -147,6 +147,9 @@
     GraphQLString,
     GraphQLBoolean,
     GraphQLID,
+    # Int boundaries constants
+    GRAPHQL_MAX_INT,
+    GRAPHQL_MIN_INT,
 )
 
 from .introspection import (
@@ -279,6 +282,8 @@
     "GraphQLString",
     "GraphQLBoolean",
     "GraphQLID",
+    "GRAPHQL_MAX_INT",
+    "GRAPHQL_MIN_INT",
     "is_introspection_type",
     "introspection_types",
     "TypeKind",

src/graphql/type/scalars.py

@@ -21,17 +21,22 @@
     "GraphQLString",
     "GraphQLBoolean",
     "GraphQLID",
+    "GRAPHQL_MAX_INT",
+    "GRAPHQL_MIN_INT",
 ]
 
-
-# As per the GraphQL Spec, Integers are only treated as valid when a valid
-# 32-bit signed integer, providing the broadest support across platforms.
-#
-# n.b. JavaScript's integers are safe between -(2^53 - 1) and 2^53 - 1 because
-# they are internally represented as IEEE 754 doubles,
+# As per the GraphQL Spec, Integers are only treated as valid
+# when they can be represented as a 32-bit signed integer,
+# providing the broadest support across platforms.
+# n.b. JavaScript's numbers are safe between -(2^53 - 1) and 2^53 - 1
+# because they are internally represented as IEEE 754 doubles,
 # while Python's integers may be arbitrarily large.
-MAX_INT = 2_147_483_647
-MIN_INT = -2_147_483_648
+
+GRAPHQL_MAX_INT = 2_147_483_647
+"""Maximum possible Int value as per GraphQL Spec (32-bit signed integer)"""
+
+GRAPHQL_MIN_INT = -2_147_483_648
+"""Minimum possible Int value as per GraphQL Spec (32-bit signed integer)"""
 
 
 def serialize_int(output_value: Any) -> int:
@@ -53,7 +58,7 @@ def serialize_int(output_value: Any) -> int:
         raise GraphQLError(
             "Int cannot represent non-integer value: " + inspect(output_value)
         )
-    if not MIN_INT <= num <= MAX_INT:
+    if not GRAPHQL_MIN_INT <= num <= GRAPHQL_MAX_INT:
         raise GraphQLError(
             "Int cannot represent non 32-bit signed integer value: "
             + inspect(output_value)
@@ -72,7 +77,7 @@ def coerce_int(input_value: Any) -> int:
         raise GraphQLError(
             "Int cannot represent non-integer value: " + inspect(input_value)
         )
-    if not MIN_INT <= input_value <= MAX_INT:
+    if not GRAPHQL_MIN_INT <= input_value <= GRAPHQL_MAX_INT:
         raise GraphQLError(
             "Int cannot represent non 32-bit signed integer value: "
             + inspect(input_value)
@@ -88,7 +93,7 @@ def parse_int_literal(value_node: ValueNode, _variables: Any = None) -> int:
             value_node,
         )
     num = int(value_node.value)
-    if not MIN_INT <= num <= MAX_INT:
+    if not GRAPHQL_MIN_INT <= num <= GRAPHQL_MAX_INT:
         raise GraphQLError(
             "Int cannot represent non 32-bit signed integer value: "
             + print_ast(value_node),