| # Copyright 1999-2017 Gentoo Foundation |
| # Distributed under the terms of the GNU General Public License v2 |
| |
| # @ECLASS: xdg-utils.eclass |
| # @MAINTAINER: |
| # gnome@gentoo.org |
| # @AUTHOR: |
| # Original author: Gilles Dartiguelongue <eva@gentoo.org> |
| # @BLURB: Auxiliary functions commonly used by XDG compliant packages. |
| # @DESCRIPTION: |
| # This eclass provides a set of auxiliary functions needed by most XDG |
| # compliant packages. |
| # It provides XDG stack related functions such as: |
| # * XDG .desktop files cache management |
| # * XDG mime information database management |
| |
| case "${EAPI:-0}" in |
| 0|1|2|3|4|5|6) ;; |
| *) die "EAPI=${EAPI} is not supported" ;; |
| esac |
| |
| # @ECLASS-VARIABLE: DESKTOP_DATABASE_UPDATE_BIN |
| # @INTERNAL |
| # @DESCRIPTION: |
| # Path to update-desktop-database |
| : ${DESKTOP_DATABASE_UPDATE_BIN:="/usr/bin/update-desktop-database"} |
| |
| # @ECLASS-VARIABLE: DESKTOP_DATABASE_DIR |
| # @INTERNAL |
| # @DESCRIPTION: |
| # Directory where .desktop files database is stored |
| : ${DESKTOP_DATABASE_DIR="/usr/share/applications"} |
| |
| # @ECLASS-VARIABLE: MIMEINFO_DATABASE_UPDATE_BIN |
| # @INTERNAL |
| # @DESCRIPTION: |
| # Path to update-mime-database |
| : ${MIMEINFO_DATABASE_UPDATE_BIN:="/usr/bin/update-mime-database"} |
| |
| # @ECLASS-VARIABLE: MIMEINFO_DATABASE_DIR |
| # @INTERNAL |
| # @DESCRIPTION: |
| # Directory where .desktop files database is stored |
| : ${MIMEINFO_DATABASE_DIR:="/usr/share/mime"} |
| |
| # @FUNCTION: xdg_environment_reset |
| # @DESCRIPTION: |
| # Clean up environment for clean builds. |
| xdg_environment_reset() { |
| # Prepare XDG base directories |
| export XDG_DATA_HOME="${HOME}/.local/share" |
| export XDG_CONFIG_HOME="${HOME}/.config" |
| export XDG_CACHE_HOME="${HOME}/.cache" |
| export XDG_RUNTIME_DIR="${T}/run" |
| mkdir -p "${XDG_DATA_HOME}" "${XDG_CONFIG_HOME}" "${XDG_CACHE_HOME}" \ |
| "${XDG_RUNTIME_DIR}" || die |
| # This directory needs to be owned by the user, and chmod 0700 |
| # https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html |
| chmod 0700 "${XDG_RUNTIME_DIR}" || die |
| |
| unset DBUS_SESSION_BUS_ADDRESS |
| } |
| |
| # @FUNCTION: xdg_desktop_database_update |
| # @DESCRIPTION: |
| # Updates the .desktop files database. |
| # Generates a list of mimetypes linked to applications that can handle them |
| xdg_desktop_database_update() { |
| local updater="${EROOT}${DESKTOP_DATABASE_UPDATE_BIN}" |
| |
| if [[ ${EBUILD_PHASE} != post* ]] ; then |
| die "xdg_desktop_database_update must be used in pkg_post* phases." |
| fi |
| |
| if [[ ! -x "${updater}" ]] ; then |
| debug-print "${updater} is not executable" |
| return |
| fi |
| |
| ebegin "Updating .desktop files database" |
| "${updater}" -q "${EROOT}${DESKTOP_DATABASE_DIR}" |
| eend $? |
| } |
| |
| # @FUNCTION: xdg_mimeinfo_database_update |
| # @DESCRIPTION: |
| # Update the mime database. |
| # Creates a general list of mime types from several sources |
| xdg_mimeinfo_database_update() { |
| local updater="${EROOT}${MIMEINFO_DATABASE_UPDATE_BIN}" |
| |
| if [[ ${EBUILD_PHASE} != post* ]] ; then |
| die "xdg_mimeinfo_database_update must be used in pkg_post* phases." |
| fi |
| |
| if [[ ! -x "${updater}" ]] ; then |
| debug-print "${updater} is not executable" |
| return |
| fi |
| |
| ebegin "Updating shared mime info database" |
| "${updater}" "${EROOT}${MIMEINFO_DATABASE_DIR}" |
| eend $? |
| } |