From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 9F66C13933E for ; Sat, 3 Jul 2021 14:13:02 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 8FD0BE0874; Sat, 3 Jul 2021 14:13:00 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 61626E0874 for ; Sat, 3 Jul 2021 14:13:00 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 1855D335C5A for ; Sat, 3 Jul 2021 14:12:59 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 5BC1C79A for ; Sat, 3 Jul 2021 14:12:57 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1625321540.6676e4b0d2b9de20892b1f68a43a4161cd47b2aa.ulm@gentoo> Subject: [gentoo-commits] repo/gentoo:master commit in: eclass/ X-VCS-Repository: repo/gentoo X-VCS-Files: eclass/plocale.eclass X-VCS-Directories: eclass/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 6676e4b0d2b9de20892b1f68a43a4161cd47b2aa X-VCS-Branch: master Date: Sat, 3 Jul 2021 14:12:57 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: b91c1d5b-ee06-40df-816c-850d80e72bc9 X-Archives-Hash: 4f933d432f7a78fc48ca291d12eb0f89 commit: 6676e4b0d2b9de20892b1f68a43a4161cd47b2aa Author: Ulrich Müller gentoo org> AuthorDate: Wed Jun 23 13:28:05 2021 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sat Jul 3 14:12:20 2021 +0000 URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=6676e4b0 plocale.eclass: Copied from l10n.eclass Ever since the L10N USE_EXPAND variable was introduced, the name of this eclass was somewhat confusing, because it operates on LINGUAS and is unrelated to L10N. Take the EAPI 8 bump as an opportunity to rename the eclass. Signed-off-by: Ulrich Müller gentoo.org> eclass/plocale.eclass | 169 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 169 insertions(+) diff --git a/eclass/plocale.eclass b/eclass/plocale.eclass new file mode 100644 index 00000000000..3a7b78e93ff --- /dev/null +++ b/eclass/plocale.eclass @@ -0,0 +1,169 @@ +# Copyright 2012-2021 Gentoo Authors +# Distributed under the terms of the GNU General Public License v2 + +# @ECLASS: plocale.eclass +# @MAINTAINER: +# Ulrich Müller +# @AUTHOR: +# Ben de Groot +# @SUPPORTED_EAPIS: 6 7 8 +# @BLURB: convenience functions to handle localizations +# @DESCRIPTION: +# The plocale (localization) eclass offers a number of functions to more +# conveniently handle localizations (translations) offered by packages. +# These are meant to prevent code duplication for such boring tasks as +# determining the cross-section between the user's set LINGUAS and what +# is offered by the package. +# +# Typical usage in an ebuild looks like this: +# +# @CODE +# PLOCALES="de en fr pt_BR zh_CN" +# PLOCALE_BACKUP="en" +# @CODE +# +# There, PLOCALES is the list of locales that the package supports. +# PLOCALE_BACKUP is optional and specifies a single locale, which is +# used as a fallback if none of the PLOCALES matches the user's +# LINGUAS selection. +# +# The eclass functions then operate on the intersection of the package's +# PLOCALES with the user's LINGUAS setting. (As a special case, if the +# LINGUAS variable is unset then all items in PLOCALES will be used, +# emulating the behaviour of gettext.) +# +# In the following simple example, locale specific README files +# (e.g. README.de, README.en) are added to the DOCS variable: +# +# @CODE +# my_add_to_docs() { +# DOCS+=( ${1}.${2} ) +# } +# plocale_for_each_locale my_add_to_docs README +# @CODE +# +# A complementary function plocale_for_each_disabled_locale exists as +# well, which operates on the set difference of PLOCALES and LINGUAS, +# i.e. on the locales that the user hasn't enabled. For example, it can +# be used to remove unnecessary locale files. +# +# Finally, plocale_find_changes is purely a helper function for ebuild +# maintenance. It can be used to scan a directory for available +# translations and check if the ebuild's PLOCALES are still up to date. + +case ${EAPI} in + 6|7|8) ;; + *) die "${ECLASS}: EAPI ${EAPI:-0} not supported" ;; +esac + +if [[ -z ${_PLOCALE_ECLASS} ]]; then +_PLOCALE_ECLASS=1 + +# @ECLASS-VARIABLE: PLOCALES +# @DEFAULT_UNSET +# @DESCRIPTION: +# Variable listing the locales for which localizations are offered by +# the package. +# +# Example: PLOCALES="cy de el_GR en_US pt_BR vi zh_CN" + +# @ECLASS-VARIABLE: PLOCALE_BACKUP +# @DEFAULT_UNSET +# @DESCRIPTION: +# In some cases the package fails when none of the offered PLOCALES are +# selected by the user. In that case this variable should be set to a +# default locale (usually 'en' or 'en_US') as backup. +# +# Example: PLOCALE_BACKUP="en_US" + +# @FUNCTION: plocale_for_each_locale +# @USAGE: [...] +# @DESCRIPTION: +# Convenience function for processing all enabled localizations. +# The parameter should be a function (defined in the consuming eclass +# or ebuild) which takes an individual locale as its (last) parameter. +# +# Example: plocale_for_each_locale install_locale +plocale_for_each_locale() { + local locs x + locs=$(plocale_get_locales) + for x in ${locs}; do + "$@" ${x} || die "failed to process enabled ${x} locale" + done +} + +# @FUNCTION: plocale_for_each_disabled_locale +# @USAGE: [...] +# @DESCRIPTION: +# Complementary to plocale_for_each_locale, this function will process +# locales that are disabled. This could be used for example to remove +# locales from a Makefile, to prevent them from being built needlessly. +plocale_for_each_disabled_locale() { + local locs x + locs=$(plocale_get_locales disabled) + for x in ${locs}; do + "$@" ${x} || die "failed to process disabled ${x} locale" + done +} + +# @FUNCTION: plocale_find_changes +# @USAGE: +# @DESCRIPTION: +# Ebuild maintenance helper function to find changes in package offered +# locales when doing a version bump. This could be added for example +# to src_prepare. +# +# Example: plocale_find_changes "${S}/src/translations" "${PN}_" '.ts' +plocale_find_changes() { + [[ $# -eq 3 ]] || die "Exactly 3 arguments are needed!" + ebegin "Looking in ${1} for new locales" + pushd "${1}" >/dev/null || die "Cannot access ${1}" + local current="" x + for x in ${2}*${3}; do + x=${x#"${2}"} + x=${x%"${3}"} + current+="${x} " + done + popd >/dev/null || die + # RHS will be sorted with single spaces so ensure the LHS is too + # before attempting to compare them for equality. See bug #513242. + # Run them both through the same sorting algorithm so we don't have + # to worry about them being the same. + [[ "$(printf '%s\n' ${PLOCALES} | LC_ALL=C sort)" \ + == "$(printf '%s\n' ${current} | LC_ALL=C sort)" ]] + if ! eend $? "There are changes in locales!"; then + eerror "This ebuild should be updated to:" + eerror "PLOCALES=\"${current%[[:space:]]}\"" + return 1 + fi +} + +# @FUNCTION: plocale_get_locales +# @USAGE: [disabled] +# @DESCRIPTION: +# Determine which LINGUAS the user has enabled that are offered by the +# package, as listed in PLOCALES, and return them. In case no locales +# are selected, fall back on PLOCALE_BACKUP. When the disabled argument +# is given, return the disabled locales instead of the enabled ones. +plocale_get_locales() { + local loc locs + if [[ -z ${LINGUAS+set} ]]; then + # enable all if unset + locs=${PLOCALES} + else + for loc in ${LINGUAS}; do + has ${loc} ${PLOCALES} && locs+="${loc} " + done + fi + [[ -z ${locs} ]] && locs=${PLOCALE_BACKUP} + if [[ ${1} == disabled ]]; then + local disabled_locs + for loc in ${PLOCALES}; do + has ${loc} ${locs} || disabled_locs+="${loc} " + done + locs=${disabled_locs} + fi + printf "%s" "${locs}" +} + +fi