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 8FDFC138334 for ; Mon, 16 Sep 2019 22:48:27 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 0B749E0A03; Mon, 16 Sep 2019 22:48:06 +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 97883E09EC for ; Mon, 16 Sep 2019 22:48:05 +0000 (UTC) Received: from linux1.home (cpe-66-68-48-101.austin.res.rr.com [66.68.48.101]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: williamh) by smtp.gentoo.org (Postfix) with ESMTPSA id 6DD8F34B282; Mon, 16 Sep 2019 22:48:04 +0000 (UTC) Received: (nullmailer pid 20553 invoked by uid 1000); Mon, 16 Sep 2019 22:48:01 -0000 From: William Hubbs To: gentoo-dev@lists.gentoo.org Cc: William Hubbs Subject: [gentoo-dev] [PATCH 1/1] go-module.eclass: introduce new eclass to handle go modules Date: Mon, 16 Sep 2019 17:47:20 -0500 Message-Id: <20190916224720.20502-2-williamh@gentoo.org> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190916224720.20502-1-williamh@gentoo.org> References: <20190916224720.20502-1-williamh@gentoo.org> 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-Transfer-Encoding: 8bit X-Archives-Salt: 679c6197-66c4-4269-bcc6-9faa7b7e2a2c X-Archives-Hash: 6f2e2a486b17bb77d2f55eb637768b98 Signed-off-by: William Hubbs --- eclass/go-module.eclass | 105 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 eclass/go-module.eclass diff --git a/eclass/go-module.eclass b/eclass/go-module.eclass new file mode 100644 index 00000000000..810e66e1c5b --- /dev/null +++ b/eclass/go-module.eclass @@ -0,0 +1,105 @@ +# Copyright 2019 gentoo authors +# Distributed under the terms of the GNU General Public License v2 + +# @ECLASS: go-module.eclass +# @MAINTAINER: +# William Hubbs +# @SUPPORTED_EAPIS: 7 +# @BLURB: basic eclass for building software written in the go +# programming language that uses go modules. +# @DESCRIPTION: +# This eclass provides some basic things needed by all software +# written in the go programming language that uses go modules. +# +# You will know the software you are packaging uses modules because +# it will have files named go.sum and go.mod in its top-level source +# directory. If it does not have these files, use the golang-* eclasses. +# +# If the software you are packaging uses modules, the next question is +# whether it has a directory named "vendor" at the top-level of the source tree. +# +# If it doesn't, you need to create a tarball of what would be in the +# vendor directory and mirror it locally. +# If foo-1.0 is the name of your project and you have the tarball for it +# in your current directory, this is done with the following commands: +# +# @CODE: +# +# tar -xf foo-1.0.tar.gz +# cd foo-1.0 +# go mod vendor +# tar -acf foo-1.0-vendor.tar.gz vendor +# +# @CODE: +# +# Regardless of whether you create a vendor tarball, Since Go programs +# are statically linked, it is important that the ebuild's LICENSE= +# setting includes the licenses of all statically linked +# dependencies. So please make sure it is accurate. + +case ${EAPI:-0} in + 7) ;; + *) die "${ECLASS} API in EAPI ${EAPI} not yet established." +esac + +if [[ -z ${_GO_MODULE} ]]; then + +_GO_MODULE=1 + +BDEPEND=">=dev-lang/go-1.12" + +# Force go to build in module mode. +# In this mode the GOPATH environment variable is ignored. +# this will become the default in the future. +export GO111MODULE=on + +# The following go flags should be used for all builds. +# -mod=vendor stopps downloading of dependencies from the internet. +# -v prints the names of packages as they are compiled +# -x prints commands as they are executed +export GOFLAGS="-mod=vendor -v -x" + +# Do not complain about CFLAGS etc since go projects do not use them. +QA_FLAGS_IGNORED='.*' + +# Go packages should not be stripped with strip(1). +RESTRICT="strip" + +EXPORT_FUNCTIONS src_prepare pkg_postinst + +# @FUNCTION: go-module_src_prepare +# @DESCRIPTION: +# Run a default src_prepare then move our provided vendor directory to +# the appropriate spot if upstream doesn't provide a vendor directory. +# If upstream vendors and we provide a vendor tarball, this is a fatal +# error. +go-module_src_prepare() { + default + if [[ -d "${S}"/vendor ]] && [[ -d ../vendor ]] ; then + eerror "The upstream source for ${P} includes a vendor directory" + eerror "and a local vendor tarball is provided." + die "vendored dependencies are provided upstream" + fi + # Use the upstream provided vendor directory if it exists. + [[ -d "${S}"/vendor ]] && return + # If we are not providing a mirror of a vendor directory we created + # manually, return since there may be nothing to vendor. + [[ ! -d ../vendor ]] && return + # At this point, we know we are providing a vendor mirror. + mv ../vendor "${S}" || die "Unable to move ../vendor directory" +} + +# @FUNCTION: go-module_pkg_postinst +# @DESCRIPTION: +# Display a warning about security updates for Go programs. +go-module_pkg_postinst() { + ewarn "${PN} is written in the Go programming language." + ewarn "Since this language is statically linked, security" + ewarn "updates will be handled in individual packages and will be" + ewarn "difficult for us to track as a distribution." + ewarn "For this reason, please update any go packages asap when new" + ewarn "versions enter the tree or go stable if you are running the" + ewarn "stable tree." +} + +fi -- 2.21.0