rham: Repo herding ain't much...

#rham

repo herding ain't much...

#Description

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

#Contributing

mailing list
- to send patches use git-send-mail
tracker

#Resources

#Packaging

#Artifacts

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

.gz compressed files for x86_64-linux, aarch64-linux and riscv64-linux binaries;
.tar.gz compressed archive for the manpages;
.SHA256 file with the checksums of the above files before compression; and
.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

~onemoresuza/rham