Support deprecation for arguments

Author: tyranron

juniper_codegen/src/common/field/arg.rs

@@ -14,14 +14,10 @@ use syn::{
     token,
 };
 
-use crate::common::{
-    Description, SpanContainer, default, diagnostic, filter_attrs,
-    parse::{
-        ParseBufferExt as _, TypeExt as _,
-        attr::{OptionExt as _, err},
-    },
-    path_eq_single, rename, scalar,
-};
+use crate::common::{Description, SpanContainer, default, diagnostic, filter_attrs, parse::{
+    ParseBufferExt as _, TypeExt as _,
+    attr::{OptionExt as _, err},
+}, path_eq_single, rename, scalar, deprecation};
 
 /// Available metadata (arguments) behind `#[graphql]` attribute placed on a
 /// method argument, when generating code for [GraphQL argument][1].
@@ -43,6 +39,15 @@ pub(crate) struct Attr {
     /// [2]: https://spec.graphql.org/October2021#sec-Descriptions
     pub(crate) description: Option<SpanContainer<Description>>,
 
+    /// Explicitly specified [deprecation][2] of this [GraphQL argument][1].
+    ///
+    /// If [`None`], then Rust `#[deprecated]` attribute will be used as the [deprecation][2], if
+    /// any.
+    ///
+    /// [1]: https://spec.graphql.org/October2021#sec-Language.Arguments
+    /// [2]: https://spec.graphql.org/October2021#sec-Deprecation
+    pub(crate) deprecated: Option<SpanContainer<deprecation::Directive>>,
+
     /// Explicitly specified [default value][2] of this [GraphQL argument][1].
     ///
     /// If [`None`], then this [GraphQL argument][1] is considered as
@@ -97,6 +102,16 @@ impl Parse for Attr {
                         .replace(SpanContainer::new(ident.span(), Some(desc.span()), desc))
                         .none_or_else(|_| err::dup_arg(&ident))?
                 }
+                "deprecated" => {
+                    let directive = input.parse::<deprecation::Directive>()?;
+                    out.deprecated
+                        .replace(SpanContainer::new(
+                            ident.span(),
+                            directive.reason.as_ref().map(|r| r.span()),
+                            directive,
+                        ))
+                        .none_or_else(|_| err::dup_arg(&ident))?
+                }
                 "default" => {
                     let val = input.parse::<default::Value>()?;
                     out.default
@@ -132,6 +147,7 @@ impl Attr {
         Ok(Self {
             name: try_merge_opt!(name: self, another),
             description: try_merge_opt!(description: self, another),
+            deprecated: try_merge_opt!(deprecated: self, another),
             default: try_merge_opt!(default: self, another),
             context: try_merge_opt!(context: self, another),
             executor: try_merge_opt!(executor: self, another),
@@ -141,13 +157,14 @@ impl Attr {
     /// Parses [`Attr`] from the given multiple `name`d [`syn::Attribute`]s
     /// placed on a function argument.
     pub(crate) fn from_attrs(name: &str, attrs: &[syn::Attribute]) -> syn::Result<Self> {
-        let attr = filter_attrs(name, attrs)
+        let mut attr = filter_attrs(name, attrs)
             .map(|attr| attr.parse_args())
             .try_fold(Self::default(), |prev, curr| prev.try_merge(curr?))?;
 
         if let Some(context) = &attr.context {
             if attr.name.is_some()
                 || attr.description.is_some()
+                || attr.deprecated.is_some()
                 || attr.default.is_some()
                 || attr.executor.is_some()
             {
@@ -161,6 +178,7 @@ impl Attr {
         if let Some(executor) = &attr.executor {
             if attr.name.is_some()
                 || attr.description.is_some()
+                || attr.deprecated.is_some()
                 || attr.default.is_some()
                 || attr.context.is_some()
             {
@@ -171,6 +189,10 @@ impl Attr {
             }
         }
 
+        if attr.deprecated.is_none() && attr.context.is_none() && attr.executor.is_none() {
+            attr.deprecated = deprecation::Directive::parse_from_deprecated_attr(attrs)?;
+        }
+
         Ok(attr)
     }
 
@@ -229,6 +251,12 @@ pub(crate) struct OnField {
     /// [1]: https://spec.graphql.org/October2021#sec-Language.Arguments
     /// [2]: https://spec.graphql.org/October2021#sec-Required-Arguments
     pub(crate) default: Option<default::Value>,
+
+    /// [Deprecation][2] of this [GraphQL field argument][1] to put into GraphQL schema.
+    ///
+    /// [1]: https://spec.graphql.org/October2021#sec-Language.Arguments
+    /// [2]: https://spec.graphql.org/October2021#sec-Deprecation
+    pub(crate) deprecated: Option<deprecation::Directive>,
 }
 
 /// Possible kinds of Rust method arguments for code generation.
@@ -300,6 +328,7 @@ impl OnMethod {
         let (name, ty) = (&arg.name, &arg.ty);
 
         let description = &arg.description;
+        let deprecated = &arg.deprecated;
 
         let method = if let Some(val) = &arg.default {
             quote_spanned! { val.span() =>
@@ -311,7 +340,7 @@ impl OnMethod {
             }
         };
 
-        Some(quote! { .argument(registry #method #description) })
+        Some(quote! { .argument(registry #method #description #deprecated) })
     }
 
     /// Returns generated code for the [`GraphQLValue::resolve_field`] method,
@@ -437,6 +466,7 @@ impl OnMethod {
             ty: argument.ty.as_ref().clone(),
             description: attr.description.map(SpanContainer::into_inner),
             default: attr.default.map(SpanContainer::into_inner),
+            deprecated: attr.deprecated.map(SpanContainer::into_inner),
         })))
     }
 }

juniper_codegen/src/graphql_input_object/mod.rs

@@ -206,12 +206,12 @@ struct FieldAttr {
 
     /// Explicitly specified [deprecation][2] of this [GraphQL input object field][1].
     ///
-    /// If [`None`], then Rust `#[deprecated]` attribute will be used as the
-    /// [deprecation][2], if any.
+    /// If [`None`], then Rust `#[deprecated]` attribute will be used as the [deprecation][2], if
+    /// any.
     ///
     /// [1]: https://spec.graphql.org/October2021#InputValueDefinition
     /// [2]: https://spec.graphql.org/October2021#sec-Deprecation
-    pub(crate) deprecated: Option<SpanContainer<deprecation::Directive>>,
+    deprecated: Option<SpanContainer<deprecation::Directive>>,
 
     /// Explicitly specified marker for the Rust struct field to be ignored and
     /// not included into the code generated for a [GraphQL input object][0]