Release 23.8 (#79)

Denis-Averin · Ivan Kamkin · web-flow · commit 60494e567c54 · 2023-09-04T23:20:15.000+07:00
* Update Swagger

* Improve dotnet docs for enums

* Improve go docs for enums

* Improve dart docs for enums

* Improve Python docs

* Improve PHP docs

---------

Co-authored-by: Ivan Kamkin &lt;234-Ivan.Kamkin@users.noreply.git.saltov.dynabic.com&gt;
diff --git a/codegen/Templates/csharp/model_doc.mustache b/codegen/Templates/csharp/model_doc.mustache
@@ -2,17 +2,24 @@
 {{#model}}
 # {{{packageName}}}.{{modelPackage}}.{{{classname}}}
 
+{{#description}}
+{{description}}
+
+{{/description}}
+{{#allowableValues}}
+## Allowable values
+
+{{#enumVars}}
+{{#-first}}* **{{value}}**{{/-first}}{{^-first}}* {{value}}{{/-first}}
+{{/enumVars}}
+{{/allowableValues}}
+{{#hasVars}}
 ## Properties
 
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
-{{#parent}}
-{{#parentVars}}
-**{{name}}** | {{#isPrimitiveType}}**{{datatype}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{datatype}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}
-{{/parentVars}}
-{{/parent}}
 {{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{datatype}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{datatype}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}
 {{/vars}}
-
+{{/hasVars}}
 {{/model}}
 {{/models}}
diff --git a/codegen/Templates/dart/object_doc.mustache b/codegen/Templates/dart/object_doc.mustache
@@ -1,13 +1,27 @@
 {{#models}}{{#model}}# {{pubName}}.model.{{classname}}
 
 ## Load the model package
+
 ```dart
 import 'package:{{pubName}}/api.dart';
 ```
+{{#description}}
+{{description}}
+{{/description}}
+{{#allowableValues}}
+## Allowable values
+
+{{#enumVars}}
+* {{#-first}}**{{/-first}}{{{classname}}}.{{name}}{{#-first}}**{{/-first}}
+{{/enumVars}}
+{{/allowableValues}}
+{{#hasVars}}
 
 ## Properties
+
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
 {{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{datatype}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{datatype}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{defaultValue}}]{{/defaultValue}}
 {{/vars}}
+{{/hasVars}}
 {{/model}}{{/models}}
diff --git a/codegen/Templates/go/model_doc.mustache b/codegen/Templates/go/model_doc.mustache
@@ -1,10 +1,22 @@
 {{#models}}{{#model}}# {{classname}}
 
+{{#description}}
+{{description}}
+
+{{/description}}
+{{#allowableValues}}
+## Allowable values
+{{#enumVars}}
+{{#-first}}* **{{{classname}}}{{value}}**{{/-first}}{{^-first}}* {{{classname}}}{{value}}{{/-first}}
+{{/enumVars}}
+{{/allowableValues}}
+{{#hasVars}}
 ## Properties
 
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
 {{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{{datatype}}}**{{/isPrimitiveType}}{{^isPrimitiveType}}{{^isDateTime}}[**{{^isContainer}}*{{/isContainer}}{{{datatype}}}**]({{^isContainer}}{{datatype}}{{/isContainer}}{{#isContainer}}{{complexType}}{{/isContainer}}.md){{/isDateTime}}{{#isDateTime}}**time.Time**{{/isDateTime}}{{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}
 {{/vars}}
+{{/hasVars}}
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md){{/model}}{{/models}}
diff --git a/codegen/Templates/php/model_doc.mustache b/codegen/Templates/php/model_doc.mustache
@@ -1,10 +1,23 @@
 {{#models}}{{#model}}# {{classname}}
+{{#description}}
+
+{{description}}
+{{/description}}
+{{#allowableValues}}
+## Allowable values
+
+{{#enumVars}}
+* {{#-first}}**{{/-first}}{{name}}{{#-first}}**{{/-first}}
+{{/enumVars}}
+{{/allowableValues}}
+{{#hasVars}}
 
 ## Properties
 Name | Type | Description | Notes
 ---- | ---- | ----------- | -----
 {{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{datatype}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{datatype}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}
 {{/vars}}
+{{/hasVars}}
 
 [[Back to Model list]](../../README.md#documentation-for-models) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to README]](../../README.md)
 
diff --git a/codegen/Templates/python/model_doc.mustache b/codegen/Templates/python/model_doc.mustache
@@ -0,0 +1,23 @@
+{{#models}}{{#model}}# {{classname}}
+
+{{#description}}
+{{description}}
+{{/description}}
+{{#allowableValues}}
+## Allowable values
+
+{{#enumVars}}
+* {{#-first}}**{{/-first}}{{{classname}}}.{{name}}{{#-first}}**{{/-first}}
+{{/enumVars}}
+{{/allowableValues}}
+{{#hasVars}}
+
+## Properties
+
+Name | Type | Description | Notes
+---- | ---- | ----------- | -----
+{{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{datatype}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{datatype}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}
+{{/vars}}
+{{/hasVars}}
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md){{/model}}{{/models}}
diff --git a/codegen/config-android.json b/codegen/config-android.json
@@ -4,7 +4,7 @@
     "androidSdkVersion": "33",
     "apiPackage": "com.aspose.barcode.cloud.demo_app",
     "artifactId": "Android Application for Barcode Processing in the Cloud via REST API",
-    "artifactVersion": "23.7.0",
+    "artifactVersion": "23.8.0",
     "groupId": "com.aspose",
     "invokerPackage": "com.aspose.barcode.cloud.demo_app",
     "modelPackage": "com.aspose.barcode.cloud.demo_app.model"
diff --git a/codegen/config-dart.json b/codegen/config-dart.json
@@ -2,6 +2,6 @@
     "browserClient": false,
     "pubDescription": "This SDK allows you to work with Aspose.BarCode for Cloud REST APIs in your Dart or Flutter applications quickly and easily",
     "pubName": "aspose_barcode_cloud",
-    "pubVersion": "0.23.7",
+    "pubVersion": "0.23.8",
     "useEnumExtension": true
 }
diff --git a/codegen/config-go.json b/codegen/config-go.json
@@ -1,4 +1,4 @@
 {
     "packageName": "barcode",
-    "packageVersion": "0.2307.0"
+    "packageVersion": "0.2308.0"
 }
diff --git a/codegen/config-java.json b/codegen/config-java.json
@@ -3,7 +3,7 @@
     "artifactDescription": "Aspose.BarCode Cloud SDK for Java",
     "artifactId": "aspose-barcode-cloud",
     "artifactUrl": "https://www.aspose.cloud",
-    "artifactVersion": "23.7.0",
+    "artifactVersion": "23.8.0",
     "developerEmail": "denis.averin@aspose.com",
     "developerName": "Denis Averin",
     "developerOrganization": "Aspose",
diff --git a/codegen/config-php.json b/codegen/config-php.json
@@ -1,4 +1,4 @@
 {
-    "artifactVersion": "23.7.1",
+    "artifactVersion": "23.8.0",
     "invokerPackage": "Aspose\\BarCode"
 }
diff --git a/codegen/config-python.json b/codegen/config-python.json
@@ -1,6 +1,6 @@
 {
     "packageName": "aspose_barcode_cloud",
     "packageUrl": "https://github.com/aspose-barcode-cloud/aspose-barcode-cloud-python",
-    "packageVersion": "23.7.0",
+    "packageVersion": "23.8.0",
     "projectName": "aspose-barcode-cloud"
 }
diff --git a/codegen/config.json b/codegen/config.json
@@ -1,8 +1,8 @@
 {
     "artifactVersion": "23.7.0",
     "npmName": "aspose-barcode-cloud-node",
-    "npmVersion": "23.7.0",
+    "npmVersion": "23.8.0",
     "packageName": "Aspose.BarCode.Cloud.Sdk",
-    "packageVersion": "23.7.1",
+    "packageVersion": "23.8.0",
     "supportsES6": true
-}
+}
diff --git a/scripts/start-release.bash b/scripts/start-release.bash
@@ -1,20 +1,29 @@
 #!/bin/bash
-#Run from aspose-barcode-cloud-codegen
 set -euo pipefail
 
-SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"
+which make || (
+    echo "Make is required"
+    echo "Install Make or use WSL"
+    exit 1
+)
 
 year=$(date +%y)
 month=$(date +%-m)
 
 major=${1:-$year}
 minor=${2:-$month}
-
 branch_name="release-${major}.${minor}"
+
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"
+pushd "${SCRIPT_DIR}/.."
+
+echo "Update Swagger specification..."
+./update_swagger_spec.bash
+
 echo "Switching to ${branch_name}"
 git switch --create "${branch_name}" || git switch "${branch_name}"
 
-pushd "${SCRIPT_DIR}/../submodules"
+pushd "./submodules"
 for d in */ ; do
     pushd "$d"
 
@@ -27,3 +36,4 @@ done
 python "${SCRIPT_DIR}/new-version.py" "${major}" "${minor}"
 
 popd >/dev/null
+popd >/dev/null
diff --git a/scripts/update_all_package_dependencies.bash b/scripts/update_all_package_dependencies.bash
@@ -1,13 +1,18 @@
 #!/bin/bash
-
 set -euo pipefail
 
+which make || (
+    echo "Make is required"
+    echo "Install Make or use WSL"
+    exit 1
+)
+
 pushd "$(dirname "$0")/../submodules"
 
 for d in */ ; do
     pushd "$d"
 
-    wsl make update
+    make update
 
     popd >/dev/null
 done
diff --git a/spec/aspose-barcode-cloud.json b/spec/aspose-barcode-cloud.json
diff --git a/submodules/android b/submodules/android
diff --git a/submodules/dart b/submodules/dart
diff --git a/submodules/dotnet b/submodules/dotnet
diff --git a/submodules/go b/submodules/go
diff --git a/submodules/java b/submodules/java

Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,6 @@`
`2`	`2`	`"browserClient": false,`
`3`	`3`	`"pubDescription": "This SDK allows you to work with Aspose.BarCode for Cloud REST APIs in your Dart or Flutter applications quickly and easily",`
`4`	`4`	`"pubName": "aspose_barcode_cloud",`
`5`		`- "pubVersion": "0.23.7",`
	`5`	`+ "pubVersion": "0.23.8",`
`6`	`6`	`"useEnumExtension": true`
`7`	`7`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`	`1`	`{`
`2`	`2`	`"packageName": "barcode",`
`3`		`- "packageVersion": "0.2307.0"`
	`3`	`+ "packageVersion": "0.2308.0"`
`4`	`4`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`	`1`	`{`
`2`		`- "artifactVersion": "23.7.1",`
	`2`	`+ "artifactVersion": "23.8.0",`
`3`	`3`	`"invokerPackage": "Aspose\\BarCode"`
`4`	`4`	`}`