Separate args into groups (#152)

* Update codegen for API 26.6

* Fix Java wrapper import template

* Ignore release tag URLs in URL check

* Release 26.6

* Split generate params into groups

* Update spec

* Dart templates fixed for new spec

* Fixed dotnet templates

* Templates fixed for new spec

* Fix java template

* Fix node template

* Fix php templates

* Fix python templates

* Fix swift template

* Update java template

* Fix Java templates

* Update Swift templates

* Fix Swift templates again

* Add .spi.yml for Swift

* Generate the Node.js SDK in a single openapi-generator run

typescript-node cannot emit docs on its own, so models.ts, the docs and the README were produced by a second generator invocation that reused the api.ts/git_push.sh/tsconfig.json output slots. Emit them as user-defined supporting files (config-node.json "files" section) so everything is produced in one run, and rename the templates to match their output.

* Emit Java, .NET, and Go SDK support files via the files config

These generators produced a file under an unrelated built-in name (git_push.sh, appveyor.yml, response.go) and moved it into place. Emit each at its real name via the config "files" section and rename the templates to match. For Go, drop the generator's default response.go before the wildcard move so it is not pulled into the SDK.

* Rework the Android SDK templates for the files config and grouped API

Emit gradle.properties, app/build.gradle and MainActivity.kt via the files config instead of hijacking the git_push.sh/gradlew/ApiException.java slots (settings.gradle overrides the built-in template directly). Update the MainActivity and README sample to the grouped generate() API (barcodeImageParams/qrParams) to match the current SDK.

* Point the Go SDK badges at the v4 module and branch

Replace the Go Report Card badge with the pkg.go.dev Go Reference badge for the v4 module, and point the CI status badge at the v4 branch.

* Drop dead boilerplate from the Go SDK utils.go template

utils.go shipped only unused openapi-generator helpers (Ptr*, Nullable*, IsNil, newStrictDecoder). Emit an empty utils.go from a trimmed template.

* Restrict the CI badge branch check to main or v4

Previously only ?branch=main passed. Accept ?branch=main or ?branch=v4 (the Go SDK's default branch); flag any other branch, a missing branch, or prefixes like v40.

* Update submodules

* Refresh the spec from the live API and drop inject-param-groups

The API now serves the x-param-group vendor extensions itself, so inject-param-groups.py only re-serialised the fetched JSON ({ } -> {}, trailing newline), drifting the committed spec from live and failing the check-swagger CI job on every 'make update'. Remove the script and its callers (update_swagger_spec.bash, the Makefile spec-param-groups target); the fetched spec needs no post-processing.

* Ignore .example domains in the URL checker

Add the reserved .example TLD to the URL checker's ignore list; also apply isort/black formatting.

* Ignore incorrect URLs from tests

---------

Co-authored-by: Timur Baiguskarov <timur.baiguskarov@aspose.com>
Co-authored-by: Ivan Kamkin <ivan.kamkin@aspose.com>

Author: 3 people

…/Templates/android/apiException.mustache …mplates/android/MainActivity.kt.mustachecodegen/Templates/android/apiException.mustache renamed to codegen/Templates/android/MainActivity.kt.mustache codegen/Templates/android/apiException.mustache renamed to codegen/Templates/android/MainActivity.kt.mustache

@@ -29,7 +29,12 @@ import com.aspose.barcode.cloud.ApiException
 import com.aspose.barcode.cloud.api.GenerateApi
 import com.aspose.barcode.cloud.api.ScanApi
 import com.aspose.barcode.cloud.model.BarcodeImageFormat
+import com.aspose.barcode.cloud.model.BarcodeImageParams
 import com.aspose.barcode.cloud.model.EncodeBarcodeType
+import com.aspose.barcode.cloud.model.QREncodeMode
+import com.aspose.barcode.cloud.model.QRErrorLevel
+import com.aspose.barcode.cloud.model.QRVersion
+import com.aspose.barcode.cloud.model.QrParams
 import com.aspose.barcode.cloud.requests.GenerateRequestWrapper
 import com.aspose.barcode.cloud.requests.ScanMultipartRequestWrapper
 import com.google.android.material.snackbar.Snackbar
@@ -227,9 +232,20 @@ class MainActivity : AppCompatActivity() {
         val type = EncodeBarcodeType.fromValue(barcodeTypeSpinner.selectedItem.toString())
 
         val genRequest = GenerateRequestWrapper(type, barcodeTextEdit.text.toString())
-        genRequest.imageFormat = BarcodeImageFormat.PNG
-        genRequest.imageHeight = barcodeImgView.measuredHeight.toFloat()
-        genRequest.imageWidth = barcodeImgView.measuredWidth.toFloat()
+        genRequest.barcodeImageParams = BarcodeImageParams().apply {
+            imageFormat = BarcodeImageFormat.PNG
+            imageHeight = barcodeImgView.measuredHeight.toFloat()
+            imageWidth = barcodeImgView.measuredWidth.toFloat()
+        }
+
+        if (type == EncodeBarcodeType.QR) {
+            genRequest.qrParams = QrParams().apply {
+                qrEncodeMode = QREncodeMode.AUTO
+                qrErrorLevel = QRErrorLevel.LEVEL_M
+                qrVersion = QRVersion.AUTO
+                qrAspectRatio = 0.75f
+            }
+        }
 
         Thread {
             try {

codegen/Templates/android/README.mustache

@@ -70,25 +70,31 @@ To use Aspose Barcode Cloud for Android you need to register an account with [As
 
 ## Getting Started
 
-- Open project in Android Studio
+- Open project in Android Studio.
 
-- Go to file *app/src/main/java/com/example/asposebarcodecloud/MainActivity.kt* and set *clientId* and *clientSecret* to apropriate values from <https://dashboard.aspose.cloud/applications>
+- Go to `app/src/main/java/com/aspose/barcode/cloud/demo_app/MainActivity.kt` and set your `clientId` and `clientSecret` from <https://dashboard.aspose.cloud/applications>.
 
-- Build project and run application on connected device or emulator.
+- Build the project and run the app on a connected device or emulator.
 
-## Generate Code128 BbarCode in Android using Java
+## Generate QR Barcode in Android using Kotlin
 
-```java
-    // Get your ClientId and ClientSecret from https://dashboard.aspose.cloud (free registration required).
-    ApiClient client = new ApiClient("MY_CLIENT_ID", "MY_CLIENT_SECRET");
+```kotlin
+val client = ApiClient("MY_CLIENT_ID", "MY_CLIENT_SECRET")
+val generateApi = GenerateApi(client)
 
-    BarcodeApi api = new BarcodeApi(client);
+val request = GenerateRequestWrapper(EncodeBarcodeType.QR, "text example")
+request.barcodeImageParams = BarcodeImageParams().apply {
+    imageFormat = BarcodeImageFormat.PNG
+}
+request.qrParams = QrParams().apply {
+    qrEncodeMode = QREncodeMode.AUTO
+    qrErrorLevel = QRErrorLevel.LEVEL_M
+    qrVersion = QRVersion.AUTO
+    qrAspectRatio = 0.75f
+}
 
-    String type = "code128";
-    String text = "text example";
-
-    File result = api.getBarcodeGenerate(type, text);
-    System.out.println(result);
+val result = generateApi.generate(request)
+println(result?.absolutePath)
 ```
 
 ## Licensing

…degen/Templates/android/gradlew.mustache …plates/android/app-build.gradle.mustachecodegen/Templates/android/gradlew.mustache renamed to codegen/Templates/android/app-build.gradle.mustache codegen/Templates/android/gradlew.mustache renamed to codegen/Templates/android/app-build.gradle.mustache

@@ -64,16 +64,22 @@ namespace {{packageName}}.Api
         /// <summary>
         /// {{summary}} {{notes}}
         /// </summary>
-        {{#allParams}}/// <param name="{{paramName}}">{{description}}{{^required}} (optional{{#defaultValue}}, default to {{.}}{{/defaultValue}}){{/required}}{{#isDeprecated}} (deprecated){{/isDeprecated}}</param>
+        {{#allParams}}
+        {{^vendorExtensions.x-param-group-camel}}
+        /// <param name="{{paramName}}">{{description}}{{^required}} (optional{{#defaultValue}}, default to {{.}}{{/defaultValue}}){{/required}}{{#isDeprecated}} (deprecated){{/isDeprecated}}</param>
+        {{/vendorExtensions.x-param-group-camel}}
         {{/allParams}}
+        {{#vendorExtensions.x-param-groups}}
+        /// <param name="{{camel}}">Grouped parameters of type {{type}} (optional)</param>
+        {{/vendorExtensions.x-param-groups}}
         /// <param name="cancellationToken"></param>
         /// <returns>
         /// A task that represents the asynchronous operation. {{#returnType}}Task result type is  <see cref="{{returnType}}" /> {{/returnType}}
         /// </returns>
         {{#isDeprecated}}
         [Obsolete]
         {{/isDeprecated}}
-       public async {{#returnType}}Task<{{{returnType}}}>{{/returnType}}{{^returnType}}Task{{/returnType}} {{nickname}}Async({{#allParams}}{{{dataType}}} {{paramName}}{{^required}}{{#optionalMethodArgument}} = default{{/optionalMethodArgument}}{{/required}}{{^-last}}, {{/-last}}{{/allParams}}{{#allParams.0}}, {{/allParams.0}}System.Threading.CancellationToken cancellationToken = default)
+       public async {{#returnType}}Task<{{{returnType}}}>{{/returnType}}{{^returnType}}Task{{/returnType}} {{nickname}}Async({{#allParams}}{{^vendorExtensions.x-param-group-camel}}{{{dataType}}} {{paramName}}{{^required}}{{#optionalMethodArgument}} = default{{/optionalMethodArgument}}{{/required}}, {{/vendorExtensions.x-param-group-camel}}{{/allParams}}{{#vendorExtensions.x-param-groups}}{{type}} {{camel}} = default, {{/vendorExtensions.x-param-groups}}System.Threading.CancellationToken cancellationToken = default)
         {
 {{#allParams}}{{#required}}{{^isEnum}}            // verify the required parameter '{{paramName}}' is set
             if ({{paramName}} == null)
@@ -87,17 +93,22 @@ namespace {{packageName}}.Api
                 .Replace("&amp;", "&")
                 .Replace("/?", "?");
             {{#headerParams}}
-            {{#-first}}Dictionary<string, string> headerParams = new Dictionary<string, string>();{{/-first}}
+            {{#-first}}
+            Dictionary<string, string> headerParams = new Dictionary<string, string>();
+            {{/-first}}
             {{/headerParams}}
             {{#formParams}}
-            {{#-first}}MultipartFormDataContent multipartContent = new MultipartFormDataContent();{{/-first}}
+            {{#-first}}
+            MultipartFormDataContent multipartContent = new MultipartFormDataContent();
+            {{/-first}}
+            {{^vendorExtensions.x-param-group-camel}}
             {{^isEnum}}
             if ({{paramName}} != null)
             { {{/isEnum}}      {{#isEnum}}{{^required}}if ({{paramName}} != null)  { {{/required}}{{/isEnum}}
                 {{#isFile}}
                  {{^required}}
             if ({{paramName}} != null)
-            { {{/required}} 
+            { {{/required}}
                 multipartContent.Add(new StreamContent({{paramName}}), "{{paramName}}", "{{paramName}}.png");
                 {{^required}} } {{/required}}
                 {{/isFile}}
@@ -113,14 +124,25 @@ namespace {{packageName}}.Api
                     {{/isPrimitiveType}}
                 {{/isFile}}
            {{^isEnum}} } {{/isEnum}}   {{#isEnum}}{{^required}} } {{/required}}{{/isEnum}}
+            {{/vendorExtensions.x-param-group-camel}}
+            {{#vendorExtensions.x-param-group-camel}}
+            if ({{vendorExtensions.x-param-group-camel}}?.{{nameInPascalCase}} != null)
+            {
+                multipartContent.Add(new StringContent($"{ {{vendorExtensions.x-param-group-camel}}?.{{nameInPascalCase}} }"), "{{paramName}}");
+            }
+            {{/vendorExtensions.x-param-group-camel}}
             {{/formParams}}
             {{#pathParams}}
             resourcePath = UrlHelper.AddPathParameter(resourcePath, "{{paramName}}", {{paramName}});
             {{/pathParams}}
             {{#queryParams}}
-            {{#-first}}#pragma warning disable CS0618 // Type or member is obsolete{{/-first}}
-            resourcePath = UrlHelper.AddQueryParameterToUrl(resourcePath, "{{paramName}}", {{paramName}});
-            {{#-last}}#pragma warning restore CS0618 // Type or member is obsolete{{/-last}}
+            {{#-first}}
+            #pragma warning disable CS0618 // Type or member is obsolete
+            {{/-first}}
+            {{^vendorExtensions.x-param-group-camel}}resourcePath = UrlHelper.AddQueryParameterToUrl(resourcePath, "{{paramName}}", {{paramName}});{{/vendorExtensions.x-param-group-camel}}{{#vendorExtensions.x-param-group-camel}}resourcePath = UrlHelper.AddQueryParameterToUrl(resourcePath, "{{paramName}}", {{vendorExtensions.x-param-group-camel}}?.{{nameInPascalCase}});{{/vendorExtensions.x-param-group-camel}}
+            {{#-last}}
+            #pragma warning restore CS0618 // Type or member is obsolete
+            {{/-last}}
             {{/queryParams}}
             {{#hasBodyParam}}string postBody = SerializationHelper.Serialize({{bodyParam.paramName}}); // http body (model) parameter{{/hasBodyParam}}
 

…n/Templates/android/git_push.sh.mustache …lates/android/gradle.properties.mustachecodegen/Templates/android/git_push.sh.mustache renamed to codegen/Templates/android/gradle.properties.mustache codegen/Templates/android/git_push.sh.mustache renamed to codegen/Templates/android/gradle.properties.mustache

@@ -22,14 +22,17 @@ namespace {{packageName}}.Interfaces
         /// </remarks>
         /// <exception cref="{{packageName}}.Api.ApiException">Thrown when fails to make API call</exception>
         {{#allParams}}
-        /// <param name="{{paramName}}">{{description}}</param>
+        {{^vendorExtensions.x-param-group-camel}}/// <param name="{{paramName}}">{{description}}</param>{{/vendorExtensions.x-param-group-camel}}
         {{/allParams}}
+        {{#vendorExtensions.x-param-groups}}
+        /// <param name="{{camel}}">Grouped parameters of type {{type}}</param>
+        {{/vendorExtensions.x-param-groups}}
         /// <param name="cancellationToken">Cancellation Token to cancel the request.</param>
         /// <returns>Task of {{returnType}}{{^returnType}}void{{/returnType}}</returns>
         {{#isDeprecated}}
         [Obsolete]
         {{/isDeprecated}}
-        {{#returnType}}Task<{{{.}}}>{{/returnType}}{{^returnType}}Task{{/returnType}} {{operationId}}Async({{#allParams}}{{{dataType}}} {{paramName}}{{^required}}{{#optionalMethodArgument}} = default{{/optionalMethodArgument}}{{/required}}{{^-last}}, {{/-last}}{{/allParams}}{{#allParams.0}}, {{/allParams.0}}System.Threading.CancellationToken cancellationToken = default);
+        {{#returnType}}Task<{{{.}}}>{{/returnType}}{{^returnType}}Task{{/returnType}} {{operationId}}Async({{#allParams}}{{^vendorExtensions.x-param-group-camel}}{{{dataType}}} {{paramName}}{{^required}}{{#optionalMethodArgument}} = default{{/optionalMethodArgument}}{{/required}}, {{/vendorExtensions.x-param-group-camel}}{{/allParams}}{{#vendorExtensions.x-param-groups}}{{type}} {{camel}} = default, {{/vendorExtensions.x-param-groups}}System.Threading.CancellationToken cancellationToken = default);
         {{/operation}}
     }
 {{/operations}}

codegen/Templates/android/pom.mustache …mplates/android/settings.gradle.mustachecodegen/Templates/android/pom.mustache renamed to codegen/Templates/android/settings.gradle.mustache codegen/Templates/android/pom.mustache renamed to codegen/Templates/android/settings.gradle.mustache

@@ -22,7 +22,7 @@ class {{classname}} {
   {{#isDeprecated}}
   @deprecated
   {{/isDeprecated}}
-  {{#returnType}}Future<{{#isResponseFile}}Uint8List{{/isResponseFile}}{{^isResponseFile}}{{{returnType}}}{{/isResponseFile}}> {{/returnType}}{{^returnType}}Future {{/returnType}}{{nickname}}({{#allParams}}{{#required}}{{^isFile}}{{{dataType}}} {{paramName}}{{/isFile}}{{#isFile}}Uint8List {{paramName}}Bytes{{/isFile}}{{^-last}}, {{/-last}}{{/required}}{{/allParams}}{{#hasOptionalParams}}{ {{#allParams}}{{^required}}{{^isFile}}{{{dataType}}}? {{paramName}}{{/isFile}}{{#isFile}}Uint8List? {{paramName}}Bytes{{/isFile}}{{^-last}}, {{/-last}}{{/required}}{{/allParams}} }{{/hasOptionalParams}}) async {
+  {{#returnType}}Future<{{#isResponseFile}}Uint8List{{/isResponseFile}}{{^isResponseFile}}{{{returnType}}}{{/isResponseFile}}> {{/returnType}}{{^returnType}}Future {{/returnType}}{{nickname}}({{#allParams}}{{#required}}{{^isFile}}{{{dataType}}} {{paramName}}{{/isFile}}{{#isFile}}Uint8List {{paramName}}Bytes{{/isFile}}{{^-last}}, {{/-last}}{{/required}}{{/allParams}}{{#hasOptionalParams}}{ {{#allParams}}{{^required}}{{^vendorExtensions.x-param-group-camel}}{{^isFile}}{{{dataType}}}? {{paramName}}{{/isFile}}{{#isFile}}Uint8List? {{paramName}}Bytes{{/isFile}}{{^-last}}, {{/-last}}{{/vendorExtensions.x-param-group-camel}}{{/required}}{{/allParams}}{{#vendorExtensions.x-param-groups}}{{type}}? {{camel}}{{^-last}}, {{/-last}}{{/vendorExtensions.x-param-groups}} }{{/hasOptionalParams}}) async {
     // ignore: prefer_final_locals
     Object? postBody = {{#bodyParam}}{{paramName}}{{/bodyParam}}{{^bodyParam}}null{{/bodyParam}};
 
@@ -34,13 +34,20 @@ class {{classname}} {
     final Map<String, String> headerParams = {};
     final Map<String, String> formParams = {};
     {{#queryParams}}
+    {{^vendorExtensions.x-param-group-camel}}
     {{^required}}
     if({{paramName}} != null) {
     {{/required}}
       queryParams.addAll(convertParametersForCollectionFormat("{{collectionFormat}}", "{{baseName}}", {{paramName}}));
     {{^required}}
     }
     {{/required}}
+    {{/vendorExtensions.x-param-group-camel}}
+    {{#vendorExtensions.x-param-group-camel}}
+    if({{vendorExtensions.x-param-group-camel}}?.{{paramName}} != null) {
+      queryParams.addAll(convertParametersForCollectionFormat("{{collectionFormat}}", "{{baseName}}", {{vendorExtensions.x-param-group-camel}}!.{{paramName}}));
+    }
+    {{/vendorExtensions.x-param-group-camel}}
     {{/queryParams}}
     {{#headerParams}}headerParams["{{baseName}}"] = {{paramName}};
     {{/headerParams}}
@@ -52,7 +59,9 @@ class {{classname}} {
 
     {{#hasFormParams}}
       MultipartRequestPlus mp = MultipartRequestPlus('{{httpMethod}}', Uri.parse(requestPath));
-      {{#formParams}}{{^isFile}}
+      {{#formParams}}
+      {{^vendorExtensions.x-param-group-camel}}
+      {{^isFile}}
       if ({{paramName}} != null) {
         {{#isCollectionFormatMulti}}
         final List<String> stringValues = {{paramName}}.map((i) => parameterToString(i)).toList();
@@ -62,8 +71,8 @@ class {{classname}} {
         mp.fields['{{baseName}}'] = [parameterToString({{paramName}})];
         {{/isCollectionFormatMulti}}
       }
-      {{/isFile}}{{#isFile}}
-      
+      {{/isFile}}
+      {{#isFile}}
       {{#required}}
         mp.files.add(MultipartFile.fromBytes("{{paramName}}", {{paramName}}Bytes.toList(), filename: "somefile.xyz"));
       {{/required}}
@@ -72,10 +81,16 @@ class {{classname}} {
         mp.files.add(MultipartFile.fromBytes("{{paramName}}", {{paramName}}Bytes.toList(), filename: "somefile.xyz"));
       }
       {{/required}}
-
-      {{/isFile}}{{/formParams}}
+      {{/isFile}}
+      {{/vendorExtensions.x-param-group-camel}}
+      {{#vendorExtensions.x-param-group-camel}}
+      if ({{vendorExtensions.x-param-group-camel}}?.{{paramName}} != null) {
+        mp.fields['{{baseName}}'] = [parameterToString({{vendorExtensions.x-param-group-camel}}!.{{paramName}})];
+      }
+      {{/vendorExtensions.x-param-group-camel}}
+      {{/formParams}}
       postBody = mp;
-    
+
     {{/hasFormParams}}
 
     final response = await _apiClient.invokeAPI(requestPath,