Merge pull request #9 from svix/jplatte/deprecated-ops

Generate deprecation annotations / javadoc markers

Author: svix-jplatte

src/template.rs

@@ -46,6 +46,20 @@ pub(crate) fn env() -> Result<minijinja::Environment<'static>, minijinja::Error>
                 .to_string())
         },
     );
+    env.add_filter(
+        "with_javadoc_deprecation",
+        |s: Cow<'_, str>, deprecated: bool| {
+            if deprecated {
+                if s.is_empty() {
+                    "@deprecated".to_owned()
+                } else {
+                    s.into_owned() + "\n\n@deprecated"
+                }
+            } else {
+                s.into_owned()
+            }
+        },
+    );
 
     Ok(env)
 }

templates/svix_lib_resource.kt.jinja

@@ -50,7 +50,10 @@ class {{ resource_type_name }} internal constructor(token: String, options: Svix
         {% set has_required_query_params =
             op.query_params | selectattr("required") | length > 0 -%}
         {% set has_header_params = op.header_params | length > 0 -%}
-        {{ op.description | to_doc_comment(style="kotlin") }}
+        {{ op.description | with_javadoc_deprecation(op.deprecated) | to_doc_comment(style="kotlin") }}
+        {% if op.deprecated -%}
+            @Deprecated
+        {% endif -%}
         suspend fun {{ op.name | to_lower_camel_case }}(
             {# path parameters -#}
             {% for p in op.path_params -%}

templates/svix_lib_resource.rs.jinja

@@ -55,6 +55,9 @@ impl<'a> {{ resource_type_name }}<'a> {
     {% if op.description is defined -%}
         {{ op.description | to_doc_comment(style="rust") }}
     {% endif -%}
+    {% if op.deprecated -%}
+        #[deprecated]
+    {% endif -%}
     pub async fn {{ op.name | to_snake_case }}(
         &self,
 

templates/svix_lib_resource.ts.jinja

@@ -41,7 +41,7 @@ export class {{ resource_type_name }} {
         {% set has_header_params = op.header_params | length > 0 -%}
         {% set response_type =
             op.response_body_schema_name | default("void") | replace("_", "") -%}
-        {{ op.description | to_doc_comment(style="js") }}
+        {{ op.description | with_javadoc_deprecation(op.deprecated) | to_doc_comment(style="js") }}
         public {{ op.name | to_lower_camel_case }}(
             {# path parameters -#}
             {% for p in op.path_params -%}