Closed
Description
When SDK writers alias model names to rename the generated code, i.e. from ._generated import AuthenticationTypeEnum as DatasourceAuthenticationType
, this breaks apiview, sphinx documentation, and does not show up well for end users
We should look through the __init__
files and raise an error if the aliased name is included in the __all__
(it's ok if internal models are aliased) and ensure there is no x as x
importing.
We want to see how many aliasing issues we are running into.
In terms of mitigation for aliasing cases (thanks @lmazuel ):
- If handwritten code: don't do it, you don't need it
- If rename generated: use directive
- Else: talk to Johan/Anna