v3 uses generics in schemas so IDEs can see instance and property base types

modules/openapi-json-schema-generator/src/main/java/org/openapijsonschematools/codegen/languages/PythonClientCodegen.java

@@ -704,6 +704,15 @@ public void processOpts() {
 
         supportingFiles.add(new SupportingFile("exceptions.hbs", packagePath(), "exceptions.py"));
 
+        // shared_imports
+        supportingFiles.add(new SupportingFile("__init__.hbs", packagePath() + File.separator + "shared_imports", "__init__.py"));
+        supportingFiles.add(new SupportingFile("shared_imports/header_imports.hbs", packagePath() + File.separator + "shared_imports", "header_imports.py"));
+        supportingFiles.add(new SupportingFile("shared_imports/response_imports.hbs", packagePath() + File.separator + "shared_imports", "response_imports.py"));
+        supportingFiles.add(new SupportingFile("shared_imports/schema_imports.hbs", packagePath() + File.separator + "shared_imports", "schema_imports.py"));
+        supportingFiles.add(new SupportingFile("shared_imports/security_scheme_imports.hbs", packagePath() + File.separator + "shared_imports", "security_scheme_imports.py"));
+        supportingFiles.add(new SupportingFile("shared_imports/server_imports.hbs", packagePath() + File.separator + "shared_imports", "server_imports.py"));
+        supportingFiles.add(new SupportingFile("shared_imports/operation_imports.hbs", packagePath() + File.separator + "shared_imports", "operation_imports.py"));
+
         if (Boolean.FALSE.equals(excludeTests)) {
             supportingFiles.add(new SupportingFile("__init__.hbs", testFolder, "__init__.py"));
             supportingFiles.add(new SupportingFile("__init__.hbs", testFolder + File.separator + modelPackage.replace('.', File.separatorChar), "__init__.py"));

modules/openapi-json-schema-generator/src/main/resources/python/README.hbs

@@ -141,7 +141,6 @@ This means that one can use normal dict methods on instances of these classes.
 - optional properties which were not set will not exist in the instance
 - None is only allowed in as a value if type: "null" was included or nullable: true was set
 - type hints are written for accessing values by key literals like instance["hi-there"]
-- and there is a method instance.get_item_["hi-there"] which returns an schemas.Unset value if the key was not set
 - required properties with valid python names are accessible with instance.SomeRequiredProp
   which uses the exact key from the openapi document
   - preserving the original key names is required to properly validate a payload to multiple json schemas

modules/openapi-json-schema-generator/src/main/resources/python/_helper_header.hbs

@@ -2,11 +2,9 @@
 {{#if appName}}
     {{{appName}}}
 {{/if}}
-
 {{#if appDescription}}
     {{{appDescription}}}  # noqa: E501
 {{/if}}
-
 {{#if version}}
     The version of the OpenAPI document: {{{version}}}
 {{/if}}