chore(go): add missing ACLs in description, remove duplicated depreca…

…tion notice (#2825)
algolia · Mar 4, 2024 · 115dd17 · 115dd17 · github-actions · Mar 4, 2024
1 parent 7e19906
commit 115dd17
Show file tree

Hide file tree

Showing 2 changed files with 26 additions and 42 deletions.
diff --git a/templates/go/api.mustache b/templates/go/api.mustache
@@ -109,53 +109,14 @@ func (r {{#structPrefix}}{{&classname}}{{/structPrefix}}{{^structPrefix}}Api{{/s
 {{/hasParams}}
 /*
 {{operationId}} Wraps {{nickname}}WithContext using context.Background.
-{{#notes}}
-
-{{{unescapedNotes}}}
-{{/notes}}
-{{#vendorExtensions}}
-{{#x-acl.0}}
-
-Required API Key ACLs:{{/x-acl.0}}
-{{#x-acl}}
-  - {{.}}
-{{/x-acl}}
-{{/vendorExtensions}}
-
-Request can be constructed by NewApi{{operationId}}Request with parameters below.
- {{#allParams}}
- @param {{paramName}} {{dataType}}{{#description}} - {{{.}}}{{/description}}
- {{/allParams}}
- {{#returnType}}@return {{{.}}}{{/returnType}}
-{{#isDeprecated}}
-
-Deprecated
-{{/isDeprecated}}
-*/
-{{#isDeprecated}}
-// Deprecated
-{{/isDeprecated}}
+{{> operation_description}}
 func (c *APIClient) {{nickname}}({{#hasParams}}r {{#structPrefix}}{{&classname}}{{/structPrefix}}{{^structPrefix}}Api{{/structPrefix}}{{operationId}}Request,{{/hasParams}} opts ...Option) ({{#returnType}}{{^isArray}}{{^returnTypeIsPrimitive}}*{{/returnTypeIsPrimitive}}{{/isArray}}{{{.}}}, {{/returnType}}error) {
   return c.{{nickname}}WithContext(context.Background(), {{#hasParams}}r,{{/hasParams}} opts...)
 }
 
 /*
 {{operationId}}
-{{#notes}}
-
-{{{unescapedNotes}}}
-{{/notes}}
-
-Request can be constructed by NewApi{{operationId}}Request with parameters below.
- {{#allParams}}
- @param {{paramName}} {{dataType}}{{#description}} - {{{.}}}{{/description}}
- {{/allParams}}
- {{#returnType}}@return {{{.}}}{{/returnType}}
-{{#isDeprecated}}
-
-Deprecated
-{{/isDeprecated}}
-*/
+{{> operation_description}}
 func (c *APIClient) {{nickname}}WithContext(ctx context.Context, {{#hasParams}}r {{#structPrefix}}{{&classname}}{{/structPrefix}}{{^structPrefix}}Api{{/structPrefix}}{{operationId}}Request,{{/hasParams}} opts ...Option) ({{#returnType}}{{^isArray}}{{^returnTypeIsPrimitive}}*{{/returnTypeIsPrimitive}}{{/isArray}}{{{.}}}, {{/returnType}}error) {
 	var (
     postBody     any
@@ -317,4 +278,4 @@ func (c *APIClient) {{nickname}}WithContext(ctx context.Context, {{#hasParams}}r
 
 {{#isSearchClient}}
 {{> search_helpers}}
-{{/isSearchClient}}
+{{/isSearchClient}}
diff --git a/templates/go/operation_description.mustache b/templates/go/operation_description.mustache
@@ -0,0 +1,23 @@
+{{#notes}}
+
+{{{unescapedNotes}}}
+{{/notes}}
+{{#vendorExtensions}}
+{{#x-acl.0}}
+
+Required API Key ACLs:{{/x-acl.0}}
+{{#x-acl}}
+  - {{.}}
+{{/x-acl}}
+{{/vendorExtensions}}
+
+Request can be constructed by NewApi{{operationId}}Request with parameters below.
+ {{#allParams}}
+ @param {{paramName}} {{dataType}}{{#description}} - {{{.}}}{{/description}}
+ {{/allParams}}
+ {{#returnType}}@return {{{.}}}{{/returnType}}
+{{#isDeprecated}}
+
+Deprecated
+{{/isDeprecated}}
+*/