hassio-addons/bashio
1
0
Fork 0
mirror of https://github.com/hassio-addons/bashio.git synced 2025-05-06 20:11:24 +00:00
Code Issues Projects Releases Packages Wiki Activity

✨ 🎉 Initial library code

Browse source
This commit is contained in:
Franck Nijhof 2019-03-14 17:14:31 +01:00
parent f91b4cbaa9
commit 2346cddca2
No known key found for this signature in database
GPG key ID: D62583BA8AB11CA3
26 changed files with 4499 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

110
lib/info.sh Normal file
View file

@ -0,0 +1,110 @@
#!/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.
# ==============================================================================
# ------------------------------------------------------------------------------
# Returns a JSON object with generic version information about the system.
#
# Arguments:
# $1 Cache key to store results in (optional)
# $2 jq Filter to apply on the result (optional)
# ------------------------------------------------------------------------------
function bashio::info() {
local cache_key=${1:-'hassio.info'}
local filter=${2:-}
local info
local response
bashio::log.trace "${FUNCNAME[0]}" "$@"
if bashio::cache.exists "${cache_key}"; then
bashio::cache.get "${cache_key}"
return "${__BASHIO_EXIT_OK}"
fi
if bashio::cache.exists 'hassio.info'; then
info=$(bashio::cache.get 'hassio.info')
else
info=$(bashio::api.hassio GET /info false)
bashio::cache.set 'hassio.info' "${info}"
fi
response="${info}"
if bashio::var.has_value "${filter}"; then
response=$(bashio::jq "${info}" "${filter}")
fi
bashio::cache.set "${cache_key}" "${response}"
printf "%s" "${response}"
return "${__BASHIO_EXIT_OK}"
}
# ------------------------------------------------------------------------------
# Returns the Hass.io supervisor version used.
# ------------------------------------------------------------------------------
function bashio::info.supervisor() {
bashio::log.trace "${FUNCNAME[0]}"
bashio::hassio::info 'hassio.info.supervisor' '.supervisor'
}
# ------------------------------------------------------------------------------
# Returns the Home Assistant version used.
# ------------------------------------------------------------------------------
function bashio::info.homeassistant() {
bashio::log.trace "${FUNCNAME[0]}"
bashio::info 'hassio.info.homeassistant' '.homeassistant'
}
# ------------------------------------------------------------------------------
# Returns the hassos version running on the host system.
# ------------------------------------------------------------------------------
function bashio::info.hassos() {
bashio::log.trace "${FUNCNAME[0]}"
bashio::info 'hassio.info.hassos' '.hassos'
}
# ------------------------------------------------------------------------------
# Returns the hostname of the host system.
# ------------------------------------------------------------------------------
function bashio::info.hostname() {
bashio::log.trace "${FUNCNAME[0]}"
bashio::info 'hassio.info.hostname' '.hostname'
}
# ------------------------------------------------------------------------------
# Returns the machine type used.
# ------------------------------------------------------------------------------
function bashio::info.machine() {
bashio::log.trace "${FUNCNAME[0]}"
bashio::info 'hassio.info.machine' '.machine'
}
# ------------------------------------------------------------------------------
# Returns the architecture of the machine.
# ------------------------------------------------------------------------------
function bashio::info.arch() {
bashio::log.trace "${FUNCNAME[0]}"
bashio::info 'hassio.info.arch' '.arch'
}
# ------------------------------------------------------------------------------
# Returns the stability channel the system is enrolled in.
# ------------------------------------------------------------------------------
function bashio::info.channel() {
bashio::log.trace "${FUNCNAME[0]}"
bashio::info 'hassio.info.channel' '.channel'
}
# ------------------------------------------------------------------------------
# Returns a list of supported architectures by this system.
# ------------------------------------------------------------------------------
function bashio::info.supported_arch() {
bashio::log.trace "${FUNCNAME[0]}"
bashio::info 'hassio.info.supported_arch' '.supported_arch[]'
}