introspection: Add missing __Directive.args(includeDeprecated)

Backport from 3.2.

Replicates graphql/graphql-js@eb0fed0

Author: Cito

src/graphql/type/introspection.py

@@ -87,27 +87,61 @@
         # Note: The fields onOperation, onFragment and onField are deprecated
         "name": GraphQLField(
             GraphQLNonNull(GraphQLString),
-            resolve=lambda directive, _info: directive.name,
+            resolve=DirectiveResolvers.name,
         ),
         "description": GraphQLField(
-            GraphQLString, resolve=lambda directive, _info: directive.description
+            GraphQLString,
+            resolve=DirectiveResolvers.description,
         ),
         "isRepeatable": GraphQLField(
             GraphQLNonNull(GraphQLBoolean),
-            resolve=lambda directive, _info: directive.is_repeatable,
+            resolve=DirectiveResolvers.is_repeatable,
         ),
         "locations": GraphQLField(
             GraphQLNonNull(GraphQLList(GraphQLNonNull(__DirectiveLocation))),
-            resolve=lambda directive, _info: directive.locations,
+            resolve=DirectiveResolvers.locations,
         ),
         "args": GraphQLField(
             GraphQLNonNull(GraphQLList(GraphQLNonNull(__InputValue))),
-            resolve=lambda directive, _info: directive.args.items(),
+            args={
+                "includeDeprecated": GraphQLArgument(
+                    GraphQLBoolean, default_value=False
+                )
+            },
+            resolve=DirectiveResolvers.args,
         ),
     },
 )
 
 
+class DirectiveResolvers:
+    @staticmethod
+    def name(directive, _info):
+        return directive.name
+
+    @staticmethod
+    def description(directive, _info):
+        return directive.description
+
+    @staticmethod
+    def is_repeatable(directive, _info):
+        return directive.is_repeatable
+
+    @staticmethod
+    def locations(directive, _info):
+        return directive.locations
+
+    # noinspection PyPep8Naming
+    @staticmethod
+    def args(directive, _info, includeDeprecated=False):
+        items = directive.args.items()
+        return (
+            list(items)
+            if includeDeprecated
+            else [item for item in items if item[1].deprecation_reason is None]
+        )
+
+
 __DirectiveLocation: GraphQLEnumType = GraphQLEnumType(
     name="__DirectiveLocation",
     description="A Directive can be adjacent to many parts of the GraphQL"

tests/type/test_introspection.py

@@ -755,7 +755,17 @@ def executes_an_introspection_query():
                             },
                             {
                                 "name": "args",
-                                "args": [],
+                                "args": [
+                                    {
+                                        "name": "includeDeprecated",
+                                        "type": {
+                                            "kind": "SCALAR",
+                                            "name": "Boolean",
+                                            "ofType": None,
+                                        },
+                                        "defaultValue": "false",
+                                    }
+                                ],
                                 "type": {
                                     "kind": "NON_NULL",
                                     "name": None,

tests/utilities/test_get_introspection_query.py

@@ -2,12 +2,25 @@
 
 from typing import Pattern
 
-from graphql.utilities import get_introspection_query
+from graphql.language import parse
+from graphql.utilities import build_schema, get_introspection_query
+from graphql.validation import validate
+
+dummy_schema = build_schema(
+    """
+  type Query {
+    dummy: String
+  }
+  """
+)
 
 
 class ExcpectIntrospectionQuery:
     def __init__(self, **options):
-        self.query = get_introspection_query(**options)
+        query = get_introspection_query(**options)
+        validation_errors = validate(dummy_schema, parse(query))
+        assert validation_errors == []
+        self.query = query
 
     def to_match(self, name: str, times: int = 1) -> None:
         pattern = self.to_reg_exp(name)

tests/utilities/test_print_schema.py

@@ -769,7 +769,7 @@ def prints_introspection_schema():
               description: String
               isRepeatable: Boolean!
               locations: [__DirectiveLocation!]!
-              args: [__InputValue!]!
+              args(includeDeprecated: Boolean = false): [__InputValue!]!
             }
 
             """