DevOps-Bash-tools/bitbucket/bitbucket_repo_set_description.sh

#!/usr/bin/env bash
#  vim:ts=4:sts=4:sw=4:et
#  args: github-actions-contexts test
#
#  Author: Hari Sekhon
#  Date: 2020-08-16 09:52:29 +0100 (Sun, 16 Aug 2020)
#
#  https://github.com/HariSekhon/DevOps-Bash-tools
#
#  License: see accompanying Hari Sekhon LICENSE file
#
#  If you're using my code you're welcome to connect with me on LinkedIn and optionally send me feedback to help steer this or other code I publish
#
#  https://www.linkedin.com/in/HariSekhon
#

set -euo pipefail
[ -n "${DEBUG:-}" ] && set -x
srcdir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# shellcheck disable=SC1090,SC1091
. "$srcdir/lib/bitbucket.sh"

# shellcheck disable=SC2034,SC2154
usage_description="
Sets the description of a BitBucket.org repo via the BitBucket API

Uses the adjacent script bitbucket_api.sh, see there for authentication details

\$CURL_OPTS can be set to provide extra arguments to curl


Repo should be specified as <workspace>/<repo> using the slugs which are usually just the same as the username and repo lowercase (they're case sensitive, eg. harisekhon/devops-bash-tools)

Repo workspace prefix, if not set, is assumed to be the username and will use \$BITBUCKET_USER if available, otherwise will query the BitBucket API to determine it


If you get an error it's possible you don't have the right token permissions.
You can generate a new token with the right permissions here:

    https://bitbucket.org/account/settings/app-passwords/


Example:

${0##*/} harisekhon/devops-bash-tools    my new description


If no args are given, will read read and description from standard input for easy chaining with other tools, can easily update multiple repositories this way, one repo + description per line:

echo <repo> <description> | ${0##*/}
"

# used by usage() in lib/utils.sh
# shellcheck disable=SC2034
usage_args="<repo> <description>"

help_usage "$@"

#min_args 2 "$@"

set_repo_description(){
    local repo="$1"
    local description="${*:2}"

    if ! [[ "$repo" =~ / ]]; then
        log "No username prefix in repo '$repo', will auto-add it"
        # reuse bitbucket_user between function calls for efficiency to save additional queries to the BitBucket API
        if [ -z "${bitbucket_user:-}" ]; then
            bitbucket_user="$(get_bitbucket_user)"
        fi
        repo="$bitbucket_user/$repo"
    fi

    timestamp "Setting BitBucket repo '$repo' description to '$description'"

    #description="$("$srcdir/../bin/urlencode.sh" <<< "$description")"

    "$srcdir/bitbucket_api.sh" "/repositories/$repo" -X PUT -H 'Content-Type: application/json' --data "{ \"description\": \"$description\" }" >/dev/null
}

if [ $# -gt 0 ]; then
    if [ $# -lt 2 ]; then
        usage
    fi
    set_repo_description "$@"
else
    while read -r repo description; do
        [ -n "$repo" ] || continue
        [ -n "$description" ] || continue
        set_repo_description "$repo" "$description"
    done
fi