mirror of
https://github.com/alexbelgium/hassio-addons.git
synced 2026-06-06 07:35:56 +02: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