From e74a675c79a9260689166ffec8459c975f599cd1 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Mon, 6 Jul 2026 10:55:01 +0200 Subject: tea: add version 0.14.2 Gitea command line client, built from source with go build. Network build (upstream tarball is not vendored), personal repo only. Co-Authored-By: Claude Opus 4.8 --- .../specs/2026-07-06-tea-slackbuild-design.md | 104 ++++++++++++++++ .extras/nvchecker.toml | 6 + tea/README | 19 +++ tea/slack-desc | 19 +++ tea/tea.SlackBuild | 133 +++++++++++++++++++++ tea/tea.info | 10 ++ 6 files changed, 291 insertions(+) create mode 100644 .extras/docs/superpowers/specs/2026-07-06-tea-slackbuild-design.md create mode 100644 tea/README create mode 100644 tea/slack-desc create mode 100644 tea/tea.SlackBuild create mode 100644 tea/tea.info diff --git a/.extras/docs/superpowers/specs/2026-07-06-tea-slackbuild-design.md b/.extras/docs/superpowers/specs/2026-07-06-tea-slackbuild-design.md new file mode 100644 index 0000000..ad12c9e --- /dev/null +++ b/.extras/docs/superpowers/specs/2026-07-06-tea-slackbuild-design.md @@ -0,0 +1,104 @@ +# SlackBuild: tea (gitea CLI client) + +Date: 2026-07-06 +Maintainer: danix + +## Goal + +Package `tea` (the Gitea command-line client) as a SlackBuild built from source, +for the personal repo. Upstream: https://gitea.com/gitea/tea + +## Target: personal repo only + +Network build (modules fetched at build time via GOPROXY). This is NOT +SBo-legal (SBo forbids network access during build and would require a vendored +source tarball). Decision: personal repo only, do not submit to SlackBuilds.org. + +## Scope + +Single package `tea`, version 0.14.2, x86_64, built via `go build`. + +## Files + +``` +tea/ +├── tea.SlackBuild +├── tea.info +├── README +└── slack-desc +``` + +Plus one entry in `.extras/nvchecker.toml`. + +## Build script + +Clone `gitleaks/gitleaks.SlackBuild` (existing Go template in this repo) verbatim, +with these changes: + +- `PRGNAM=tea`, `VERSION=0.14.2` +- The gitea archive extracts to a top dir named `tea/`, NOT `tea-0.14.2/`. + So: `rm -rf $PRGNAM`, `tar xvf .../$PRGNAM-$VERSION.tar.gz`, `cd $PRGNAM`. +- Version stamp in ldflags (tea injects its version via a version package): + `LIB_LDFLAGS='-linkmode=external -s -w -X "gitea.dev/tea/modules/version.Version=$VERSION"'` +- Build: `go build -ldflags="$LIB_LDFLAGS" -o "$PKG"/usr/bin/tea .` +- Docs installed: `LICENSE README.md CONTRIBUTING.md` + +Everything else (GOPATH sandbox, CGO flags, GOFLAGS, strip, makepkg) unchanged +from gitleaks. + +## Environment facts + +- **No `vendor/` dir** in the tarball. Build fetches modules over the network via + GOPROXY (`https://proxy.golang.org,direct`). Build host needs internet. +- **Requires Go 1.26.** Confirmed: Go 1.26.4 present on this machine and the + buildsystem VM. (Note: buildsystem also has a gccgo 1.18 at `/usr/bin/go` — + ignore it, the real toolchain is used.) +- Module path is `gitea.dev/tea`; `main.go` is at repo root, so `go build .`. +- Without the version ldflag, `tea --version` reports blank/dev. + +## .info + +``` +PRGNAM="tea" +VERSION="0.14.2" +HOMEPAGE="https://gitea.com/gitea/tea" +DOWNLOAD="https://gitea.com/gitea/tea/archive/v0.14.2.tar.gz" +MD5SUM="b1f37f2cc43763a3a0c05f060b485768" +DOWNLOAD_x86_64="" +MD5SUM_x86_64="" +REQUIRES="" +MAINTAINER="danix" +EMAIL="danix@danix.xyz" +``` + +REQUIRES empty: static-ish Go binary, no SBo runtime deps. + +## slack-desc + +11-line format. First line `tea: tea (Gitea command line tool)`. Body describes +tea: interact with Gitea/Forgejo servers from the CLI (issues, PRs, releases, +repos, etc). + +## nvchecker + +```toml +[tea] +source = "gitea" +gitea = "gitea/tea" +use_max_tag = true +``` + +No `host` key (only needed for self-hosted instances; default is gitea.com). + +## Verification + +1. `sbolint` clean on the 4 files. +2. `sbodl` reports md5sum matches OK. +3. Build on buildsystem VM (Go 1.26 + network). `sbopkglint` clean. +4. `tea --version` on installed binary shows `0.14.2`, not blank. + +## Out of scope + +- Multi-arch (arm/aarch64). x86_64 only. +- Prebuilt-binary variant (`tea-bin`). +- SBo submission (needs a vendored source tarball; not done here). diff --git a/.extras/nvchecker.toml b/.extras/nvchecker.toml index 87967ef..4dd2403 100644 --- a/.extras/nvchecker.toml +++ b/.extras/nvchecker.toml @@ -119,3 +119,9 @@ url = "https://www.urbanterror.info/downloads/" regex = "UrbanTerror(\\d+)_full\\.zip" from_pattern = "(\\d)(\\d)(\\d)" to_pattern = "\\1.\\2.\\3" + +[tea] +source = "gitea" +gitea = "gitea/tea" +use_max_tag = true +prefix = "v" diff --git a/tea/README b/tea/README new file mode 100644 index 0000000..bdb6df7 --- /dev/null +++ b/tea/README @@ -0,0 +1,19 @@ +tea (Gitea command line tool) + +tea is the official command line tool for Gitea and Forgejo. It talks +to a server through the Gitea API and lets you manage repositories, +issues, pull requests, releases, labels, milestones, comments and more +without leaving the terminal. + +Log in to a server once with "tea login add", then run commands such as +"tea issues", "tea pulls", "tea releases" or "tea repos" against it. It +can autodetect the target repo from the current git remote. + +tea is written in Go and distributed as a single static binary. No +runtime dependencies are required. + +This build is compiled from source. The build fetches Go modules over +the network (the upstream tarball is not vendored), so an internet +connection is required at build time. + +Homepage: https://gitea.com/gitea/tea diff --git a/tea/slack-desc b/tea/slack-desc new file mode 100644 index 0000000..2ab4cfe --- /dev/null +++ b/tea/slack-desc @@ -0,0 +1,19 @@ +# HOW TO EDIT THIS FILE: +# The "handy ruler" below makes it easier to edit a package description. Line +# up the first '|' above the ':' following the base package name, and the '|' +# on the right side marks the last column you can put a character in. You must +# make exactly 11 lines for the formatting to be correct. It's also +# customary to leave one space after the ':' except on otherwise blank lines. + + |-----handy-ruler------------------------------------------------------| +tea: tea (Gitea command line tool) +tea: +tea: tea is the official command line tool to interact with Gitea and +tea: Forgejo servers. It lets you manage repositories, issues, pull +tea: requests, releases, labels, milestones and more, straight from the +tea: terminal, using the Gitea API. +tea: +tea: It is written in Go and distributed as a single static binary. +tea: +tea: Homepage: https://gitea.com/gitea/tea +tea: diff --git a/tea/tea.SlackBuild b/tea/tea.SlackBuild new file mode 100644 index 0000000..a779647 --- /dev/null +++ b/tea/tea.SlackBuild @@ -0,0 +1,133 @@ +#!/bin/bash +# +# Slackware build script for tea +# +# Copyright 2026 danix +# All rights reserved. +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version, with the following exception: +# the text of the GPL license may be omitted. + +# This program is distributed in the hope that it will be useful, but +# without any warranty; without even the implied warranty of +# merchantability or fitness for a particular purpose. Compiling, +# interpreting, executing or merely reading the text of the program +# may result in lapses of consciousness and/or very being, up to and +# including the end of all existence and the Universe as we know it. +# See the GNU General Public License for more details. + +# You may have received a copy of the GNU General Public License along +# with this program (most likely, a file named COPYING). If not, see +# . +# + +cd $(dirname $0) ; CWD=$(pwd) + +PRGNAM=tea +VERSION=${VERSION:-0.14.2} +BUILD=${BUILD:-1} +TAG=${TAG:-_SBo} +PKGTYPE=${PKGTYPE:-tgz} +ARCH=x86_64 + +# If the variable PRINT_PACKAGE_NAME is set, then this script will report what +# the name of the created package would be, and then exit. This information +# could be useful to other scripts. +if [ ! -z "${PRINT_PACKAGE_NAME:-""}" ]; then + echo "$PRGNAM-$VERSION-$ARCH-$BUILD.txz " + exit 0 +fi + +TMP=${TMP:-/tmp/SBo} +PKG=$TMP/package-$PRGNAM +OUTPUT=${OUTPUT:-/tmp} + +if [ "$ARCH" = "i686" ]; then + SLKCFLAGS="-O2 -march=pentium4 -mtune=generic" + LIBDIRSUFFIX="" +elif [ "$ARCH" = "x86_64" ]; then + SLKCFLAGS="-O2 -march=x86-64 -mtune=generic -fPIC -pipe -fomit-frame-pointer" + LIBDIRSUFFIX="64" +else + SLKCFLAGS="-O2" + LIBDIRSUFFIX="" +fi + +set -e + +rm -rf $PKG +mkdir -p $TMP $PKG $OUTPUT +cd $TMP +# The gitea archive URL basename is "v$VERSION.tar.gz"; sbodl saves it as +# "$PRGNAM-v$VERSION.tar.gz". It also extracts to a top dir named "tea", not +# "tea-$VERSION". +rm -rf $PRGNAM +tar xvf $CWD/$PRGNAM-v$VERSION.tar.gz +cd $PRGNAM + +chown -R root:root . +find . \ + \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 -o -perm 511 \) \ + -exec chmod 755 {} \; -o \ + \( -perm 666 -o -perm 664 -o -perm 600 -o -perm 444 -o -perm 440 -o -perm 400 \) \ + -exec chmod 644 {} \; + + +# Use vendor mode if directory is present; otherwise, fallback to readonly +# to prevent automatic go.mod updates during the build process. +if [ -d vendor ]; then + MOD_STRATEGY="-mod=vendor" +else + MOD_STRATEGY="-mod=readonly" +fi + +# Standard Slackware CGO flags to respect $SLKCFLAGS +export CGO_CPPFLAGS="$SLKCFLAGS" +export CGO_CFLAGS="$SLKCFLAGS" +export CGO_CXXFLAGS="$SLKCFLAGS" + +# Setup local Go environment to avoid polluting the user's home directory +# Using a hidden directory within the build root +export GOPATH="$(pwd)/.gocache" +export GOPROXY="https://proxy.golang.org,direct" + +# Optimized GOFLAGS for Slackware: +# -buildmode=pie: Enable Position Independent Executable for security +# -trimpath: Remove local file system paths from the resulting binary +# -modcacherw: Ensure the module cache is writable (prevents permission issues during cleanup) +export GOFLAGS="$MOD_STRATEGY -trimpath -modcacherw" + +# Linker flags: +# -s: Omit the symbol table and debug information +# -w: Omit the DWARF symbol table +# -linkmode=external: Ensure proper linking with Slackware's glibc +# -X ...version.Version: stamp the version so `tea --version` reports it +LIB_LDFLAGS="-linkmode=external -s -w -X gitea.dev/tea/modules/version.Version=$VERSION" + +mkdir -p "$PKG"/usr/bin +# Compile all packages in the module +go build -ldflags="$LIB_LDFLAGS" -o "$PKG"/usr/bin/$PRGNAM . + +# Optional: Clean up the temporary Go cache after build to save space +rm -rf "$GOPATH" + +# Don't ship .la files: +rm -f $PKG/{,usr/}lib${LIBDIRSUFFIX}/*.la + +find $PKG | xargs file | grep -e "executable" -e "shared object" | grep ELF | cut -f 1 -d : | xargs -r strip --strip-unneeded 2> /dev/null || true +find $PKG | xargs file | grep "current ar archive" | cut -f 1 -d : | xargs -r strip -g 2> /dev/null || true + +mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION +cp -a \ + CONTRIBUTING.md LICENSE README.md \ + $PKG/usr/doc/$PRGNAM-$VERSION 2>/dev/null || true +cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild + +mkdir -p $PKG/install +cat $CWD/slack-desc > $PKG/install/slack-desc + +cd $PKG +/sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE diff --git a/tea/tea.info b/tea/tea.info new file mode 100644 index 0000000..baf13ec --- /dev/null +++ b/tea/tea.info @@ -0,0 +1,10 @@ +PRGNAM="tea" +VERSION="0.14.2" +HOMEPAGE="https://gitea.com/gitea/tea" +DOWNLOAD="https://gitea.com/gitea/tea/archive/v0.14.2.tar.gz" +MD5SUM="b1f37f2cc43763a3a0c05f060b485768" +DOWNLOAD_x86_64="" +MD5SUM_x86_64="" +REQUIRES="" +MAINTAINER="danix" +EMAIL="danix@danix.xyz" -- cgit v1.2.3