mirror of
https://github.com/alexbelgium/hassio-addons.git
synced 2026-01-11 10:21:02 +01:00
Create bashio-standalone.sh
This commit is contained in:
Alexandre
254
.templates/bashio-standalone.sh
Normal file
254
.templates/bashio-standalone.sh
Normal file
@@ -0,0 +1,254 @@
|
||||
# /usr/local/lib/bashio-standalone.sh
|
||||
# shellcheck shell=bash
|
||||
# Minimal bashio compatibility layer for running Home Assistant add-ons
|
||||
# as standalone containers (no Supervisor). It overrides common bashio::*
|
||||
# functions to source config from ENV (and optionally a JSON file).
|
||||
# Load it conditionally in your entry script when supervisor isn't reachable.
|
||||
|
||||
# -------- internals ----------------------------------------------------------
|
||||
|
||||
# Whether to emit ANSI colors (disabled if not a TTY)
|
||||
if [ -t 1 ]; then
|
||||
_BASHIO_COLOR=1
|
||||
else
|
||||
_BASHIO_COLOR=0
|
||||
fi
|
||||
|
||||
_bashio_color() {
|
||||
# $1=name; returns ANSI sequence or empty
|
||||
if [ "$_BASHIO_COLOR" != "1" ]; then return 0; fi
|
||||
case "$1" in
|
||||
blue) printf '\033[34m' ;;
|
||||
green) printf '\033[32m' ;;
|
||||
yellow) printf '\033[33m' ;;
|
||||
red) printf '\033[31m' ;;
|
||||
magenta) printf '\033[35m' ;;
|
||||
reset) printf '\033[0m' ;;
|
||||
esac
|
||||
}
|
||||
|
||||
_bashio_log() {
|
||||
# $1=color name, $2...=msg
|
||||
local c="$1"; shift
|
||||
local pre; pre="$(_bashio_color "$c")"
|
||||
local rst; rst="$(_bashio_color reset)"
|
||||
printf '%s%s%s\n' "$pre" "$*" "$rst"
|
||||
}
|
||||
|
||||
# Optional JSON options source (single flat object or nested).
|
||||
# Set STANDALONE_OPTIONS_JSON to a path (e.g., /data/options.json).
|
||||
# If jq is present, keys can be fetched as .key or .nested.key
|
||||
_bashio_json_get() {
|
||||
# $1=key (dot.notation). echoes value or empty; returns 0 always
|
||||
local key="${1:-}"
|
||||
local file="${STANDALONE_OPTIONS_JSON:-}"
|
||||
if [ -z "$file" ] || [ ! -f "$file" ] || ! command -v jq >/dev/null 2>&1; then
|
||||
return 0
|
||||
fi
|
||||
# jq -r returns "null" for missing; convert to empty
|
||||
local val
|
||||
val="$(jq -er --arg k "$key" '. as $r | getpath(($k|split("."))) // empty' "$file" 2>/dev/null || true)"
|
||||
[ "$val" = "null" ] && val=""
|
||||
printf '%s' "$val"
|
||||
}
|
||||
|
||||
# Map a bashio "key" to an env var name.
|
||||
# Order tried:
|
||||
# 1) exact as-is
|
||||
# 2) uppercase exact
|
||||
# 3) dot->underscore, dash->underscore (upper & lower)
|
||||
# 4) with prefixes: CFG_, CONFIG_, ADDON_, OPTION_, OPT_
|
||||
_bashio_env_get() {
|
||||
# $1=key
|
||||
local key="${1:-}"
|
||||
[ -z "$key" ] && return 0
|
||||
|
||||
local variants=()
|
||||
variants+=("$key")
|
||||
variants+=("$(printf '%s' "$key" | tr '[:lower:]' '[:upper:]')")
|
||||
variants+=("$(printf '%s' "$key" | tr '.' '_' | tr '-' '_' )")
|
||||
variants+=("$(printf '%s' "$key" | tr '.' '_' | tr '-' '_' | tr '[:lower:]' '[:upper:]')")
|
||||
|
||||
local prefixes=(""
|
||||
"CFG_" "CONFIG_" "ADDON_" "OPTION_" "OPT_")
|
||||
|
||||
local v p name
|
||||
for v in "${variants[@]}"; do
|
||||
for p in "${prefixes[@]}"; do
|
||||
name="${p}${v}"
|
||||
if [ -n "${!name+x}" ]; then
|
||||
printf '%s' "${!name}"
|
||||
return 0
|
||||
fi
|
||||
done
|
||||
done
|
||||
}
|
||||
|
||||
# Helper: true/false parsing
|
||||
_bashio_is_true() {
|
||||
# $1=value
|
||||
case "${1:-}" in
|
||||
1|true|TRUE|yes|YES|on|On) return 0 ;;
|
||||
*) return 1 ;;
|
||||
esac
|
||||
}
|
||||
|
||||
# Net wait using /dev/tcp (POSIX bash) with a timeout
|
||||
_bashio_tcp_wait() {
|
||||
# $1=host $2=port $3=timeout(s, default 30)
|
||||
local host="$1" port="$2" to="${3:-30}"
|
||||
local start now
|
||||
start="$(date +%s)"
|
||||
while :; do
|
||||
if exec 3<>"/dev/tcp/${host}/${port}" 2>/dev/null; then
|
||||
exec 3>&- 3<&-
|
||||
return 0
|
||||
fi
|
||||
now="$(date +%s)"
|
||||
if [ $((now - start)) -ge "$to" ]; then
|
||||
return 1
|
||||
fi
|
||||
sleep 1
|
||||
done
|
||||
}
|
||||
|
||||
# -------- logs ---------------------------------------------------------------
|
||||
|
||||
bashio::log.blue() { _bashio_log blue "$*"; }
|
||||
bashio::log.green() { _bashio_log green "$*"; }
|
||||
bashio::log.yellow() { _bashio_log yellow "$*"; }
|
||||
bashio::log.red() { _bashio_log red "$*"; }
|
||||
bashio::log.magenta() { _bashio_log magenta "$*"; }
|
||||
|
||||
# compatibility aliases often used
|
||||
bashio::log.info() { bashio::log.blue "$@"; }
|
||||
bashio::log.warning() { bashio::log.yellow "$@"; }
|
||||
bashio::log.error() { bashio::log.red "$@"; }
|
||||
bashio::log.debug() { printf '%s\n' "$*"; }
|
||||
|
||||
# -------- supervisor & addon meta -------------------------------------------
|
||||
|
||||
# In standalone, "ping" always fails unless forced
|
||||
bashio::supervisor.ping() {
|
||||
if _bashio_is_true "${STANDALONE_FORCE_SUPERVISOR_PING:-}"; then
|
||||
return 0
|
||||
fi
|
||||
return 1
|
||||
}
|
||||
|
||||
# Add-on metadata (use env or sensible defaults)
|
||||
bashio::addon.name() { printf '%s' "${ADDON_NAME:-Standalone container}"; }
|
||||
bashio::addon.description() { printf '%s' "${ADDON_DESCRIPTION:-Running without Home Assistant Supervisor}"; }
|
||||
bashio::addon.version() { printf '%s' "${BUILD_VERSION:-1.0}"; }
|
||||
bashio::addon.version_latest(){ printf '%s' "${ADDON_VERSION_LATEST:-${BUILD_VERSION:-1.0}}"; }
|
||||
bashio::addon.update_available() {
|
||||
if [ "${ADDON_VERSION_LATEST:-}" != "" ] && [ "${ADDON_VERSION_LATEST:-}" != "${BUILD_VERSION:-}" ]; then
|
||||
printf '%s' "true"; return 0
|
||||
fi
|
||||
printf '%s' "false"
|
||||
}
|
||||
bashio::addon.ingress_port() { printf '%s' "${ADDON_INGRESS_PORT:-}"; }
|
||||
bashio::addon.ingress_entry() { printf '%s' "${ADDON_INGRESS_ENTRY:-}"; }
|
||||
bashio::addon.ip_address() { printf '%s' "${ADDON_IP_ADDRESS:-}"; }
|
||||
|
||||
# Ports:
|
||||
# - numeric arg "8080" -> env PORT_8080 or ADDON_PORT_8080, falling back to the number
|
||||
# - non-numeric "WEB_PORT" -> resolve as config/env key
|
||||
bashio::addon.port() {
|
||||
local arg="${1:-}"
|
||||
if [[ "$arg" =~ ^[0-9]+$ ]]; then
|
||||
local v
|
||||
v="$(_bashio_env_get "PORT_${arg}")"
|
||||
[ -z "$v" ] && v="$(_bashio_env_get "ADDON_PORT_${arg}")"
|
||||
printf '%s' "${v:-$arg}"
|
||||
else
|
||||
printf '%s' "$(_bashio_env_get "$arg")"
|
||||
fi
|
||||
}
|
||||
|
||||
# -------- system info --------------------------------------------------------
|
||||
|
||||
bashio::info.operating_system() {
|
||||
if [ -r /etc/os-release ]; then
|
||||
. /etc/os-release
|
||||
printf '%s' "${PRETTY_NAME:-${NAME:-Linux}}"
|
||||
else
|
||||
printf '%s' "Linux"
|
||||
fi
|
||||
}
|
||||
bashio::info.arch() { uname -m; }
|
||||
bashio::info.machine() { uname -m; }
|
||||
bashio::info.homeassistant(){ printf '%s' "standalone"; }
|
||||
bashio::info.supervisor() { printf '%s' "standalone"; }
|
||||
|
||||
# -------- config -------------------------------------------------------------
|
||||
|
||||
# Primary getter:
|
||||
# 1) ENV (several name variants/prefixes)
|
||||
# 2) JSON file via STANDALONE_OPTIONS_JSON (jq required)
|
||||
bashio::config() {
|
||||
local key="${1:-}"
|
||||
local v
|
||||
v="$(_bashio_env_get "$key")"
|
||||
if [ -z "$v" ]; then
|
||||
v="$(_bashio_json_get "$key")"
|
||||
fi
|
||||
printf '%s' "${v:-}"
|
||||
}
|
||||
|
||||
bashio::config.has_value() { local k="$1"; [ -n "$(bashio::config "$k")" ]; }
|
||||
bashio::config.true() { local k="$1"; _bashio_is_true "$(bashio::config "$k")"; }
|
||||
|
||||
# Some add-ons call "require.ssl" (noop by default)
|
||||
bashio::config.require.ssl(){ printf '%s' "${REQUIRE_SSL:-true}"; }
|
||||
|
||||
# -------- variables & fs helpers --------------------------------------------
|
||||
|
||||
bashio::var.true() { _bashio_is_true "${1:-}"; }
|
||||
bashio::var.has_value() { [ -n "${1:-}" ]; }
|
||||
|
||||
bashio::fs.directory_exists() { [ -d "$1" ]; }
|
||||
|
||||
# -------- network/services ---------------------------------------------------
|
||||
|
||||
# Wait for TCP service: bashio::net.wait_for host port [timeout]
|
||||
bashio::net.wait_for() {
|
||||
local host="$1" port="$2" to="${3:-30}"
|
||||
_bashio_tcp_wait "$host" "$port" "$to"
|
||||
}
|
||||
|
||||
# Discovery stubs; map to common env names, or JSON:
|
||||
# Usage patterns seen:
|
||||
# bashio::services "mqtt" "host"
|
||||
# bashio::services "mysql" "port"
|
||||
bashio::services() {
|
||||
local svc="${1:-}" key="${2:-}"
|
||||
[ -z "$svc" ] && return 0
|
||||
local upper svc_upper var v
|
||||
upper="$(printf '%s' "$key" | tr '[:lower:]' '[:upper:]')"
|
||||
svc_upper="$(printf '%s' "$svc" | tr '[:lower:]' '[:upper:]')"
|
||||
|
||||
# Common mappings
|
||||
case "$svc_upper:$upper" in
|
||||
MQTT:HOST) var="MQTT_HOST" ;;
|
||||
MQTT:PORT) var="MQTT_PORT" ;;
|
||||
MQTT:USERNAME) var="MQTT_USER" ;;
|
||||
MQTT:PASSWORD) var="MQTT_PASSWORD" ;;
|
||||
MQTT:TLS) var="MQTT_TLS" ;;
|
||||
MYSQL:HOST|MARIADB:HOST) var="DB_HOST" ;;
|
||||
MYSQL:PORT|MARIADB:PORT) var="DB_PORT" ;;
|
||||
MYSQL:USERNAME|MARIADB:USERNAME) var="DB_USER" ;;
|
||||
MYSQL:PASSWORD|MARIADB:PASSWORD) var="DB_PASSWORD" ;;
|
||||
MYSQL:DATABASE|MARIADB:DATABASE) var="DB_NAME" ;;
|
||||
*) var="${svc_upper}_${upper}" ;;
|
||||
esac
|
||||
|
||||
v="$(_bashio_env_get "$var")"
|
||||
if [ -z "$v" ] && [ -n "${STANDALONE_OPTIONS_JSON:-}" ]; then
|
||||
v="$(_bashio_json_get "services.${svc}.${key}")"
|
||||
[ -z "$v" ] && v="$(_bashio_json_get "${svc}.${key}")"
|
||||
fi
|
||||
printf '%s' "${v:-}"
|
||||
}
|
||||
|
||||
# -------- end ----------------------------------------------------------------
|
||||
Reference in New Issue
Block a user