shell/rtd-verify.sh

   1 #!/bin/bash -l
   2 # SPDX-License-Identifier: EPL-1.0
   3 ##############################################################################
   4 # Copyright (c) 2017 The Linux Foundation and others.
   5 #
   6 # All rights reserved. This program and the accompanying materials
   7 # are made available under the terms of the Eclipse Public License v1.0
   8 # which accompanies this distribution, and is available at
   9 # http://www.eclipse.org/legal/epl-v10.html
  10 ##############################################################################
  11 echo "---> rtd-verify.sh"
  12
  13 # Ensure we fail the job if any steps fail.
  14 # DO NOT set -u
  15 set -xe -o pipefail
  16
  17 echo "---> Fetching project"
  18 if [ "$GERRIT_PROJECT" != "$PROJECT" ]; then
  19     # Only test projects that are a submodule of docs
  20     if ! git submodule | grep "$GERRIT_PROJECT"; then
  21         echo "WARN: Project is not a submodule of docs. This likely means " \
  22             "the project is not participating in the monolithic docs build " \
  23             "and should have their own verify job. Quitting job run..."
  24         exit 0
  25     fi
  26
  27     cd "docs/submodules/$GERRIT_PROJECT"
  28 fi
  29
  30 git fetch origin "$GERRIT_REFSPEC" && git checkout FETCH_HEAD
  31 git submodule update
  32
  33
  34 # When a new commands are added in lftools, the docs verify job needs to
  35 # run the new command which requires installing the lftools dev version
  36 if [[ $JOB_NAME == "lf-infra-lftools-rtd-verify-any" ]]; then
  37     # shellcheck disable=SC1090
  38     source ~/lf-env.sh
  39     lf-activate-venv pip
  40     pip install -e .
  41 fi
  42
  43 echo "---> Generating docs"
  44 cd "$WORKSPACE"
  45 tox -edocs
  46
  47 echo "---> Archiving generated docs"
  48 mkdir -p "$WORKSPACE/archives"
  49 mv "$DOC_DIR" archives/