chore: migrate to microgenerator (#380)

* chore: Remove spurious build warnings by deleting--include_source_info from .bazelrc

Committer: @miraleung
PiperOrigin-RevId: 344134135

Source-Author: Google APIs <[email protected]>
Source-Date: Tue Nov 24 14:38:21 2020 -0800
Source-Repo: googleapis/googleapis
Source-Sha: b11a87f3b54be3a5e42c15020ee1e0781f86da90
Source-Link: googleapis/googleapis@b11a87f

* chore: Undo removal of --include_source_info from .bazelrc

Committer: @miraleung
PiperOrigin-RevId: 345067549

Source-Author: Google APIs <[email protected]>
Source-Date: Tue Dec 1 11:49:14 2020 -0800
Source-Repo: googleapis/googleapis
Source-Sha: 8cfc6c874574b649b4524a4ef6a0651533325a84
Source-Link: googleapis/googleapis@8cfc6c8

* chore: migrate speech to the Java microgenerator

Committer: @miraleung
PiperOrigin-RevId: 345300630

Source-Author: Google APIs <[email protected]>
Source-Date: Wed Dec 2 13:28:53 2020 -0800
Source-Repo: googleapis/googleapis
Source-Sha: 948b4798f4f3957acaea5cbb5134a8a3a3d057e9
Source-Link: googleapis/googleapis@948b479

* chore: update gapic-generator-java to 0.0.9

Committer: @miraleung
PiperOrigin-RevId: 346372957

Source-Author: Google APIs <[email protected]>
Source-Date: Tue Dec 8 11:37:30 2020 -0800
Source-Repo: googleapis/googleapis
Source-Sha: 857f70daef9f4c38f042fb3dfb7b8423ae18fd19
Source-Link: googleapis/googleapis@857f70d

* chore: update gapic-generator-java to 0.0.11

Committer: @miraleung
PiperOrigin-RevId: 347036369

Source-Author: Google APIs <[email protected]>
Source-Date: Fri Dec 11 11:13:47 2020 -0800
Source-Repo: googleapis/googleapis
Source-Sha: 6d65640b1fcbdf26ea76cb720de0ac138cae9bed
Source-Link: googleapis/googleapis@6d65640

* chore: smoke test is no longer generated so skip synth replacements

Co-authored-by: Jeff Ching <[email protected]>

Author: yoshi-automation

google-cloud-speech/src/main/java/com/google/cloud/speech/v1/SpeechClient.java

@@ -5,14 +5,15 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ *      https://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+
 package com.google.cloud.speech.v1;
 
 import com.google.api.core.ApiFunction;
@@ -33,7 +34,7 @@
 import java.util.List;
 import javax.annotation.Generated;
 
-// AUTO-GENERATED DOCUMENTATION AND CLASS
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
 /**
  * Settings class to configure an instance of {@link SpeechClient}.
  *
@@ -50,23 +51,23 @@
  *
  * <p>For example, to set the total timeout of recognize to 30 seconds:
  *
- * <pre>
- * <code>
- * SpeechSettings.Builder speechSettingsBuilder =
- *     SpeechSettings.newBuilder();
+ * <pre>{@code
+ * SpeechSettings.Builder speechSettingsBuilder = SpeechSettings.newBuilder();
  * speechSettingsBuilder
  *     .recognizeSettings()
  *     .setRetrySettings(
- *         speechSettingsBuilder.recognizeSettings().getRetrySettings().toBuilder()
+ *         speechSettingsBuilder
+ *             .recognizeSettings()
+ *             .getRetrySettings()
+ *             .toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
  * SpeechSettings speechSettings = speechSettingsBuilder.build();
- * </code>
- * </pre>
+ * }</pre>
  */
-@Generated("by gapic-generator")
-@BetaApi
+@Generated("by gapic-generator-java")
 public class SpeechSettings extends ClientSettings<SpeechSettings> {
+
   /** Returns the object with the settings used for calls to recognize. */
   public UnaryCallSettings<RecognizeRequest, RecognizeResponse> recognizeSettings() {
     return ((SpeechStubSettings) getStubSettings()).recognizeSettings();
@@ -78,8 +79,6 @@ public UnaryCallSettings<LongRunningRecognizeRequest, Operation> longRunningReco
   }
 
   /** Returns the object with the settings used for calls to longRunningRecognize. */
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   public OperationCallSettings<
           LongRunningRecognizeRequest, LongRunningRecognizeResponse, LongRunningRecognizeMetadata>
       longRunningRecognizeOperationSettings() {
@@ -151,18 +150,15 @@ protected SpeechSettings(Builder settingsBuilder) throws IOException {
 
   /** Builder for SpeechSettings. */
   public static class Builder extends ClientSettings.Builder<SpeechSettings, Builder> {
+
     protected Builder() throws IOException {
-      this((ClientContext) null);
+      this(((ClientContext) null));
     }
 
     protected Builder(ClientContext clientContext) {
       super(SpeechStubSettings.newBuilder(clientContext));
     }
 
-    private static Builder createDefault() {
-      return new Builder(SpeechStubSettings.newBuilder());
-    }
-
     protected Builder(SpeechSettings settings) {
       super(settings.getStubSettings().toBuilder());
     }
@@ -171,11 +167,15 @@ protected Builder(SpeechStubSettings.Builder stubSettings) {
       super(stubSettings);
     }
 
+    private static Builder createDefault() {
+      return new Builder(SpeechStubSettings.newBuilder());
+    }
+
     public SpeechStubSettings.Builder getStubSettingsBuilder() {
       return ((SpeechStubSettings.Builder) getStubSettings());
     }
 
-    // NEXT_MAJOR_VER: remove 'throws Exception'
+    // NEXT_MAJOR_VER: remove 'throws Exception'.
     /**
      * Applies the given settings updater function to all of the unary API methods in this service.
      *
@@ -200,8 +200,6 @@ public UnaryCallSettings.Builder<RecognizeRequest, RecognizeResponse> recognizeS
     }
 
     /** Returns the builder for the settings used for calls to longRunningRecognize. */
-    @BetaApi(
-        "The surface for long-running operations is not stable yet and may change in the future.")
     public OperationCallSettings.Builder<
             LongRunningRecognizeRequest, LongRunningRecognizeResponse, LongRunningRecognizeMetadata>
         longRunningRecognizeOperationSettings() {

google-cloud-speech/src/main/java/com/google/cloud/speech/v1/SpeechSettings.java

@@ -5,7 +5,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ *      https://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -15,37 +15,15 @@
  */
 
 /**
- * A client to Cloud Speech-to-Text API.
+ * The interfaces provided are listed below, along with usage samples.
  *
- * <p>The interfaces provided are listed below, along with usage samples.
- *
- * <p>============ SpeechClient ============
+ * <p>======================= SpeechClient =======================
  *
  * <p>Service Description: Service that implements Google Cloud Speech API.
  *
  * <p>Sample for SpeechClient:
- *
- * <pre>
- * <code>
- * try (SpeechClient speechClient = SpeechClient.create()) {
- *   RecognitionConfig.AudioEncoding encoding = RecognitionConfig.AudioEncoding.FLAC;
- *   int sampleRateHertz = 44100;
- *   String languageCode = "en-US";
- *   RecognitionConfig config = RecognitionConfig.newBuilder()
- *     .setEncoding(encoding)
- *     .setSampleRateHertz(sampleRateHertz)
- *     .setLanguageCode(languageCode)
- *     .build();
- *   String uri = "gs://bucket_name/file_name.flac";
- *   RecognitionAudio audio = RecognitionAudio.newBuilder()
- *     .setUri(uri)
- *     .build();
- *   RecognizeResponse response = speechClient.recognize(config, audio);
- * }
- * </code>
- * </pre>
  */
-@Generated("by gapic-generator")
+@Generated("by gapic-generator-java")
 package com.google.cloud.speech.v1;
 
 import javax.annotation.Generated;

google-cloud-speech/src/main/java/com/google/cloud/speech/v1/package-info.java

@@ -5,17 +5,17 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ *      https://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+
 package com.google.cloud.speech.v1.stub;
 
-import com.google.api.core.BetaApi;
 import com.google.api.gax.grpc.GrpcCallSettings;
 import com.google.api.gax.grpc.GrpcCallableFactory;
 import com.google.api.gax.grpc.GrpcStubCallableFactory;
@@ -31,18 +31,19 @@
 import com.google.api.gax.rpc.StreamingCallSettings;
 import com.google.api.gax.rpc.UnaryCallSettings;
 import com.google.api.gax.rpc.UnaryCallable;
+import com.google.longrunning.Operation;
 import com.google.longrunning.stub.OperationsStub;
 import javax.annotation.Generated;
 
-// AUTO-GENERATED DOCUMENTATION AND CLASS
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
 /**
- * gRPC callable factory implementation for Cloud Speech-to-Text API.
+ * gRPC callable factory implementation for the Speech service API.
  *
  * <p>This class is for advanced usage.
  */
 @Generated("by gapic-generator")
-@BetaApi("The surface for use by generated code is not stable yet and may change in the future.")
 public class GrpcSpeechCallableFactory implements GrpcStubCallableFactory {
+
   @Override
   public <RequestT, ResponseT> UnaryCallable<RequestT, ResponseT> createUnaryCallable(
       GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
@@ -55,61 +56,58 @@ public <RequestT, ResponseT> UnaryCallable<RequestT, ResponseT> createUnaryCalla
   public <RequestT, ResponseT, PagedListResponseT>
       UnaryCallable<RequestT, PagedListResponseT> createPagedCallable(
           GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
-          PagedCallSettings<RequestT, ResponseT, PagedListResponseT> pagedCallSettings,
+          PagedCallSettings<RequestT, ResponseT, PagedListResponseT> callSettings,
           ClientContext clientContext) {
-    return GrpcCallableFactory.createPagedCallable(
-        grpcCallSettings, pagedCallSettings, clientContext);
+    return GrpcCallableFactory.createPagedCallable(grpcCallSettings, callSettings, clientContext);
   }
 
   @Override
   public <RequestT, ResponseT> UnaryCallable<RequestT, ResponseT> createBatchingCallable(
       GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
-      BatchingCallSettings<RequestT, ResponseT> batchingCallSettings,
+      BatchingCallSettings<RequestT, ResponseT> callSettings,
       ClientContext clientContext) {
     return GrpcCallableFactory.createBatchingCallable(
-        grpcCallSettings, batchingCallSettings, clientContext);
+        grpcCallSettings, callSettings, clientContext);
   }
 
-  @BetaApi(
-      "The surface for long-running operations is not stable yet and may change in the future.")
   @Override
   public <RequestT, ResponseT, MetadataT>
       OperationCallable<RequestT, ResponseT, MetadataT> createOperationCallable(
-          GrpcCallSettings<RequestT, com.google.longrunning.Operation> grpcCallSettings,
-          OperationCallSettings<RequestT, ResponseT, MetadataT> operationCallSettings,
+          GrpcCallSettings<RequestT, Operation> grpcCallSettings,
+          OperationCallSettings<RequestT, ResponseT, MetadataT> callSettings,
           ClientContext clientContext,
           OperationsStub operationsStub) {
     return GrpcCallableFactory.createOperationCallable(
-        grpcCallSettings, operationCallSettings, clientContext, operationsStub);
+        grpcCallSettings, callSettings, clientContext, operationsStub);
   }
 
   @Override
   public <RequestT, ResponseT>
       BidiStreamingCallable<RequestT, ResponseT> createBidiStreamingCallable(
           GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
-          StreamingCallSettings<RequestT, ResponseT> streamingCallSettings,
+          StreamingCallSettings<RequestT, ResponseT> callSettings,
           ClientContext clientContext) {
     return GrpcCallableFactory.createBidiStreamingCallable(
-        grpcCallSettings, streamingCallSettings, clientContext);
+        grpcCallSettings, callSettings, clientContext);
   }
 
   @Override
   public <RequestT, ResponseT>
       ServerStreamingCallable<RequestT, ResponseT> createServerStreamingCallable(
           GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
-          ServerStreamingCallSettings<RequestT, ResponseT> streamingCallSettings,
+          ServerStreamingCallSettings<RequestT, ResponseT> callSettings,
           ClientContext clientContext) {
     return GrpcCallableFactory.createServerStreamingCallable(
-        grpcCallSettings, streamingCallSettings, clientContext);
+        grpcCallSettings, callSettings, clientContext);
   }
 
   @Override
   public <RequestT, ResponseT>
       ClientStreamingCallable<RequestT, ResponseT> createClientStreamingCallable(
           GrpcCallSettings<RequestT, ResponseT> grpcCallSettings,
-          StreamingCallSettings<RequestT, ResponseT> streamingCallSettings,
+          StreamingCallSettings<RequestT, ResponseT> callSettings,
           ClientContext clientContext) {
     return GrpcCallableFactory.createClientStreamingCallable(
-        grpcCallSettings, streamingCallSettings, clientContext);
+        grpcCallSettings, callSettings, clientContext);
   }
 }