chore: GitHub Actions workflow to generate new client library

.github/workflows/generate_new_client.yaml

@@ -0,0 +1,147 @@
+name: Generate new GAPIC client library
+on:
+  workflow_dispatch:
+      # some inputs are ommited due to limit of 10 input arguments
+      inputs:
+        api_shortname:
+          required: true
+          type: string
+          description: "`api_shortname`: Name for the new directory name and (default) artifact name"
+        name_pretty:
+          required: true
+          type: string
+          description: "`name_pretty`: The human-friendly name that appears in README.md"
+        proto_path:
+          required: true
+          type: string
+          description: |
+            `proto_path`: Path to proto file from the root of the googleapis repository to the
+            directory that contains the proto files (without the version).
+            For example, to generate the library for 'google/maps/routing/v2',
+            then you specify this value as 'google/maps/routing'
+        product_docs:
+          required: true
+          type: string
+          description: "`product_docs`: Documentation URL that appears in README.md"
+        rest_docs:
+          required: false
+          type: string
+          description: |
+            `rest_docs`: If it exists, link to the REST Documentation for a service
+        rpc_docs:
+          required: false
+          type: string
+          description: |
+            `rpc_docs`: If it exists, link to the RPC Documentation for a service
+        api_description:
+          required: true
+          description: "`api_description`: Description that appears in README.md"
+        transport:
+          required: false
+          type: choice
+          default: grpc
+          options:
+            - grpc
+            - http
+            - both
+          description: "`transport`: A label that appears in repo-metadata.json"
+        destination_name:
+          required: false
+          type: string
+          description: |
+            `destination_name`: The directory name of the new library. By default it's
+            java-<api_shortname>
+        distribution_name:
+          required: false
+          type: string
+          description: |
+            `distribution_name`: Maven coordinates of the generated library. By default it's
+            com.google.cloud:google-cloud-<api_shortname>
+jobs:
+  generate:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.9'
+          cache: 'pip' # caching pip dependencies
+      - name: Get current week within the year
+        id: date
+        run: echo "::set-output name=week_of_year::$(date +'%W' --utc)"
+      - name: Install new-client.py dependencies
+        run: pip install --require-hashes -r generation/new_client/requirements.txt
+      - name: Generate
+        id: generation
+        run: |
+          set -x
+          arguments="--api_shortname=\"${API_SHORTNAME}\" \
+          --proto-path=\"${PROTO_PATH}\" \
+          --name-pretty=\"${NAME_PRETTY}\" \
+          --product-docs=\"${PRODUCT_DOCS}\" \
+          --api-description=\"${API_DESCRIPTION}\""
+
+          # helper function that appends a python argument only if specified in the GH action inputs
+          append_argument() {
+            py_arg=$1
+            # env vars look exactly like new-client arguments but uppercase + underscores
+            env_name=$(echo "${py_arg}" | sed 's/-/_/g' | sed -e 's/\([a-z]\)/\U\1/g')
+            if [[ -n "${!env_name}" ]]; then
+              # $(echo) is redundant but it works around a syntax highlighting problem in vim
+              arguments=$(echo "${arguments} --${py_arg}=\"${!env_name}\"")
+            fi
+          }
+
+          declare -a optional_args=('transport' 'destination-name' 'distribution-name' 'group-id' 'rest-docs' 'rpc-docs')
+
+          for python_argument in "${optional_args[@]}"; do
+            append_argument "${python_argument}"
+          done
+          echo "::set-output name=new_library_args::${arguments}"
+          echo "${arguments} --googleapis-gen-url=\"${GOOGLEAPIS_GEN_URL}\"" | xargs python generation/new_client/new-client.py generate
+        env:
+          GOOGLEAPIS_GEN_URL: https://yoshi-approver:${{ secrets.YOSHI_CODE_BOT_TOKEN }}@github.com/googleapis/googleapis-gen.git
+          API_SHORTNAME: ${{ github.event.inputs.api_shortname }}
+          NAME_PRETTY: ${{ github.event.inputs.name_pretty }}
+          PROTO_PATH: ${{ github.event.inputs.proto_path }}
+          PRODUCT_DOCS: ${{ github.event.inputs.product_docs }}
+          REST_DOCS: ${{ github.event.inputs.rest_docs }}
+          RPC_DOCS: ${{ github.event.inputs.rpc_docs }}
+          API_DESCRIPTION: ${{ github.event.inputs.api_description }}
+          TRANSPORT: ${{ github.event.inputs.transport }}
+          DESTINATION_NAME: ${{ github.event.inputs.destination_name }}
+          DISTRIBUTION_NAME: ${{ github.event.inputs.distribution_name }}
+      - name: Push to branch and create PR
+        run: |
+          set -x
+          [ -z "`git config user.email`" ] && git config --global user.email "${USERNAME:-script}@google.com"
+          [ -z "`git config user.name`" ] && git config --global user.name "${USERNAME:-script}"
+
+          # create and push to branch in origin
+          # random_id allows multiple runs of this workflow
+          random_id=$(tr -dc A-Za-z0-9 </dev/urandom | head -c 5; echo)
+          branch_name="new-library/${{ github.event.inputs.api_shortname }}-${random_id}"
+          git checkout -b "${branch_name}"
+          git add --all
+          git commit -m "feat: [${API_SHORTNAME}] new module for ${API_SHORTNAME}
+
+
+          Generated with https://github.com/googleapis/google-cloud-java/actions/workflows/generate_new_client.yaml
+
+          Command used:
+
+          \`\`\`
+          python generation/new_client/new-client.py generate ${GENERATION_ARGUMENTS}
+          \`\`\`"
+          git remote add monorepo https://${{ github.actor }}:${{ github.token }}@github.com/${{ github.repository }}.git
+          git fetch -q --unshallow monorepo
+          git push -f monorepo "${branch_name}"
+
+          # create PR
+          gh pr create --fill --head "${branch_name}"
+        env:
+          USERNAME: ${{ github.actor }}
+          API_SHORTNAME: ${{ github.event.inputs.api_shortname }}
+          GENERATION_ARGUMENTS: ${{ steps.generation.outputs.new_library_args }}
+          GH_TOKEN: ${{ secrets.YOSHI_CODE_BOT_TOKEN }}
+

.github/workflows/verify-client-generation.yaml

@@ -38,7 +38,7 @@ jobs:
         with:
           path: ~/.m2/repository
           key: ${{ runner.os }}-maven-unified-${{ steps.date.outputs.week_of_year }}
-      - name: Install dependencies
+      - name: Install new-client.py dependencies
         run: pip install --require-hashes -r generation/new_client/requirements.txt
       - name: Remove Client
         run: |