Jamie-BitFlight

bash-52-features

Bash 5.2 release features and improvements with practical examples. Use when working with Bash 5.2 features, variable handling enhancements, readline improvements, or when user asks about Bash 5.2 changes, new features, or version-specific capabilities.

Jamie-BitFlight 49 8 Updated 3mo ago
GitHub

Install

npx skillscat add jamie-bitflight/claude-skills/bash-52-features

Install via the SkillsCat registry.

SKILL.md

Bash 5.2 Features and Improvements

Released in September 2022, Bash 5.2 brought enhancements to variable handling, readline integration, array support, and numerous bug fixes.

Variable Handling Enhancements

Improved Readonly and Unset Variable Behavior

Better error messages and more consistent behavior:

# More informative error messages for readonly variables
readonly CONFIG_PATH="/etc/app/config"

# Attempting to modify generates clearer error
CONFIG_PATH="/tmp/config"  # bash: CONFIG_PATH: readonly variable

# Better handling of unset variables with set -u
set -u

# Checking before use is now more reliable
if [[ -n "${OPTIONAL_VAR:-}" ]]; then
    echo "Variable is set: ${OPTIONAL_VAR}"
else
    echo "Variable is not set"
fi

# Practical example: Configuration validation
validate_config() {
    local -a required_vars=("DATABASE_URL" "API_KEY" "LOG_DIR")
    local var

    for var in "${required_vars[@]}"; do
        if [[ -z "${!var:-}" ]]; then
            printf 'Error: Required variable %s is not set\n' "${var}" >&2
            return 1
        fi
    done

    echo "All required configuration variables are set"
}

export DATABASE_URL="postgres://localhost/db"
export API_KEY="secret123"
export LOG_DIR="/var/log/app"

validate_config

Nameref Improvements

Enhanced reference variable handling:

# Improved nameref with arrays and special variables
process_array() {
    local -n arr_ref="${1}"  # Create nameref to array
    local item

    echo "Processing array '${1}':"
    for item in "${arr_ref[@]}"; do
        printf '  - %s\n' "${item}"
    done
}

my_array=("apple" "banana" "cherry")
process_array my_array

# Practical example: Generic array manipulation
array_push() {
    local -n array_ref="${1}"
    shift
    array_ref+=("$@")
}

array_pop() {
    local -n array_ref="${1}"
    local last_index=$((${#array_ref[@]} - 1))

    if [[ ${last_index} -ge 0 ]]; then
        unset 'array_ref[last_index]'
        return 0
    fi
    return 1
}

stack=()
array_push stack "first" "second" "third"
echo "Stack: ${stack[*]}"
array_pop stack
echo "After pop: ${stack[*]}"

Readline 8.2 Integration

Significant improvements to command-line editing:

Enhanced Completion and History

# Better completion behavior in ~/.inputrc
# Skip completions for invisible characters
set skip-completed-text on

# Enhanced history search
# Cycle through history with prefix matching
bind '"\e[A": history-search-backward'  # Up arrow
bind '"\e[B": history-search-forward'   # Down arrow

# Improved completion coloring
set colored-stats on
set colored-completion-prefix on

# Better handling of long completions
set completion-display-width 0  # Use full terminal width

Input Handling Improvements

# More robust input reading in scripts
read_input() {
    local prompt="${1}"
    local var_name="${2}"
    local default="${3:-}"
    local input

    if [[ -n "${default}" ]]; then
        read -r -e -p "${prompt} [${default}]: " -i "${default}" input
    else
        read -r -e -p "${prompt}: " input
    fi

    printf -v "${var_name}" '%s' "${input}"
}

# Example usage
read_input "Enter hostname" hostname "localhost"
read_input "Enter port" port "8080"
echo "Connecting to ${hostname}:${port}"

Array Support Enhancements

Better Indexed Array Operations

# Improved array slicing and expansion
array=(10 20 30 40 50 60 70 80 90)

# Slice notation is more reliable
echo "First 3: ${array[@]:0:3}"      # 10 20 30
echo "Last 3: ${array[@]: -3}"       # 70 80 90
echo "Middle: ${array[@]:3:3}"       # 40 50 60

# Practical example: Batch processing
process_batch() {
    local -a items=("$@")
    local batch_size=3
    local i

    for ((i = 0; i < ${#items[@]}; i += batch_size)); do
        local -a batch=("${items[@]:i:batch_size}")
        printf 'Processing batch %d: %s\n' \
            "$((i / batch_size + 1))" \
            "${batch[*]}"

        # Process batch items...
        for item in "${batch[@]}"; do
            echo "  Processing: ${item}"
        done
    done
}

files=(file1 file2 file3 file4 file5 file6 file7)
process_batch "${files[@]}"

Associative Array Improvements

# More reliable key iteration and value access
declare -A user_data=(
    [name]="John Doe"
    [email]="john@example.com"
    [role]="admin"
    [active]="true"
)

# Improved iteration over keys and values
echo "User Information:"
for key in "${!user_data[@]}"; do
    printf '  %-10s: %s\n' "${key}" "${user_data[${key}]}"
done

# Practical example: Cache implementation
declare -A cache=()
declare -A cache_timestamps=()
readonly CACHE_TTL=300  # 5 minutes

cache_set() {
    local key="${1}"
    local value="${2}"
    cache["${key}"]="${value}"
    cache_timestamps["${key}"]="${EPOCHSECONDS}"
}

cache_get() {
    local key="${1}"
    local timestamp="${cache_timestamps[${key}]:-0}"
    local age=$((EPOCHSECONDS - timestamp))

    if [[ ${age} -lt ${CACHE_TTL} ]] && [[ -n "${cache[${key}]:-}" ]]; then
        echo "${cache[${key}]}"
        return 0
    fi
    return 1
}

cache_set "user:123" "John Doe"
sleep 1
if result=$(cache_get "user:123"); then
    echo "Cache hit: ${result}"
fi

Parameter Expansion Enhancements

Improved Pattern Matching

# More reliable pattern substitution
text="Hello, World! Hello, Universe!"

# Case-insensitive pattern matching (enhanced reliability)
shopt -s nocasematch
if [[ "${text}" =~ hello ]]; then
    echo "Match found (case-insensitive)"
fi
shopt -u nocasematch

# Practical example: String sanitization
sanitize_filename() {
    local filename="${1}"

    # Remove leading/trailing whitespace
    filename="${filename#"${filename%%[![:space:]]*}"}"
    filename="${filename%"${filename##*[![:space:]]}"}"

    # Replace invalid characters with underscore
    filename="${filename//[^a-zA-Z0-9._-]/_}"

    # Remove consecutive underscores
    while [[ "${filename}" =~ __ ]]; do
        filename="${filename//__/_}"
    done

    echo "${filename}"
}

echo "$(sanitize_filename '  My File (2023)!.txt  ')"  # My_File_2023_.txt

Enhanced Substring Operations

# More consistent substring extraction
text="2023-09-15 14:30:00"

# Extract components
year="${text:0:4}"
month="${text:5:2}"
day="${text:8:2}"
hour="${text:11:2}"
minute="${text:14:2}"

printf 'Date: %s/%s/%s Time: %s:%s\n' \
    "${year}" "${month}" "${day}" "${hour}" "${minute}"

# Practical example: URL parsing
parse_url() {
    local url="${1}"
    local protocol scheme host port path

    # Extract protocol
    protocol="${url%%://*}"

    # Remove protocol
    url="${url#*://}"

    # Extract host and port
    if [[ "${url}" =~ ^([^/:]+)(:([0-9]+))?(/.*)?$ ]]; then
        host="${BASH_REMATCH[1]}"
        port="${BASH_REMATCH[3]:-80}"
        path="${BASH_REMATCH[4]:-/}"
    fi

    printf 'Protocol: %s\nHost: %s\nPort: %s\nPath: %s\n' \
        "${protocol}" "${host}" "${port}" "${path}"
}

parse_url "https://example.com:8443/api/v1/users"

Security Fixes

Bash 5.2 includes several security-related fixes:

  • Improved handling of environment variable inheritance
  • Better validation of variable names
  • Enhanced protection against command injection in certain contexts
# Safer environment variable handling
export_safe() {
    local var_name="${1}"
    local var_value="${2}"

    # Validate variable name
    if [[ "${var_name}" =~ ^[a-zA-Z_][a-zA-Z0-9_]*$ ]]; then
        printf -v "${var_name}" '%s' "${var_value}"
        export "${var_name}"
    else
        echo "Invalid variable name: ${var_name}" >&2
        return 1
    fi
}

export_safe "MY_VAR" "safe_value"
export_safe "123_INVALID" "value"  # Will fail

Performance Improvements

  • Faster variable expansion in complex scenarios
  • Optimized array operations for large arrays
  • Reduced memory footprint for associative arrays
  • Improved efficiency in pattern matching
# Benchmark example showing improved performance
benchmark_arrays() {
    local -a array
    local i
    local start end

    start="${EPOCHREALTIME}"

    # Large array operations are faster in 5.2
    for ((i = 0; i < 10000; i++)); do
        array+=("item_${i}")
    done

    end="${EPOCHREALTIME}"

    printf 'Array population time: %.4f seconds\n' \
        "$(awk "BEGIN {print ${end} - ${start}}")"

    echo "Array size: ${#array[@]}"
}

benchmark_arrays

Compatibility Notes

Upgrading from Bash 5.1

Generally backward compatible, but note:

  • Some edge cases in variable expansion have changed behavior
  • Error messages are more detailed (may affect scripts parsing stderr)
  • Readline behavior changes might affect interactive scripts

Version Check

# Check for Bash 5.2 features
if [[ "${BASH_VERSINFO[0]}" -eq 5 ]] && [[ "${BASH_VERSINFO[1]}" -ge 2 ]]; then
    echo "Bash 5.2+ features available"
    # Use enhanced features
elif [[ "${BASH_VERSINFO[0]}" -ge 6 ]]; then
    echo "Bash 6.0+ detected"
else
    echo "Bash version too old for 5.2 features"
fi

Migration Tips

From Bash 5.1 to 5.2

Most scripts work without modification, but consider:

# Take advantage of improved error messages
set -euo pipefail

error_handler() {
    local line="${1}"
    local command="${2}"
    echo "Error in command '${command}' at line ${line}" >&2
    exit 1
}

trap 'error_handler ${LINENO} "${BASH_COMMAND}"' ERR

# Use enhanced array operations
declare -a data
mapfile -t data < <(some_command)

# Process with improved iteration
for item in "${data[@]}"; do
    # Bash 5.2's improved handling makes this more reliable
    process_item "${item}"
done

References

Additional Resources

For broader Bash development patterns and best practices, see: