Skip to content
This repository was archived by the owner on Sep 16, 2023. It is now read-only.

Commit 9d28dca

Browse files
authored
feat: promote to GA (#53)
Release-As: 1.0.0
1 parent 8b94456 commit 9d28dca

File tree

4 files changed

+117
-146
lines changed

4 files changed

+117
-146
lines changed

Diff for: .repo-metadata.json

+5-3
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
{
22
"name": "texttospeech",
3-
"name_pretty": "Google Cloud Text-to-Speech",
3+
"name_pretty": "Cloud Text-to-Speech",
44
"product_documentation": "https://cloud.google.com/text-to-speech",
5-
"client_documentation": "https://googleapis.dev/java/google-cloud-clients/latest/index.html?com/google/cloud/texttospeech/v1/package-summary.html",
5+
"client_documentation": "https://googleapis.dev/java/google-cloud-texttospeech/latest/index.html",
6+
"api_description": "enables easy integration of Google text recognition technologies into developer applications. Send text and receive synthesized audio output from the Cloud Text-to-Speech API service.",
67
"issue_tracker": "https://issuetracker.google.com/savedsearches/5235428",
7-
"release_level": "beta",
8+
"release_level": "ga",
89
"language": "java",
10+
"transport": "grpc",
911
"repo": "googleapis/java-texttospeech",
1012
"repo_short": "java-texttospeech",
1113
"distribution_name": "com.google.cloud:google-cloud-texttospeech",

Diff for: README.md

+105-68
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,49 @@
1-
Google Cloud Java Client for Cloud Text-to-Speech
2-
======================================
1+
# Google Cloud Text-to-Speech Client for Java
32

4-
Java idiomatic client for [Cloud Text-to-Speech][cloud-texttospeech].
3+
Java idiomatic client for [Cloud Text-to-Speech][product-docs].
54

6-
[![Kokoro CI](http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/master.svg)](http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/master.html)
7-
[![Maven](https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-texttospeech.svg)](https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-texttospeech.svg)
8-
[![Codacy Badge](https://api.codacy.com/project/badge/grade/9da006ad7c3a4fe1abd142e77c003917)](https://www.codacy.com/app/mziccard/google-cloud-java)
5+
[![Maven][maven-version-image]][maven-version-link]
6+
![Stability][stability-image]
97

10-
- [Product Documentation][texttospeech-product-docs]
11-
- [Client Library Documentation][texttospeech-client-lib-docs]
8+
- [Product Documentation][product-docs]
9+
- [Client Library Documentation][javadocs]
1210

13-
> Note: This client is a work-in-progress, and may occasionally
14-
> make backwards-incompatible changes.
11+
## Quickstart
1512

16-
Quickstart
17-
----------
18-
If you are using Maven with a BOM, add this to your pom.xml file.
13+
If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file
1914
```xml
2015
<dependencyManagement>
21-
<dependencies>
22-
<dependency>
23-
<groupId>com.google.cloud</groupId>
24-
<artifactId>libraries-bom</artifactId>
25-
<version>2.8.0</version>
26-
<type>pom</type>
27-
<scope>import</scope>
28-
</dependency>
29-
</dependencies>
16+
<dependencies>
17+
<dependency>
18+
<groupId>com.google.cloud</groupId>
19+
<artifactId>libraries-bom</artifactId>
20+
<version>3.4.0</version>
21+
<type>pom</type>
22+
<scope>import</scope>
23+
</dependency>
24+
</dependencies>
3025
</dependencyManagement>
3126

32-
<dependency>
33-
<groupId>com.google.cloud</groupId>
34-
<artifactId>google-cloud-texttospeech</artifactId>
35-
</dependency>
27+
<dependencies>
28+
<dependency>
29+
<groupId>com.google.cloud</groupId>
30+
<artifactId>google-cloud-texttospeech</artifactId>
31+
</dependency>
32+
</dependencies>
3633
```
34+
3735
[//]: # ({x-version-update-start:google-cloud-texttospeech:released})
38-
If you are using Maven without BOM, add this to your dependencies.
36+
37+
If you are using Maven without BOM, add this to your dependencies:
38+
3939
```xml
4040
<dependency>
4141
<groupId>com.google.cloud</groupId>
4242
<artifactId>google-cloud-texttospeech</artifactId>
4343
<version>0.117.2-beta</version>
4444
</dependency>
4545
```
46+
4647
If you are using Gradle, add this to your dependencies
4748
```Groovy
4849
compile 'com.google.cloud:google-cloud-texttospeech:0.117.2-beta'
@@ -53,66 +54,102 @@ libraryDependencies += "com.google.cloud" % "google-cloud-texttospeech" % "0.117
5354
```
5455
[//]: # ({x-version-update-end})
5556

56-
Authentication
57-
--------------
57+
## Authentication
5858

59-
See the [Authentication](https://github.com/googleapis/google-cloud-java#authentication) section in the base directory's README.
59+
See the [Authentication][authentication] section in the base directory's README.
6060

61-
About Cloud Text-to-Speech
62-
----------------------------
61+
## Getting Started
6362

64-
[Cloud Text-to-Speech API][cloud-texttospeech] enables easy integration of Google text recognition technologies into developer applications. Send text and receive synthesized audio output from the Cloud Text-to-Speech API service.
63+
### Prerequisites
6564

66-
See the [Cloud Text-to-Speech client library docs][texttospeech-client-lib-docs] to learn how to use this Cloud Text-to-Speech API Client Library.
65+
You will need a [Google Cloud Platform Console][developer-console] project with the Cloud Text-to-Speech [API enabled][enable-api].
6766

68-
Getting Started
69-
---------------
70-
#### Prerequisites
71-
You will need a [Google Developers Console](https://console.developers.google.com/) project with the Cloud Text-to-Speech API enabled. [Follow these instructions](https://cloud.google.com/resource-manager/docs/creating-managing-projects) to get your project set up. You will also need to set up the local development environment by [installing the Google Cloud SDK](https://cloud.google.com/sdk/) and running the following commands in command line: `gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
67+
[Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
68+
[installing the Google Cloud SDK][cloud-sdk] and running the following commands in command line:
69+
`gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
7270

73-
#### Installation and setup
74-
You'll need to obtain the `google-cloud-texttospeech` library. See the [Quickstart](#quickstart) section to add `google-cloud-texttospeech` as a dependency in your code.
71+
### Installation and setup
7572

76-
Troubleshooting
77-
---------------
73+
You'll need to obtain the `google-cloud-texttospeech` library. See the [Quickstart](#quickstart) section
74+
to add `google-cloud-texttospeech` as a dependency in your code.
7875

79-
To get help, follow the instructions in the [shared Troubleshooting document](https://github.com/googleapis/google-cloud-common/blob/master/troubleshooting/readme.md#troubleshooting).
76+
## About Cloud Text-to-Speech
8077

81-
Transport
82-
---------
83-
Cloud Text-to-Speech uses gRPC for the transport layer.
8478

85-
Java Versions
86-
-------------
79+
[Cloud Text-to-Speech][product-docs] enables easy integration of Google text recognition technologies into developer applications. Send text and receive synthesized audio output from the Cloud Text-to-Speech API service.
8780

88-
Java 7 or above is required for using this client.
81+
See the [Cloud Text-to-Speech client library docs][javadocs] to learn how to
82+
use this Cloud Text-to-Speech Client Library.
8983

90-
Versioning
91-
----------
9284

93-
This library follows [Semantic Versioning](http://semver.org/).
9485

95-
It is currently in major version zero (``0.y.z``), which means that anything may change at any time and the public API should not be considered stable.
9686

97-
Contributing
98-
------------
87+
## Troubleshooting
9988

100-
Contributions to this library are always welcome and highly encouraged.
89+
To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
10190

102-
See `google-cloud`'s [CONTRIBUTING] documentation and the [shared documentation](https://github.com/googleapis/google-cloud-common/blob/master/contributing/readme.md#how-to-contribute-to-gcloud) for more information on how to get started.
91+
## Transport
10392

104-
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information.
93+
Cloud Text-to-Speech uses gRPC for the transport layer.
10594

106-
License
107-
-------
95+
## Java Versions
10896

109-
Apache 2.0 - See [LICENSE] for more information.
97+
Java 7 or above is required for using this client.
98+
99+
## Versioning
110100

101+
This library follows [Semantic Versioning](http://semver.org/).
102+
103+
104+
105+
## Contributing
106+
107+
108+
Contributions to this library are always welcome and highly encouraged.
111109

112-
[CONTRIBUTING]:https://github.com/googleapis/google-cloud-java/blob/master/CONTRIBUTING.md
113-
[code-of-conduct]:https://github.com/googleapis/google-cloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
114-
[LICENSE]: https://github.com/googleapis/google-cloud-java/blob/master/LICENSE
115-
[cloud-platform]: https://cloud.google.com/
116-
[cloud-texttospeech]: https://cloud.google.com/text-to-speech
117-
[texttospeech-product-docs]: https://cloud.google.com/text-to-speech/docs
118-
[texttospeech-client-lib-docs]: https://googleapis.dev/java/google-cloud-clients/latest/index.html?com/google/cloud/texttospeech/v1/package-summary.html
110+
See [CONTRIBUTING][contributing] for more information how to get started.
111+
112+
Please note that this project is released with a Contributor Code of Conduct. By participating in
113+
this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
114+
information.
115+
116+
## License
117+
118+
Apache 2.0 - See [LICENSE][license] for more information.
119+
120+
## CI Status
121+
122+
Java Version | Status
123+
------------ | ------
124+
Java 7 | [![Kokoro CI][kokoro-badge-image-1]][kokoro-badge-link-1]
125+
Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2]
126+
Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3]
127+
Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4]
128+
Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
129+
130+
[product-docs]: https://cloud.google.com/text-to-speech
131+
[javadocs]: https://googleapis.dev/java/google-cloud-texttospeech/latest/index.html
132+
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java7.svg
133+
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java7.html
134+
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java8.svg
135+
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java8.html
136+
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java8-osx.svg
137+
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java8-osx.html
138+
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java8-win.svg
139+
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java8-win.html
140+
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java11.svg
141+
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-texttospeech/java11.html
142+
[stability-image]: https://img.shields.io/badge/stability-ga-green
143+
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-texttospeech.svg
144+
[maven-version-link]: https://search.maven.org/search?q=g:com.google.cloud%20AND%20a:google-cloud-texttospeech&core=gav
145+
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
146+
[developer-console]: https://console.developers.google.com/
147+
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
148+
[cloud-sdk]: https://cloud.google.com/sdk/
149+
[troubleshooting]: https://github.com/googleapis/google-cloud-common/blob/master/troubleshooting/readme.md#troubleshooting
150+
[contributing]: https://github.com/googleapis/java-texttospeech/blob/master/CONTRIBUTING.md
151+
[code-of-conduct]: https://github.com/googleapis/java-texttospeech/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
152+
[license]: https://github.com/googleapis/java-texttospeech/blob/master/LICENSE
153+
154+
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=texttospeech.googleapis.com
155+
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM

Diff for: synth.metadata

+2-58
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"updateTime": "2020-01-23T09:04:50.584865Z",
2+
"updateTime": "2020-01-23T21:27:12.281801Z",
33
"sources": [
44
{
55
"generator": {
@@ -12,9 +12,7 @@
1212
"git": {
1313
"name": "googleapis",
1414
"remote": "https://github.com/googleapis/googleapis.git",
15-
"sha": "8d16f76de065f530d395a4c7eabbf766d6a120fd",
16-
"internalRef": "291008516",
17-
"log": "8d16f76de065f530d395a4c7eabbf766d6a120fd\nGenerate Memcache v1beta2 API protos and gRPC ServiceConfig files\n\nPiperOrigin-RevId: 291008516\n\n3af1dabd93df9a9f17bf3624d3b875c11235360b\ngrafeas: Add containeranalysis default_host to Grafeas service\n\nPiperOrigin-RevId: 290965849\n\nbe2663fa95e31cba67d0cd62611a6674db9f74b7\nfix(google/maps/roads): add missing opening bracket\n\nPiperOrigin-RevId: 290964086\n\nfacc26550a0af0696e0534bc9cae9df14275aa7c\nUpdating v2 protos with the latest inline documentation (in comments) and adding a per-service .yaml file.\n\nPiperOrigin-RevId: 290952261\n\ncda99c1f7dc5e4ca9b1caeae1dc330838cbc1461\nChange api_name to 'asset' for v1p1beta1\n\nPiperOrigin-RevId: 290800639\n\n94e9e90c303a820ce40643d9129e7f0d2054e8a1\nAdds Google Maps Road service\n\nPiperOrigin-RevId: 290795667\n\na3b23dcb2eaecce98c600c7d009451bdec52dbda\nrpc: new message ErrorInfo, other comment updates\n\nPiperOrigin-RevId: 290781668\n\n26420ef4e46c37f193c0fbe53d6ebac481de460e\nAdd proto definition for Org Policy v1.\n\nPiperOrigin-RevId: 290771923\n\n7f0dab8177cf371ae019a082e2512de7ac102888\nPublish Routes Preferred API v1 service definitions.\n\nPiperOrigin-RevId: 290326986\n\nad6e508d0728e1d1bca6e3f328cd562718cb772d\nFix: Qualify resource type references with \"jobs.googleapis.com/\"\n\nPiperOrigin-RevId: 290285762\n\n58e770d568a2b78168ddc19a874178fee8265a9d\ncts client library\n\nPiperOrigin-RevId: 290146169\n\naf9daa4c3b4c4a8b7133b81588dd9ffd37270af2\nAdd more programming language options to public proto\n\nPiperOrigin-RevId: 290144091\n\nd9f2bbf2df301ef84641d4cec7c828736a0bd907\ntalent: add missing resource.proto dep to Bazel build target\n\nPiperOrigin-RevId: 290143164\n\n3b3968237451d027b42471cd28884a5a1faed6c7\nAnnotate Talent API.\nAdd gRPC service config for retry.\nUpdate bazel file with google.api.resource dependency.\n\nPiperOrigin-RevId: 290125172\n\n"
15+
"sha": "c2cdcd2b08ca35c5054268f6277ea04713c88e39"
1816
}
1917
},
2018
{
@@ -63,9 +61,6 @@
6361
{
6462
"path": ".github/release-please.yml"
6563
},
66-
{
67-
"path": ".gitignore"
68-
},
6964
{
7065
"path": ".kokoro/build.bat"
7166
},
@@ -231,12 +226,6 @@
231226
{
232227
"path": ".kokoro/trampoline.sh"
233228
},
234-
{
235-
"path": ".repo-metadata.json"
236-
},
237-
{
238-
"path": "CHANGELOG.md"
239-
},
240229
{
241230
"path": "CODE_OF_CONDUCT.md"
242231
},
@@ -246,18 +235,9 @@
246235
{
247236
"path": "LICENSE"
248237
},
249-
{
250-
"path": "README.md"
251-
},
252238
{
253239
"path": "codecov.yaml"
254240
},
255-
{
256-
"path": "google-cloud-texttospeech-bom/pom.xml"
257-
},
258-
{
259-
"path": "google-cloud-texttospeech/pom.xml"
260-
},
261241
{
262242
"path": "google-cloud-texttospeech/src/main/java/com/google/cloud/texttospeech/v1/TextToSpeechClient.java"
263243
},
@@ -309,12 +289,6 @@
309289
{
310290
"path": "google-cloud-texttospeech/src/test/java/com/google/cloud/texttospeech/v1/TextToSpeechClientTest.java"
311291
},
312-
{
313-
"path": "google-cloud-texttospeech/src/test/java/com/google/cloud/texttospeech/v1/TextToSpeechSmokeTest.java"
314-
},
315-
{
316-
"path": "google-cloud-texttospeech/src/test/java/com/google/cloud/texttospeech/v1/it/ITSystemTest.java"
317-
},
318292
{
319293
"path": "google-cloud-texttospeech/src/test/java/com/google/cloud/texttospeech/v1beta1/MockTextToSpeech.java"
320294
},
@@ -324,21 +298,9 @@
324298
{
325299
"path": "google-cloud-texttospeech/src/test/java/com/google/cloud/texttospeech/v1beta1/TextToSpeechClientTest.java"
326300
},
327-
{
328-
"path": "google-cloud-texttospeech/src/test/java/com/google/cloud/texttospeech/v1beta1/TextToSpeechSmokeTest.java"
329-
},
330-
{
331-
"path": "google-cloud-texttospeech/src/test/java/com/google/cloud/texttospeech/v1beta1/it/ITSystemTest.java"
332-
},
333-
{
334-
"path": "grpc-google-cloud-texttospeech-v1/pom.xml"
335-
},
336301
{
337302
"path": "grpc-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/TextToSpeechGrpc.java"
338303
},
339-
{
340-
"path": "grpc-google-cloud-texttospeech-v1beta1/pom.xml"
341-
},
342304
{
343305
"path": "grpc-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/TextToSpeechGrpc.java"
344306
},
@@ -348,12 +310,6 @@
348310
{
349311
"path": "license-checks.xml"
350312
},
351-
{
352-
"path": "pom.xml"
353-
},
354-
{
355-
"path": "proto-google-cloud-texttospeech-v1/pom.xml"
356-
},
357313
{
358314
"path": "proto-google-cloud-texttospeech-v1/src/main/java/com/google/cloud/texttospeech/v1/AudioConfig.java"
359315
},
@@ -414,9 +370,6 @@
414370
{
415371
"path": "proto-google-cloud-texttospeech-v1/src/main/proto/google/cloud/texttospeech/v1/cloud_tts.proto"
416372
},
417-
{
418-
"path": "proto-google-cloud-texttospeech-v1beta1/pom.xml"
419-
},
420373
{
421374
"path": "proto-google-cloud-texttospeech-v1beta1/src/main/java/com/google/cloud/texttospeech/v1beta1/AudioConfig.java"
422375
},
@@ -479,15 +432,6 @@
479432
},
480433
{
481434
"path": "renovate.json"
482-
},
483-
{
484-
"path": "synth.metadata"
485-
},
486-
{
487-
"path": "synth.py"
488-
},
489-
{
490-
"path": "versions.txt"
491435
}
492436
]
493437
}

0 commit comments

Comments
 (0)