Conversation
iscai-msft
requested review from
annatisch,
johanste,
lmazuel,
mikekistler and
msyyc
docs/customizations.md
Outdated
| ``` | ||
|
|
||
| ```python | ||
| from ._models import FooGenerated |
There was a problem hiding this comment.
One thing writing this doc made me realize: we're really solidifying the file names of the generated code. I think it would be great (for version tolerant at least) to have the following names
_models.pyfor models (we won't really need 2.7 models any more)_operations.pyfor operations (we already do this by default for version tolerant)_client.pyfor client (currently it's the name of the service client)
| ) | ||
|
|
||
| __all__ = ["ServiceClient"] | ||
| ``` |
There was a problem hiding this comment.
We could add more doc reference at the end of doc for users ^^: https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/customize_code/how-to-patch-sdk-code.md
There was a problem hiding this comment.
EDIT: decided to not include in this doc, at least for now. The how-to-patch-sdk-code.md doc was really good when we didn't have our customizations design, but now patch_sdk is something that we really want users to treat as "everything else has failed, so let me last ditch use patch_sdk. I've included some comment about patch_sdk in the generated code, so I think it's best to leave the customizations doc with just common customization use cases for now
…into raise_version_tolerant_multiapi * 'autorestv3' of https://github.com/Azure/autorest.python: add customizations doc (#1123)
…into storage_to_main * 'autorestv3' of https://github.com/Azure/autorest.python: raise error if multiapi and version tolerant (#1190) add 3.6 check and remove 3.6 incompatible future annotations import (#1188) add customizations doc (#1123)
4 participants
fixes #1141