Support deprecation via introspection

Closes #35

Author: jhgg

graphql/core/utils/build_client_schema.py

@@ -150,7 +150,8 @@ def build_enum_def(enum_introspection):
             name=enum_introspection['name'],
             description=enum_introspection['description'],
             values=OrderedDict([(value_introspection['name'],
-                                 GraphQLEnumValue(description=value_introspection['description']))
+                                 GraphQLEnumValue(description=value_introspection['description'],
+                                                  deprecation_reason=value_introspection['deprecationReason']))
                                 for value_introspection in enum_introspection['enumValues']
                                 ])
         )
@@ -179,6 +180,7 @@ def build_field_def_map(type_introspection):
                 type=get_output_type(f['type']),
                 description=f['description'],
                 resolver=no_execution,
+                deprecation_reason=f['deprecationReason'],
                 args=build_input_value_def_map(f['args'], GraphQLArgument)))
             for f in type_introspection['fields']
         ])

graphql/core/utils/introspection_query.py

@@ -23,7 +23,7 @@
     kind
     name
     description
-    fields {
+    fields(includeDeprecated: true) {
         name
         description
         args {
@@ -41,7 +41,7 @@
     interfaces {
         ...TypeRef
     }
-    enumValues {
+    enumValues(includeDeprecated: true) {
         name
         description
         isDeprecated

tests/core_utils/test_build_client_schema.py

@@ -291,11 +291,12 @@ def test_builds_a_schema_with_an_enum():
     assert isinstance(clientFoodEnum, GraphQLEnumType)
 
     assert clientFoodEnum.get_values() == [
-        GraphQLEnumValue(name='VEGETABLES', value='VEGETABLES', description='Foods that are vegetables.'),
-        GraphQLEnumValue(name='FRUITS', value='FRUITS', description='Foods that are fruits.'),
-        GraphQLEnumValue(name='OILS', value='OILS', description='Foods that are oils.'),
-        GraphQLEnumValue(name='DAIRY', value='DAIRY', description='Foods that are dairy.'),
-        GraphQLEnumValue(name='MEAT', value='MEAT', description='Foods that are meat.')
+        GraphQLEnumValue(name='VEGETABLES', value='VEGETABLES', description='Foods that are vegetables.',
+                         deprecation_reason=None),
+        GraphQLEnumValue(name='FRUITS', value='FRUITS', description='Foods that are fruits.', deprecation_reason=None),
+        GraphQLEnumValue(name='OILS', value='OILS', description='Foods that are oils.', deprecation_reason=None),
+        GraphQLEnumValue(name='DAIRY', value='DAIRY', description='Foods that are dairy.', deprecation_reason=None),
+        GraphQLEnumValue(name='MEAT', value='MEAT', description='Foods that are meat.', deprecation_reason=None)
     ]
 
 
@@ -381,6 +382,40 @@ def test_builds_a_schema_with_field_arguments_with_default_values():
     _test_schema(schema)
 
 
+def test_builds_a_schema_aware_of_deprecation():
+    schema = GraphQLSchema(
+        query=GraphQLObjectType(
+            name='Simple',
+            description='This is a simple type',
+            fields=OrderedDict([
+                ('shinyString', GraphQLField(
+                    type=GraphQLString,
+                    description='This is a shiny string field'
+                )),
+                ('deprecatedString', GraphQLField(
+                    type=GraphQLString,
+                    description='This is a deprecated string field',
+                    deprecation_reason='Use shinyString'
+                )),
+                ('color', GraphQLField(
+                    type=GraphQLEnumType(
+                        name='Color',
+                        values=OrderedDict([
+                            ('RED', GraphQLEnumValue(description='So rosy')),
+                            ('GREEN', GraphQLEnumValue(description='So grassy')),
+                            ('BLUE', GraphQLEnumValue(description='So calming')),
+                            ('MAUVE', GraphQLEnumValue(description='So sickening',
+                                                       deprecation_reason='No longer in fashion')),
+                        ])
+                    )
+                ))
+            ])
+        )
+    )
+
+    _test_schema(schema)
+
+
 def test_cannot_use_client_schema_for_general_execution():
     customScalar = GraphQLScalarType(
         name='CustomScalar',