Updates docs

Author: spacether

bin/utils/export_docs_generators.sh

@@ -3,7 +3,7 @@
 SCRIPT="$0"
 echo "# START SCRIPT: ${SCRIPT}"
 
-executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+executable="./modules/openapi-json-schema-generator-cli/target/openapi-json-schema-generator-cli.jar"
 
 if [[ "true" == "${SKIP_EXPORT_DOCS}" ]]; then
   echo "Skipping doc exports. Note that docs generated by Windows may break paths as they have not yet been normalized to OS-specific paths."

bin/utils/export_generator.sh

@@ -12,6 +12,7 @@ else
     exit 1;
 fi
 
-executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+executable="./modules/openapi-json-schema-generator-cli/target/openapi-json-schema-generator-cli.jar"
+
 
 java -jar ${executable} config-help -g "${NAME}" --full-details --named-header --format markdown --markdown-header -o "docs/generators/${NAME}.md"

docs/generators/python.md

@@ -22,6 +22,7 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |generateSourceCodeOnly|Specifies that only a library source code is to be generated.| |false|
 |hideGenerationTimestamp|Hides the generation timestamp when files are generated.| |true|
 |library|library template (sub-template) to use: urllib3| |urllib3|
+|nonCompliantUseDiscriminatorIfCompositionFails|When true, If the payload fails to validate against composed schemas (allOf/anyOf/oneOf/not) and a discriminator is present, then ignore the compostion validation errors and attempt to use the discriminator to validate the payload. Note: setting this to true makes the generated client not comply with json schema because it ignores compotion validation errors . Please consider making your schemas more restrictive rather than setting this to true. You can do that by: - defining the propertyName as an enum with only one value in the schemas that are in your discriminator map- setting additionalProperties: false in your schemas| |false|
 |packageName|python package name (convention: snake_case).| |openapi_client|
 |packageUrl|python package URL.| |null|
 |packageVersion|python package version.| |1.0.0|

modules/openapi-json-schema-generator/src/main/java/org/openapitools/codegen/CodegenConstants.java

@@ -407,10 +407,12 @@ public static enum ENUM_PROPERTY_NAMING_TYPE {camelCase, PascalCase, snake_case,
     public static final String NON_COMPLIANT_USE_DISCR_IF_COMPOSITION_FAILS = "nonCompliantUseDiscriminatorIfCompositionFails";
 
     public static final String NON_COMPLIANT_USE_DISCR_IF_COMPOSITION_FAILS_DESC =
-            "When true, If the payload fails to validate against composed schemas (allOf/anyOf/oneOf/not) and a discriminator is present, " +
-            "then ignore the compostion validation errors and attempt to use the discriminator to validate the payload. " +
-            "Note: setting this to true makes the generated client not comply with json schema because it ignores compotion validation errors . " +
-            "Please consider making your schemas more restrictive rather than setting this to true. You can do that by: " +
+            "When true, If the payload fails to validate against composed schemas (allOf/anyOf/oneOf/not) and a " +
+            "discriminator is present, then ignore the compostion validation errors and attempt to use the " +
+            "discriminator to validate the payload. " +
+            "Note: setting this to true makes the generated client not comply with json schema because it ignores " +
+            "composition validation errors. Please consider making your schemas more restrictive rather than " +
+            "setting this to true. You can do that by: " +
             "- defining the propertyName as an enum with only one value in the schemas that are in your discriminator map" +
             "- setting additionalProperties: false in your schemas";