cli-tools

A collection of helpful scripts for contributing to (and maintaining) Terra!

Installation

# First, install Terra if you haven't already
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release

# Then install this package from Terra
dnf install terra-cli-tools

How to install individual scripts

1. Download the individual scripts you want.
2. Move each script to /usr/local/bin/ so they can be called as commands:

sudo mv </path/to/script_filename> /usr/local/bin/ && chmod -x /usr/local/bin/<script_filename>

3. Call scripts by running their filename as a command. e.g. rpmdate or ldd-dnf <arg>.

Note: You can also run these scripts without moving them to /usr/local/bin by calling them with ./path/to/<script_filename>. You may need to chmod -x <script_filename> first to enable executability.

How to Use

Scripts for Packagers/Package Maintainers

Name	Usage	Command
changelog.sh	Generates info for a changelog entry based on your git config by default. You can manually configure it with --name="" and --email="".	changelog [--help | -h] [--name=NAME] [--email=EMAIL] ["message"]
format-license.sh	Formats the build output of %cargo_license_summary_online and %tauri_cargo_license_summary into a proper string for the RPM License: tag.	format-license [--help | -h] "<raw license build output>"
ldd-dnf.sh	Finds libraries that a binary dynamically links to, and gets the name of each package that provides them.	ldd-dnf [--help | -h] <path/to/binary.rpm>
getcommit.sh	Fetches and formats the latest commit hash and date for a given git repository for when packaging nightly packages.	getcommit [--help | -h] <git repo url>
panda.sh	Runs Anda builds in a container. Just pass Anda arguments after Panda. Switch container branch with -b fxx	panda [--help | -h] <anda arguments>
icedtea-fetch.sh	Fetches IcedTea archives for use in Java builds. Use icedtea-fetch -h to view all flags.	icedtea-fetch [--help | -h] <icedtea-fetch flags>

Scripts for Repository/Mass Package Maintainers

Name	Usage	Command
backports.sh	Automatically merges backports for a given PR URL(s). Requires that you are authenticated with gh (GitHub CLI). You can also autodetect PRs to backport using --user and --time. More info can be found with -h. Use carefully.	backports [--help | -h] [-y] [-w] [--exclude-branch=<branch>] <pr-url-1> [pr-url-2] ... OR backports [-y] [-w] -A --user=<user> --time=<duration>
satm-grepdel.fish	Batch delete all packages matching a certain exact pattern from a set of repos in Subatomic repo manager. Prints a list of packages to be deleted before confirming deletion, pass --no-dry-run to actually perform the deletion, or --dry-run to explicitly run in safe mode.	satm-grepdel [--dry-run | --no-dry-run] "<pattern>"
satm-rm-stdin.sh	Deletes packages piped in via stdin from a single Subatomic repo. An alternative to satm-grepdel.fish.	cat packages-to-delete.txt | satm-rm-stdin <repo> OR subatomic-cli pkg list <repo> | grep "pattern-to-delete" | satm-rm-stdin <repo> OR satm-rm-stdin [--help | -h]
sync-branches.sh	Creates a branch sync pull request for when automatic bumps are out of sync across branches, or multiple backports are failing, by cloning terrapkg/packages over HTTPS, for a given release branch.	sync-branches [--help | -h] <username> <branch> [-x]
sync-branches-ssh.sh	Same as sync-branches.sh, but clones and pushes over SSH instead of HTTPS.	sync-branches-ssh [--help | -h] <username> <branch> [-x]
terra-subtree-build.sh	Builds every Anda project (package) in the current monorepo whose name matches a given pattern. Requires the CONFIG env var to be set.	terra-subtree-build [--help | -h] $0 <pattern>
terra_mass_rebuild.py	Prints a formatted list of every package to be pasted into the JSON build Terra workflow, for mass package rebuilds when making new branches/rebuilding frawhide.	python3 terra_mass_rebuild.py [--help | -h]

Plans

• Once more scripts get added, a CLI tool that includes all the scripts should be created and packaged.
• Add guide for contributing new scripts.

Attribution

• ldd-dnf.sh, changelog.sh: june@fyralabs.com
• format-license.sh, getcommit.sh, backports.sh: jonah@fyralabs.com
• panda.sh: jade@fyralabs.com
• icedtea-fetch.sh, sync-branches.sh, sync-branches-ssh.sh: roachy@fyralabs.com
• satm-grepdel.fish, satm-rm-stdin.sh, terra-subtree-build.sh: cappy@fyralabs.com
• terra-mass-rebuild.py: mado@fyralabs.com

The following scripts were originally from the terra-scripts repository:

• sync-branches.sh
• sync-branches-ssh.sh
• satm-grepdel.fish
• satm-rm-stdin
• terra-subtree-build.sh
• terra-mass-rebuild.py