Check S3 Bucket Existence

1
#######################################
2
# Prints a fun ASCII banner header.
3
# Globals:
4
#   CYAN
5
#   NC
6
# Arguments:
7
#   None
8
# Outputs:
9
#   Writes header text to stdout.
10
#######################################
11
function print_fun() {
12
  echo -e "${CYAN}"
13
  echo "╭──────────────────────────────╮"
14
  echo "│  ☁️  S3 Bucket Checker Bash  │"
15
  echo "╰──────────────────────────────╯"
16
  echo -e "${NC}"
17
}

1
#######################################
2
# Prints a log message with timestamp and log level.
3
# Globals:
4
#   CYAN, GREEN, RED, NC
5
# Arguments:
6
#   $1 - Log level (INFO, SUCCESS, ERROR)
7
#   $2 - Log message
8
# Outputs:
9
#   Writes formatted log message to stdout.
10
#######################################
11
function log() {
12
  local type="$1"
13
  local message="$2"
14
  local timestamp
15
  timestamp=$(date "+%Y-%m-%d %H:%M:%S")
16

17
  case "$type" in
18
    INFO)
19
      echo -e "${CYAN}[${timestamp}] [INFO]:${NC} $message"
20
      ;;
21
    SUCCESS)
22
      echo -e "${GREEN}[${timestamp}] [SUCCESS]:${NC} $message"
23
      ;;
24
    ERROR)
25
      echo -e "${RED}[${timestamp}] [ERROR]:${NC} $message"
26
      ;;
27
    *)
28
      echo -e "[${timestamp}] [LOG]: $message"
29
      ;;
30
  esac
31
}

1
#######################################
2
# Initializes script by parsing CLI arguments.
3
# Exits with error if bucket name is not provided.
4
# Globals:
5
#   BUCKET_NAME, YELLOW, NC
6
# Arguments:
7
#   --bucket | --b <bucket-name>
8
# Outputs:
9
#   Sets BUCKET_NAME variable.
10
#######################################
11
function init() {
12
  while [[ "$#" -gt 0 ]]; do
13
    case "$1" in
14
      --bucket|--b)
15
        BUCKET_NAME="$2"
16
        shift 2
17
        ;;
18
      *)
19
        log ERROR "Unknown argument: $1"
20
        exit 1
21
        ;;
22
    esac
23
  done
24

25
  if [[ -z "$BUCKET_NAME" ]]; then
26
    log ERROR "Bucket name not provided. Use --bucket or --b to specify it."
27
    echo -e "${YELLOW}Example:${NC} ./check_bucket.sh --bucket my-bucket-name"
28
    exit 1
29
  fi
30
}

1
#######################################
2
# Checks if the specified S3 bucket exists.
3
# Globals:
4
#   BUCKET_NAME
5
# Outputs:
6
#   Success or error message to stdout.
7
# Returns:
8
#   0 if bucket exists, exits with 1 otherwise.
9
#######################################
10
function check_bucket_exists() {
11
  log INFO "Checking if bucket '$BUCKET_NAME' exists..."
12

13
  if aws s3api head-bucket --bucket "$BUCKET_NAME" 2>/dev/null; then
14
    log SUCCESS "Bucket '$BUCKET_NAME' exists and is accessible."
15
  else
16
    log ERROR "Bucket '$BUCKET_NAME' does not exist or access is denied."
17
    exit 1
18
  fi
19
}

1
#######################################
2
# Main function that runs the script.
3
# Calls init and check_bucket_exists in order.
4
# Arguments:
5
#   Passes all script arguments to init.
6
#######################################
7
function main() {
8
  print_fun
9
  init "$@"
10
  check_bucket_exists
11
}
12

13
main "$@"