= README for shipper =

shipper automates the tedious process of shipping a software release.

You declare delivery channels in a per-project control file; these can
be scp destinations for tarballs and other assets, email and IRC
addresses to push notifications to, and other things (it can template
web pages for you, too). Then you can invoke shipper to generate a
shellscript that does the pushing when you pipe it to shell.

shipper never runs commands itself; it's just an orchestrator that
output a custom procedure you can audit.

The result is that you can type "make release" in your project
directory, have it call shipper piping to a shell, and the right
things will happen.

Requires Python 3.12 or later and ssh.  Wants gitlab-igor, irker,
and lftp.

You can run a regression test on this software with 'make check'.

Known bugs and to-do items are in TODO.
