vchudnov-g

🦑 G.A.P.I.C 🖥 codelab 🎓

.
├── artman_dogs.yaml
├── dogs.proto
├── dogs_gapic.yaml
├── dogs_server.js
├── dogs_service.yaml
└── generate-and-run.sh

vchudnov-g

🖋 GAPIC :: Library Partials

So you want to write a partial helper, eh?

Hand-written code adds all kinds of functionality on top of generated GAPIC client libraries!

Let's look at the most common type of hand-written extension:

>> Helper Methods added to service object which wraps call to 1 rpc method <<

vchudnov-g

# -*- coding: utf-8 -*-
#
# Copyright 2018 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# 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
#

vchudnov-g

# -*- coding: utf-8 -*-
#
# Copyright 2018 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# 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
#

vchudnov-g

type: manifest/samples
schema_version: 3
base: &common
  env: 'java'
  bin: 'echo mvn exec:java -q -D{sample} -Dexec.args=@args'
  chdir: '{@manifest_dir}/../..'
  basepath: '.'
samples:
- <<: *common
  path: '{basepath}/src/main/java/com/google/cloud/examples/speech/v1/SpeechTranscribeAsyncWordTimeOffsetsGcs.java'

vchudnov-g

type: manifest/samples
schema_version: 3
base: &common
  env: 'java'
  chdir: '{@manifest_dir}/../..'
  basepath: '/tmp'
samples:
- <<: *common
  path: '{basepath}/echo-me'
  sample: 'first'