@sebastienrousseau/dotfiles 0.2.469 → 0.2.499

package/dist/lib/functions/apihealth.sh

@@ -1,277 +0,0 @@
-#!/usr/bin/env bash
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - apihealth
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# apihealth - API Health Check Script
-#
-# This script checks the health/status of one or multiple APIs by sending HTTP
-# requests to specified endpoints. It supports different HTTP methods, allows
-# specifying expected HTTP status codes, and accepts custom HTTP headers.
-#
-# Usage:
-#   apihealth [OPTIONS] URL [URL ...]
-#
-# Options:
-#   -h, --help            Show this help message and exit
-#   -v, --version         Show script version and exit
-#   -m, --method METHOD   Specify HTTP method (default: GET)
-#   -e, --expect STATUS   Specify expected HTTP status code (default: 200)
-#   -H, --header HEADER   Specify HTTP header (can be used multiple times)
-#   -t, --timeout SECONDS Specify request timeout in seconds (default: 10)
-#
-# Examples:
-#   apihealth https://api.example.com/health
-#   apihealth -m POST -e 201 https://api.example.com/create
-#   apihealth --method GET --expect 204 https://api.example.com/status1 https://api.example.com/status2
-#   apihealth -H "Authorization: Bearer token123" -H "Content-Type: application/json" https://api.example.com/secure
-#   apihealth -t 5 https://api.example.com/health
-#
-################################################################################
-
-# Constants
-APIHEALTH_SCRIPT_NAME="apihealth"
-APIHEALTH_VERSION="0.1"
-
-# Default values
-DEFAULT_METHOD="GET"
-DEFAULT_EXPECT_STATUS=200
-DEFAULT_TIMEOUT=10
-
-# Initialize headers array
-HEADERS=()
-
-#######################################
-# Print usage information.
-# Returns:
-#   0 if help was shown
-#######################################
-print_help() {
-    cat << EOF
-Usage: $APIHEALTH_SCRIPT_NAME [OPTIONS] URL [URL ...]
-
-Options:
-  -h, --help                Show this help message and exit
-  -v, --version             Show script version and exit
-  -m, --method METHOD       Specify HTTP method (default: GET)
-  -e, --expect STATUS       Specify expected HTTP status code (default: 200)
-  -H, --header HEADER       Specify HTTP header (can be used multiple times)
-  -t, --timeout SECONDS     Specify request timeout in seconds (default: 10)
-
-Examples:
-  $APIHEALTH_SCRIPT_NAME https://api.example.com/health
-  $APIHEALTH_SCRIPT_NAME -m POST -e 201 https://api.example.com/create
-  $APIHEALTH_SCRIPT_NAME -H "Authorization: Bearer token123" https://api.example.com/secure
-  $APIHEALTH_SCRIPT_NAME -t 5 https://api.example.com/health
-EOF
-    return 0
-}
-
-
-#######################################
-# Print version information.
-# Returns:
-#   0 if version was shown
-#######################################
-print_version() {
-    echo "$APIHEALTH_SCRIPT_NAME version $APIHEALTH_VERSION"
-    return 0
-}
-
-#######################################
-# Check if required dependencies are installed.
-# Returns:
-#   1 if dependencies are missing
-#######################################
-check_dependencies() {
-    if ! command -v curl >/dev/null 2>&1; then
-        echo -e "\e[31m[ERROR]\e[0m Required command 'curl' is not installed."
-        return 1
-    fi
-    return 0
-}
-
-#######################################
-# Check API health/status endpoints.
-# Arguments:
-#   $1 - URL
-#   $2 - HTTP Method
-#   $3 - Expected HTTP Status Code
-#   $4 - Timeout in seconds
-# Returns:
-#   0 if health check passed, 1 if failed
-#######################################
-apihealthealth() {
-    local url="$1"
-    local method="${2:-$DEFAULT_METHOD}"
-    local expect_status="${3:-$DEFAULT_EXPECT_STATUS}"
-    local timeout="${4:-$DEFAULT_TIMEOUT}"
-    local curl_headers=()
-
-    echo -e "[INFO] Testing API health: $url"
-    echo -e "[INFO] Method: $method, Expected Status: $expect_status, Timeout: ${timeout}s"
-
-    # Build curl headers array
-    if [[ ${#HEADERS[@]} -gt 0 ]]; then
-        for header in "${HEADERS[@]}"; do
-            curl_headers+=(-H "$header")
-        done
-    fi
-
-    # Perform the HTTP request
-    local response
-    if [[ ${#curl_headers[@]} -gt 0 ]]; then
-        response=$(curl -s -o /dev/null -w "%{http_code}" \
-            -X "$method" \
-            --max-time "$timeout" \
-            "${curl_headers[@]}" \
-            "$url" 2>/dev/null || echo "000")
-    else
-        response=$(curl -s -o /dev/null -w "%{http_code}" \
-            -X "$method" \
-            --max-time "$timeout" \
-            "$url" 2>/dev/null || echo "000")
-    fi
-
-    if [[ "$response" -eq "$expect_status" ]]; then
-        echo -e "\e[32m[SUCCESS]\e[0m API is healthy (Status: $response)"
-        return 0
-    elif [[ "$response" -eq "000" ]]; then
-        echo -e "\e[31m[ERROR]\e[0m API health check failed (No response)"
-        return 1
-    else
-        echo -e "\e[31m[ERROR]\e[0m API health check failed (Status: $response)"
-        return 1
-    fi
-}
-
-#######################################
-# Parse command-line arguments.
-# Arguments:
-#   Command line arguments
-# Returns:
-#   0 if parsing successful, 1 if failed
-#######################################
-parse_arguments() {
-    # Initialize variables
-    METHOD="$DEFAULT_METHOD"
-    EXPECT_STATUS="$DEFAULT_EXPECT_STATUS"
-    TIMEOUT="$DEFAULT_TIMEOUT"
-    URLS=()
-    HEADERS=()
-
-    while [[ $# -gt 0 ]]; do
-        case "$1" in
-            -h|--help)
-                print_help
-                return 2  # Special return code for help/version display
-                ;;
-            -v|--version)
-                print_version
-                return 2  # Special return code for help/version display
-                ;;
-            -m|--method)
-                if [[ -n "${2:-}" && ! "$2" =~ ^- ]]; then
-                    METHOD="$2"
-                    shift 2
-                else
-                    echo -e "\e[31m[ERROR]\e[0m --method requires a non-empty option argument."
-                    return 1
-                fi
-                ;;
-            -e|--expect)
-                if [[ -n "${2:-}" && ! "$2" =~ ^- ]]; then
-                    EXPECT_STATUS="$2"
-                    shift 2
-                else
-                    echo -e "\e[31m[ERROR]\e[0m --expect requires a non-empty option argument."
-                    return 1
-                fi
-                ;;
-            -H|--header)
-                if [[ -n "${2:-}" && ! "$2" =~ ^- ]]; then
-                    if [[ ! "$2" =~ ^[^:]+:[[:space:]]*[^[:space:]]+.*$ ]]; then
-                        echo -e "\e[31m[ERROR]\e[0m Invalid header format: '$2'. Expected 'Key: Value'"
-                        return 1
-                    fi
-                    HEADERS+=("$2")
-                    shift 2
-                else
-                    echo -e "\e[31m[ERROR]\e[0m --header requires a non-empty option argument."
-                    return 1
-                fi
-                ;;
-            -t|--timeout)
-                if [[ -n "${2:-}" && ! "$2" =~ ^- ]]; then
-                    if ! [[ "$2" =~ ^[0-9]+$ ]]; then
-                        echo -e "\e[31m[ERROR]\e[0m Timeout must be a positive integer."
-                        return 1
-                    fi
-                    TIMEOUT="$2"
-                    shift 2
-                else
-                    echo -e "\e[31m[ERROR]\e[0m --timeout requires a non-empty option argument."
-                    return 1
-                fi
-                ;;
-            -*)
-                echo -e "\e[31m[ERROR]\e[0m Unknown option: $1"
-                print_help
-                return 1
-                ;;
-            *)
-                URLS+=("$1")
-                shift
-                ;;
-        esac
-    done
-
-    # Validate URLs provided
-    if [[ ${#URLS[@]} -eq 0 ]]; then
-        echo -e "\e[31m[ERROR]\e[0m No URLs provided."
-        print_help
-        return 1
-    fi
-
-    return 0
-}
-
-#######################################
-# Main execution function.
-# Arguments:
-#   Command line arguments
-# Returns:
-#   0 if all checks passed, 1 if any failed
-#######################################
-apihealth_main() {
-    if ! check_dependencies; then
-        return 1
-    fi
-
-    if ! parse_arguments "$@"; then
-        return 1
-    fi
-
-    local overall_status=0
-
-    for url in "${URLS[@]}"; do
-        if ! apihealthealth "$url" "$METHOD" "$EXPECT_STATUS" "$TIMEOUT"; then
-            overall_status=1
-        fi
-        echo "----------------------------------------"
-    done
-
-    if [[ "$overall_status" -eq 0 ]]; then
-        echo -e "\e[32mAll API health checks passed successfully.\e[0m"
-    else
-        echo -e "\e[31mSome API health checks failed.\e[0m"
-    fi
-
-    return "$overall_status"
-}
-
-# Define the function for sourcing
-apihealth() {
-    apihealth_main "$@"
-}

package/dist/lib/functions/apilatency.sh

@@ -1,157 +0,0 @@
-#!/usr/bin/env bash
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - apilatency
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# apilatency - API Latency / Response Time Monitor
-#
-# This script monitors the response time of an API endpoint over a specified
-# number of requests and interval.
-#
-# Usage:
-#   apilatency URL [COUNT] [INTERVAL]
-#
-# Options:
-#   -h, --help            Show this help message and exit
-#   -v, --version         Show script version and exit
-#
-# Examples:
-#   apilatency https://api.example.com 10 1
-#   apilatency https://api.example.com 20 0.5
-#
-################################################################################
-
-# Constants
-APILATENCY_SCRIPT_NAME="apilatency"
-APILATENCY_VERSION="0.0.1"
-
-#######################################
-# Print usage information.
-#######################################
-apilatency_print_help() {
-    cat << EOF
-Usage: $APILATENCY_SCRIPT_NAME URL [COUNT] [INTERVAL]
-
-Arguments:
-  URL                 The API endpoint to monitor
-  COUNT               Number of requests to perform (default: 10)
-  INTERVAL            Delay between requests in seconds (default: 1)
-
-Options:
-  -h, --help            Show this help message and exit
-  -v, --version         Show script version and exit
-
-Examples:
-  $APILATENCY_SCRIPT_NAME https://api.example.com 10 1
-  $APILATENCY_SCRIPT_NAME https://api.example.com 20 0.5
-EOF
-}
-
-#######################################
-# Print version information.
-#######################################
-apilatency_print_version() {
-    echo "$APILATENCY_SCRIPT_NAME version $APILATENCY_VERSION"
-}
-
-#######################################
-# Monitor API response time.
-#######################################
-apilatency_monitor() {
-    local url="$1"
-    local count="${2:-10}"
-    local interval="${3:-1}"
-    
-    echo -e "[INFO] Monitoring API latency for $url"
-    echo -e "[INFO] Total Requests: $count, Delay Between Requests: $interval seconds"
-    echo "Time,Response_Time"
-    
-    for ((i = 1; i <= count; i++)); do
-        local start=$(date +%s.%N)
-        curl -s -o /dev/null "$url"
-        local end=$(date +%s.%N)
-        local latency=$(echo "$end - $start" | bc)
-        echo "$(date '+%H:%M:%S'),$latency"
-        sleep "$interval"
-    done
-    
-    echo -e "\e[32m[SUCCESS]\e[0m Latency monitoring completed."
-}
-
-#######################################
-# Parse command-line arguments.
-#######################################
-apilatency_parse_arguments() {
-    # First argument handling
-    case "${1:-}" in
-        -h|--help)
-            apilatency_print_help
-            return 2
-            ;;
-        -v|--version)
-            apilatency_print_version
-            return 2
-            ;;
-        "")
-            echo -e "\e[31m[ERROR]\e[0m Missing required URL argument."
-            apilatency_print_help
-            return 1
-            ;;
-    esac
-
-    # Store arguments
-    local url="$1"
-    local count="${2:-10}"
-    local interval="${3:-1}"
-
-    # Validate URL
-    if [[ ! "$url" =~ ^https?:// ]]; then
-        echo -e "\e[31m[ERROR]\e[0m Invalid URL format. Must start with http:// or https://"
-        return 1
-    fi
-
-    # Validate count
-    if ! [[ "$count" =~ ^[0-9]+$ ]]; then
-        echo -e "\e[31m[ERROR]\e[0m COUNT must be a positive integer."
-        return 1
-    fi
-
-    # Validate interval
-    if ! [[ "$interval" =~ ^[0-9]+(\.[0-9]+)?$ ]]; then
-        echo -e "\e[31m[ERROR]\e[0m INTERVAL must be a positive number."
-        return 1
-    fi
-
-    # Export variables for use in main function
-    URL="$url"
-    COUNT="$count"
-    INTERVAL="$interval"
-    
-    return 0
-}
-
-#######################################
-# Main function.
-#######################################
-apilatency_main() {
-    apilatency_parse_arguments "$@"
-    local parse_result=$?
-    
-    case $parse_result in
-        0)  # Normal operation
-            apilatency_monitor "$URL" "$COUNT" "$INTERVAL"
-            ;;
-        2)  # Help or version was displayed
-            return 0
-            ;;
-        *)  # Error occurred
-            return 1
-            ;;
-    esac
-}
-
-# The main function that gets exported for use
-apilatency() {
-    apilatency_main "$@"
-}

package/dist/lib/functions/apiload.sh

@@ -1,165 +0,0 @@
-#!/usr/bin/env bash
-################################################################################
-# 🅳🅾🆃🅵🅸🅻🅴🆂 - apiload
-# Made with ♥ by Sebastien Rousseau
-# License: MIT
-#
-# apiload - API Load Testing Script
-#
-# This script performs basic load testing on a specified API endpoint using
-# default utilities available in macOS, Linux, or Windows environments. It allows
-# you to specify the number of total requests and the delay between requests.
-#
-# Usage:
-#   apiload URL [REQUESTS] [DELAY]
-#
-# Examples:
-#   apiload https://api.example.com 100 0.1
-#   apiload https://api.example.com 500 0.5
-#
-################################################################################
-
-# Constants
-APILOAD_SCRIPT_NAME="apiload"
-APILOAD_VERSION="0.0.1"
-
-#######################################
-# Print usage information.
-#######################################
-apiload_print_help() {
-    cat << EOF
-Usage: $APILOAD_SCRIPT_NAME URL [REQUESTS] [DELAY]
-
-Arguments:
-  URL                 The API endpoint to load test
-  REQUESTS            Number of total requests to perform (default: 100)
-  DELAY               Delay between requests in seconds (default: 0.1)
-
-Options:
-  -h, --help            Show this help message and exit
-  -v, --version         Show script version and exit
-
-Examples:
-  $APILOAD_SCRIPT_NAME https://api.example.com 100 0.1
-  $APILOAD_SCRIPT_NAME https://api.example.com 500 0.5
-EOF
-}
-
-#######################################
-# Print version information.
-#######################################
-apiload_print_version() {
-    echo "$APILOAD_SCRIPT_NAME version $APILOAD_VERSION"
-}
-
-#######################################
-# Perform API load testing.
-#######################################
-apiload_load_test() {
-    local url="$1"
-    local requests="${2:-100}"
-    local delay="${3:-0.1}"
-    
-    echo -e "[INFO] Running load test on $url"
-    echo -e "[INFO] Total Requests: $requests, Delay Between Requests: $delay seconds"
-    
-    local success_count=0
-    local fail_count=0
-    
-    for ((i = 1; i <= requests; i++)); do
-        response=$(curl -s -o /dev/null -w "%{http_code}" "$url")
-        if [[ "$response" -eq 200 ]]; then
-            echo -e "\e[32m[Request $i]\e[0m Success (HTTP 200)"
-            ((success_count++))
-        else
-            echo -e "\e[31m[Request $i]\e[0m Failed (HTTP $response)"
-            ((fail_count++))
-        fi
-        sleep "$delay"
-    done
-    
-    echo -e "\n[SUMMARY]"
-    echo -e "Total Requests: $requests"
-    echo -e "Successful: \e[32m$success_count\e[0m"
-    echo -e "Failed: \e[31m$fail_count\e[0m"
-    echo -e "Success Rate: $(( (success_count * 100) / requests ))%"
-    
-    echo -e "\n\e[32m[SUCCESS]\e[0m Load test completed."
-}
-
-#######################################
-# Parse command-line arguments.
-#######################################
-apiload_parse_arguments() {
-    # First argument handling
-    case "${1:-}" in
-        -h|--help)
-            apiload_print_help
-            return 2
-            ;;
-        -v|--version)
-            apiload_print_version
-            return 2
-            ;;
-        "")
-            echo -e "\e[31m[ERROR]\e[0m Missing required URL argument."
-            apiload_print_help
-            return 1
-            ;;
-    esac
-
-    # Store arguments
-    local url="$1"
-    local requests="${2:-100}"
-    local delay="${3:-0.1}"
-
-    # Validate URL
-    if [[ ! "$url" =~ ^https?:// ]]; then
-        echo -e "\e[31m[ERROR]\e[0m Invalid URL format. Must start with http:// or https://"
-        return 1
-    fi
-
-    # Validate requests
-    if ! [[ "$requests" =~ ^[0-9]+$ ]]; then
-        echo -e "\e[31m[ERROR]\e[0m REQUESTS must be a positive integer."
-        return 1
-    fi
-
-    # Validate delay
-    if ! [[ "$delay" =~ ^[0-9]+(\.[0-9]+)?$ ]]; then
-        echo -e "\e[31m[ERROR]\e[0m DELAY must be a positive number."
-        return 1
-    fi
-
-    # Export variables for use in main function
-    URL="$url"
-    REQUESTS="$requests"
-    DELAY="$delay"
-    
-    return 0
-}
-
-#######################################
-# Main function.
-#######################################
-apiload_main() {
-    apiload_parse_arguments "$@"
-    local parse_result=$?
-    
-    case $parse_result in
-        0)  # Normal operation
-            apiload_load_test "$URL" "$REQUESTS" "$DELAY"
-            ;;
-        2)  # Help or version was displayed
-            return 0
-            ;;
-        *)  # Error occurred
-            return 1
-            ;;
-    esac
-}
-
-# The apiload_main function that gets exported for use
-apiload() {
-    apiload_main "$@"
-}