Mionsz/common.ps1

## common.ps1
# invoke:
# $URI = "Mionsz/bc9c1a71587ca43b147d75d8feb73088/raw/3e04c112921939b6a32173ac52b4b56d99c71cdd/common.ps1"
# Invoke-Expression (Invoke-RestMethod -Uri "https://gist.githubusercontent.com/$URI"); Print-LogoAnim

# Enhanced version with better color support
function Print-Logo {
    param(
        [array]$BlueCode = @(26, 27, 20, 19, 20, 20, 21, 4, 27, 26, 32, 12, 33, 6, 39, 38, 44, 45)
    )

    # Try to enable ANSI colors
    $ansiSupported = Enable-AnsiColors

    $logoString = @"
.-----------------------------------------------------------.
|        *          .                    ..        .    *   |
|       .                         .   .  .  .   .           |
|                                    . .  *:. . .           |
|                             .  .   . .. .         .       |
|                    .     . .  . ...    .    .             |
|  .              .  .  . .    . .  . .                     |
|                   .    .     . ...   ..   .       .       |
|            .  .    . *.   . .                             |
|                   :.  .           .                       |
|            .   .    .    .                                |
|        .  .  .    . ^                                     |
|       .  .. :.    . |             .               .       |
|.   ... .            |                                     |
| :.  . .   *.    We are here.              .               |
|   .               .             *.                        |
.©-Intel-Corporation--------------------ascii-author-unknown.
=                                                           =
=        88                                  88             =
=        ""                ,d                88             =
=        88                88                88             =
=        88  8b,dPPYba,  MM88MMM  ,adPPYba,  88             =
=        88  88P'   '"8a   88    a8P_____88  88             =
=        88  88       88   88    8PP"""""""  88             =
=        88  88       88   88,   "8b,   ,aa  88             =
=        88  88       88   "Y888  '"Ybbd8"'  88             =
=                                                           =
=============================================================
"@

    if (-not $ansiSupported) {
        # Fallback: output without colors
        Write-Host $logoString
        return
    }

    # Use StringBuilder for better performance
    $output = [System.Text.StringBuilder]::new()

    for ($i = 0; $i -lt $logoString.Length; $i++) {
        $colorIndex = [math]::Floor(($i - [math]::Floor($i / 64) * 64) / 4) % $BlueCode.Length
        $colorCode = $BlueCode[$colorIndex]

        # Add color escape sequence and character
        [void]$output.Append("$([char]27)[38;5;${colorCode}m$($logoString[$i])")
    }

    # Reset color
    [void]$output.Append("$([char]27)[0m")

    Write-Host $output.ToString() -NoNewline
    Write-Host "" # Final newline
}

function Print-Logo-Old {
    param(
        [array]$BlueCode = @(26, 27, 20, 19, 20, 20, 21, 4, 27, 26, 32, 12, 33, 6, 39, 38, 44, 45)
    )

    $logoString = @"
.-----------------------------------------------------------.
|        *          .                    ..        .    *   |
|       .                         .   .  .  .   .           |
|                                    . .  *:. . .           |
|                             .  .   . .. .         .       |
|                    .     . .  . ...    .    .             |
|  .              .  .  . .    . .  . .                     |
|                   .    .     . ...   ..   .       .       |
|            .  .    . *.   . .                             |
|                   :.  .           .                       |
|            .   .    .    .                                |
|        .  .  .    . ^                                     |
|       .  .. :.    . |             .               .       |
|.   ... .            |                                     |
| :.  . .   *.    We are here.              .               |
|   .               .             *.                        |
.©-Intel-Corporation--------------------ascii-author-unknown.
=                                                           =
=        88                                  88             =
=        ""                ,d                88             =
=        88                88                88             =
=        88  8b,dPPYba,  MM88MMM  ,adPPYba,  88             =
=        88  88P'   '"8a   88    a8P_____88  88             =
=        88  88       88   88    8PP"""""""  88             =
=        88  88       88   88,   "8b,   ,aa  88             =
=        88  88       88   "Y888  '"Ybbd8"'  88             =
=                                                           =
=============================================================
"@

    # Enable ANSI escape sequences in PowerShell
    if ($PSVersionTable.PSVersion.Major -ge 7) {
        # PowerShell 7+ has ANSI support by default
    } elseif ($Host.UI.SupportsVirtualTerminal) {
        # Windows PowerShell 5.1 with ANSI support
    } else {
        # Enable ANSI sequences for older PowerShell versions
        try {
            [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
            $null = [System.Console]::WriteLine()
        } catch {
            # Fallback: output without colors
            Write-Host $logoString
            return
        }
    }

    $colorizedOutput = New-Object System.Text.StringBuilder

    for ($i = 0; $i -lt $logoString.Length; $i++) {
        $colorIndex = [math]::Floor(($i - [math]::Floor($i / 64) * 64) / 4) % $BlueCode.Length
        $colorCode = $BlueCode[$colorIndex]

        # Build the colorized string
        $null = $colorizedOutput.Append("$([char]27)[38;5;${colorCode}m")
        $null = $colorizedOutput.Append($logoString[$i])
    }

    # Reset color at the end
    $null = $colorizedOutput.Append("$([char]27)[0m")

    # Output to stderr equivalent (Write-Error writes to error stream)
    # But for visual purposes, we'll use Write-Host
    Write-Host $colorizedOutput.ToString() -NoNewline
    Write-Host "" # Add final newline
}

function Print-LogoSequence {
    param(
        [double]$WaitBetweenFrames = 0
    )

    $blueCodeFixed = @(26, 27, 20, 19, 20, 20, 21, 4, 27, 26, 32, 12, 33, 6, 39, 38, 44, 45)
    $size = $blueCodeFixed.Length

    for ($move = 0; $move -lt $size; $move++) {
        $blueCode = @()

        # Add elements from move position to end
        for ($i = $move; $i -lt $size; $i++) {
            $blueCode += $blueCodeFixed[$i]
        }

        # Add elements from beginning to move position
        for ($i = 0; $i -lt $move; $i++) {
            $blueCode += $blueCodeFixed[$i]
        }

        # Move cursor to top-left (home position)
        Write-Host "$([char]27)[H" -NoNewline
        Print-Logo -BlueCode $blueCode

        if ($WaitBetweenFrames -gt 0) {
            Start-Sleep -Seconds $WaitBetweenFrames
        }
    }
}

function Print-LogoAnim {
    param(
        [int]$NumberOfSequences = 2,
        [double]$WaitBetweenFrames = 0.025
    )

    # Clear screen using ANSI escape sequence
    Write-Host "$([char]27)[2J$([char]27)[H" -NoNewline

    for ($pt = 0; $pt -lt $NumberOfSequences; $pt++) {
        Print-LogoSequence -WaitBetweenFrames $WaitBetweenFrames
    }
}

# Alternative version for better compatibility across different PowerShell versions
function Enable-AnsiColors {
    if ($PSVersionTable.PSVersion.Major -lt 7) {
        # For Windows PowerShell 5.1 and earlier
        if ($Host.Name -eq 'ConsoleHost') {
            try {
                # Try to enable ANSI escape sequences
                $kernel32 = Add-Type -MemberDefinition @"
[DllImport("kernel32.dll", SetLastError = true)]
public static extern bool SetConsoleMode(IntPtr hConsoleHandle, uint dwMode);

[DllImport("kernel32.dll", SetLastError = true)]
public static extern IntPtr GetStdHandle(int nStdHandle);

[DllImport("kernel32.dll", SetLastError = true)]
public static extern bool GetConsoleMode(IntPtr hConsoleHandle, out uint lpMode);
"@ -Name 'Kernel32' -Namespace 'Win32' -PassThru

                $handle = $kernel32::GetStdHandle(-11) # STD_OUTPUT_HANDLE
                $mode = 0
                $null = $kernel32::GetConsoleMode($handle, [ref]$mode)
                $null = $kernel32::SetConsoleMode($handle, $mode -bor 4) # ENABLE_VIRTUAL_TERMINAL_PROCESSING

                return $true
            } catch {
                return $false
            }
        }
    }
    return $true
}

function Print-LogoSequence {
    param(
        [double]$WaitBetweenFrames = 0  # Keep as seconds for compatibility
    )

    $blueCodeFixed = @(26, 27, 20, 19, 20, 20, 21, 4, 27, 26, 32, 12, 33, 6, 39, 38, 44, 45)
    $size = $blueCodeFixed.Length

    for ($move = 0; $move -lt $size; $move++) {
        $blueCode = @()

        for ($i = $move; $i -lt $size; $i++) {
            $blueCode += $blueCodeFixed[$i]
        }

        for ($i = 0; $i -lt $move; $i++) {
            $blueCode += $blueCodeFixed[$i]
        }

        Write-Host "$([char]27)[H" -NoNewline
        Print-Logo -BlueCode $blueCode

        if ($WaitBetweenFrames -gt 0) {
            # Convert seconds to milliseconds
            $milliseconds = [int]($WaitBetweenFrames * 1000)
            Start-Sleep -Milliseconds $milliseconds
        }
    }
}

function Print-LogoAnim {
    param(
        [int]$NumberOfSequences = 3,
        [double]$WaitBetweenFrames = 0.035  # 35 milliseconds
    )

    Write-Host "$([char]27)[2J$([char]27)[H" -NoNewline

    for ($pt = 0; $pt -lt $NumberOfSequences; $pt++) {
        Print-LogoSequence -WaitBetweenFrames $WaitBetweenFrames
    }
}

## common.sh
#!/bin/bash

# SPDX-License-Identifier: BSD-3-Clause
# Copyright 2025 Intel Corporation

# common.sh: Utility functions for common script usages (v0.9.0)
# Sets up environment, logging, file manipulation, and system utilities.

# Set repository directory
REPOSITORY_DIR="$(readlink -f "$(dirname -- "${BASH_SOURCE[0]}")/..")"

# Configure defaults
PM="${PM:-apt-get}"
NPROC="${NPROC:-$(nproc)}"

# Basic terminal and variable based colors output check
COLORS_ENABLED="${COLORS_ENABLED}"
TPUT_COLORS_NUMBER="$(tput colors 2> /dev/null || echo 0)"
DISABLE_COLOR_PRINT="${DISABLE_COLOR_PRINT:-0}"

# Check terminal color support
if [[ "${TPUT_COLORS_NUMBER}" -ge 8 && "${DISABLE_COLOR_PRINT}" == 0 ]]; then
    BOLD="\e[1;"; REGULAR="\e[0;"; RED="31m"; GREEN="32m"; YELLOW="33m"; BLUE="34m"; EndCl='\e[m'; export COLORS_ENABLED=1;
else
    BOLD=""; REGULAR=""; RED=""; GREEN=""; YELLOW=""; BLUE=""; EndCl=""; export COLORS_ENABLED=0;
fi

# Log message with color
function log_message() { # type, message
    local TYPE="${1^^}";
    shift;
    local HEADER="";
    case "${TYPE}" in
      ERROR)        HEADER="${REGULAR}${RED}${TYPE}:  ${BOLD}${RED}$*${EndCl}" ;;
      WARN|WARNING) HEADER="${REGULAR}${BLUE}${TYPE}: ${BOLD}${YELLOW}$*${EndCl}" ;;
      SUCC|SUCCESS) HEADER="${REGULAR}${BLUE}${TYPE}: ${BOLD}${GREEN}$*${EndCl}" ;;
      INFO|*)       HEADER="${REGULAR}${BLUE}${TYPE}: ${BOLD}${BLUE}$*${EndCl}" ;;
    esac
    echo -e "${HEADER}" >&2
}

function log_info()    { log_message "INFO" "$@"; }
function log_success() { log_message "SUCCESS" "$@"; }
function log_warning() { log_message "WARNING" "$@"; }
function log_error()   { log_message "ERROR" "$@"; }

# Prompt user for yes/no input
# default (0=no, 1=yes)
function get_user_input_confirm() {
    local confirm
    local confirm_string
    local confirm_default="${1:-0}"
    confirm_string=( "(N)o" "(Y)es" )

    echo -en "${REGULAR}${BLUE}CHOOSE:${BOLD}${BLUE} (Y)es/(N)o [default: ${confirm_string[$confirm_default]}]: ${EndCl}" >&2
    read -r confirm
    if [[ -z "$confirm" ]]; then
        confirm="$confirm_default"
    else
        { [[ $confirm == [yY] ]] || [[ $confirm == [yY][eE][sS] ]]; } && confirm="1" || confirm="0"
    fi
    echo "${confirm}"
}
# Prompt user get_user_input_confirm. Default yes.
function get_user_input_def_yes() {
    get_user_input_confirm 1
}
# Prompt user get_user_input_confirm. Default no.
function get_user_input_def_no() {
    get_user_input_confirm 0
}
# File/path utilities
# Extract filename from path
function get_filename() {
    local path="$1"
    echo "${path##*/}"
}
# Extract directory from path
function get_dirname() {
    local path="$1"
    echo "${path%/*}/"
}
# Get file extension
function get_extension() {
    local filename
    filename="$(get_filename "${1}")"
    echo "${filename#*.}"
}
# Check if file has extension
function check_extension() {
    local filename="$1"
    local extension="$2"
    if [ "${filename}" == "${filename%"${extension}"}" ]; then
        echo "0"
    else
        echo "1"
    fi
}
# Get filename without extension
function get_basename() {
    local filename
    filename="$(get_filename "${1}")"
    echo "${filename%%.*}"
}

# Extracts namespace and repository part from valid GitHub URL passed as argument.
#  input: valid GitHub repository URL
# output: two element string array, space separated
function get_github_elements() {
    local path_part
    local path_elements
    path_part="${1#*://github.com/}"
    mapfile -t -d'/' path_elements <<< "${path_part}"
    if [[ "${#path_elements[@]}" -lt "2" ]]; then
        log_error  "Invalid link passed to get_github_elements method."
        return 1
    fi
    echo "${path_elements[0]} ${path_elements[1]}"
}
# Get GitHub namespace
function get_github_namespace() {
    cut -d' ' -f1 <<< "$(get_github_elements "$1")"
}
# Get GitHub repository
function get_github_repo() {
    cut -d' ' -f2 <<< "$(get_github_elements "$1")"
}

# Adds sufix to base of filename from full path.
# input[1]: string sufix to be added
# input[2]: path string to be modified
#   output: [path]/[file_base][id].[extension]
function get_filepath_add_sufix() {
    local dir_path
    local file_base
    local file_ext
    local file_sufix="${1}"
    local file_path="${2}"
    dir_path="$(get_dirname "${file_path}")"
    file_base="$(get_basename "${file_path}")"
    file_ext="$(get_extension "${file_path}")"
    echo "${dir_path}${file_base}${file_sufix}.${file_ext}"
}
# Check if command exists
function command_exists {
    command -v "$@" > /dev/null 2>&1
}
# Run command as root
function as_root()
{
    CMD_TO_EVALUATE="$*"
    CURRENT_USER_ID="$(id -u)"
    EFECTIVE_USER_ID="${EUID:-$CURRENT_USER_ID}"
    AS_ROOT="/bin/bash -c"

    if [ "${EFECTIVE_USER_ID}" -ne 0 ]; then
        if command_exists sudo; then
            AS_ROOT="sudo -E /bin/bash -c"
        elif command_exists su; then
            AS_ROOT="su -c"
        else
            log_error  "This command must be run as root [EUID=0] ${CMD_TO_EVALUATE[*]}."
            log_error  "- current [EUID=${EFECTIVE_USER_ID}]."
            log_error  "- 'sudo' nor 'su' commands were found in PATH."
            log_error  "Re-run the script as sudo or install sudo pkg."
            exit 1
        fi
    fi
    $AS_ROOT "${CMD_TO_EVALUATE[*]}"
}
# GitHub API call
function github_api_call() {
    url=$1
    shift
    GITHUB_API_URL=https://api.github.com
    INPUT_OWNER=$(echo "${url#"${GITHUB_API_URL}/repos/"}" | cut -f1 -d'/')
    INPUT_REPO=$(echo "${url#"${GITHUB_API_URL}/repos/"}" | cut -f2 -d'/')
    API_SUBPATH="${url#"${GITHUB_API_URL}/repos/${INPUT_OWNER}/${INPUT_REPO}/"}"
    if [ -z "${INPUT_GITHUB_TOKEN}" ]; then
        echo >&2 "Set the INPUT_GITHUB_TOKEN env variable first."
        return
    fi

    echo >&2 "GITHUB_API_URL=$GITHUB_API_URL"
    echo >&2 "INPUT_OWNER=$INPUT_OWNER"
    echo >&2 "INPUT_REPO=$INPUT_REPO"
    echo >&2 "API_SUBPATH=$API_SUBPATH"
    echo >&2 "curl --fail-with-body -sSL \"${GITHUB_API_URL}/repos/${INPUT_OWNER}/${INPUT_REPO}/${API_SUBPATH}\" -H \"Authorization: Bearer ${INPUT_GITHUB_TOKEN}\" -H 'Accept: application/vnd.github.v3+json' -H 'Content-Type: application/json' $*"

    if API_RESPONSE=$(curl --fail-with-body -sSL \
        "${GITHUB_API_URL}/repos/${INPUT_OWNER}/${INPUT_REPO}/${API_SUBPATH}" \
        -H "Authorization: Bearer ${INPUT_GITHUB_TOKEN}" \
        -H 'Accept: application/vnd.github.v3+json' \
        -H 'Content-Type: application/json' \
        "$@")
    then
        echo "${API_RESPONSE}"
    else
        echo >&2 "GitHub API call failed."
        echo >&2 "${API_RESPONSE}"
        return
    fi
}

# Print ASCII logo
function print_logo()
{
    [[ "${COLORS_ENABLED}" == 0 ]] && return 0;
    if [[ -z "$blue_code" ]]; then
        local blue_code=( 26 27 20 19 20 20 21 04 27 26 32 12 33 06 39 38 44 45 )
    fi
    local IFS
	local logo_string
    local colorized_logo_string
    IFS=$'\n\t'
    logo_string="$(cat <<- EOF
	.-----------------------------------------------------------.
	|        *          .                    ..        .    *   |
	|       .                         .   .  .  .   .           |
	|                                    . .  *:. . .           |
	|                             .  .   . .. .         .       |
	|                    .     . .  . ...    .    .             |
	|  .              .  .  . .    . .  . .                     |
	|                   .    .     . ...   ..   .       .       |
	|            .  .    . *.   . .                             |
	|                   :.  .           .                       |
	|            .   .    .    .                                |
	|        .  .  .    . ^                                     |
	|       .  .. :.    . |             .               .       |
	|.   ... .            |                                     |
	| :.  . .   *.    We are here.              .               |
	|   .               .             *.                        |
	.©-Intel-Corporation--------------------ascii-author-unknown.
	=                                                           =
	=        88                                  88             =
	=        ""                ,d                88             =
	=        88                88                88             =
	=        88  8b,dPPYba,  MM88MMM  ,adPPYba,  88             =
	=        88  88P'   '"8a   88    a8P_____88  88             =
	=        88  88       88   88    8PP"""""""  88             =
	=        88  88       88   88,   "8b,   ,aa  88             =
	=        88  88       88   "Y888  '"Ybbd8"'  88             =
	=                                                           =
	=============================================================
EOF
    )"

    colorized_logo_string=""
    for (( i=0; i<${#logo_string}; i++ ))
    do
        colorized_logo_string+="\e[38;05;${blue_code[$(( (i-(i/64)*64)/4 ))]}m"
        colorized_logo_string+="${logo_string:$i:1}"
    done;
    colorized_logo_string+='\e[m\n'

    echo -e "$colorized_logo_string" >&2
}

# Animate ASCII logo, one full sequence
function print_logo_sequence()
{
    set +x
    [[ "${COLORS_ENABLED}" == 0 ]] && return 0;
    local wait_between_frames="${1:-0}"
    local wait_cmd=""
    if [ ! "${wait_between_frames}" = "0" ]; then
        wait_cmd="sleep ${wait_between_frames}"
    fi

    blue_code_fixed=( 26 27 20 19 20 20 21 04 27 26 32 12 33 06 39 38 44 45 )
    size=${#blue_code_fixed[@]}
    for (( move=0; move<size; move++ ))
    do
    	blue_code=()
    	for (( i=move; i<size; i++ ))
    	do
    		blue_code+=("${blue_code_fixed[i]}")
    	done
    	for (( i=0; i<move; i++ ))
    	do
    		blue_code+=("${blue_code_fixed[i]}")
    	done
    	echo -en "\e[0;0H"
    	print_logo
        ${wait_cmd}
    done;
}

# Animate ASCII logo, number of sequences
function print_logo_anim()
{
    set +x
    [[ "${COLORS_ENABLED}" == 0 ]] && return 0;
    local number_of_sequences="${1:-2}"
    local wait_between_frames="${2:-0.025}"
    clear
    for (( pt=0; pt<number_of_sequences; pt++ ))
    do
        print_logo_sequence "${wait_between_frames}"
    done
}

# Detect if the script is being run on Ci/Jenkins infrastructure
function detect_jenkins_environment() {
    local jenkins_indicators=0

    # Check for Jenkins-specific environment variables
    [ -n "$JENKINS_URL" ] && ((jenkins_indicators++))
    [ -n "$JENKINS_HOME" ] && ((jenkins_indicators++))
    [ -n "$BUILD_NUMBER" ] && ((jenkins_indicators++))
    [ -n "$JOB_NAME" ] && ((jenkins_indicators++))
    [ -n "$BUILD_URL" ] && ((jenkins_indicators++))
    [ -n "$WORKSPACE" ] && ((jenkins_indicators++))
    [ -n "$NODE_NAME" ] && ((jenkins_indicators++))
    [ -n "$EXECUTOR_NUMBER" ] && ((jenkins_indicators++))

    # Check for CI environment variable (generic CI indicator)
    [ "$CI" = "true" ] && ((jenkins_indicators++))

    # Return true if we found multiple indicators
    if [[ "${jenkins_indicators}" -gt 2 ]]; then
        echo 1
    else
        echo 0
    fi
    return 0
}

# Error handling with debug output
function catch_error_print_debug() {
    local _last_command_height=""
    local -n _lineno="${1:-LINENO}"
    local -n _bash_lineno="${2:-BASH_LINENO}"
    local _last_command="${3:-${BASH_COMMAND}}"
    local _code="${4:-0}"
    local -a _output_array=()
    _last_command_height="$(wc -l <<<"${_last_command}")"

    _output_array+=(
        '---'
        "timestamp: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
        "lines_history: [${_lineno} ${_bash_lineno[*]}]"
        "function_trace: [${FUNCNAME[*]}]"
        "exit_code: ${_code}"
    )

    if [[ "${#BASH_SOURCE[@]}" -gt 1 ]]; then
        _output_array+=('source_trace:')
        for _item in "${BASH_SOURCE[@]}"; do
            _output_array+=("  - ${_item}")
        done
    else
        _output_array+=("source_trace: [${BASH_SOURCE[*]}]")
    fi

    if [[ "${_last_command_height}" -gt 1 ]]; then
        _output_array+=('last_command: ->')
        _output_array+=("${_last_command}")
    else
        _output_array+=("last_command: ${_last_command}")
    fi

    _output_array+=('---')
    log_error "${_output_array[*]}"
}

function trap_error_print_debug() {
    log_info "Setting trap for error handling"
    trap 'catch_error_print_debug "LINENO" "BASH_LINENO" "${BASH_COMMAND}" "${?}"; exit 1' SIGINT ERR
    log_info "Trap set successfully"
}

# GITHUB_CREDENTIALS="username:password"
# URL construction: https://${GITHUB_CREDENTIALS}@github.com/${name}/archive/${version}.tar.gz
# $1 - name
# $2 - version
# $3 - dest_dir
function git_download_strip_unpack()
{
    # Version can be commit sha or tag, examples:
    # version=d2515b90cc0ef651f6d0a6661d5a644490bfc3f3
    # version=refs/tags/v${JPEG_XS_VER}
    name="${1}"
    version="${2}"
    dest_dir="${3}"
    filename="$(get_filename "${version}")"
    [ -n "${GITHUB_CREDENTIALS}" ] && creds="${GITHUB_CREDENTIALS}@" || creds=""

    mkdir -p "${dest_dir}"
    curl -Lf "https://${creds}github.com/${name}/archive/${version}.tar.gz" -o "${dest_dir}/${filename}.tar.gz"
    tar -zx --strip-components=1 -C "${dest_dir}" -f "${dest_dir}/${filename}.tar.gz"
    rm -f "${dest_dir}/${filename}.tar.gz"
}

# Downloads and strip unpack a file from URL ($1) to a target directory ($2)
# $1 - URL to download
# $2 - destination directory to strip unpack the tar.gz
function wget_download_strip_unpack()
{
    local filename
    local source_url="${1}"
    local dest_dir="${2}"
    filename="$(get_filename "${source_url}")"
    [ -n "${GITHUB_CREDENTIALS}" ] && creds="${GITHUB_CREDENTIALS}@" || creds=""

    mkdir -p "${dest_dir}"
    curl -Lf "${source_url}" -o "${dest_dir}/${filename}.tar.gz"
    tar -zx --strip-components=1 -C "${dest_dir}" -f "${dest_dir}/${filename}.tar.gz"
    rm -f "${dest_dir}/${filename}.tar.gz"
}

# Example usage:
#    PM="$(setup_package_manager)" && \
#    $PM install python3
function setup_package_manager()
{
    TIBER_USE_PM="${PM:-$1}"
    if [[ -x "$(command -v "$TIBER_USE_PM")" ]]; then
        export PM="${TIBER_USE_PM}"
    elif [[ -x "$(command -v yum)" ]]; then
        export PM='yum'
    elif [[ -x "$(command -v dnf)" ]]; then
        export PM='dnf'
    elif [[ -x "$(command -v apt-get)" ]]; then
        export PM='apt-get'
    elif [[ -x "$(command -v apt)" ]]; then
        export PM='apt'
    else
        log_error  "No known pkg manager found. Try to re-run with variable, example:"
        log_error  "export PM=\"apt\""
        return 1
    fi
    log_info "Setting pkg manager to ${PM}."
    echo "${PM}"
    return 0
}

# Setup build dir and ffmpeg version/directory.
# FFMPEG_VER taken from environment or forced by 1st parameter
# Exports FFMPEG_DIR and FFMPEG_VER
function lib_setup_ffmpeg_dir_and_version()
{
    FFMPEG_VER="${1:-$FFMPEG_VER}"
    FFMPEG_7_0_DIR="${FFMPEG_7_0_DIR:-ffmpeg-7-0}"
    FFMPEG_6_1_DIR="${FFMPEG_6_1_DIR:-ffmpeg-6-1}"

    if [[ "${FFMPEG_VER}" == "7.0" ]]; then
        FFMPEG_SUB_DIR="${FFMPEG_7_0_DIR}"
    elif [[ "${FFMPEG_VER}" == "6.1" ]]; then
        FFMPEG_SUB_DIR="${FFMPEG_6_1_DIR}"
    else
        log_error "Unsupported version of FFmpeg == '${FFMPEG_VER}'."
        log_error "Try again, choose one of '7.0', '6.1'."
        exit 2
    fi
    export FFMPEG_VER
    export FFMPEG_SUB_DIR
}
# Execute command locally or via SSH.
# Wrapper/helper for command lunching on remote machines
function exec_command()
{
    # One of: yes|no|accept-new
    SSH_STRICT_HOST_KEY_CHECKING="accept-new"
    SSH_CMD="ssh -oStrictHostKeyChecking=${SSH_STRICT_HOST_KEY_CHECKING} -t -o"

    local values_returned=""
    local user_at_address=""
    [[ "$#" -eq "2" ]] && user_at_address="${2}"
    [[ "$#" -eq "3" ]] && user_at_address="${3}@${2}"

    if [ "$#" -eq "1" ]; then
        values_returned="$(eval "${1}")"
    elif [[ "$#" -eq "2" ]] || [[ "$#" -eq "3" ]]; then
        values_returned="$($SSH_CMD "RemoteCommand=eval \"${1}\"" "${user_at_address}" 2>/dev/null)"
    else
        log_error  "Wrong arguments for exec_command(). Valid number is one of [1 2 3], got $#"
        return 1
    fi

    if [ -z "$values_returned" ]; then
        log_error  "Unable to collect results or results are empty."
        return 1
    else
        echo "${values_returned}"
        return 0
    fi
}

# Get system hostname
function get_hostname() {
    exec_command 'hostname' "$@"
}

# Get Intel NIC devices
function get_intel_nic_device() {
    exec_command "lspci | grep 'Intel Corporation.*\(810\|X722\)'" "$@"
}

# Get default route NIC
function get_default_route_nic() {
    exec_command "ip -json r show default | jq '.[0].dev' -r" "$@"
}

# Get CPU architecture
function get_cpu_arch() {
    local arch=""
    if ! arch="$(exec_command 'cat /sys/devices/cpu/caps/pmu_name' "$@")"; then echo "Got: $arch" && return 1; fi

    case $arch in
        icelake)
            log_info "Xeon IceLake CPU (icx)" 1>&2
            echo "icx"
            ;;
        sapphire_rapids)
            log_info "Xeon Sapphire Rapids CPU (spr)" 1>&2
            echo "spr"
            ;;
        skylake)
            log_info "Xeon SkyLake"
            echo "skl"
            ;;
        *)
            log_error  "Unsupported architecture: ${arch}. Please edit the script or setup the architecture manually."
            return 1
            ;;
    esac
    return 0
}

function debian_install_docker()
{
    export DEBIAN_FRONTEND="noninteractive"
    export TZ="${TZ:-Europe/Warsaw}"
    apt-get update --fix-missing -y
    apt-get install -y --no-install-recommends \
      ca-certificates \
      sudo \
      curl \
      unzip \
      vim \
      apt-transport-https \
      software-properties-common \
      jq \
      tar \
      apt-utils \
      libssl3 \
      gnupg
    curl -k -fsSL "https://download.docker.com/linux/ubuntu/gpg" -o "/etc/apt/keyrings/docker.asc" && \
    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" > /etc/apt/sources.list.d/docker.list
    apt-key update && \
    apt-get update  --fix-missing && \
    apt-get install -y --no-install-recommends \
      docker-ce \
      docker-ce-cli \
      containerd.io \
      docker-buildx-plugin \
      docker-compose-plugin
}

function debian_configure_docker()
{
    export DEBIAN_FRONTEND="noninteractive"
    export TZ="${TZ:-Europe/Warsaw}"

    mkdir -p /etc/docker
    if [[ ! -f /etc/docker/daemon.json ]]; then
        echo '{"insecure-registries": ["ger-is-registry.caas.intel.com"]}' > /etc/docker/daemon.json
    else
        OLD_REGISTRY="$(cat /etc/docker/daemon.json)"
        jq '. | ."insecure-registries" = (."insecure-registries" + ["ger-is-registry.caas.intel.com"] | unique)' <(echo "$OLD_REGISTRY") > /etc/docker/daemon.json
    fi
    echo '[Service]
Environment="http_proxy=HHTP PROXY"
Environment="no_proxy=127.0.0.1,127.0.0.0/8,134.134.0.0/16,10.0.0.0/8,192.168.0.0/16,172.16.0.0/12,localhost,intel.com,.intel.com,.local,longhorn-system,cattle-system,harvester-system"
Environment="NO_PROXY=127.0.0.1,127.0.0.0/8,134.134.0.0/16,10.0.0.0/8,192.168.0.0/16,172.16.0.0/12,localhost,intel.com,.intel.com,.local,longhorn-system,cattle-system,harvester-system"
' > /etc/systemd/system/docker.service.d/intel-proxy.conf
    systemctl daemon-reload
    systemctl restart docker
}

function prepare_docker_templates()
{
  log_info "Preparing docker templates..."
  dockerTemplate='#!/bin/bash
  docker run --rm --init -it \
      --entrypoint=/bin/bash \
      --volume @REPOSITORY_DIR@:/build_dir \
      -w /build_dir \
      --name make-ddk \
      tools/docker_ddk:@DOCKER_TAG@ -c "make $@"
  '
  dockerTemplate="${dockerTemplate//@REPOSITORY_DIR@/${REPOSITORY_DIR}}"
  echo "${dockerTemplate//@DOCKER_TAG@/90GA}" > /usr/local/bin/make-ddk9
  echo "${dockerTemplate//@DOCKER_TAG@/80u3}" > /usr/local/bin/make-ddk8
  echo "${dockerTemplate//@DOCKER_TAG@/70}" > /usr/local/bin/make-ddk7
  chmod a+x /usr/local/bin/make-ddk*
  log_info "Path agnostic docker wrappers available:"
  log_info "  make-ddk9"
  log_info "  make-ddk8"
  log_info "  make-ddk7"
  log_info ""
  log_info "example:"
  log_info "  make-ddk9"
  log_info "  make-ddk9 bazel"
  log_success "Done. Finished prepare_docker_templates()"
}

## print-logo-anim.sh
# For PowerShell copy and paste:
Invoke-Expression (Invoke-RestMethod -Uri "https://gist.githubusercontent.com/Mionsz/bc9c1a71587ca43b147d75d8feb73088/raw/3e04c112921939b6a32173ac52b4b56d99c71cdd/common.ps1"); Print-LogoAnim

# For Bash script copy and paste:
eval ". $(curl https://gist.githubusercontent.com/Mionsz/bc9c1a71587ca43b147d75d8feb73088/raw/3e04c112921939b6a32173ac52b4b56d99c71cdd/common.sh); print_logo_anim"
	# invoke:
	# $URI = "Mionsz/bc9c1a71587ca43b147d75d8feb73088/raw/3e04c112921939b6a32173ac52b4b56d99c71cdd/common.ps1"
	# Invoke-Expression (Invoke-RestMethod -Uri "https://gist.githubusercontent.com/$URI"); Print-LogoAnim

	# Enhanced version with better color support
	function Print-Logo {
	param(
	[array]$BlueCode = @(26, 27, 20, 19, 20, 20, 21, 4, 27, 26, 32, 12, 33, 6, 39, 38, 44, 45)
	)

	# Try to enable ANSI colors
	$ansiSupported = Enable-AnsiColors

	$logoString = @"
	.-----------------------------------------------------------.
	\| * . .. . * \|
	\| . . . . . . \|
	\| . . *:. . . \|
	\| . . . .. . . \|
	\| . . . . ... . . \|
	\| . . . . . . . . . \|
	\| . . . ... .. . . \|
	\| . . . *. . . \|
	\| :. . . \|
	\| . . . . \|
	\| . . . . ^ \|
	\| . .. :. . \| . . \|
	\|. ... . \| \|
	\| :. . . *. We are here. . \|
	\| . . *. \|
	.©-Intel-Corporation--------------------ascii-author-unknown.
	= =
	= 88 88 =
	= "" ,d 88 =
	= 88 88 88 =
	= 88 8b,dPPYba, MM88MMM ,adPPYba, 88 =
	= 88 88P' '"8a 88 a8P_____88 88 =
	= 88 88 88 88 8PP""""""" 88 =
	= 88 88 88 88, "8b, ,aa 88 =
	= 88 88 88 "Y888 '"Ybbd8"' 88 =
	= =
	=============================================================
	"@

	if (-not $ansiSupported) {
	# Fallback: output without colors
	Write-Host $logoString
	return
	}

	# Use StringBuilder for better performance
	$output = [System.Text.StringBuilder]::new()

	for ($i = 0; $i -lt $logoString.Length; $i++) {
	$colorIndex = [math]::Floor(($i - [math]::Floor($i / 64) * 64) / 4) % $BlueCode.Length
	$colorCode = $BlueCode[$colorIndex]

	# Add color escape sequence and character
	[void]$output.Append("$([char]27)[38;5;${colorCode}m$($logoString[$i])")
	}

	# Reset color
	[void]$output.Append("$([char]27)[0m")

	Write-Host $output.ToString() -NoNewline
	Write-Host "" # Final newline
	}

	function Print-Logo-Old {
	param(
	[array]$BlueCode = @(26, 27, 20, 19, 20, 20, 21, 4, 27, 26, 32, 12, 33, 6, 39, 38, 44, 45)
	)

	$logoString = @"
	.-----------------------------------------------------------.
	\| * . .. . * \|
	\| . . . . . . \|
	\| . . *:. . . \|
	\| . . . .. . . \|
	\| . . . . ... . . \|
	\| . . . . . . . . . \|
	\| . . . ... .. . . \|
	\| . . . *. . . \|
	\| :. . . \|
	\| . . . . \|
	\| . . . . ^ \|
	\| . .. :. . \| . . \|
	\|. ... . \| \|
	\| :. . . *. We are here. . \|
	\| . . *. \|
	.©-Intel-Corporation--------------------ascii-author-unknown.
	= =
	= 88 88 =
	= "" ,d 88 =
	= 88 88 88 =
	= 88 8b,dPPYba, MM88MMM ,adPPYba, 88 =
	= 88 88P' '"8a 88 a8P_____88 88 =
	= 88 88 88 88 8PP""""""" 88 =
	= 88 88 88 88, "8b, ,aa 88 =
	= 88 88 88 "Y888 '"Ybbd8"' 88 =
	= =
	=============================================================
	"@

	# Enable ANSI escape sequences in PowerShell
	if ($PSVersionTable.PSVersion.Major -ge 7) {
	# PowerShell 7+ has ANSI support by default
	} elseif ($Host.UI.SupportsVirtualTerminal) {
	# Windows PowerShell 5.1 with ANSI support
	} else {
	# Enable ANSI sequences for older PowerShell versions
	try {
	[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
	$null = [System.Console]::WriteLine()
	} catch {
	# Fallback: output without colors
	Write-Host $logoString
	return
	}
	}

	$colorizedOutput = New-Object System.Text.StringBuilder

	for ($i = 0; $i -lt $logoString.Length; $i++) {
	$colorIndex = [math]::Floor(($i - [math]::Floor($i / 64) * 64) / 4) % $BlueCode.Length
	$colorCode = $BlueCode[$colorIndex]

	# Build the colorized string
	$null = $colorizedOutput.Append("$([char]27)[38;5;${colorCode}m")
	$null = $colorizedOutput.Append($logoString[$i])
	}

	# Reset color at the end
	$null = $colorizedOutput.Append("$([char]27)[0m")

	# Output to stderr equivalent (Write-Error writes to error stream)
	# But for visual purposes, we'll use Write-Host
	Write-Host $colorizedOutput.ToString() -NoNewline
	Write-Host "" # Add final newline
	}

	function Print-LogoSequence {
	param(
	[double]$WaitBetweenFrames = 0
	)

	$blueCodeFixed = @(26, 27, 20, 19, 20, 20, 21, 4, 27, 26, 32, 12, 33, 6, 39, 38, 44, 45)
	$size = $blueCodeFixed.Length

	for ($move = 0; $move -lt $size; $move++) {
	$blueCode = @()

	# Add elements from move position to end
	for ($i = $move; $i -lt $size; $i++) {
	$blueCode += $blueCodeFixed[$i]
	}

	# Add elements from beginning to move position
	for ($i = 0; $i -lt $move; $i++) {
	$blueCode += $blueCodeFixed[$i]
	}

	# Move cursor to top-left (home position)
	Write-Host "$([char]27)[H" -NoNewline
	Print-Logo -BlueCode $blueCode

	if ($WaitBetweenFrames -gt 0) {
	Start-Sleep -Seconds $WaitBetweenFrames
	}
	}
	}

	function Print-LogoAnim {
	param(
	[int]$NumberOfSequences = 2,
	[double]$WaitBetweenFrames = 0.025
	)

	# Clear screen using ANSI escape sequence
	Write-Host "$([char]27)[2J$([char]27)[H" -NoNewline

	for ($pt = 0; $pt -lt $NumberOfSequences; $pt++) {
	Print-LogoSequence -WaitBetweenFrames $WaitBetweenFrames
	}
	}

	# Alternative version for better compatibility across different PowerShell versions
	function Enable-AnsiColors {
	if ($PSVersionTable.PSVersion.Major -lt 7) {
	# For Windows PowerShell 5.1 and earlier
	if ($Host.Name -eq 'ConsoleHost') {
	try {
	# Try to enable ANSI escape sequences
	$kernel32 = Add-Type -MemberDefinition @"
	[DllImport("kernel32.dll", SetLastError = true)]
	public static extern bool SetConsoleMode(IntPtr hConsoleHandle, uint dwMode);

	[DllImport("kernel32.dll", SetLastError = true)]
	public static extern IntPtr GetStdHandle(int nStdHandle);

	[DllImport("kernel32.dll", SetLastError = true)]
	public static extern bool GetConsoleMode(IntPtr hConsoleHandle, out uint lpMode);
	"@ -Name 'Kernel32' -Namespace 'Win32' -PassThru

	$handle = $kernel32::GetStdHandle(-11) # STD_OUTPUT_HANDLE
	$mode = 0
	$null = $kernel32::GetConsoleMode($handle, [ref]$mode)
	$null = $kernel32::SetConsoleMode($handle, $mode -bor 4) # ENABLE_VIRTUAL_TERMINAL_PROCESSING

	return $true
	} catch {
	return $false
	}
	}
	}
	return $true
	}

	function Print-LogoSequence {
	param(
	[double]$WaitBetweenFrames = 0 # Keep as seconds for compatibility
	)

	$blueCodeFixed = @(26, 27, 20, 19, 20, 20, 21, 4, 27, 26, 32, 12, 33, 6, 39, 38, 44, 45)
	$size = $blueCodeFixed.Length

	for ($move = 0; $move -lt $size; $move++) {
	$blueCode = @()

	for ($i = $move; $i -lt $size; $i++) {
	$blueCode += $blueCodeFixed[$i]
	}

	for ($i = 0; $i -lt $move; $i++) {
	$blueCode += $blueCodeFixed[$i]
	}

	Write-Host "$([char]27)[H" -NoNewline
	Print-Logo -BlueCode $blueCode

	if ($WaitBetweenFrames -gt 0) {
	# Convert seconds to milliseconds
	$milliseconds = [int]($WaitBetweenFrames * 1000)
	Start-Sleep -Milliseconds $milliseconds
	}
	}
	}

	function Print-LogoAnim {
	param(
	[int]$NumberOfSequences = 3,
	[double]$WaitBetweenFrames = 0.035 # 35 milliseconds
	)

	Write-Host "$([char]27)[2J$([char]27)[H" -NoNewline

	for ($pt = 0; $pt -lt $NumberOfSequences; $pt++) {
	Print-LogoSequence -WaitBetweenFrames $WaitBetweenFrames
	}
	}
	#!/bin/bash

	# SPDX-License-Identifier: BSD-3-Clause
	# Copyright 2025 Intel Corporation

	# common.sh: Utility functions for common script usages (v0.9.0)
	# Sets up environment, logging, file manipulation, and system utilities.

	# Set repository directory
	REPOSITORY_DIR="$(readlink -f "$(dirname -- "${BASH_SOURCE[0]}")/..")"

	# Configure defaults
	PM="${PM:-apt-get}"
	NPROC="${NPROC:-$(nproc)}"

	# Basic terminal and variable based colors output check
	COLORS_ENABLED="${COLORS_ENABLED}"
	TPUT_COLORS_NUMBER="$(tput colors 2> /dev/null \|\| echo 0)"
	DISABLE_COLOR_PRINT="${DISABLE_COLOR_PRINT:-0}"

	# Check terminal color support
	if [[ "${TPUT_COLORS_NUMBER}" -ge 8 && "${DISABLE_COLOR_PRINT}" == 0 ]]; then
	BOLD="\e[1;"; REGULAR="\e[0;"; RED="31m"; GREEN="32m"; YELLOW="33m"; BLUE="34m"; EndCl='\e[m'; export COLORS_ENABLED=1;
	else
	BOLD=""; REGULAR=""; RED=""; GREEN=""; YELLOW=""; BLUE=""; EndCl=""; export COLORS_ENABLED=0;
	fi

	# Log message with color
	function log_message() { # type, message
	local TYPE="${1^^}";
	shift;
	local HEADER="";
	case "${TYPE}" in
	ERROR) HEADER="${REGULAR}${RED}${TYPE}: ${BOLD}${RED}$*${EndCl}" ;;
	WARN\|WARNING) HEADER="${REGULAR}${BLUE}${TYPE}: ${BOLD}${YELLOW}$*${EndCl}" ;;
	SUCC\|SUCCESS) HEADER="${REGULAR}${BLUE}${TYPE}: ${BOLD}${GREEN}$*${EndCl}" ;;
	INFO\|) HEADER="${REGULAR}${BLUE}${TYPE}: ${BOLD}${BLUE}$${EndCl}" ;;
	esac
	echo -e "${HEADER}" >&2
	}

	function log_info() { log_message "INFO" "$@"; }
	function log_success() { log_message "SUCCESS" "$@"; }
	function log_warning() { log_message "WARNING" "$@"; }
	function log_error() { log_message "ERROR" "$@"; }

	# Prompt user for yes/no input
	# default (0=no, 1=yes)
	function get_user_input_confirm() {
	local confirm
	local confirm_string
	local confirm_default="${1:-0}"
	confirm_string=( "(N)o" "(Y)es" )

	echo -en "${REGULAR}${BLUE}CHOOSE:${BOLD}${BLUE} (Y)es/(N)o [default: ${confirm_string[$confirm_default]}]: ${EndCl}" >&2
	read -r confirm
	if [[ -z "$confirm" ]]; then
	confirm="$confirm_default"
	else
	{ [[ $confirm == [yY] ]] \|\| [[ $confirm == [yY][eE][sS] ]]; } && confirm="1" \|\| confirm="0"
	fi
	echo "${confirm}"
	}
	# Prompt user get_user_input_confirm. Default yes.
	function get_user_input_def_yes() {
	get_user_input_confirm 1
	}
	# Prompt user get_user_input_confirm. Default no.
	function get_user_input_def_no() {
	get_user_input_confirm 0
	}
	# File/path utilities
	# Extract filename from path
	function get_filename() {
	local path="$1"
	echo "${path##*/}"
	}
	# Extract directory from path
	function get_dirname() {
	local path="$1"
	echo "${path%/*}/"
	}
	# Get file extension
	function get_extension() {
	local filename
	filename="$(get_filename "${1}")"
	echo "${filename#*.}"
	}
	# Check if file has extension
	function check_extension() {
	local filename="$1"
	local extension="$2"
	if [ "${filename}" == "${filename%"${extension}"}" ]; then
	echo "0"
	else
	echo "1"
	fi
	}
	# Get filename without extension
	function get_basename() {
	local filename
	filename="$(get_filename "${1}")"
	echo "${filename%%.*}"
	}

	# Extracts namespace and repository part from valid GitHub URL passed as argument.
	# input: valid GitHub repository URL
	# output: two element string array, space separated
	function get_github_elements() {
	local path_part
	local path_elements
	path_part="${1#*://github.com/}"
	mapfile -t -d'/' path_elements <<< "${path_part}"
	if [[ "${#path_elements[@]}" -lt "2" ]]; then
	log_error "Invalid link passed to get_github_elements method."
	return 1
	fi
	echo "${path_elements[0]} ${path_elements[1]}"
	}
	# Get GitHub namespace
	function get_github_namespace() {
	cut -d' ' -f1 <<< "$(get_github_elements "$1")"
	}
	# Get GitHub repository
	function get_github_repo() {
	cut -d' ' -f2 <<< "$(get_github_elements "$1")"
	}

	# Adds sufix to base of filename from full path.
	# input[1]: string sufix to be added
	# input[2]: path string to be modified
	# output: [path]/[file_base][id].[extension]
	function get_filepath_add_sufix() {
	local dir_path
	local file_base
	local file_ext
	local file_sufix="${1}"
	local file_path="${2}"
	dir_path="$(get_dirname "${file_path}")"
	file_base="$(get_basename "${file_path}")"
	file_ext="$(get_extension "${file_path}")"
	echo "${dir_path}${file_base}${file_sufix}.${file_ext}"
	}
	# Check if command exists
	function command_exists {
	command -v "$@" > /dev/null 2>&1
	}
	# Run command as root
	function as_root()
	{
	CMD_TO_EVALUATE="$*"
	CURRENT_USER_ID="$(id -u)"
	EFECTIVE_USER_ID="${EUID:-$CURRENT_USER_ID}"
	AS_ROOT="/bin/bash -c"

	if [ "${EFECTIVE_USER_ID}" -ne 0 ]; then
	if command_exists sudo; then
	AS_ROOT="sudo -E /bin/bash -c"
	elif command_exists su; then
	AS_ROOT="su -c"
	else
	log_error "This command must be run as root [EUID=0] ${CMD_TO_EVALUATE[*]}."
	log_error "- current [EUID=${EFECTIVE_USER_ID}]."
	log_error "- 'sudo' nor 'su' commands were found in PATH."
	log_error "Re-run the script as sudo or install sudo pkg."
	exit 1
	fi
	fi
	$AS_ROOT "${CMD_TO_EVALUATE[*]}"
	}
	# GitHub API call
	function github_api_call() {
	url=$1
	shift
	GITHUB_API_URL=https://api.github.com
	INPUT_OWNER=$(echo "${url#"${GITHUB_API_URL}/repos/"}" \| cut -f1 -d'/')
	INPUT_REPO=$(echo "${url#"${GITHUB_API_URL}/repos/"}" \| cut -f2 -d'/')
	API_SUBPATH="${url#"${GITHUB_API_URL}/repos/${INPUT_OWNER}/${INPUT_REPO}/"}"
	if [ -z "${INPUT_GITHUB_TOKEN}" ]; then
	echo >&2 "Set the INPUT_GITHUB_TOKEN env variable first."
	return
	fi

	echo >&2 "GITHUB_API_URL=$GITHUB_API_URL"
	echo >&2 "INPUT_OWNER=$INPUT_OWNER"
	echo >&2 "INPUT_REPO=$INPUT_REPO"
	echo >&2 "API_SUBPATH=$API_SUBPATH"
	echo >&2 "curl --fail-with-body -sSL \"${GITHUB_API_URL}/repos/${INPUT_OWNER}/${INPUT_REPO}/${API_SUBPATH}\" -H \"Authorization: Bearer ${INPUT_GITHUB_TOKEN}\" -H 'Accept: application/vnd.github.v3+json' -H 'Content-Type: application/json' $*"

	if API_RESPONSE=$(curl --fail-with-body -sSL \
	"${GITHUB_API_URL}/repos/${INPUT_OWNER}/${INPUT_REPO}/${API_SUBPATH}" \
	-H "Authorization: Bearer ${INPUT_GITHUB_TOKEN}" \
	-H 'Accept: application/vnd.github.v3+json' \
	-H 'Content-Type: application/json' \
	"$@")
	then
	echo "${API_RESPONSE}"
	else
	echo >&2 "GitHub API call failed."
	echo >&2 "${API_RESPONSE}"
	return
	fi
	}

	# Print ASCII logo
	function print_logo()
	{
	[[ "${COLORS_ENABLED}" == 0 ]] && return 0;
	if [[ -z "$blue_code" ]]; then
	local blue_code=( 26 27 20 19 20 20 21 04 27 26 32 12 33 06 39 38 44 45 )
	fi
	local IFS
	local logo_string
	local colorized_logo_string
	IFS=$'\n\t'
	logo_string="$(cat <<- EOF
	.-----------------------------------------------------------.
	\| * . .. . * \|
	\| . . . . . . \|
	\| . . *:. . . \|
	\| . . . .. . . \|
	\| . . . . ... . . \|
	\| . . . . . . . . . \|
	\| . . . ... .. . . \|
	\| . . . *. . . \|
	\| :. . . \|
	\| . . . . \|
	\| . . . . ^ \|
	\| . .. :. . \| . . \|
	\|. ... . \| \|
	\| :. . . *. We are here. . \|
	\| . . *. \|
	.©-Intel-Corporation--------------------ascii-author-unknown.
	= =
	= 88 88 =
	= "" ,d 88 =
	= 88 88 88 =
	= 88 8b,dPPYba, MM88MMM ,adPPYba, 88 =
	= 88 88P' '"8a 88 a8P_____88 88 =
	= 88 88 88 88 8PP""""""" 88 =
	= 88 88 88 88, "8b, ,aa 88 =
	= 88 88 88 "Y888 '"Ybbd8"' 88 =
	= =
	=============================================================
	EOF
	)"

	colorized_logo_string=""
	for (( i=0; i<${#logo_string}; i++ ))
	do
	colorized_logo_string+="\e[38;05;${blue_code[$(( (i-(i/64)*64)/4 ))]}m"
	colorized_logo_string+="${logo_string:$i:1}"
	done;
	colorized_logo_string+='\e[m\n'

	echo -e "$colorized_logo_string" >&2
	}

	# Animate ASCII logo, one full sequence
	function print_logo_sequence()
	{
	set +x
	[[ "${COLORS_ENABLED}" == 0 ]] && return 0;
	local wait_between_frames="${1:-0}"
	local wait_cmd=""
	if [ ! "${wait_between_frames}" = "0" ]; then
	wait_cmd="sleep ${wait_between_frames}"
	fi

	blue_code_fixed=( 26 27 20 19 20 20 21 04 27 26 32 12 33 06 39 38 44 45 )
	size=${#blue_code_fixed[@]}
	for (( move=0; move<size; move++ ))
	do
	blue_code=()
	for (( i=move; i<size; i++ ))
	do
	blue_code+=("${blue_code_fixed[i]}")
	done
	for (( i=0; i<move; i++ ))
	do
	blue_code+=("${blue_code_fixed[i]}")
	done
	echo -en "\e[0;0H"
	print_logo
	${wait_cmd}
	done;
	}

	# Animate ASCII logo, number of sequences
	function print_logo_anim()
	{
	set +x
	[[ "${COLORS_ENABLED}" == 0 ]] && return 0;
	local number_of_sequences="${1:-2}"
	local wait_between_frames="${2:-0.025}"
	clear
	for (( pt=0; pt<number_of_sequences; pt++ ))
	do
	print_logo_sequence "${wait_between_frames}"
	done
	}

	# Detect if the script is being run on Ci/Jenkins infrastructure
	function detect_jenkins_environment() {
	local jenkins_indicators=0

	# Check for Jenkins-specific environment variables
	[ -n "$JENKINS_URL" ] && ((jenkins_indicators++))
	[ -n "$JENKINS_HOME" ] && ((jenkins_indicators++))
	[ -n "$BUILD_NUMBER" ] && ((jenkins_indicators++))
	[ -n "$JOB_NAME" ] && ((jenkins_indicators++))
	[ -n "$BUILD_URL" ] && ((jenkins_indicators++))
	[ -n "$WORKSPACE" ] && ((jenkins_indicators++))
	[ -n "$NODE_NAME" ] && ((jenkins_indicators++))
	[ -n "$EXECUTOR_NUMBER" ] && ((jenkins_indicators++))

	# Check for CI environment variable (generic CI indicator)
	[ "$CI" = "true" ] && ((jenkins_indicators++))

	# Return true if we found multiple indicators
	if [[ "${jenkins_indicators}" -gt 2 ]]; then
	echo 1
	else
	echo 0
	fi
	return 0
	}

	# Error handling with debug output
	function catch_error_print_debug() {
	local _last_command_height=""
	local -n _lineno="${1:-LINENO}"
	local -n _bash_lineno="${2:-BASH_LINENO}"
	local _last_command="${3:-${BASH_COMMAND}}"
	local _code="${4:-0}"
	local -a _output_array=()
	_last_command_height="$(wc -l <<<"${_last_command}")"

	_output_array+=(
	'---'
	"timestamp: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
	"lines_history: [${_lineno} ${_bash_lineno[*]}]"
	"function_trace: [${FUNCNAME[*]}]"
	"exit_code: ${_code}"
	)

	if [[ "${#BASH_SOURCE[@]}" -gt 1 ]]; then
	_output_array+=('source_trace:')
	for _item in "${BASH_SOURCE[@]}"; do
	_output_array+=(" - ${_item}")
	done
	else
	_output_array+=("source_trace: [${BASH_SOURCE[*]}]")
	fi

	if [[ "${_last_command_height}" -gt 1 ]]; then
	_output_array+=('last_command: ->')
	_output_array+=("${_last_command}")
	else
	_output_array+=("last_command: ${_last_command}")
	fi

	_output_array+=('---')
	log_error "${_output_array[*]}"
	}

	function trap_error_print_debug() {
	log_info "Setting trap for error handling"
	trap 'catch_error_print_debug "LINENO" "BASH_LINENO" "${BASH_COMMAND}" "${?}"; exit 1' SIGINT ERR
	log_info "Trap set successfully"
	}

	# GITHUB_CREDENTIALS="username:password"
	# URL construction: https://${GITHUB_CREDENTIALS}@github.com/${name}/archive/${version}.tar.gz
	# $1 - name
	# $2 - version
	# $3 - dest_dir
	function git_download_strip_unpack()
	{
	# Version can be commit sha or tag, examples:
	# version=d2515b90cc0ef651f6d0a6661d5a644490bfc3f3
	# version=refs/tags/v${JPEG_XS_VER}
	name="${1}"
	version="${2}"
	dest_dir="${3}"
	filename="$(get_filename "${version}")"
	[ -n "${GITHUB_CREDENTIALS}" ] && creds="${GITHUB_CREDENTIALS}@" \|\| creds=""

	mkdir -p "${dest_dir}"
	curl -Lf "https://${creds}github.com/${name}/archive/${version}.tar.gz" -o "${dest_dir}/${filename}.tar.gz"
	tar -zx --strip-components=1 -C "${dest_dir}" -f "${dest_dir}/${filename}.tar.gz"
	rm -f "${dest_dir}/${filename}.tar.gz"
	}

	# Downloads and strip unpack a file from URL ($1) to a target directory ($2)
	# $1 - URL to download
	# $2 - destination directory to strip unpack the tar.gz
	function wget_download_strip_unpack()
	{
	local filename
	local source_url="${1}"
	local dest_dir="${2}"
	filename="$(get_filename "${source_url}")"
	[ -n "${GITHUB_CREDENTIALS}" ] && creds="${GITHUB_CREDENTIALS}@" \|\| creds=""

	mkdir -p "${dest_dir}"
	curl -Lf "${source_url}" -o "${dest_dir}/${filename}.tar.gz"
	tar -zx --strip-components=1 -C "${dest_dir}" -f "${dest_dir}/${filename}.tar.gz"
	rm -f "${dest_dir}/${filename}.tar.gz"
	}

	# Example usage:
	# PM="$(setup_package_manager)" && \
	# $PM install python3
	function setup_package_manager()
	{
	TIBER_USE_PM="${PM:-$1}"
	if [[ -x "$(command -v "$TIBER_USE_PM")" ]]; then
	export PM="${TIBER_USE_PM}"
	elif [[ -x "$(command -v yum)" ]]; then
	export PM='yum'
	elif [[ -x "$(command -v dnf)" ]]; then
	export PM='dnf'
	elif [[ -x "$(command -v apt-get)" ]]; then
	export PM='apt-get'
	elif [[ -x "$(command -v apt)" ]]; then
	export PM='apt'
	else
	log_error "No known pkg manager found. Try to re-run with variable, example:"
	log_error "export PM=\"apt\""
	return 1
	fi
	log_info "Setting pkg manager to ${PM}."
	echo "${PM}"
	return 0
	}

	# Setup build dir and ffmpeg version/directory.
	# FFMPEG_VER taken from environment or forced by 1st parameter
	# Exports FFMPEG_DIR and FFMPEG_VER
	function lib_setup_ffmpeg_dir_and_version()
	{
	FFMPEG_VER="${1:-$FFMPEG_VER}"
	FFMPEG_7_0_DIR="${FFMPEG_7_0_DIR:-ffmpeg-7-0}"
	FFMPEG_6_1_DIR="${FFMPEG_6_1_DIR:-ffmpeg-6-1}"

	if [[ "${FFMPEG_VER}" == "7.0" ]]; then
	FFMPEG_SUB_DIR="${FFMPEG_7_0_DIR}"
	elif [[ "${FFMPEG_VER}" == "6.1" ]]; then
	FFMPEG_SUB_DIR="${FFMPEG_6_1_DIR}"
	else
	log_error "Unsupported version of FFmpeg == '${FFMPEG_VER}'."
	log_error "Try again, choose one of '7.0', '6.1'."
	exit 2
	fi
	export FFMPEG_VER
	export FFMPEG_SUB_DIR
	}
	# Execute command locally or via SSH.
	# Wrapper/helper for command lunching on remote machines
	function exec_command()
	{
	# One of: yes\|no\|accept-new
	SSH_STRICT_HOST_KEY_CHECKING="accept-new"
	SSH_CMD="ssh -oStrictHostKeyChecking=${SSH_STRICT_HOST_KEY_CHECKING} -t -o"

	local values_returned=""
	local user_at_address=""
	[[ "$#" -eq "2" ]] && user_at_address="${2}"
	[[ "$#" -eq "3" ]] && user_at_address="${3}@${2}"

	if [ "$#" -eq "1" ]; then
	values_returned="$(eval "${1}")"
	elif [[ "$#" -eq "2" ]] \|\| [[ "$#" -eq "3" ]]; then
	values_returned="$($SSH_CMD "RemoteCommand=eval \"${1}\"" "${user_at_address}" 2>/dev/null)"
	else
	log_error "Wrong arguments for exec_command(). Valid number is one of [1 2 3], got $#"
	return 1
	fi

	if [ -z "$values_returned" ]; then
	log_error "Unable to collect results or results are empty."
	return 1
	else
	echo "${values_returned}"
	return 0
	fi
	}

	# Get system hostname
	function get_hostname() {
	exec_command 'hostname' "$@"
	}

	# Get Intel NIC devices
	function get_intel_nic_device() {
	exec_command "lspci \| grep 'Intel Corporation.*\(810\\|X722\)'" "$@"
	}

	# Get default route NIC
	function get_default_route_nic() {
	exec_command "ip -json r show default \| jq '.[0].dev' -r" "$@"
	}

	# Get CPU architecture
	function get_cpu_arch() {
	local arch=""
	if ! arch="$(exec_command 'cat /sys/devices/cpu/caps/pmu_name' "$@")"; then echo "Got: $arch" && return 1; fi

	case $arch in
	icelake)
	log_info "Xeon IceLake CPU (icx)" 1>&2
	echo "icx"
	;;
	sapphire_rapids)
	log_info "Xeon Sapphire Rapids CPU (spr)" 1>&2
	echo "spr"
	;;
	skylake)
	log_info "Xeon SkyLake"
	echo "skl"
	;;
	*)
	log_error "Unsupported architecture: ${arch}. Please edit the script or setup the architecture manually."
	return 1
	;;
	esac
	return 0
	}

	function debian_install_docker()
	{
	export DEBIAN_FRONTEND="noninteractive"
	export TZ="${TZ:-Europe/Warsaw}"
	apt-get update --fix-missing -y
	apt-get install -y --no-install-recommends \
	ca-certificates \
	sudo \
	curl \
	unzip \
	vim \
	apt-transport-https \
	software-properties-common \
	jq \
	tar \
	apt-utils \
	libssl3 \
	gnupg
	curl -k -fsSL "https://download.docker.com/linux/ubuntu/gpg" -o "/etc/apt/keyrings/docker.asc" && \
	echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" > /etc/apt/sources.list.d/docker.list
	apt-key update && \
	apt-get update --fix-missing && \
	apt-get install -y --no-install-recommends \
	docker-ce \
	docker-ce-cli \
	containerd.io \
	docker-buildx-plugin \
	docker-compose-plugin
	}

	function debian_configure_docker()
	{
	export DEBIAN_FRONTEND="noninteractive"
	export TZ="${TZ:-Europe/Warsaw}"

	mkdir -p /etc/docker
	if [[ ! -f /etc/docker/daemon.json ]]; then
	echo '{"insecure-registries": ["ger-is-registry.caas.intel.com"]}' > /etc/docker/daemon.json
	else
	OLD_REGISTRY="$(cat /etc/docker/daemon.json)"
	jq '. \| ."insecure-registries" = (."insecure-registries" + ["ger-is-registry.caas.intel.com"] \| unique)' <(echo "$OLD_REGISTRY") > /etc/docker/daemon.json
	fi
	echo '[Service]
	Environment="http_proxy=HHTP PROXY"
	Environment="no_proxy=127.0.0.1,127.0.0.0/8,134.134.0.0/16,10.0.0.0/8,192.168.0.0/16,172.16.0.0/12,localhost,intel.com,.intel.com,.local,longhorn-system,cattle-system,harvester-system"
	Environment="NO_PROXY=127.0.0.1,127.0.0.0/8,134.134.0.0/16,10.0.0.0/8,192.168.0.0/16,172.16.0.0/12,localhost,intel.com,.intel.com,.local,longhorn-system,cattle-system,harvester-system"
	' > /etc/systemd/system/docker.service.d/intel-proxy.conf
	systemctl daemon-reload
	systemctl restart docker
	}

	function prepare_docker_templates()
	{
	log_info "Preparing docker templates..."
	dockerTemplate='#!/bin/bash
	docker run --rm --init -it \
	--entrypoint=/bin/bash \
	--volume @REPOSITORY_DIR@:/build_dir \
	-w /build_dir \
	--name make-ddk \
	tools/docker_ddk:@DOCKER_TAG@ -c "make $@"
	'
	dockerTemplate="${dockerTemplate//@REPOSITORY_DIR@/${REPOSITORY_DIR}}"
	echo "${dockerTemplate//@DOCKER_TAG@/90GA}" > /usr/local/bin/make-ddk9
	echo "${dockerTemplate//@DOCKER_TAG@/80u3}" > /usr/local/bin/make-ddk8
	echo "${dockerTemplate//@DOCKER_TAG@/70}" > /usr/local/bin/make-ddk7
	chmod a+x /usr/local/bin/make-ddk*
	log_info "Path agnostic docker wrappers available:"
	log_info " make-ddk9"
	log_info " make-ddk8"
	log_info " make-ddk7"
	log_info ""
	log_info "example:"
	log_info " make-ddk9"
	log_info " make-ddk9 bazel"
	log_success "Done. Finished prepare_docker_templates()"
	}
	# For PowerShell copy and paste:
	Invoke-Expression (Invoke-RestMethod -Uri "https://gist.githubusercontent.com/Mionsz/bc9c1a71587ca43b147d75d8feb73088/raw/3e04c112921939b6a32173ac52b4b56d99c71cdd/common.ps1"); Print-LogoAnim

	# For Bash script copy and paste:
	eval ". $(curl https://gist.githubusercontent.com/Mionsz/bc9c1a71587ca43b147d75d8feb73088/raw/3e04c112921939b6a32173ac52b4b56d99c71cdd/common.sh); print_logo_anim"