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.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 030D915800A for ; Sun, 16 Jul 2023 12:39:46 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 6FC07E081A; Sun, 16 Jul 2023 12:39:39 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id D655AE0805 for ; Sun, 16 Jul 2023 12:39:38 +0000 (UTC) From: =?UTF-8?q?Maciej=20Bar=C4=87?= To: gentoo-dev@lists.gentoo.org Cc: =?UTF-8?q?Maciej=20Bar=C4=87?= Subject: [gentoo-dev] [PATCH 1/7] eclass/nuget.eclass: introduce new eclass Date: Sun, 16 Jul 2023 14:38:03 +0200 Message-ID: <20230716123830.78932-1-xgqt@gentoo.org> X-Mailer: git-send-email 2.41.0 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Archives-Salt: bd335f25-47cd-44de-a0c1-45c74870e7e9 X-Archives-Hash: 2d884d950c27e20890553a0753fafbda Bug: https://bugs.gentoo.org/900597 Bug: https://github.com/gentoo/gentoo/pull/29309 Signed-off-by: Maciej Barć --- eclass/nuget.eclass | 192 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 192 insertions(+) create mode 100644 eclass/nuget.eclass diff --git a/eclass/nuget.eclass b/eclass/nuget.eclass new file mode 100644 index 0000000000..cbc9bae4a1 --- /dev/null +++ b/eclass/nuget.eclass @@ -0,0 +1,192 @@ +# Copyright 1999-2023 Gentoo Authors +# Distributed under the terms of the GNU General Public License v2 + +# @ECLASS: nuget.eclass +# @MAINTAINER: +# Gentoo Dotnet project +# @AUTHOR: +# Anna Figueiredo Gomes +# Maciej Barć +# @SUPPORTED_EAPIS: 7 8 +# @BLURB: common functions and variables for handling .NET NuGets +# @DESCRIPTION: +# This eclass is designed to provide support for .NET NuGet's ".nupkg" files. +# +# This eclass does not export any phase functions, for that see +# the "dotnet-pkg" eclass. + +case "${EAPI}" in + 7 | 8 ) + : + ;; + * ) + die "${ECLASS}: EAPI ${EAPI} unsupported." + ;; +esac + +if [[ -z ${_NUGET_ECLASS} ]] ; then +_NUGET_ECLASS=1 + +# @ECLASS_VARIABLE: SYSTEM_NUGETS +# @DESCRIPTION: +# Location of the system NuGet packages directory. +SYSTEM_NUGETS=/opt/dotnet-nugets + +# @ECLASS_VARIABLE: NUGET_APIS +# @DESCRIPTION: +# NuGet API URLs to use for precompiled NuGet package ".nupkg" downloads. +# Set or append to this variable post-inherit, but before calling +# the "nuget_uris" function, preferably just before "SRC_URI". +# +# Example: +# @CODE +# SRC_URI="https://example.com/example.tar.xz" +# NUGET_APIS+=( "https://api.nuget.org/v3-flatcontainer" ) +# SRC_URI+=" $(nuget_uris) " +# @CODE +NUGET_APIS=( "https://api.nuget.org/v3-flatcontainer" ) + +# @ECLASS_VARIABLE: NUGET_PACKAGES +# @DEFAULT_UNSET +# @PRE_INHERIT +# @DESCRIPTION: +# Path from where NuGets will be restored from. +# Defaults to ${T}/nugets for use with "nuget_uris" but may be set to a custom +# location to, for example, restore NuGets extracted form a prepared archive. +# Do not set this variable in conjunction with non-empty "NUGETS". +if [[ "${NUGETS}" ]] || [[ ! "${NUGET_PACKAGES}" ]] ; then + NUGET_PACKAGES="${T}"/nugets +fi +export NUGET_PACKAGES + +# @ECLASS_VARIABLE: NUGETS +# @DEFAULT_UNSET +# @PRE_INHERIT +# @DESCRIPTION: +# String containing all NuGet packages that need to be downloaded. +# Used by "nuget_uris". +# +# Example: +# @CODE +# NUGETS=" +# ImGui.NET-1.87.2 +# Config.Net-4.19.0 +# " +# +# inherit dotnet-pkg +# +# ... +# +# SRC_URI+=" $(nuget_uris) " +# @CODE + +# @FUNCTION: nuget_uris +# @USAGE: +# @DESCRIPTION: +# Generates the URIs to put in SRC_URI to help fetch dependencies. +# If no arguments provided, uses the "NUGETS" variable. +nuget_uris() { + debug-print-function ${FUNCNAME} "${@}" + + local -r regex='^([a-zA-Z0-9_.-]+)-([0-9]+\.[0-9]+\.[0-9]+.*)$' + local nugets + + if (( ${#} != 0 )) ; then + nugets="${@}" + elif [[ ${NUGETS} ]] ; then + nugets="${NUGETS}" + else + eerror "NUGETS variable is not defined and nothing passed as argument" + die "${FUNCNAME}: Can't generate SRC_URI from empty input" + fi + + local nuget name version nuget_api url + for nuget in ${nugets} ; do + [[ ${nuget} =~ ${regex} ]] || + die "${FUNCNAME}: Could not parse given nuget: ${nuget}" + + name="${BASH_REMATCH[1]}" + version="${BASH_REMATCH[2]}" + + for nuget_api in "${NUGET_APIS[@]}" ; do + case "${nuget_api}" in + */v2 | */v2/ ) + url="${nuget_api}/package/${name}/${version} + -> ${name}.${version}.nupkg" + ;; + * ) + url="${nuget_api}/${name}/${version}/${name}.${version}.nupkg" + ;; + esac + echo "${url}" + done + done +} + +# @FUNCTION: nuget_link +# @USAGE: +# @DESCRIPTION: +# Link a specified NuGet package at "nuget-path" to the "NUGET_PACKAGES" +# directory. +# +# Example: +# @CODE +# nuget_link "${DISTDIR}"/pkg.0.nupkg +# @CODE +# +# This function is used inside "dotnet-pkg_src_unpack" +# from the "dotnet-pkg" eclass. +nuget_link() { + [[ ! "${1}" ]] && die "${FUNCNAME}: no nuget path given" + + mkdir -p "${NUGET_PACKAGES}" || die + + local nuget_name="$(basename "${1}")" + + if [[ -f "${NUGET_PACKAGES}"/${nuget_name} ]] ; then + ewarn "${FUNCNAME}: ${nuget_name} already exists" + else + ln -s "${1}" "${NUGET_PACKAGES}"/${nuget_name} || die + fi +} + +# @FUNCTION: nuget_link-system-nugets +# @DESCRIPTION: +# Link all system NuGet packages to the "NUGET_PACKAGES" directory. +# +# Example: +# @CODE +# src_unpack() { +# nuget_link-system-nugets +# default +# } +# @CODE +# +# This function is used inside "dotnet-pkg_src_unpack" +# from the "dotnet-pkg" eclass. +nuget_link-system-nugets() { + local runtime_nuget + for runtime_nuget in "${EPREFIX}${SYSTEM_NUGETS}"/*.nupkg ; do + if [[ -f "${runtime_nuget}" ]] ; then + nuget_link "${runtime_nuget}" + fi + done +} + +# @FUNCTION: nuget_donuget +# @USAGE: ... +# @DESCRIPTION: +# Install NuGet package(s) at "nuget-path" to the system nugets directory. +# +# Example: +# @CODE +# src_install() { +# nuget_donuget my-pkg.nupkg +# } +# @CODE +nuget_donuget() { + insinto "${SYSTEM_NUGETS}" + doins "${@}" +} + +fi -- 2.41.0