ci: use python 3.8 in docs build (#1302)

* ci: use python 3.8 in docs build

* add files required for docs build

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* update docs link

* remove docfx session from publish-docs.sh

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: parthea

packages/gapic-generator/.github/workflows/tests.yaml

@@ -22,7 +22,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v3
         with:
-          python-version: "3.9"
+          python-version: "3.8"
           cache: 'pip'
       - name: Install nox.
         run: python -m pip install nox

packages/gapic-generator/.kokoro/docs/docs-presubmit.cfg

@@ -24,5 +24,5 @@ env_vars: {
 # Only run this nox session.
 env_vars: {
     key: "NOX_SESSION"
-    value: "docs docfx"
+    value: "docs"
 }

packages/gapic-generator/.kokoro/publish-docs.sh

@@ -43,22 +43,3 @@ cat docs.metadata
 
 # upload docs
 python3 -m docuploader upload docs/_build/html --metadata-file docs.metadata --staging-bucket "${STAGING_BUCKET}"
-
-
-# docfx yaml files
-nox -s docfx
-
-# create metadata.
-python3 -m docuploader create-metadata \
-  --name=$(jq --raw-output '.name // empty' .repo-metadata.json) \
-  --version=$(python3 setup.py --version) \
-  --language=$(jq --raw-output '.language // empty' .repo-metadata.json) \
-  --distribution-name=$(python3 setup.py --name) \
-  --product-page=$(jq --raw-output '.product_documentation // empty' .repo-metadata.json) \
-  --github-repository=$(jq --raw-output '.repo // empty' .repo-metadata.json) \
-  --issue-tracker=$(jq --raw-output '.issue_tracker // empty' .repo-metadata.json)
-
-cat docs.metadata
-
-# upload docs
-python3 -m docuploader upload docs/_build/html/docfx_yaml --metadata-file docs.metadata --destination-prefix docfx --staging-bucket "${V2_STAGING_BUCKET}"

packages/gapic-generator/.repo-metadata.json

@@ -1,7 +1,8 @@
 {
-    "name": "gapic-generator-python",
+    "name": "gapic-generator",
     "name_pretty": "Google API Client Generator for Python",
     "client_documentation": "https://gapic-generator-python.readthedocs.io/en/stable/",
+    "product_documentation": "",
     "issue_tracker": "https://github.com/googleapis/gapic-generator-python/issues",
     "release_level": "preview",
     "language": "python",

packages/gapic-generator/.trampolinerc

@@ -0,0 +1,63 @@
+# Copyright 2020 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
+#
+#      http://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.
+
+# Template for .trampolinerc
+
+# Add required env vars here.
+required_envvars+=(
+)
+
+# Add env vars which are passed down into the container here.
+pass_down_envvars+=(
+    "NOX_SESSION"
+    ###############
+    # Docs builds
+    ###############
+    "STAGING_BUCKET"
+    "V2_STAGING_BUCKET"
+    ##################
+    # Samples builds
+    ##################
+    "INSTALL_LIBRARY_FROM_SOURCE"
+    "RUN_TESTS_SESSION"
+    "BUILD_SPECIFIC_GCLOUD_PROJECT"
+    # Target directories.
+    "RUN_TESTS_DIRS"
+    # The nox session to run.
+    "RUN_TESTS_SESSION"
+)
+
+# Prevent unintentional override on the default image.
+if [[ "${TRAMPOLINE_IMAGE_UPLOAD:-false}" == "true" ]] && \
+   [[ -z "${TRAMPOLINE_IMAGE:-}" ]]; then
+   echo "Please set TRAMPOLINE_IMAGE if you want to upload the Docker image."
+   exit 1
+fi
+
+# Define the default value if it makes sense.
+if [[ -z "${TRAMPOLINE_IMAGE_UPLOAD:-}" ]]; then
+    TRAMPOLINE_IMAGE_UPLOAD=""
+fi
+
+if [[ -z "${TRAMPOLINE_IMAGE:-}" ]]; then
+    TRAMPOLINE_IMAGE=""
+fi
+
+if [[ -z "${TRAMPOLINE_DOCKERFILE:-}" ]]; then
+    TRAMPOLINE_DOCKERFILE=""
+fi
+
+if [[ -z "${TRAMPOLINE_BUILD_FILE:-}" ]]; then
+    TRAMPOLINE_BUILD_FILE=""
+fi

packages/gapic-generator/README.rst

@@ -24,11 +24,9 @@ regarding:
 Documentation
 -------------
 
-`Documentation`_ is available on Read the Docs.
+See the `documentation`_.
 
-.. _documentation: https://gapic-generator-python.readthedocs.io/
+.. _documentation: https://googleapis.dev/python/gapic-generator-python/latest
 
 .. |release level| image:: https://img.shields.io/badge/release%20level-beta-yellow.svg?style=flat
   :target: https://cloud.google.com/terms/launch-stages
-.. |docs| image:: https://readthedocs.org/projects/gapic-generator-python/badge/?version=latest
-  :target: https://gapic-generator-python.readthedocs.io/

packages/gapic-generator/noxfile.py

@@ -422,7 +422,7 @@ def snippetgen(session):
     session.run("py.test", "-vv", "tests/snippetgen")
 
 
-@nox.session(python="3.9")
+@nox.session(python="3.8")
 def docs(session):
     """Build the docs."""
 

packages/gapic-generator/owlbot.py

@@ -18,7 +18,18 @@
 templated_files = CommonTemplates().py_library()
 s.move(
     templated_files / ".kokoro",
-    excludes=["samples/**/*", "test-samples*"],
+    excludes=["samples/**/*", "test-samples*", "publish-docs.sh"],
 )
+
+# remove docfx build
+assert 1 == s.replace(
+    ".kokoro/docs/docs-presubmit.cfg",
+    'value: "docs docfx"',
+    'value: "docs"',
+)
+
+# needed for docs build
+s.move(templated_files / ".trampolinerc")
+
 s.move(templated_files / "LICENSE")
 s.move(templated_files / ".github", excludes=["workflows", "CODEOWNERS"])