feat!: regenerate with microgenerator #30
Conversation
busunkim96
added
the
do not merge
googlebot
added
the
cla: yes
| @@ -0,0 +1,134 @@ | |||
| # 2.0.0 Migration Guide | |||
There was a problem hiding this comment.
@software-dov @telpirion Please review
UPGRADING.md
Outdated
| In the 2.0.0 release, all methods have a single positional argument `request`. Method docstrings indicate whether an argument is | ||
| required or optional. | ||
|
|
||
| Some methods have additional keyword only arguments. The available parameters depend on the [`google.api.method_signature` annotation](https://github.com/googleapis/googleapis/blob/master/google/cloud/texttospeech/v1/cloud_tts.proto#L53) specified by the API producer. |
There was a problem hiding this comment.
I think it would be good to emphasize that the request param and any kword only flattenings are mutually exclusive.
| ["google/cloud/**/client.py", "google/cloud/**/cloud_tts.py"], | ||
| "((en)|(no)|(nb)(cmn)|(yue))-\*", | ||
| "\g<1>-\*", |
There was a problem hiding this comment.
I'm not sure I understand this part. Is this indicative of an error in the template, bad escaping on the part of the generator, or just garbage input and garbage sphinx?
There was a problem hiding this comment.
Sphinx/RST interprets the * as emphasis. I'd expect the generator to escape it? The proto comments look valid to me
|
|
||
| > **WARNING**: Breaking change | ||
|
|
||
| Methods expect request objects. We provide a script that will convert most common use cases. |
There was a problem hiding this comment.
Yes: scripts/fixup_keywords.py is published with the library.
If you install the library it will be available on the command line. https://python-packaging.readthedocs.io/en/latest/command-line-scripts.html#the-scripts-keyword-argument
|
|
||
| client = texttospeech.TextToSpeechClient() | ||
|
|
||
| voices = client.list_voices(request={"language_code": "no"}) |
There was a problem hiding this comment.
This is a significant change in behavior. You might want to updated the docs too, at least a release note.
There was a problem hiding this comment.
👍 Will follow up with the TW.
| ## Enums and Types | ||
|
|
||
|
|
||
| > **WARNING**: Breaking change |
There was a problem hiding this comment.
Same as above: consider updating the documentation on cloud.google.com for all breaking changes.
|
|
||
| > **WARNING**: Breaking change | ||
|
|
||
| Methods expect request objects. We provide a script that will convert most common use cases. |
There was a problem hiding this comment.
Yes: scripts/fixup_keywords.py is published with the library.
If you install the library it will be available on the command line. https://python-packaging.readthedocs.io/en/latest/command-line-scripts.html#the-scripts-keyword-argument
|
|
||
| client = texttospeech.TextToSpeechClient() | ||
|
|
||
| voices = client.list_voices(request={"language_code": "no"}) |
There was a problem hiding this comment.
👍 Will follow up with the TW.
TODO: