~onemoresuza/rham

Repo herding ain't much...

78ca655 refactor: create run fn

a month ago

d701b48 refactor: create parsing functions

2 months ago

#rham

repo herding ain't much...

built with nix

Static Badge REUSE status

Static Badge

builds.sr.ht status

#Description

rham is a tool for managing (herding) multiple repos.

#Contributing

  1. mailing list
  2. tracker

#Resources

#Packaging

#Artifacts

At every release, starting at 0.1.0, the following files are made available:

  1. .gz compressed files for x86_64-linux, aarch64-linux and riscv64-linux binaries;
  2. .tar.gz compressed archive for the manpages;
  3. .SHA256 file with the checksums of the above files before compression; and
  4. .SHA256.sig file, being the signature of the checksum (see here).

#Verifying Artifacts

Every checksum file (.SHA256), starting at 0.9.0, is signed with the ssh key named builds.sr.ht-rham available here on Sourcehut.

After fetching the public key, do the following:

readonly id="builds@sr.ht"
readonly signersfile="./allowed_signers"
printf -- '%s <public-ssh-key>\n' "$id" 1>"$signersfile"
ssh-keygen \
	-Y verify \
	-f "$signersfile" \
	-I "$id" \
	-n file \
	-s checksum-*.SHA256.sig <checksum-*.SHA256

For more details, see Andrew Ayer's Blog.

#Compiling

#Dependencies

Dependency Upstream Repology Description
Hare URL URL Languange on which rham is written
hare-toml URL URL TOML implementation in Hare
haredo URL URL Build framework
scdoc URL URL Man page generator

#Embedded Values

Constant Type Environment Variable Description
VERSION str LOCALVER Suffix of the program's version

The VERSION constant may not be changed directly, only through the appending of a suffix if LOCALVER is not empty like so: <version>-$LOCALVER.

#Conventions

Both PREFIX and DESTDIR are honored, being /usr/local the default value of the former.

#Build Steps

# Build the program and generate its manpages.
haredo all doc
# Install the program.
haredo install