#!/usr/bin/env bash # ============================================================================== # Community Hass.io Add-ons: Bashio # Bashio is an bash function library for use with Hass.io add-ons. # # It contains a set of commonly used operations and can be used # to be included in add-on scripts to reduce code duplication across add-ons. # ============================================================================== # ------------------------------------------------------------------------------ # Checks if a give value is true. # # Arguments: # $1 value # ------------------------------------------------------------------------------ function bashio::var.true() { local value=${1:-null} bashio::log.trace "${FUNCNAME[0]}:" "$@" if [[ "${value}" = "true" ]]; then return "${__BASHIO_EXIT_OK}" fi return "${__BASHIO_EXIT_NOK}" } # ------------------------------------------------------------------------------ # Checks if a give value is false. # # Arguments: # $1 value # ------------------------------------------------------------------------------ function bashio::var.false() { local value=${1:-null} bashio::log.trace "${FUNCNAME[0]}:" "$@" if [[ "${value}" = "false" ]]; then return "${__BASHIO_EXIT_OK}" fi return "${__BASHIO_EXIT_NOK}" } # ------------------------------------------------------------------------------ # Checks if a global variable is defined. # # Arguments: # $1 Name of the variable # ------------------------------------------------------------------------------ bashio::var.defined() { local variable=${1} bashio::log.trace "${FUNCNAME[0]}:" "$@" [[ "${!variable-X}" = "${!variable-Y}" ]] } # ------------------------------------------------------------------------------ # Checks if a value has actual value. # # Arguments: # $1 Value # ------------------------------------------------------------------------------ function bashio::var.has_value() { local value=${1} bashio::log.trace "${FUNCNAME[0]}:" "$@" if [[ -n "${value}" ]]; then return "${__BASHIO_EXIT_OK}" fi return "${__BASHIO_EXIT_NOK}" } # ------------------------------------------------------------------------------ # Checks if a value is empty. # # Arguments: # $1 Value # ------------------------------------------------------------------------------ function bashio::var.is_empty() { local value=${1} bashio::log.trace "${FUNCNAME[0]}:" "$@" if [[ -z "${value}" ]]; then return "${__BASHIO_EXIT_OK}" fi return "${__BASHIO_EXIT_NOK}" } # ------------------------------------------------------------------------------ # Checks if a value equals. # # Arguments: # $1 Value # $2 Equals value # ------------------------------------------------------------------------------ function bashio::var.equals() { local value=${1} local equals=${2} bashio::log.trace "${FUNCNAME[0]}:" "$@" if [[ "${value}" = "${equals}" ]]; then return "${__BASHIO_EXIT_OK}" fi return "${__BASHIO_EXIT_NOK}" } # ------------------------------------------------------------------------------ # Creates JSON based on function arguments. # # Arguments: # $@ Bash array of key/value pairs, prefix integer or boolean values with ^ # ------------------------------------------------------------------------------ function bashio::var.json() { local data=("$@"); local number_of_items=${#data[@]} local json='' local separator local counter local item if [[ ${number_of_items} -eq 0 ]]; then bashio::log.error "Length of input array needs to be at least 2" return "${__BASHIO_EXIT_NOK}" fi if [[ $((number_of_items%2)) -eq 1 ]]; then bashio::log.error "Length of input array needs to be even (key/value pairs)" return "${__BASHIO_EXIT_NOK}" fi counter=0; for i in "${data[@]}"; do separator="," if [ $((++counter%2)) -eq 0 ]; then separator=":"; fi item="\"$i\"" if [[ "${i:0:1}" == "^" ]]; then item="${i:1}" fi json="$json$separator$item"; done echo "{${json:1}}"; return "${__BASHIO_EXIT_OK}" }