[PROPOSAL] Improved type hints using TypedDict, the datamodel-code-generator library, and the OpenAPI Spec

[burck1]

ref: #746

Changes

• Added a dev dependency on datamodel-code-generator
• Added a dependency on typing-extensions
• Added a poetry script to download the Management API's OpenAPI Spec to the repo
  • poetry run download-openapi
• Added a poetry script and [tool.datamodel-codegen] config to run the datamodel code generator
  • poetry run datamodel-codegen
• Downloaded the latest OpenAPI Spec and committed.
• Ran the code generator to create auth0/management/models.py and committed.
• As an example, updated auth0/management/clients.py to use the generated models.

References

• Proposal to used TypedDict to improve type hints #746
• https://auth0.com/docs/api/management/openapi.json
• https://typing.python.org/en/latest/spec/typeddict.html
• https://koxudaxi.github.io/datamodel-code-generator/

Testing

Run poetry run download-openapi and poetry run datamodel-codegen. Then run the unit tests.

• This change adds unit test coverage
• This change adds integration test coverage
• This change has been tested on the latest version of the platform/language or why not

Checklist

• I have read the Auth0 general contribution guidelines
• I have read the Auth0 Code of Conduct
• All existing and new tests complete without errors