Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[codegen][python-experimental] Composed schema with additionalProperties #6290

Merged
merged 146 commits into from
May 28, 2020
Merged
Show file tree
Hide file tree
Changes from 130 commits
Commits
Show all changes
146 commits
Select commit Hold shift + click to select a range
41e97e6
Mustache template should use invokerPackage tag to generate import
sebastien-rosset May 13, 2020
1760f6a
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 13, 2020
3ae466e
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 13, 2020
b628667
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 13, 2020
fca81de
Add a unit test for allOf and additionalProperties
sebastien-rosset May 13, 2020
13d865a
Fix getAdditionalProperties
sebastien-rosset May 13, 2020
eed27dc
Add code comments
sebastien-rosset May 14, 2020
158ee57
Add code comments
sebastien-rosset May 14, 2020
24fc6c5
set nullable for additionalproperties
sebastien-rosset May 14, 2020
c47d097
add variants of additionalProperties
sebastien-rosset May 14, 2020
4c88951
Add more unit tests
sebastien-rosset May 14, 2020
9b687da
Handle additionalProperties for composed schemas
sebastien-rosset May 14, 2020
4dc915c
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 14, 2020
bc628a4
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 14, 2020
c603f09
improve code comments
sebastien-rosset May 14, 2020
a594a1a
Add code comments
sebastien-rosset May 14, 2020
068b137
Add code comments
sebastien-rosset May 14, 2020
524bd31
Add code comments
sebastien-rosset May 14, 2020
e2e2e08
Add code comments
sebastien-rosset May 14, 2020
b62ae93
Add code comments
sebastien-rosset May 14, 2020
c2cadb0
Add assertions in unit tests
sebastien-rosset May 14, 2020
6273388
Add new property to support the 'additionalProperties' keyword with c…
sebastien-rosset May 14, 2020
f32f9eb
run sample scripts
sebastien-rosset May 14, 2020
87f900f
fix unit tests to handle additionalProperties
sebastien-rosset May 14, 2020
ed47df0
Handle additional properties and composed schema
sebastien-rosset May 14, 2020
80a6f9b
Handle additional properties and composed schema
sebastien-rosset May 14, 2020
8250756
Add support for additionalProperties and composed schema
sebastien-rosset May 14, 2020
6472351
Format java code
sebastien-rosset May 14, 2020
e158fef
Add more unit tests for Python
sebastien-rosset May 14, 2020
250dd7c
Handle reference in additionalProperty keyword
sebastien-rosset May 15, 2020
6b4fa1f
Handle reference in additionalProperty keyword
sebastien-rosset May 15, 2020
3b2261b
Add use case for additionalProperties and reference
sebastien-rosset May 15, 2020
b8b6d22
run sample scripts
sebastien-rosset May 15, 2020
66ec230
resolve schema reference
sebastien-rosset May 15, 2020
594332a
Add OpenAPI argument
sebastien-rosset May 15, 2020
12c55ca
Add OpenAPI argument
sebastien-rosset May 15, 2020
b0b198a
Add OpenAPI argument
sebastien-rosset May 15, 2020
628520d
Add OpenAPI argument
sebastien-rosset May 15, 2020
fa07164
Add OpenAPI argument
sebastien-rosset May 15, 2020
d45636b
Handle additional property keyword with reference
sebastien-rosset May 16, 2020
8a1c425
Handle additional property keyword with reference
sebastien-rosset May 16, 2020
ed36b75
Handle additional property keyword with reference
sebastien-rosset May 16, 2020
230c2b8
Handle additional property keyword with reference
sebastien-rosset May 16, 2020
726d47e
add additionalproperties attribute with boolean values
sebastien-rosset May 16, 2020
a67cc80
Run sample scripts
sebastien-rosset May 16, 2020
7a207f6
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 16, 2020
c729225
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 16, 2020
cd1f8fd
handle additional properties
sebastien-rosset May 16, 2020
776fba6
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 18, 2020
7773c48
resolve merge conflicts
sebastien-rosset May 18, 2020
70f6207
Handle additionalProperties boolean values
sebastien-rosset May 18, 2020
c4d049f
Run sample scripts
sebastien-rosset May 19, 2020
98e862a
fix javadoc issues
sebastien-rosset May 19, 2020
86d6733
fix javadoc issues
sebastien-rosset May 19, 2020
1f51fb0
Add Locale to String.toLowerCase
sebastien-rosset May 19, 2020
886d412
execute sample scripts
sebastien-rosset May 19, 2020
4bdf111
handle additional properties
sebastien-rosset May 19, 2020
3fac434
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 19, 2020
45bf565
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 19, 2020
b05b415
Add code comments
sebastien-rosset May 19, 2020
f57338d
Handle imports of referenced models in additional properties
sebastien-rosset May 19, 2020
be49ab4
Handle isNullable class
sebastien-rosset May 19, 2020
faecafd
handle nullable type
sebastien-rosset May 20, 2020
cbfa018
improve documentation, run sample scripts
sebastien-rosset May 20, 2020
45959d8
improve documentation, run sample scripts
sebastien-rosset May 20, 2020
1cc405c
execute sample scripts
sebastien-rosset May 20, 2020
f55c2f0
execute sample scripts
sebastien-rosset May 20, 2020
a96c46b
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 20, 2020
eeb6ed0
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 20, 2020
c41d5fc
Execute sample scripts
sebastien-rosset May 20, 2020
2cb7acd
Run samples scripts
sebastien-rosset May 20, 2020
ddbb667
set legacyAdditionalPropertiesBehavior to true by default, except python
sebastien-rosset May 20, 2020
f12663a
create separate yaml file to avoid having lots of changes in the pr
sebastien-rosset May 20, 2020
88dd98f
create separate yaml file to avoid having lots of changes in the pr
sebastien-rosset May 20, 2020
782bdf6
create separate yaml file to avoid having lots of changes in the pr
sebastien-rosset May 20, 2020
58d38c2
create separate yaml file to avoid having lots of changes in the pr
sebastien-rosset May 20, 2020
4be1ef9
create separate yaml file to avoid having lots of changes in the pr
sebastien-rosset May 20, 2020
9fd0685
create separate yaml file to avoid having lots of changes in the pr
sebastien-rosset May 20, 2020
ac27812
Change name of CLI option
sebastien-rosset May 21, 2020
d9518f1
Generate doc
sebastien-rosset May 21, 2020
79e5ecf
Add TODO statement
sebastien-rosset May 21, 2020
34740a1
add code comments
sebastien-rosset May 21, 2020
598b0e4
run samples scripts
sebastien-rosset May 21, 2020
8d93337
run sample scripts
sebastien-rosset May 21, 2020
7195e03
run sample scripts
sebastien-rosset May 21, 2020
9212c85
run sample scripts
sebastien-rosset May 21, 2020
cc80080
run sample scripts
sebastien-rosset May 21, 2020
3604c95
run sample scripts
sebastien-rosset May 21, 2020
dee6dc4
run sample scripts
sebastien-rosset May 21, 2020
0b67974
run sample scripts
sebastien-rosset May 21, 2020
22777e7
run sample scripts
sebastien-rosset May 21, 2020
a389e18
run sample scripts
sebastien-rosset May 21, 2020
5f428a4
run sample scripts
sebastien-rosset May 21, 2020
9b82711
run sample scripts
sebastien-rosset May 21, 2020
0b19b7f
refactor cli option for additional properties
sebastien-rosset May 21, 2020
006900a
refactor cli option for additional properties
sebastien-rosset May 21, 2020
a63f670
run samples scripts
sebastien-rosset May 21, 2020
38ecb91
run sample scripts
sebastien-rosset May 21, 2020
66d35c5
run sample scripts
sebastien-rosset May 21, 2020
fe87ff0
run sample scripts
sebastien-rosset May 21, 2020
ed54ab8
run sample scripts
sebastien-rosset May 21, 2020
65d1401
Add yaml comments
sebastien-rosset May 21, 2020
0ce0b6b
small refactor
sebastien-rosset May 21, 2020
92cb99b
small refactor
sebastien-rosset May 21, 2020
765757f
run sample scripts
sebastien-rosset May 21, 2020
ec20030
run sample scripts
sebastien-rosset May 21, 2020
d14898c
fix unit tests
sebastien-rosset May 21, 2020
89117b9
Set disallowAdditionalPropertiesIfNotPresent flag
sebastien-rosset May 21, 2020
1351fd0
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 21, 2020
ba65735
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 22, 2020
9a0b89e
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 22, 2020
4c84190
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 22, 2020
0f1f59c
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 22, 2020
5206a30
reduced size of test yaml file
sebastien-rosset May 22, 2020
5339ab7
simplify code and add imports directly
sebastien-rosset May 22, 2020
0f014dd
rename some of the properties used in tests
sebastien-rosset May 22, 2020
ffae039
Handle more scenarios for nullable types
sebastien-rosset May 22, 2020
94ae683
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 22, 2020
8fdbd27
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 22, 2020
aac9f5a
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 23, 2020
248086a
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 23, 2020
93baa3d
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 23, 2020
47e542e
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 23, 2020
5c313b4
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 23, 2020
e91ad67
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 23, 2020
cda8898
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 23, 2020
aee63b6
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 23, 2020
b1b487a
add code comments
sebastien-rosset May 23, 2020
1f7e5c1
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 24, 2020
b0339d0
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 24, 2020
5466a88
Adds *args input to __init__ method to fix test testFruitNullValue
spacether May 24, 2020
7eb9c8e
Merge pull request #21 from spacether/all-of-additional-properties_jb…
sebastien-rosset May 25, 2020
bef435e
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 25, 2020
e5ba967
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 25, 2020
6d561ad
Resolve merge issues
sebastien-rosset May 25, 2020
4e6a827
Merge branch 'all-of-additional-properties' of github.com:CiscoM31/op…
sebastien-rosset May 26, 2020
768d933
run samples scripts
sebastien-rosset May 26, 2020
3283e3c
run doc generator
sebastien-rosset May 26, 2020
a9cad38
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 26, 2020
5bed2f7
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 26, 2020
877ecfe
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 27, 2020
fba4803
Merge branch 'master' of github.com:CiscoM31/openapi-generator into a…
sebastien-rosset May 27, 2020
8c055f5
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 27, 2020
d64f421
Merge branch 'master' of https://github.com/OpenAPITools/openapi-gene…
sebastien-rosset May 28, 2020
408409e
resolve merge conflicts
sebastien-rosset May 28, 2020
65f6cf8
fix merge conflicts
sebastien-rosset May 28, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion bin/python-experimental-petstore.sh
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,6 @@ fi

# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
ags="generate -t modules/openapi-generator/src/main/resources/python -i modules/openapi-generator/src/test/resources/2_0/python-client-experimental/petstore-with-fake-endpoints-models-for-testing.yaml -g python-experimental -o samples/client/petstore/python-experimental --additional-properties packageName=petstore_api $@"
ags="generate -t modules/openapi-generator/src/main/resources/python -i modules/openapi-generator/src/test/resources/2_0/python-client-experimental/petstore-with-fake-endpoints-models-for-testing.yaml -g python-experimental -o samples/client/petstore/python-experimental --additional-properties packageName=petstore_api --additional-properties disallowAdditionalPropertiesIfNotPresent=true $@"

java $JAVA_OPTS -jar $executable $ags
2 changes: 2 additions & 0 deletions docs/generators/ada-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ sidebar_label: ada-server
| Option | Description | Values | Default |
| ------ | ----------- | ------ | ------- |
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|disallowAdditionalPropertiesIfNotPresent|Specify the behavior when the 'additionalProperties' keyword is not present in the OAS document
If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents: 1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed. 2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.</dd></dl>|true|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|legacyDiscriminatorBehavior|This flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.|<dl><dt>**true**</dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt>**false**</dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl>|true|
|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
Expand Down
2 changes: 2 additions & 0 deletions docs/generators/ada.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ sidebar_label: ada
| Option | Description | Values | Default |
| ------ | ----------- | ------ | ------- |
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|disallowAdditionalPropertiesIfNotPresent|Specify the behavior when the 'additionalProperties' keyword is not present in the OAS document
If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents: 1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed. 2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.</dd></dl>|true|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|legacyDiscriminatorBehavior|This flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.|<dl><dt>**true**</dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt>**false**</dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl>|true|
|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
Expand Down
2 changes: 2 additions & 0 deletions docs/generators/android.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ sidebar_label: android
|apiPackage|package for generated api classes| |null|
|artifactId|artifactId for use in the generated build.gradle and pom.xml| |null|
|artifactVersion|artifact version for use in the generated build.gradle and pom.xml| |null|
|disallowAdditionalPropertiesIfNotPresent|Specify the behavior when the 'additionalProperties' keyword is not present in the OAS document
If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents: 1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed. 2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.</dd></dl>|true|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|groupId|groupId for use in the generated build.gradle and pom.xml| |null|
|invokerPackage|root package for generated code| |null|
Expand Down
2 changes: 2 additions & 0 deletions docs/generators/apache2.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ sidebar_label: apache2
| Option | Description | Values | Default |
| ------ | ----------- | ------ | ------- |
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|disallowAdditionalPropertiesIfNotPresent|Specify the behavior when the 'additionalProperties' keyword is not present in the OAS document
If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents: 1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed. 2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.</dd></dl>|true|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|legacyDiscriminatorBehavior|This flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.|<dl><dt>**true**</dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt>**false**</dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl>|true|
|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
Expand Down
2 changes: 2 additions & 0 deletions docs/generators/apex.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ sidebar_label: apex
|apiVersion|The Metadata API version number to use for components in this package.| |null|
|buildMethod|The build method for this package.| |null|
|classPrefix|Prefix for generated classes. Set this to avoid overwriting existing classes in your org.| |null|
|disallowAdditionalPropertiesIfNotPresent|Specify the behavior when the 'additionalProperties' keyword is not present in the OAS document
If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents: 1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed. 2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.</dd></dl>|true|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|legacyDiscriminatorBehavior|This flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.|<dl><dt>**true**</dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt>**false**</dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl>|true|
|namedCredential|The named credential name for the HTTP callouts| |null|
Expand Down
2 changes: 2 additions & 0 deletions docs/generators/asciidoc.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ sidebar_label: asciidoc
|appName|short name of the application| |null|
|artifactId|artifactId in generated pom.xml. This also becomes part of the generated library's filename| |null|
|artifactVersion|artifact version in generated pom.xml. This also becomes part of the generated library's filename| |null|
|disallowAdditionalPropertiesIfNotPresent|Specify the behavior when the 'additionalProperties' keyword is not present in the OAS document
If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents: 1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed. 2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.</dd></dl>|true|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|groupId|groupId in generated pom.xml| |null|
|headerAttributes|generation of asciidoc header meta data attributes (set to false to suppress, default: true)| |true|
Expand Down
Loading