2 # shellcheck shell=bash
4 # SPDX-License-Identifier: EPL-1.0
5 ##############################################################################
6 # Copyright (c) 2019 The Linux Foundation and others.
8 # All rights reserved. This program and the accompanying materials
9 # are made available under the terms of the Eclipse Public License v1.0
10 # which accompanies this distribution, and is available at
11 # http://www.eclipse.org/legal/epl-v10.html
12 ##############################################################################
14 # A library of functions for LF/Jenkins bash scripts. In the general case, these
15 # functions should only use 'local' variables, and should NOT set
16 # shell/environment variables. If you want to make a variable available, provide
17 # a function that sets the variable: 'function lf_set_foo() {foo=asdf;}'. Any
18 # scripts that need access to the variable can call the 'set' function. This
19 # keeps the name-space pollution to a minimum.
21 # This script will be installed in ~jenkins by the Jenkins Init Script when the
22 # build agent boots. When the build starts it should already be installed.
24 ################################################################################
26 # Name: lf-echo-stderr
31 # lf-echo-stderr "this entire" "string will be sent to stderr"
34 # This function will echo all command line aruments to 'stderr'
39 ################################################################################
41 function lf-echo-stderr() { echo "$@" 1>&2; }
43 ################################################################################
49 # # shellcheck disable=SC1090
52 # if lf-boolean $VAR; then
57 # This function will return a BOOLEAN (true or false) based upon the value
58 # of VAR. The value of VAR will be mapped to lower case. If VAR maps to
59 # "true", return true(0). If VAR maps to "false", return false(1). Any
60 # other values will return false(2) and an error message.
66 ################################################################################
70 if (( $# != 1 )); then
71 echo "ERROR: ${FUNCNAME[0]}() line: ${BASH_LINENO[0]} : Missing Required Argument"
75 bool=$(echo "$1" | tr '[:upper:]' '[:lower:]')
80 lf-echo-stderr "ERROR: ${FUNCNAME[0]}() line:{BASH_LINENO[0]} : A boolean cannot be a empty string" >&2
84 lf-echo-stderr "ERROR: ${FUNCNAME[0]}() line: ${BASH_LINENO[0]} : Invalid value for a boolean: '$bool'"
90 ################################################################################
93 # lf-activate-venv [-p|--python python] [--no-path]
94 # [--system-site-packages] [package]...
97 # # shellcheck disable=SC1090
100 # lf-activate-venv tox tox-pyenv
102 # lf-activate-venv jenkins-job-builder
104 # lf-activate-venv lftools
106 # lf-activate-venv --python 3.6 git-review
109 # This function will create a new Python Virtual Environment (venv) and
110 # install the specified packages in the new venv. The venv will be installed
111 # in $lf_venv and by default, the $lf_venv/bin directory will be prepended
114 # The 'lf_venv' variable will be set so you can directly execute commands
115 # in the venv with: $lf_venv/bin/command. Beware that subsequent calls to
116 # lf-activate-venv() will overwrite 'lf_venv'.
118 # By default all packages are installed with '--upgrade-strategy eager'.
119 # The venv will always contain pip & virtualenv.
121 # Some packages have a default version. If one of those packages is specified,
122 # the 'version' specifier will be added for the install. If the version is
123 # specified on the command line that version will be used.
124 # The following packages have default versions:
126 # jenkins-job-builder $JJB_VERSION
128 # If the --python flag is specified, the specified python executable will be
129 # used to create the venv. The --python option must be in the PATH. The venv
130 # will be located in $lf_venv (/tmp/venv-####).
132 # If the --no-path flag is specified, $lf_venv/bin will not be prepended to
135 # If the --system-site-packages flag is specified, the --system-site-packages
136 # flag will be passed to the inital 'pip install' (python3* only).
142 ################################################################################
144 function lf-activate-venv()
146 lf_venv=$(mktemp -d /tmp/venv-XXXX)
150 local install_args=""
151 options=$(getopt -o 'n:p:' -l 'no-path,python:,system-site-packages' -n "${FUNCNAME[0]}" -- "$@" )
152 eval set -- "$options"
155 -n|--no-path) set_path=false ; shift ;;
156 -p|--python) python=$2 ; shift 2 ;;
157 --system-site-packages) install_args="--system-site-packages" ; shift ;;
159 *) lf-echo-stderr "${FUNCNAME[0]}(): ERROR: Unknown switch '$1'." ; return 1 ;;
162 if ! type "$python" > /dev/null; then
163 lf-echo-stderr "${FUNCNAME[0]}(): ERROR: Unknown Python: $python"
167 echo "${FUNCNAME[0]}(): INFO: Creating $python venv at $lf_venv"
172 # For Python2, just create venv and install pip
173 virtualenv -p "$python" "$lf_venv" || return 1
174 "$lf_venv/bin/pip" install --upgrade --quiet pip || return 1
175 if [[ -z $pkg_list ]]; then
176 echo "${FUNCNAME[0]}(): WARNING: No packages to install"
179 echo "${FUNCNAME[0]}(): INFO: Installing: $pkg_list"
180 # $pkg_list is expected to be unquoted
181 # shellcheck disable=SC2086
182 "$lf_venv/bin/pip" install --upgrade --quiet $pkg_list || return 1
186 # Add version specifier for some packages
189 jenkins-job-builder) pkg_list+="jenkins-job-builder==${JJB_VERSION:-2.8.0} " ;;
190 *) pkg_list+="$arg " ;;
193 $python -m venv "$install_args" "$lf_venv" || return 1
194 "$lf_venv/bin/pip" install --upgrade --quiet pip virtualenv || return 1
195 if [[ -z $pkg_list ]]; then
196 echo "${FUNCNAME[0]}(): WARNING: No packages to install"
199 echo "${FUNCNAME[0]}(): INFO: Installing: $pkg_list"
200 # $pkg_list is expected to be unquoted
201 # shellcheck disable=SC2086
202 "$lf_venv/bin/pip" install --upgrade --quiet --upgrade-strategy eager \
203 $pkg_list || return 1
206 lf-echo-stderr "${FUNCNAME[0]}(): ERROR: No support for: $python"
211 echo "${FUNCNAME[0]}(): INFO: Adding $lf_venv/bin to PATH"
212 PATH=$lf_venv/bin:$PATH
215 echo "${FUNCNAME[0]}(): INFO: Path not set, lf_venv set to: $lf_venv"
218 } # End lf-activate-venv()
220 ################################################################################
223 # lf-git-validate-jira-urls
226 # # shellcheck disable=SC1090
229 # lf-git-validate-jira-urls
232 # Check for JIRA URLS in the commit message
238 ################################################################################
240 function lf-git-validate-jira-urls()
242 echo "Checking for JIRA URLs in commit message..."
243 # if JIRA_URL is not defined, nothing to do
244 if [[ -v JIRA_URL ]]; then
245 base_url=$(echo "$JIRA_URL" | awk -F'/' '{print $3}')
246 jira_link=$(git rev-list --format=%B --max-count=1 HEAD | grep -io "http[s]*://$base_url/" || true)
247 if [[ -n $jira_link ]]; then
248 lf-echo-stderr "${FUNCNAME[0]}(): ERROR: JIRA URL found in commit message"
249 lf-echo-stderr 'Add jira references as: Issue: <JIRAKEY>-<ISSUE#>, instead of URLs'
253 echo "${FUNCNAME[0]}(): WARNING: JIRA_URL not set, continuing anyway"
258 ################################################################################
261 # lf-jjb-check-ascii()
264 # # shellcheck disable=SC1090
270 # Check for JJB YAML files containing non-printable ascii characters. This
271 # function must be run from the top of the global-jjb repo.
277 ################################################################################
279 function lf-jjb-check-ascii()
281 if [[ ! -d "jjb" ]]; then
282 lf-echo-stderr "${FUNCNAME[0]}(): ERROR: missing jjb directory"
283 lf-echo-stderr "This function can only be run from top of global-jjb directory"
286 if LC_ALL=C grep -I -r '[^[:print:][:space:]]' jjb/; then
287 lf-echo-stderr "${FUNCNAME[0]}(): ERROR: Found YAML files containing non-printable characters."
290 echo "${FUNCNAME[0]}(): INFO: All JJB YAML files contain only printable ASCII characters"
294 ################################################################################
295 # Functions that assign Variables
296 ################################################################################
298 # These variables are shell (local) variables and need to be lower-case so
299 # Shellcheck knows they are shell variables and will check for
302 function lf-set-maven-options()
304 # Disable 'unused-variable' check
305 # shellcheck disable=SC2034
306 maven_options="--show-version --batch-mode -Djenkins \
307 -Dorg.slf4j.simpleLogger.log.org.apache.maven.cli.transfer.Slf4jMavenTransferListener=warn \
308 -Dmaven.repo.local=/tmp/r -Dorg.ops4j.pax.url.mvn.localRepository=/tmp/r"